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

AnalyticDB:DescribeApsActionLogs

最終更新日:Mar 17, 2026

AnalyticDB for MySQL クラスターのリアルタイムデータインジェストジョブのログをクエリします。

操作説明

  • 汎用エンドポイント:adb.aliyuncs.com

  • リージョンパブリックエンドポイント:adb.<region-id>.aliyuncs.com。例:adb.cn-hangzhou.aliyuncs.com

  • リージョン Virtual Private Cloud (VPC) エンドポイント:adb-vpc.<region-id>.aliyuncs.com。例:adb-vpc.cn-hangzhou.aliyuncs.com

今すぐお試しください

この 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:DescribeApsActionLogs

none

*DBClusterLakeVersion

acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

DBClusterId

string

必須

AnalyticDB for MySQL Data Lakehouse Edition クラスターの ID です。

説明

リージョン内の AnalyticDB for MySQL クラスターの ID は、DescribeDBClusters 操作を呼び出してクエリできます。

amv-bp1r053byu48p****

RegionId

string

必須

クラスターのリージョン ID です。

説明

最新のリージョンリストは、DescribeRegions 操作を呼び出してクエリできます。

cn-hangzhou

StartTime

string

必須

クエリ対象ログの開始時刻です。ISO 8601 標準に従い、yyyy-MM-ddTHH:mmZ 形式で指定します。時刻は協定世界時 (UTC) である必要があります。

2023-02-11T08:30Z

EndTime

string

必須

クエリ対象ログの終了時刻です。ISO 8601 標準に従い、yyyy-MM-ddTHH:mmZ 形式で指定します。時刻は協定世界時 (UTC) である必要があります。

説明

終了時刻は開始時刻より後である必要があります。指定可能な最大期間は 30 日間です。

2023-02-11T09:30Z

WorkloadId

string

必須

リアルタイムデータインジェストジョブの ID です。

aps-hz109vpvt4fg8528d****

Keyword

string

任意

クエリ時にあいまい一致に使用するキーワードです。

table_test

Stage

string

任意

クエリ対象ログが生成されたフェーズです。有効な値は以下のとおりです。

  • StructureMigrate:スキーマ移行

  • FullDataSync:フルデータ同期

  • IncrementalSync:増分同期

説明

このパラメーターを指定しない場合、すべてのフェーズのログがクエリされます。

FullDataSync

State

string

任意

ログタイプです。複数のログタイプをカンマ (,) で区切って指定できます。有効な値は以下のとおりです。

  • INFO

  • WARN

  • ERROR

説明

このパラメーターを指定しない場合、すべてのタイプのログがクエリされます。

INFO,WARN,ERROR

PageSize

integer

任意

1 ページあたりのエントリ数です。有効な値は以下のとおりです。

  • 30(デフォルト)

  • 50

  • 100

30

PageNumber

integer

任意

ページ番号です。ページ番号は 1 から始まります。デフォルト値は 1 です。

1

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID です。

A5EDBA27-AF3E-5966-9503-FD1557E19167

DBClusterId

string

AnalyticDB for MySQL Data Lakehouse Edition (V3.0) クラスターの ID です。

amv-bp1r053byu48p****

WorkloadId

string

リアルタイムデータインジェストジョブの ID です。

aps-hz109vpvt4fg8528d****

TotalCount

string

返されたエントリの総数です。

3

PageSize

string

1 ページあたりのエントリ数です。

30

PageNumber

string

ページ番号です。

1

ActionLogs

array<object>

クエリされたログです。

object

Time

string

ログが生成された時刻です。ISO 8601 標準に従い、yyyy-MM-ddTHH:mm:ssZ 形式で表示されます。時刻は協定世界時 (UTC) です。

2023-02-01T05:46:30Z

Stage

string

ログが生成されたフェーズです。有効な値は以下のとおりです。

  • StructureMigrate:スキーマ移行

  • FullDataSync:フルデータ同期

  • IncrementalSync:増分同期

FullDataSync

State

string

ログタイプです。複数のログタイプはカンマ (,) で区切られます。有効な値は以下のとおりです。

  • INFO

  • WARN

  • ERROR

INFO,WARN,ERROR

Context

string

ログの内容です。

DDL migration job finished

AccessDeniedDetail

string

リクエスト拒否に関する情報です。

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

成功レスポンス

JSONJSON

{
  "RequestId": "A5EDBA27-AF3E-5966-9503-FD1557E19167",
  "DBClusterId": "amv-bp1r053byu48p****",
  "WorkloadId": "aps-hz109vpvt4fg8528d****",
  "TotalCount": "3",
  "PageSize": "30",
  "PageNumber": "1",
  "ActionLogs": [
    {
      "Time": "2023-02-01T05:46:30Z",
      "Stage": "FullDataSync",
      "State": "INFO,WARN,ERROR",
      "Context": "DDL migration job finished"
    }
  ],
  "AccessDeniedDetail": "{\n  \"AuthAction\": \"xxx\",\n  \"AuthPrincipalDisplayName\": \"sampleName\",\n  \"AuthPrincipalOwnerId\": \"111111111111111111\",\n  \"AuthPrincipalType\": \"SubUser\",\n  \"AuthResource\": \"xxx\",\n  \"NoPermissionType\": \"xxx\",\n  \"PolicyType\": \"xxx\"\n}"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. The DBClusterId provided does not exist in our records.

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

変更履歴

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