DescribeHybridMonitorDataList を使用したハイブリッドクラウドメトリクスの取得 - CMS

名前空間内のモニタリングデータをクエリします。

操作説明

制限事項

各呼び出しで返されるモニタリングデータのサイズは 1.5 MB を超えることはできません。返されたデータが上限に達した場合、クエリは失敗します。クエリ条件をリセットする必要があります。

操作の説明

この Topic では、default-aliyun 名前空間の AliyunEcs_cpu_total メトリックのモニタリングデータを、1653804865 (2022年5月29日 14:14:25) から 1653805225 (2022年5月29日 14:20:25) までクエリする方法の例を示します。

操作説明

このトピックでは、default-aliyun 名前空間内の AliyunEcs_cpu_total メトリックのモニタリングデータを 1653804865 (2022年5月29日 14:14:25) から 1653805225 (2022年5月29日 14:20:25) までクエリする方法の例を説明します。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cms:DescribeCustomMetricDataPoint

list

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Namespace	string	必須	名前空間の名前。名前空間の名前をクエリする方法の詳細については、「DescribeHybridMonitorNamespaceList」をご参照ください。	default-aliyun
PromSQL	string	必須	メトリック名。説明 PromQL 文がサポートされています。	AliyunEcs_cpu_total
Start	integer	必須	クエリする時間範囲の開始時刻。単位：秒。	1653804865
End	integer	必須	クエリする時間範囲の終了時刻。単位：秒。	1653805225
Period	string	任意	モニタリングデータの統計期間。単位：秒。	60

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

レスポンスフィールド

フィールド	型	説明	例
	object	なし。
Code	string	応答コード。説明状態コード 200 は、リクエストが成功したことを示します。	200
Message	string	返されたメッセージ。	end timestamp must not be before start time.
RequestId	string	リクエスト ID。	C240412F-3F5F-50E2-ACEC-DE808EF9C4BE
Success	string	リクエストが成功したかどうかを示します。有効な値： true false	true
TimeSeries	array<object>	返されたモニタリングデータ。
	array<object>
MetricName	string	メトリック名。	AliyunEcs_cpu_total
Labels	array<object>	時間ディメンションのタグ。
	object
K	string	タグキー。	instanceId
V	string	タグ値。	i-rj99xc6cptkk64ml****
Values	array<object>	異なるタイムスタンプで収集されたメトリック値。
	object
V	string	メトリック値。	0.13
Ts	string	メトリック値が収集された時間を示すタイムスタンプ。単位：秒。	1653804865

例

成功レスポンス

JSONJSON

{
  "Code": "200",
  "Message": "end timestamp must not be before start time.",
  "RequestId": "C240412F-3F5F-50E2-ACEC-DE808EF9C4BE",
  "Success": "true",
  "TimeSeries": [
    {
      "MetricName": "AliyunEcs_cpu_total",
      "Labels": [
        {
          "K": "instanceId",
          "V": "i-rj99xc6cptkk64ml****"
        }
      ],
      "Values": [
        {
          "V": "0.13",
          "Ts": "1653804865"
        }
      ]
    }
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	%s	%s
400	BadRequest	Bad request.
500	InternalError	%s
403	%s	%s
404	%s	%s
409	%s	Resources already exist.

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

変更履歴

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