Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Utilice API de credenciales seguras de monitoreo sintético
Con la API REST de monitoreo sintético, puede realizar una llamada API para cambiar o recuperar datos de credenciales seguras . Este documento explica los requisitos de API y contiene ejemplos de comando curl de API.
Para obtener pautas generales para configurar credenciales seguras y configurarlas en la UI, consulte Credenciales seguras.
Importante
Ahora puede administrar sus credenciales seguras con nuestra API NerdGraph.
La tasa de solicitudes de una cuenta está limitada a tres solicitudes por segundo. Las solicitudes que superen este umbral devolverán un código de respuesta 429.
No se puede acceder al valor de una clave a través de la API; un usuario no autorizado no tendría acceso al valor principal seguro.
Ejemplos de API
Para enviar una credencial segura a su cuenta de New Relic, envíe una solicitud POST a https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials con una carga útil JSON que describa la credencial segura. He aquí un ejemplo:
Aquí hay un ejemplo de cómo hacer esto con un comando curl:
curl -v \
-X POST -H "Api-Key:$API_KEY" \
-H 'Content-Type: application/json' https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials \
-d '{ "key": "MYKEY", "value": "my value", "description": "Description of MYKEY" }'
Una solicitud exitosa devolverá una respuesta 201 Created , con el URI de la credencial segura recién creada especificada en el encabezado location . Los posibles códigos de error incluyen:
303 See Other: La clave especificada ya existe. El encabezado de ubicación devuelto contendrá el URI de la clave.
400 Bad Request: Clave demasiado larga o faltante, valor demasiado largo o faltante, carga útil JSON no analizable.
Para ver una lista de todas las credenciales seguras en su cuenta New Relic, envíe una solicitud GET a https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials. Por ejemplo:
Una solicitud exitosa devolverá una respuesta 200 OK . Los datos devueltos serán un objeto JSON en el siguiente formato:
{
"key": string,
"description": string,
"createdAt": date,
"lastUpdated": date
}
Una clave no válida devolverá 404 Not Found: The specified key doesn't exist.
Para actualizar una credencial existente en New Relic, envíe una solicitud PUT a https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials/$KEY.
curl -v \
-X PUT -H "Api-Key:$API_KEY" \
-H 'Content-Type: application/json' https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials/$KEY \
-d '{ "key": "MYKEY", "value": "my value", "description": "Description of MYKEY" }'
Una clave no válida devolverá 404 Not Found: The specified key doesn't exist.
Para eliminar una credencial existente en New Relic, envíe una solicitud DELETE a https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials/$KEY.