グループ内のメトリックの最新の値の取得

get

http://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/targets/{targetId}/metricGroups/{metricGroupName}/latestData

ターゲットのメトリック・グループ内のメトリックについて、EMリポジトリから収集した最新の値を取得します。キーがないメトリック・グループの場合、返される可能性があるのは1行のデータです。キーがあるメトリック・グループの場合は、複数行のデータが返される可能性があります。

リクエスト

パス・パラメータ
問合せパラメータ
  • オプションのパラメータ。メトリックにキーが関連付けられている場合は、key_<name>という形式の名前が付いた問合せパラメータを使用して特定のキーをフィルタできます。
    例:
    key_mountPoint=/scratch&key_mountPoint=/
  • 最小値: 1
    最大値: 500
    現在のコールで返されるアイテムの数を制限します。アイテムを追加でフェッチするには、レスポンスからのself/previous/nextリンクを使用します。
    デフォルト値: 50
  • 最大長: 64
    オプションのパラメータであり、メトリックの名前。
    例:
    size
  • 取得するアイテムのセットを特定します。レスポンスのlinksリストのhref要素により、このパラメータのエンコードされた値が提供されます。href要素の値は、それぞれのアイテム・セットをフェッチする場合はそのまま使用する必要があります。
    例:
    MQ%3D%3D
  • 最大長: 256
    1つ以上のキー列で結果をソートします。列の順序は<key_column>:<sortDirection>として指定する必要があります。key_columnは、問合せ内のメトリックの有効なキー列である必要があります。sortDirectionとしてはASC (つまり、昇順)またはDESC (つまり、降順)を指定でき、指定しない場合はデフォルトでASCになります。複数列にわたりソートするには、カンマ(,)で区切って複数の列の順序を指定します。
    例:
    mountPoint:DESC

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

サポートされているメディア・タイプ

200レスポンス

OK
本文()
ルート・スキーマ: MetricGroupLatestData
型: object
ターゲットのメトリック・グループ内のメトリックの最新収集データ。
ソースの表示
  • 返されたアイテム・リスト内に存在する行の数
    例: 2
  • items
    メトリック・グループの最新アップロードに対応するメトリック・データの行を提供します。キーがないメトリック・グループの場合、返される可能性があるのは1行のデータです。キーがあるメトリック・グループの場合は、複数行のデータが返される可能性があります。行はキー値によって識別されます。データが存在しない場合は、空になります。
  • links
  • 最大長: 64
    メトリック・グループ
    例: Filesystems
  • 最大長: 32
    ターゲットのID
    例: CF99A10F233254B78ED96ED1B5C15140
  • 最大長: 256
    ターゲット名
    例: myhost.mydomain.com
  • 最大長: 64
    ターゲット・タイプ
    例: host
  • 日時書式 - yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
    例: 2021-08-26T21:35:55.000Z
ネストされたスキーマ: items
型: array
メトリック・グループの最新アップロードに対応するメトリック・データの行を提供します。キーがないメトリック・グループの場合、返される可能性があるのは1行のデータです。キーがあるメトリック・グループの場合は、複数行のデータが返される可能性があります。行はキー値によって識別されます。データが存在しない場合は、空になります。
ソースの表示
  • MetricRowData
    使用可能なその他のプロパティ: additionalProperties
    メトリック・グループに対応する、1行のメトリック・データを表します。行はカンマで区切られた名前/値のペアであり、名前はメトリックまたはキーを示し、値は数値または文字列型です。
例:
[
    {
        "mountPoint":"/",
        "available":"29004.7",
        "fileSystem":"/dev/vda1",
        "pctAvailable":"60.82",
        "size":"50267.62"
    },
    {
        "mountPoint":"/scratch",
        "available":"65508.38",
        "fileSystem":"/dev/vdb",
        "pctAvailable":"28.55",
        "size":"241776.06"
    }
]
ネストされたスキーマ: MetricRowData
型: object
使用可能なその他のプロパティ
ソースの表示
メトリック・グループに対応する、1行のメトリック・データを表します。行はカンマで区切られた名前/値のペアであり、名前はメトリックまたはキーを示し、値は数値または文字列型です。
例:
{
    "mountPoint":"/",
    "available":"29004.7",
    "fileSystem":"/dev/vda1",
    "pctAvailable":"60.82",
    "size":"50267.62"
}

400レスポンス

不正なリクエスト。ペイロードがnullであるか、一部のパラメータがありません
本文()
ルート・スキーマ: ErrorResponse
型: object
エラー・レスポンス
ソースの表示

401レスポンス

未認可。ユーザーにはリクエストされた操作を実行する権限がありません
本文()
ルート・スキーマ: ErrorResponse
型: object
エラー・レスポンス
ソースの表示

404レスポンス

見つかりません。リクエストされたREST API URLが見つかりません。
本文()
ルート・スキーマ: ErrorResponse
型: object
エラー・レスポンス
ソースの表示

500レスポンス

内部サーバー・エラー。REST APIの実行中に例外が発生しました。
本文()
ルート・スキーマ: ErrorResponse
型: object
エラー・レスポンス
ソースの表示

503レスポンス

サービスが使用できません。サーバーはリクエストを処理できません。
本文()
ルート・スキーマ: ErrorResponse
型: object
エラー・レスポンス
ソースの表示
先頭に戻る