すべてのプロダクト
Search

このプロダクト

    Cloud Monitor:BatchExport

    ドキュメントセンター

    Cloud Monitor:BatchExport

    最終更新日:Dec 24, 2025

    Cursor 操作で定義されたモニタリングデータをエクスポートします。

    操作説明

    前提条件

    Cursor 操作を呼び出すと、Cursor 情報が返されます。

    説明

    このトピックでは、Elastic Compute Service (ECS) の cpu_idle メトリックのモニタリングデータをエクスポートする方法の例を示します。 ECS の名前空間は acs_ecs_dashboard です。 Cursor 情報が指定されています。 各応答で最大 1,000 件のデータエントリを返すことができます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Namespace

    string

    必須

    クラウドサービスの名前空間です。

    クラウドサービスの名前空間の詳細については、「付録1：メトリック」をご参照ください。

    説明

    このパラメーターの値は、Cursor 操作のリクエストパラメーター Namespace の値と同じである必要があります。

    acs_ecs_dashboard
    Metric

    string

    必須

    クラウドサービスを監視するために使用されるメトリックです。

    クラウドサービスのメトリックの詳細については、「付録1：メトリック」をご参照ください。

    説明

    このパラメーターの値は、Cursor 操作のリクエストパラメーター Metric の値と同じである必要があります。

    cpu_idle
    Cursor

    string

    必須

    この操作を呼び出してデータをエクスポートする場合、Cursor パラメーターを指定する必要があります。 次のいずれかの方法で Cursor パラメーターの値を取得できます：

    • この操作を初めて呼び出す場合は、Cursor 操作を呼び出して Cursor 値を取得する必要があります。 詳細については、「Cursor」をご参照ください。

    • この操作を再度呼び出す場合は、最後の呼び出しの返されたデータから Cursor 値を取得できます。

    eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0MzIwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQ3NTY2MzYzMjY3NmI2ZjM5MzU2YjY4MzAzMTYyNzg3MTcwNjkzMTM3MjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2****
    Length

    integer

    必須

    各応答で返すことができるデータエントリの最大数です。

    有効値：1～10000。

    1000
    Measurements

    array

    任意

    返されるデータをカスタマイズするために使用される統計メソッドです。 デフォルトでは、すべての統計メソッドに基づくメジャーが返されます。

    たとえば、ECS (acs_ecs_dashboard) の cpu_idle メトリックには、Average、Maximum、Minimum の 3 つの統計メソッドがあります。 Average と Maximum の統計メソッドに基づくメジャーのみを返す場合は、このパラメーターを ["Average", "Maximum"] に設定します。

    メトリックの統計メソッドは、各クラウドサービスのメトリックページの Statistics 列に表示されます。 詳細については、「付録1：メトリック」をご参照ください。

    string

    任意

    統計メソッドです。

    Maximum

    共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    なし。

    Message

    string

    返されたメッセージ。

    success
    Code

    integer

    HTTP ステータスコードです。

    説明

    状態コード 200 は、リクエストが成功したことを示します。

    200
    Success

    boolean

    リクエストが成功したかどうかを示します。 有効値：

    • true

    • false

    true
    RequestId

    string

    リクエスト ID。

    251402CD-305C-1617-808E-D8C11FC8138D
    Cursor

    string

    この操作を再度呼び出すために使用される Cursor 情報です。

    説明

    null が返された場合、モニタリングデータはエクスポート済みであることを示します。

    v2.5eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0ODAwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQzMjdhNjU2MjY3N2E2NjZhNzczOTY2NmM3Mjc0NjM3MzY5Njg3NDcyMjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2MH0***
    Length

    integer

    この呼び出しで返されたデータエントリの数。

    1000
    Anchor

    integer

    バックエンドによってリクエストされたデータのタイムスタンプ。 タイムスタンプが大きいほど、データのエクスポート時刻が現在の時刻に近いことを示します。

    1678781819000
    HasNext

    boolean

    データがエクスポートされたかどうかを示します。 有効値：

    • true：一部のデータがエクスポートされていません。

    • false：すべてのデータがエクスポートされました。

    true
    DataResults

    array

    この呼び出しで返されたデータ。

    MetricStat

    エクスポートされたデータ。 次のパラメーターが含まれます：

    • Namespace：クラウドサービスの名前空間。 例：acs_ecs_dashboard。

    • Metric：メトリックの名前。 例：cpu_idle。

    • Timestamp：モニタリングデータのタイムスタンプ。 単位：ミリ秒。 例：1641454680000。

    • Period：モニタリングデータの統計期間。 単位：秒。 例：60。

    • Dimensions：監視対象インスタンスを識別するために使用されるディメンション。例：[{"Label":"userId", "Value":""20654616023382****"}, {"Label":"InstanceId", "Value":""i-2ze2d6j5uhg20x4****"}]。

    • Associated：キーと値のペアのタグなど、監視対象インスタンスに関する追加情報。 例：{"group":"test****", "name":"Alice"}。

    • Measurements：メトリックの統計メソッド。 デフォルトでは複数の値が表示されます。 例：{"Average":60,"Maximum":85}。

    • LogTime：モニタリングデータが記録された時刻。 単位：ミリ秒。 生データではないデータ (集計データ) の場合、LogTime の値は null です。

    例

    成功レスポンス

    JSONJSON

    {
  "Message": "success",
  "Code": 200,
  "Success": true,
  "RequestId": "251402CD-305C-1617-808E-D8C11FC8138D",
  "Cursor": "v2.5eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0ODAwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQzMjdhNjU2MjY3N2E2NjZhNzczOTY2NmM3Mjc0NjM3MzY5Njg3NDcyMjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2MH0***",
  "Length": 1000,
  "Anchor": 1678781819000,
  "HasNext": true,
  "DataResults": [
    {
      "Namespace": "acs_ecs_dashboard",
      "Metric": "cpu_idle",
      "Period": 60,
      "Timestamp": 1641454680000,
      "Dimensions": [
        {
          "Label": "instanceId",
          "Value": "i-dferwret*****"
        }
      ],
      "Associated": {
        "key": "{\"group\":\"test****\", \"name\":\"Alice\"}"
      },
      "Measurements": {
        "key": "{\"Average\":60,\"Maximum\":85}"
      },
      "LogTime": 1683686550073
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 %s %s
    500 InternalError The request processing has failed due to some unknown error.
    500 %s %s
    403 %s %s
    404 %s %s
    503 %s %s

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。