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

DataWorks:ListDataAssets

最終更新日:Sep 03, 2026

タグに関連付けられた DataWorks データ資産をページ単位で照会します。

操作説明

この特徴を使用するには、DataWorks Enterprise Edition 以上のエディションを購入する必要があります。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

dataworks:*

list

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

Tags

array<object>

任意

データ資産に関連付けられたタグのリスト。タグはクエリのフィルターとして使用されます。

  • 複数の値は OR 関係になります。たとえば、["key1:v1", "key2:v1", "key3:v1"] は、指定されたタグのいずれかを含むデータ資産を照会します。

  • このパラメーターが指定されていないか空の場合、タグに基づくフィルタリングは適用されません。

object

任意

タグキーと値の構造解像度。

Key

string

任意

ユーザーが指定したカスタムタグキー。

タグキーの長さは最大 64 文字で、dw: で始まることはできず、英数字および次の特殊文字のみをサポートします: -@#*<>|[]()+=&%$!~。

key

Value

string

任意

タグ値。

値

DataAssetIds

array

任意

一意のデータ資産 ID のリスト。

string

任意

データ資産の一意の ID。

7000069357000

DataAssetType

string

任意

データ資産のアセットタイプ。有効な値:

  • ACS::DataWorks::Table: データテーブル。

  • ACS::DataWorks::Task: スケジューリングノード。

ACS::DataWorks::Task

ProjectId

integer

任意

ワークスペースの ID。

10000

PageNumber

integer

任意

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

1

PageSize

integer

任意

1 ページあたりのエントリ数。デフォルト値: 10。最大値: 100。

10

EnvType

string

任意

データ資産が属するワークスペース環境。有効な値:

  • Dev: 開発環境。

  • Prod: 本番環境。

Prod

AssetDomainId

integer

任意

アセットドメインの ID。

1001

CategoryUuid

string

任意

アセットカテゴリの ID。

cate-xxxxxxxx

Name

string

任意

アセットの名前。名前によるあいまい検索がサポートされています。

AssetDomainName

レスポンスフィールド

フィールド

型

説明

例

object

レスポンススキーマ。

RequestId

string

リクエストの ID。

0bc1ec92159376

PagingInfo

object

ページネーション情報。

TotalCount

integer

エントリの総数。

100

PageNumber

integer

ページ番号。

1

PageSize

integer

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

10

DataAssets

array<object>

データ資産のリスト。

array<object>

データ資産のスキーマ解像度。

Id

string

データ資産の ID。

7259557313

Name

string

データ資産の名前。

ali_cn_es_gfn

Type

string

データ資産のアセットタイプ。有効な値:

  • ACS::DataWorks::Table: テーブル。

  • ACS::DataWorks::Task: スケジューリングノード。

ACS::DataWorks::Task

EnvType

string

データ資産が属するワークスペース環境。有効な値:

  • Dev: 開発環境。

  • Prod: 本番環境。

Prod

ProjectId

integer

DataWorks ワークスペースの ID。

54275

DataAssetTagMappings

array<object>

データ資産に関連付けられたタグのリスト。

object

データ資産とタグのマッピングのスキーマ解像度。

Key

string

タグキー。

key

Value

string

タグ値。

value

TagSource

string

データ資産とタグのマッピングのソース。有効な値:

  • System: マッピングはデータ資産ガバナンスシステムによって作成されます。

  • UserDefined: マッピングはユーザーによって手動で作成されます。

UserDefined

Creator

string

データ資産とタグのマッピングの作成者。

12345

AutoTraceEnabled

boolean

自動リネージ追跡が有効かどうかを示します。

false

DataAssetId

string

データ資産の ID。

7259557313

AssetCategories

array<object>

object

Id

string

cate-xxxxxx

Name

string

资产域名称

AssetDomainId

string

1001

例

成功レスポンス

JSONJSON

{
  "RequestId": "0bc1ec92159376",
  "PagingInfo": {
    "TotalCount": 100,
    "PageNumber": 1,
    "PageSize": 10,
    "DataAssets": [
      {
        "Id": "7259557313",
        "Name": "ali_cn_es_gfn",
        "Type": "ACS::DataWorks::Task",
        "EnvType": "Prod",
        "ProjectId": 54275,
        "DataAssetTagMappings": [
          {
            "Key": "key",
            "Value": "value",
            "TagSource": "UserDefined",
            "Creator": "12345",
            "AutoTraceEnabled": false,
            "DataAssetId": "7259557313"
          }
        ],
        "AssetCategories": [
          {
            "Id": "cate-xxxxxx",
            "Name": "资产域名称",
            "AssetDomainId": "1001"
          }
        ]
      }
    ]
  }
}

エラーコード

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

変更履歴

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