Use API credenciais seguras de monitoramento sintético

Para enviar uma credencial segura para sua conta New Relic, envie uma solicitação POST para https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials com uma carga JSON que descreva a credencial segura. Aqui está um exemplo:

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

Aqui está um exemplo de como fazer isso com um 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" }'

Uma solicitação bem-sucedida retornará uma resposta 201 Created , com o URI da credencial segura recém-criada especificada no cabeçalho location . Os possíveis códigos de erro incluem:

• 303 See Other: a chave especificada já existe. O cabeçalho de localização retornado conterá o URI da chave.
• 400 Bad Request: chave muito longa ou ausente, valor muito longo ou ausente, carga JSON não analisável.

Para visualizar uma lista de todas as credenciais seguras em sua conta New Relic, envie uma solicitação GET para https://synthetics.newrelic.com/synthetics/api/v1/secure-credentials. Por exemplo:

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

Uma solicitação bem-sucedida retornará uma resposta 200 OK . Os dados retornados serão um objeto JSON no seguinte formato:

{
  "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
}

Para visualizar uma única credencial segura, envie uma solicitação GET para 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

Uma solicitação bem-sucedida retornará uma resposta 200 OK . Os dados retornados serão um objeto JSON no seguinte formato:

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

Uma chave inválida retornará 404 Not Found: The specified key doesn't exist.

Para atualizar uma credencial existente no New Relic, envie uma solicitação PUT para 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" }'

Uma chave inválida retornará 404 Not Found: The specified key doesn't exist.

Para excluir uma credencial existente no New Relic, envie uma solicitação DELETE para 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

Observe que se a chave especificada não existir, nenhum erro ocorrerá.