L'API REST New Relic (v2) pagine certaines réponses, pour des raisons de performances. Cela est dû au fait que le renvoi de l’ensemble des données peut être réalisable pour certaines requêtes, mais prohibitif pour d’autres qui renvoient une très grande quantité de données.
Exigences et limites
retour de données métriques :
- La pagination n'est plus disponible pour la sortie des métriques pour certains clients (obsolescence à partir de décembre 2020).
- Renvoie jusqu'à 3000 résultats par cellule. Pour les sorties volumineuses, nous recommandons de restreindre la requête à l'aide de l'identifiant d'application ou d'un autre attribut.
L'ordre de tri des données renvoyées est indéterminé. Ne présumez pas et ne vous fiez pas à un ordre particulier.
Les données renvoyées par page dépendent des données demandées. Le nombre de pages dépend du nombre d'objets JSON nécessaires pour compléter la liste.
Important
Avant de répertorier les noms de métriques, consultez les directives relatives à la liste des noms de métriques.
Demander une page spécifique
Pour spécifier une page, ajoutez le paramètre page= à la requête. Voici un exemple :
$curl -X GET 'https://api.newrelic.com/v2/alerts_incidents.json?page=3' \> -H "Api-Key:$API_KEY" -iDans l'explorateur d'API REST, vous pouvez rapidement modifier la page visualisée.
Exemples d'en-têtes de liens affichant le nombre de pages
L'appel d'API renvoie l'en-tête Link si les données sont paginées. Cela indique le nombre de pages et la page consultée. Cette ligne apparaît également en haut du Response dans l’explorateur d’API REST.
Important
L'en-tête du lien n'apparaîtra que si les données de sortie sont paginées.
Conseil
La référence rel="last" ne sera pas affichée lors des appels au point de terminaison de violation (https://api.newrelic.com/v2/alerts_violations.json). Pour déterminer la page finale lors des appels vers ce point de terminaison, recherchez l’absence d’une référence rel="next" .
Pour obtenir cette ligne en utilisant certaines implémentations de curl, vous devrez peut-être inclure l'option -v .
$curl -v -X GET 'https://api.newrelic.com/v2/applications/$APP_ID/...'New Relic utilise le format standard RFC 5988 pour les liens.