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

Database Autonomy Service:GetAsyncErrorRequestListByCode

最終更新日:Mar 13, 2026

データベースインスタンスの SQL Explorer 結果で MySQL エラーコードを生成する SQL ステートメントの ID を非同期的にクエリします。

操作説明

説明

GetAsyncErrorRequestListByCode は非同期操作です。リクエスト送信後、完全な結果はすぐに返されません。レスポンスで isFinish パラメーターの値が false の場合、1 秒待機してから再度リクエストを送信してください。isFinish パラメーターの値が true の場合、完全な結果が返されます。

  • この API オペレーションは、Database Autonomy Service (DAS) Enterprise Edition が有効になっている ApsaraDB RDS for MySQL インスタンスと PolarDB for MySQL クラスターのみをサポートします。詳細については、「DAS Economy Edition と DAS Enterprise Edition の有効化と管理」をご参照ください。

  • SDK を使用して DAS の API オペレーションを呼び出す場合、リージョン ID を cn-shanghai に設定する必要があります。

  • この操作を呼び出す際、2024 年 9 月 1 日以降、SQL テンプレートアルゴリズムの最適化により SqlId パラメーターの値が変更されます。詳細については、「[通知] 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

hdm:GetAsyncErrorRequestListByCode

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

InstanceId

string

必須

インスタンス ID。

rm-2ze8g2am97624****

NodeId

string

任意

ノード ID。

説明

データベースインスタンスが PolarDB for MySQL クラスターである場合、このパラメーターは指定する必要があります。

pi-wz9s658475e58****

Start

integer

任意

クエリする時間範囲の開始。このパラメーターは、1970 年 1 月 1 日 00:00:00 協定世界時 (UTC) から経過したミリ秒数を表す UNIX タイムスタンプに設定します。

説明

開始時刻は、データベースインスタンスの SQL Explorer 機能の保存期間内である必要があり、現在時刻より最大 90 日前まで遡ることができます。

1642556990714

End

integer

任意

クエリする時間範囲の終了。このパラメーターは、1970 年 1 月 1 日 00:00:00 協定世界時 (UTC) から経過したミリ秒数を表す UNIX タイムスタンプに設定します。

説明

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

1642566830000

ErrorCode

string

任意

エラーコード。インスタンスの SQL Explorer 結果で生成される可能性のある MySQL エラーコードをクエリするには、GetAsyncErrorRequestStatByCode オペレーションを呼び出すことができます。

1064

レスポンスフィールド

フィールド

型

説明

例

object

Code

integer

返された HTTP ステータスコード。

200

Message

string

返されたメッセージ。

説明

リクエストが成功した場合、Successful が返されます。リクエストが失敗した場合、エラーコードなどのエラーメッセージが返されます。

Successful

Data

object

返されたデータ。

{ "fail": false, "data": [ { "sqlId": "ad78a4e7d3ce81590c9dc2d5f4bc****", "instanceId": "rm-2ze8g2am97624****" }, { "sqlId": "0f92feacd92c048b06a16617a633****", "instanceId": "rm-2ze8g2am97624****" } ], "resultId": "async__c39d43ece52d35267cc4b92a0c26****", "isFinish": true, "state": "SUCCESS", "complete": true, "timestamp": 1644559407740 }

fail

boolean

非同期リクエストが失敗したかどうかを示します。有効な値:

  • true

  • false

false

result

array<object>

インスタンス ID。

object

sqlId

string

SQL ID。

ad78a4e7d3ce81590c9dc2d5f4bc****

instanceId

string

インスタンス ID

rm-2ze8g2am97624****

resultId

string

非同期リクエストの ID。

async__c39d43ece52d35267cc4b92a0c26****

isFinish

boolean

非同期リクエストが完了したかどうかを示します。有効な値:

  • true

  • false

true

state

string

非同期リクエストの状態。有効な値:

  • RUNNING

  • SUCCESS

  • FAIL

SUCCESS

complete

boolean

非同期リクエストが完了したかどうかを示します。

  • true

  • false

true

timestamp

integer

非同期リクエストが実行された時刻。この値は、1970 年 1 月 1 日 00:00:00 協定世界時 (UTC) から経過したミリ秒数を表す UNIX タイムスタンプです。

1644559407740

RequestId

string

リクエスト ID。

9CB97BC4-6479-55D0-B9D0-EA925AFE****

Success

boolean

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

  • true

  • false

true

例

成功レスポンス

JSONJSON

{
  "Code": 200,
  "Message": "Successful",
  "Data": {
    "fail": false,
    "result": [
      {
        "sqlId": "ad78a4e7d3ce81590c9dc2d5f4bc****",
        "instanceId": "rm-2ze8g2am97624****"
      }
    ],
    "resultId": "async__c39d43ece52d35267cc4b92a0c26****",
    "isFinish": true,
    "state": "SUCCESS",
    "complete": true,
    "timestamp": 1644559407740
  },
  "RequestId": "9CB97BC4-6479-55D0-B9D0-EA925AFE****",
  "Success": true
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParams The request parameters are invalid.
403 NoPermission You are not authorized to do this action.

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

変更履歴

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