• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

API出力のパジネーション

New Relic REST API (v2) は、パフォーマンス上の理由から、一部のレスポンスをページネーションします。これは、データセット全体を返すことが可能なクエリもあれば、非常に大量のデータを返すクエリもあるためです。

要件と制限

  • メトリックデータのリターン。

    • 一部のお客様のメトリクス出力で、ページネーションが利用できなくなりました(2020年12月より非推奨)。
    • セルあたり最大3000件の結果を返します。大量の結果を得るためには、アプリケーションIDや他の属性を使ってクエリを絞り込むことをお勧めします。
  • 返されたデータのソート順は不確定です。特定の順序を仮定したり、依存したりしないでください。

ページごとに返されるデータは、どのようなデータが要求されているかによって異なります。ページ数は、リストを完成させるために必要なJSONオブジェクトの数によって異なります。

重要

メトリック名を記載する前に、 メトリック名記載のガイドライン を参照してください。

特定のページをリクエストする

ページを指定するには、クエリにpage=パラメータを追加します。次に例を示します。

curl -X GET 'https://api.newrelic.com/v2/alerts_incidents.json?page=3' \
     -H 'Api-Key:$API_KEY' -i

REST API Explorerでは、 閲覧しているページを素早く変更することができます

データがページ分割されている場合、API 呼び出しはLinkヘッダーを返します。これは、ページ数と閲覧中のページを示します。この行は、REST API エクスプローラーのResponseの上部にも表示されます。

重要

リンクヘッダは、出力データがページネーションされている場合にのみ表示されます。

ヒント

Violations エンドポイント ( https://api.newrelic.com/v2/alerts_violations.json ) を呼び出す場合、 rel="last"参照は表示されません。このエンドポイントを呼び出す際の最終ページを判別するには、 rel="next"参照がないことを確認してください。

curlの一部の実装を使用してこの行を取得するには、 -vオプションを含める必要がある場合があります。

curl -v -X GET 'https://api.newrelic.com/v2/applications/$APP_ID/...'

New Relic では、リンクに RFC 5988 の標準フォーマットを使用しています。

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.