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

DataWorks:ListDatasets

最終更新日:Sep 03, 2026

データセットの一覧を照会します。現在、DataWorks データセットおよび PAI データセットがサポートされています。

今すぐお試しください

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

list

*All Resource

*

なし なし

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

ProjectId

integer

任意

DataWorks ワークスペースの ID。

251363

Origin

string

任意

データセットのソース。有効な値は以下のとおりです。

  • DataWorks

  • PAI

DataWorks

Name

string

任意

データセット名。あいまい検索をサポートします。

test_dataset

DataTypeList

array

任意

データの型。複数選択可能。有効な値は以下のとおりです。

  • COMMON

  • PIC

  • TEXT

  • TABLE

  • VIDEO

  • AUDIO

  • INDEX

string

任意

データの型

有効な値は以下のとおりです。

  • TABLE: テーブル

  • VIDEO: 動画

  • COMMON: 一般

  • TEXT: テキスト

  • PIC: 画像

  • INDEX: インデックス

  • AUDIO: 音声

列挙値:

  • TABLE :
  • VIDEO :
  • COMMON :
  • TEXT :
  • PIC :
  • INDEX :
  • AUDIO :

COMMON

StorageTypeList

array

任意

ストレージタイプ。複数選択可能。サポートされる値は以下のとおりです。

  • OSS

  • NAS: 汎用型 NAS ファイルシステム

  • EXTREMENAS: 超高速型 NAS ファイルシステム

  • DLF_LANCE: Data Lake Formation

  • CPFS: クラウド並列ファイルストレージ

  • BMCPFS: CPFS for Lingjun

  • MAXCOMPUTE: MaxCompute テーブル

列挙値:

  • NAS :
  • MAXCOMPUTE :
  • CPFS :
  • BMCPFS :
  • EXTREMENAS :
  • OSS :
  • DLF_LANCE :

string

任意

ストレージタイプ。

NAS

CreatorId

string

任意

作成者 ID。

12103XXX46492139

SortBy

string

任意

ソート対象フィールド。デフォルト値:CreateTime。

有効な値は以下のとおりです。

  • ModifyTime: 更新日時

  • CreateTime: 作成日時

  • Name: 名前

列挙値:

  • ModifyTime :
  • CreateTime :
  • Name :

CreateTime

Order

string

任意

ソート順。デフォルト値:Desc。

有効な値は以下のとおりです。

  • Asc: 昇順

  • Desc: 降順

列挙値:

  • Asc :
  • Desc :

Asc

PageNumber

integer

任意

ページ番号。デフォルト値:1。

1

PageSize

integer

任意

1 ページあたりの表示件数。デフォルト値:10。最大値:100。

10

レスポンスフィールド

フィールド

型

説明

例

object

応答のスキーマ

RequestId

string

リクエスト ID

6A6CBE87-9F91-1323-B680-E7A7065XXXXX

Success

boolean

リクエストが成功したかどうかを示します。

true

PagingInfo

object

ページネーション情報

TotalCount

integer

返された合計件数

100

PageNumber

integer

ページ番号

1

PageSize

integer

このページに表示される件数

10

Datasets

array

データセット一覧

Dataset

データセットオブジェクト

例

成功レスポンス

JSONJSON

{
  "RequestId": "6A6CBE87-9F91-1323-B680-E7A7065XXXXX\n",
  "Success": true,
  "PagingInfo": {
    "TotalCount": 100,
    "PageNumber": 1,
    "PageSize": 10,
    "Datasets": [
      {
        "Id": "",
        "Name": "",
        "Comment": "",
        "ProjectId": 0,
        "Origin": "",
        "DataType": "",
        "StorageType": "",
        "CreatorId": "",
        "Readme": "",
        "LatestVersion": {
          "Id": "dataworks-datasetVersion:0gfxxxjx155usz3hrv:1",
          "DatasetId": "dataworks-datasetVersion:0gfxxxjx155usz3hrv",
          "Comment": "初始版本",
          "CreatorId": "17815XXX61016173",
          "VersionNumber": 1,
          "StorageType": "OSS",
          "Url": "oss://test-oss-bucket/test_dir/",
          "MountPath": "/mnt/data",
          "CreateTime": 1736756055000,
          "ModifyTime": 1736756055000,
          "Labels": [
            {
              "Key": "key1",
              "Value": "value1"
            }
          ],
          "ImportInfo": {
            "key": "None"
          }
        },
        "CreateTime": 0,
        "ModifyTime": 0,
        "Labels": [
          {
            "Key": "key1",
            "Value": "value1"
          }
        ]
      }
    ]
  }
}

エラーコード

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

変更履歴

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