すべてのプロダクト
Search

このプロダクト

    :DescribeMetricLast

    ドキュメントセンター

    :DescribeMetricLast

    最終更新日:Nov 17, 2025

    インスタンスまたはマトリックスの最新のモニタリングデータをクエリします。CPU、メモリ、ディスク、ネットワークなどのメトリックをクエリできます。

    今すぐお試しください

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

    テスト

    RAM 認証

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

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    MetricNames

    array

    必須

    モニタリングメトリックのリスト。

    string

    任意

    メトリックの名前。

    列挙値:

    • disk_read_bps :
      ディスク読み取り bps
    • disk_read_iops :
      ディスク読み取り IOPS
    • cpu_utilization :

      CPU 使用率

    • disk_write_iops :
      ディスク書き込み IOPS
    • disk_write_bps :
      ディスク書き込み bps
    • diskusage_utilization :

      ストレージ使用量

    • memory_used_utilization :

      メモリ使用量

    • intranet_out_rate :

      接続の送信帯域幅

    • process_memory :

      プロセスのメモリ使用量

    • intranet_in_rate :

      接続の受信帯域幅

    • process_cpu :

      プロセスの CPU 使用率

    cpu_utilization
    AndroidInstanceIds

    array

    任意

    インスタンスレベルのモニタリングでは、CP インスタンス ID のリストを指定します。

    string

    任意

    インスタンスレベルのモニタリングでは、CP インスタンス ID を指定します。

    acp-6nongia0tuev7****
    Period

    integer

    任意

    モニタリングデータの統計期間。

    有効な値: 60、900、3600。

    単位: 秒。

    列挙値:

    • 15 :
      15
    • 60 :

      60

    • 900 :

      900

    • 3600 :

      3600

    60
    StartTime

    string

    任意

    メトリックをクエリする開始時刻。

    2019-01-31 10:00:00
    EndTime

    string

    任意

    メトリックをクエリする終了時刻。

    2019-01-31 11:00:00
    NextToken

    string

    任意

    現在の読み取り位置の開始を示すトークン。このパラメーターを空のままにすると、クエリは最初から開始されます。

    AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uONHqPtDLM2U8s****
    Length

    string

    任意

    ページングクエリで各ページに返すモニタリングデータエントリの数。

    デフォルト値は 1000 です。これは、ページごとに 1000 件のモニタリングデータエントリが返されることを意味します。

    1000
    InstanceIds

    array

    任意

    インスタンス ID のリスト。

    string

    任意

    インスタンス ID。

    説明

    帯域幅プラン ID を指定すると、帯域幅プランの最新の帯域幅データをクエリできます。

    np-5hh4a31emkt6u****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    API によって返されるデータ。

    RequestId

    string

    リクエスト ID。

    2B9E6946-0E2A-5D2B-B275-361DF81F****
    Count

    integer

    エントリ数。

    100
    NextToken

    string

    次のクエリのトークン。1 回のクエリですべての結果が返されない場合、返される NextToken は空ではありません。返された NextToken を次のクエリで使用して、クエリを続行できます。

    AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****
    MetricTotalModel

    array<object>

    インスタンスのモニタリング結果のリスト。

    array<object>

    インスタンスのモニタリング結果。

    AndroidInstanceId

    string

    インスタンスレベルのモニタリングでは、CP インスタンス ID が返されます。

    acp-fkuit0cmyru4p****
    MetricModelList

    array<object>

    メトリックのモニタリング結果のリスト。

    array<object>

    メトリックのモニタリング結果。

    MetricName

    string

    メトリックの名前。

    cpu_utilization
    DataPoints

    array<object>

    モニタリングデータポイントのリスト。

    object

    モニタリングデータポイント。

    Timestamp

    integer

    統計のタイムスタンプ。単位: ミリ秒。

    1548777660000
    Minimum

    number

    最小値。単位: %。

    説明

    メトリックが `bandwidth_package_usage_out` または `bandwidth_package_usage_in` の場合、単位は bps です。

    93.1
    Average

    number

    平均値。単位: %。

    説明

    メトリックが `bandwidth_package_usage_out` または `bandwidth_package_usage_in` の場合、単位は bps です。

    99.52
    Maximum

    number

    最大値。単位: %。

    説明

    メトリックが `bandwidth_package_usage_out` または `bandwidth_package_usage_in` の場合、単位は bps です。

    100
    GpuId

    string

    GPU ID。

    cpn-1t1bxvp9az2pk****-gpu-0
    ProcessLastInfos

    array<object>

    プロセスのモニタリングメトリックのリスト。

    説明

    このパラメーターは、メトリックが `process_cpu` または `process_memory` の場合に返されます。

    object

    プロセスのモニタリングメトリック。

    Timestamp

    integer

    統計のタイムスタンプ。単位: ミリ秒。

    1548777660000
    Name

    string

    プロセス名。

    com.offerup
    ProcessIds

    array

    プロセス ID のリスト。

    integer

    プロセス ID。

    100056
    MemoryUsage

    number

    メモリ使用量。単位: %。

    50
    CpuUsage

    number

    CPU 使用率。単位: %。

    50

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "2B9E6946-0E2A-5D2B-B275-361DF81F****",
  "Count": 100,
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****",
  "MetricTotalModel": [
    {
      "AndroidInstanceId": "acp-fkuit0cmyru4p****",
      "MetricModelList": [
        {
          "MetricName": "cpu_utilization",
          "DataPoints": [
            {
              "Timestamp": 1548777660000,
              "Minimum": 93.1,
              "Average": 99.52,
              "Maximum": 100,
              "GpuId": "cpn-1t1bxvp9az2pk****-gpu-0"
            }
          ],
          "ProcessLastInfos": [
            {
              "Timestamp": 1548777660000,
              "Name": "com.offerup",
              "ProcessIds": [
                100056
              ],
              "MemoryUsage": 50,
              "CpuUsage": 50
            }
          ]
        }
      ]
    }
  ]
}

    エラーコード

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

    変更履歴

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