Utiliser monitoring d'informations d'identification sécurisées Synthétique API

Pour envoyer des informations d'identification sécurisées à votre compte New Relic, envoyez une requête POST à https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials avec une charge utile JSON qui décrit les informations d'identification sécurisées. Voici un exemple :

{
  "key": string [required, 1-64 characters uppercase],
  "value": string [required, 1-3,000 characters],
  "description": string [optional]
}

Voici un exemple de réalisation avec une commande 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" }'

Une demande réussie renverra une réponse 201 Created , avec l'URI des informations d'identification sécurisées nouvellement créées spécifiées dans l'en-tête location . Les codes d’erreur possibles incluent :

• 303 See Other: La clé spécifiée existe déjà. L'en-tête d'emplacement renvoyé contiendra l'URI de la clé.
• 400 Bad Request: Clé trop longue ou manquante, valeur trop longue ou manquante, charge utile JSON non analysable.

Pour afficher la liste de toutes les informations d'identification sécurisées de votre compte New Relic, envoyez une demande GET à https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials. Par exemple:

$
curl -v \
>
     -H "Api-Key:$API_KEY" \
>
     'https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials'

Une demande réussie renverra une réponse 200 OK . Les données renvoyées seront un objet JSON au format suivant :

{
  "secureCredentials": [
    {
      "key": "MYKEY1",
      "description": "Description of MYKEY1",
      "createdAt": "2016-09-26T23:12:46.981+0000",
      "lastUpdated": "2016-09-26T23:12:46.981+0000"
    },
    {
      "key": "MYKEY2",
      "description": "Description of MYKEY2",
      "createdAt": "2016-09-26T23:12:46.981+0000",
      "lastUpdated": "2016-09-26T23:12:46.981+0000"
    }
  ],
  "count": 2
}

Pour afficher un seul identifiant sécurisé, envoyez une demande GET à https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials/$KEY.

curl -v \
     -H "Api-Key:$API_KEY" \
     'https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials/$KEY'

Une demande réussie renverra une réponse 200 OK . Les données renvoyées seront un objet JSON au format suivant :

{
  "key": string,
  "description": string,
  "createdAt": date,​
  "lastUpdated": date
}

Une clé non valide renverra 404 Not Found: The specified key doesn't exist.

Pour mettre à jour une information d’identification existante dans New Relic, envoyez une demande PUT à 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" }'

Une clé non valide renverra 404 Not Found: The specified key doesn't exist.

Pour supprimer une information d’identification existante dans New Relic, envoyez une demande DELETE à https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials/$KEY.

$
curl -v \
>
     -H "Api-Key:$API_KEY" \
>
     -X DELETE \
>
     https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials/$KEY

Veuillez noter que si la clé spécifiée n'existe pas, aucune erreur ne se produira.