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

Data Security Center:DescribeDataMaskingRunHistory

最終更新日:Jul 07, 2026

データマスキングタスクの実行履歴を照会します。

操作説明

この操作は、静的データマスキングタスクの実行ステータスを取得するために使用され、タスクステータスの検索やタスク進捗のビューが可能です。

QPS 制限

この操作の単一ユーザー QPS 制限は、1 秒あたり 10 回の呼び出しです。制限を超えると API 呼び出しがスロットリングされ、ビジネスに影響が出る可能性があります。この操作は適切に呼び出してください。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-sddp:DescribeDataMaskingRunHistory

get

*すべてのリソース。

*

  • acs:ResourceGroupId
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Lang

string

任意

リクエストおよび応答の言語。デフォルト値: zh_cn。有効な値:

  • zh_cn: 中国語。

  • en_us: 英語。

zh_cn

TaskId

string

任意

データマスキングタスクの ID。

mt4HBgtw1B******

StartTime

integer

任意

クエリするタスク実行の開始時刻。値はミリ秒単位のタイムスタンプです。

1582992000000

EndTime

integer

任意

クエリするタスク実行の終了時刻。値はミリ秒単位のタイムスタンプです。

1583856000000

Status

integer

任意

タスク実行ステータス。有効な値:

  • -1: 実行待ち。

  • 0: 実行中。

  • 1: 実行成功。

  • 2: 失敗した。

  • 3: ユーザーによる終了。

  • 4: 一部失敗。

0

SrcType

integer

任意

マスキング対象データが属するソースプロダクトのタイプ。有効な値: 1: MaxCompute、2: OSS、3: ADS、4: OTS、5: RDS など。

2

DstType

integer

任意

マスキング済みデータが保存される送信先プロダクトのタイプ。有効な値: 1: MaxCompute、2: OSS、3: ADS、4: OTS、5: RDS など。

2

PageSize

integer

任意

ページあたりの最大値。

10

CurrentPage

integer

任意

ページングクエリのページ番号。

1

MainProcessId

integer

任意

メインタスクの ID。

説明

タスクにサブタスクが含まれる場合、このパラメーターは現在のタスク ID に設定されます。それ以外の場合、このパラメーターは空です。

366731

SrcTableName

string

任意

ソーステーブルの名前。

add

レスポンスフィールド

フィールド

説明

object

CurrentPage

integer

結果における現在のページのページ番号。

1

RequestId

string

リクエスト ID。

769FB3C1-F4C9-4******

PageSize

integer

結果におけるページサイズ。

10

TotalCount

integer

結果のエントリの総数。

100

Items

array<object>

データマスキングタスク情報のリスト。

object

クエリ結果の詳細。

Status

integer

タスク実行ステータス。有効な値:

  • -1: 実行待ち。

  • 0: 実行中。

  • 1: 実行成功。

  • 2: 失敗した。

  • 3: ユーザーによる終了。

  • 4: 一部失敗。

1

Type

integer

実行モード。有効な値:

  • 1: 手動。

  • 2: スケジュール。

1

SrcType

integer

マスキング対象データが属するソースプロダクトのタイプ。有効な値: 1: MaxCompute、2: OSS、3: ADS、4: OTS、5: RDS など。

2

SrcTableName

string

ソーステーブルの名前。

add

MaskingCount

integer

マスキングされた行数。

100

Percentage

integer

実行進捗。

100

DstType

integer

マスキング済みデータが保存される送信先プロダクトのタイプ。有効な値: 1: MaxCompute、2: OSS、3: ADS、4: OTS、5: RDS など。

2

FailMsg

string

タスク実行失敗の理由。

error

FailCode

string

タスク実行失敗のエラーコード。このパラメーターは、タスク実行が失敗した場合にのみ値を持ちます。

masking_task_not_found

ConflictCount

integer

データ競合行数。これは、送信先テーブルに挿入されるマスキング済みデータと送信先テーブルの既存データが競合する行数を示します。

0

DstTypeCode

string

送信先プロダクトのタイプ。有効な値: MaxCompute、OSS、ADS、OTS、RDS など。

OSS

EndTime

integer

実行の終了時刻。

1582251233000

RunIndex

integer

タスク実行のシーケンス番号。

1

StartTime

integer

実行時刻。値はミリ秒単位のタイムスタンプです。

1582251233000

HasSubProcess

integer

作成されたサブタスクの数。

4

HasDownloadFile

integer

ダウンロードファイルが存在するかどうかを示します。有効な値:

  • 1: はい。

  • 0: いいえ。

1

TaskId

string

タスク ID。

mt4HBgtw1B******

SrcTypeCode

string

ソースプロダクトのタイプ。有効な値: MaxCompute、OSS、ADS、OTS、RDS など。

OSS

Id

integer

実行 Record の ID。

1

成功レスポンス

JSONJSON

{
  "CurrentPage": 1,
  "RequestId": "769FB3C1-F4C9-4******",
  "PageSize": 10,
  "TotalCount": 100,
  "Items": [
    {
      "Status": 1,
      "Type": 1,
      "SrcType": 2,
      "SrcTableName": "add",
      "MaskingCount": 100,
      "Percentage": 100,
      "DstType": 2,
      "FailMsg": "error",
      "FailCode": "masking_task_not_found",
      "ConflictCount": 0,
      "DstTypeCode": "OSS",
      "EndTime": 1582251233000,
      "RunIndex": 1,
      "StartTime": 1582251233000,
      "HasSubProcess": 4,
      "HasDownloadFile": 1,
      "TaskId": "mt4HBgtw1B******",
      "SrcTypeCode": "OSS",
      "Id": 1
    }
  ]
}

エラーコード

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

変更履歴

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