すべてのプロダクト
Search
ドキュメントセンター

AnalyticDB:DescribeDBClusterPerformance

最終更新日:Sep 04, 2026

指定されたクラスターのパフォーマンスデータを照会します。

操作説明

パフォーマンスパラメーターに基づいて、指定された時間範囲内の指定されたクラスターのパフォーマンスモニタリングデータを照会します。データ収集の粒度は 30 秒です。スロー SQL 文を照会し、SQL クエリの持続時間、スキャン行数、スキャンボリュームなどの監視メトリクスを表示できます。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

adb:DescribeDBClusterPerformance

list

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

DBClusterId

string

必須

AnalyticDB for MySQL クラスターの ID。

説明

DescribeDBClusters 操作を呼び出して、指定されたリージョン内のすべての AnalyticDB for MySQL クラスターの詳細 (クラスター ID を含む) を照会できます。

am-8vbf80pjcz*****

Key

string

任意

照会するパフォーマンスメトリック (モニタリングキー) の名前。複数の値はコンマ (,) で区切ります。サポートされているメトリックの詳細については、「監視メトリクスの概要」を参照してください。

AnalyticDB_CPU

StartTime

string

任意

照会する時間範囲の開始時刻。時刻を yyyy-MM-ddTHH:mmZ フォーマット (協定世界時 (UTC)) で指定します。

2021-05-03T15:00Z

EndTime

string

任意

照会する時間範囲の終了時刻。時刻を yyyy-MM-ddTHH:mmZ フォーマット (協定世界時 (UTC)) で指定します。

説明

終了時刻は開始時刻より後である必要があり、開始時刻と終了時刻の間隔は 2 日を超えることはできません。

2021-05-03T15:01Z

RegionId

string

必須

クラスターが属するリージョン。

cn-hangzhou

ResourcePools

string

任意

リソースグループの名前。

test

レスポンスフィールド

フィールド

型

説明

例

object

応答の詳細。

EndTime

string

クエリの時間範囲の終了時刻。時刻は yyyy-MM-ddTHH:mm:ssZ フォーマット (協定世界時 (UTC)) です。

2021-05-03T15:01:00Z

RequestId

string

リクエスト ID。

25B56BC7-4978-40B3-9E48-4B7067******

StartTime

string

クエリの時間範囲の開始時刻。時刻は yyyy-MM-ddTHH:mm:ssZ フォーマット (協定世界時 (UTC)) です。

2021-05-03T15:00:00Z

DBClusterId

string

クラスター ID。

am-8vbf80pjcz*****

Performances

array<object>

クラスターのパフォーマンスメトリックのリスト。

array<object>

パフォーマンスメトリックの詳細。

Key

string

パフォーマンスメトリックの名前。

AnalyticDB_CPU

Unit

string

データの単位。

%

Series

array<object>

パフォーマンスデータのリスト。

object

パフォーマンスメトリックの詳細。

Values

array

パフォーマンスメトリック値の詳細。

string

異なる時間でのパフォーマンス値の詳細。

[ "2021-05-03T15:00:12.72Z", "0.1250" ], [ "2021-05-03T15:00:42.739Z", "0.3125" ]

Name

string

パフォーマンスメトリックの名前 (監視メトリクスの値名)。メトリックの詳細については、「監視メトリクスの概要」を参照してください。

worker_avg_cpu_used

Tags

string

タグ。

instance_name: "amv-8vbf80pjcz*****"

TranslateKey

string

対応するメトリックの英語名。

elastic_executor_avg_cpu_use

AccessDeniedDetail

string

アクセス拒否の詳細。このフィールドは、Resource Access Management (RAM) の権限検証に失敗した場合にのみ返されます。

{ "AuthAction": "xxx", "AuthPrincipalDisplayName": "sampleName", "AuthPrincipalOwnerId": "111111111111111111", "AuthPrincipalType": "SubUser", "AuthResource": "xxx", "NoPermissionType": "xxx", "PolicyType": "xxx" }

例

成功レスポンス

JSONJSON

{
  "EndTime": "2021-05-03T15:01:00Z",
  "RequestId": "25B56BC7-4978-40B3-9E48-4B7067******",
  "StartTime": "2021-05-03T15:00:00Z",
  "DBClusterId": "am-8vbf80pjcz*****",
  "Performances": [
    {
      "Key": "AnalyticDB_CPU",
      "Unit": "%",
      "Series": [
        {
          "Values": [
            "[               \"2021-05-03T15:00:12.72Z\",               \"0.1250\"             ],             [               \"2021-05-03T15:00:42.739Z\",               \"0.3125\"             ]"
          ],
          "Name": "worker_avg_cpu_used",
          "Tags": "instance_name: \"amv-8vbf80pjcz*****\"",
          "TranslateKey": "elastic_executor_avg_cpu_use"
        }
      ]
    }
  ],
  "AccessDeniedDetail": "{\n  \"AuthAction\": \"xxx\",\n  \"AuthPrincipalDisplayName\": \"sampleName\",\n  \"AuthPrincipalOwnerId\": \"111111111111111111\",\n  \"AuthPrincipalType\": \"SubUser\",\n  \"AuthResource\": \"xxx\",\n  \"NoPermissionType\": \"xxx\",\n  \"PolicyType\": \"xxx\"\n}"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

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

変更履歴

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