El endpoint screenboard
permite crear, actualizar, eliminar y consultar screenboards mediante programación.
Crear un screenboard
Firma
POST https://api.datadoghq.com/api/v1/screen
Argumentos
board_title
[required (requerido)]:
Nombre del dashboard.description
(descripción) [opcional, default=None]:
Descripción del contenido del dashboard.widgets
[required (requerido)]:
Una lista de definiciones de widget. Para obtener una definición de widget, utiliza la pestaña JSON en la IU de la configuración de widget.template_variables
[optional, default=None]:
Una lista de variables de plantilla para utilizar la plantilla dashboard.read_only
[opcional, default=False]:
El estado de solo lectura del screenboard.
Ejemplos
desde inicializar importación datadog, api
opciones = {
'api_key': '<DATADOG_API_KEY>',
'app_key': '<DATADOG_APPLICATION_KEY>'
}
inicializar(**opciones)
board_title = "Mi screenboard"
descripción = "Un screenboard informativo."
ancho = 1024
widgets = [{
"tipo": "imagen",
"altura": 20,
"ancho": 32,
"y": 7,
"x": 32,
"url": "https://path/to/image.jpg"
}]
template_variables = [{
"nombre": "host1",
"prefijo": "host",
"por defecto": "host:my-host"
}]
api.Screenboard.create(board_title=board_title,
description=description,
widgets=widgets,
template_variables=template_variables,
width=width)
requerir 'rubygems'
requerir 'dogapi'
api_key='<DATADOG_API_KEY>'
app_key='<DATADOG_APPLICATION_KEY>'
dog = Dogapi::Client.new(api_key, app_key)
board = {
"ancho" => 1024,
"altura" => 768,
"board_title" => "dogapi test",
"widgets" => [
{
"tipo" => "imagen",
"altura" => 20,
"ancho" => 32,
"y" => 7,
"x" => 32,
"url" => "https://path/to/image.jpg"
}
]
}
resultado = dog.create_screenboard(board)
api_key=<DATADOG_API_KEY>
app_key=<DATADOG_APPLICATION_KEY>
curl -X POST -H "Tipo de contenido: aplicación/json" \
-d '{
"ancho": 1024,
"altura": 768,
"board_title": "dogapi test",
"widgets": [
{
"tipo": "imagen",
"altura": 20,
"ancho": 32,
"y": 7,
"x": 32,
"url": "https://path/to/image.jpg"
}
]
}' \
"https://api.datadoghq.com/api/v1/screen?api_key=${DD_CLIENT_API_KEY}&application_key=${DD_CLIENT_APP_KEY}"
Actualizar a screenboard
Firma
PONER https://api.datadoghq.com/api/v1/screen/<SCREEENBOARD_ID>
Argumentos
board_title
[required (requerido)]:
Nombre del dashboard.description
(descripción) [opcional, default=None]:
Descripción del contenido del dashboard.widgets
[required (requerido)]:
Una lista de definiciones de widget. Para obtener una definición de widget, utiliza la pestaña JSON en la IU de la configuración de widget.template_variables
[optional, default=None]:
Una lista de variables de plantilla para utilizar la plantilla dashboard.width
[optional (opcional), default=None]:
Ancho de screenboard en píxelesheight
(altura) [optional (opcional), default=None]:
Altura de screenboard en píxeles.read_only
[opcional, default=False]:
El estado de solo lectura del screenboard.
Ejemplos
desde inicializar importación datadog, api
opciones = {
'api_key': '<DATADOG_API_KEY>',
'app_key': '<DATADOG_APPLICATION_KEY>'
}
inicializar(**opciones)
board_id = 2551
board_title = "Mi screenboard"
descripción = "Un screenboard informativo."
ancho = 1024
widgets = [{
"tipo": "imagen",
"altura": 20,
"ancho": 32,
"y": 7,
"x": 32,
"url": "https://path/to/image.jpg"
}]
template_variables = [{
"nombre": "host1",
"prefijo": "host",
"por defecto": "host:my-host"
}]
api.Screenboard.update(board_id,
board_title=board_title,
description=description,
widgets=widgets,
template_variables=template_variables,
width=width)
requerir 'rubygems'
requerir 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
dog = Dogapi::Client.new(api_key, app_key)
board_id = 7953
board = {
"ancho" => 1024,
"altura" => 768,
"board_title" => "dogapi test",
"widgets" => [{
"tipo" => "imagen",
"altura" => 20,
"ancho" => 32,
"y" => 7,
"x" => 32,
"url" => "https://path/to/image.jpg"
}]
}
resultado = dog.update_screenboard(board_id, board)
api_key=<DATADOG_API_KEY>
app_key=<DATADOG_APPLICATION_KEY>
curl -X PONER -H "Tipo de contenido: aplicaciones/json" \
-d '{
"ancho": 1024,
"altura": 768,
"board_title": "dogapi test",
"widgets": [
{
"tipo": "imagen",
"altura": 20,
"ancho": 32,
"y": 7,
"x": 32,
"url": "https://path/to/image.jpg"
}
]
}' \
"https://api.datadoghq.com/api/v1/screen/${board_id}?api_key=${DD_CLIENT_API_KEY}&application_key=${DD_CLIENT_APP_KEY}"
Eliminar un screenboard
Eliminar un screenboard existente .
Este endpoint no toma argumentos JSON.
Firma
ELIMINAR https://api.datadoghq.com/api/v1/screen/<SCREEENBOARD_ID>
Argumentos
Este endpoint no toma argumentos JSON.
Ejemplos
desde inicializar importación datadog, api
opciones = {
'api_key': '<DATADOG_API_KEY>',
'app_key': '<DATADOG_APPLICATION_KEY>'
}
inicializar (**opciones)
api.Screenboard.delete(811)
requerir 'rubygems'
requerir 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
dog = Dogapi::Client.new(api_key, app_key)
board_id = '2534'
resultado = dog.delete_screenboard(board_id)
api_key=<DATADOG_API_KEY>
app_key=<DATADOG_APPLICATION_KEY>
board_id=2471
# Crear un screenboard para eliminar
board_id=$(curl -X POST -H "Tipo de contenido: aplicación/json" \
-d '{
"ancho": 1024,
"altura": 768,
"board_title": "tests dogapi",
"widgets": [
{
"tipo": "imagen",
"altura": 20,
"ancho": 32,
"y": 7,
"x": 32,
"url": "https://path/to/image.jpg"
}
]
}' \
"https://api.datadoghq.com/api/v1/screen?api_key=${DD_CLIENT_API_KEY}&application_key=${DD_CLIENT_APP_KEY}" | jq '.id')
curl -X ELIMINAR\
"https://api.datadoghq.com/api/v1/screen/${board_id}?api_key=${DD_CLIENT_API_KEY}&application_key=${DD_CLIENT_APP_KEY}"
Consigue un screenboard
Obtener una definición existente de screenboard.
Firma
OBTENER https://api.datadoghq.com/api/v1/screen/<SCREEENBOARD_ID>
Argumentos
Este endpoint no toma argumentos JSON.
Ejemplos
desde inicializar importación datadog, api
opciones = {
'api_key': '<DATADOG_API_KEY>',
'app_key': '<DATADOG_APPLICATION_KEY>'
}
inicializar (**opciones)
api.Screenboard.get(811)
requerir 'rubygems'
requerir 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
dog = Dogapi::Client.new(api_key, app_key)
board_id = '6334'
resultado = dog.get_screenboard(board_id)
api_key=<DATADOG_API_KEY>
app_key=<DATADOG_APPLICATION_KEY>
board_id=6334
# Crear un screenboard para obtener
board_id=$(curl -X POST -H "Tipo de contenido: aplicación/json" \
-d '{
"ancho": 1024,
"altura": 768,
"board_title": "tests dogapi",
"widgets": [
{
"tipo": "imagen",
"altura": 20,
"ancho": 32,
"y": 7,
"x": 32,
"url": "https://path/to/image.jpg"
}
]
}' \
"https://api.datadoghq.com/api/v1/screen?api_key=${DD_CLIENT_API_KEY}&application_key=${DD_CLIENT_APP_KEY}" | jq '.id')
curl -X OBTENER\
"https://api.datadoghq.com/api/v1/screen/${board_id}?api_key=${DD_CLIENT_API_KEY}&application_key=${DD_CLIENT_APP_KEY}"
Obtén todos los screenboards
Obtén todas las definiciones de tus screenboards.
Firma
OBTENER https://api.datadoghq.com/api/v1/screen
Argumentos
Este endpoint no toma argumentos JSON.
Ejemplos
desde inicializar importación datadog, api
opciones = {
'api_key': '<DATADOG_API_KEY>',
'app_key': '<DATADOG_APPLICATION_KEY>'
}
inicializar (**opciones)
api.Screenboard.get_all()
requerir 'rubygems'
requerir 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
dog = Dogapi::Client.new(api_key, app_key)
resultado = dog.get_all_screenboards()
api_key=<Datadog_API_KEY>
app_key=<Datadog_APPLICATION_KEY>
curl -X OBTENER "https://api.datadoghq.com/api/v1/screen?api_key=${DD_CLIENT_API_KEY}&application_key=${DD_CLIENT_APP_KEY}"