调用GetDataset获取数据集_人工智能平台 PAI-阿里云帮助中心

获取数据集。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v1/datasets/{DatasetId}

请求参数

名称	类型	必填	描述	示例值
DatasetId	string	是	数据集ID。如何获取数据集ID，详情请参见ListDatasets。	d-rbvg5wz****c9ks92

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求ID。	5A14FA81-DD4E-******-6343FE44B941
DatasetId	string	数据集ID。	d-rbvg5wz****c9ks92
Name	string	数据集名称。	myName
Description	string	描述。	用于标注的数据。
GmtCreateTime	string	创建时间。	2021-01-30T12:51:33.028Z
GmtModifiedTime	string	更新时间。	2021-01-30T12:51:33.028Z
UserId	string	数据集所属用户ID。	2485765****023475
OwnerId	string	主账户ID。	1631044****3440
Property	string	数据集属性。可能值： FILE：文件。 DIRECTORY：文件夹。	DIRECTORY
DataSourceType	string	数据源类型。可能值： OSS：阿里云对象存储（OSS）。 NAS：阿里云文件存储（NAS）。	NAS
Uri	string	Uri样例，可能值：数据源类型为OSS：`oss://bucket.endpoint/object`。数据源类型为NAS：通用型NAS格式为：`nas://<nasfisid>.region/subpath/to/dir/`； CPFS1.0：`nas://<cpfs-fsid>.region/subpath/to/dir/`； CPFS2.0：`nas://<cpfs-fsid>.region/<protocolserviceid>/`； CPFS1.0和CPFS2.0根据fsid的格式来区分： CPFS1.0 格式为cpfs-<8位ascii字符>； CPFS2.0 格式为cpfs-<16为ascii字符>。	nas://09f****f2.cn-hangzhou/
Labels	array	标签列表。
	Label	为数据集添加的标签。	{"Key": "env", "Value": "test"}
DataType	string	数据类型，可能值： COMMON：普通。 PIC：图片。 TEXT：文本。 VIDEO：视频。 AUDIO：音频。	COMMON
SourceType	string	数据来源类型，可能值： PAI-PUBLIC-DATASET：PAI公共数据集。 ITAG：iTAG模块标注结果生成的数据集。 USER：用户注册的数据集。枚举值： PAI_PUBLIC_DATASET：PAI_PUBLIC_DATASET。 ITAG：ITAG。 USER：USER。	USER
SourceId	string	数据来源ID，可能值：当SourceType为USER时，SourceId支持自定义。当SourceType为ITAG时，即iTAG模块标注结果生成的数据集时，SourceId为ITAG的任务ID。当SourceType为PAI_PUBLIC_DATASET时，即使用PAI公共数据集创建的数据集时，SourceId默认为空。	jdnhf***fnrimv
WorkspaceId	string	数据集所在工作空间ID。	478**
Options	string	扩展字段，JsonString类型。当DLC使用数据集时，可通过配置mountPath字段指定数据集默认挂载路径。	{ "mountPath": "/mnt/data/" }
Accessibility	string	工作空间可见度。可能值： PRIVATE：表示工作空间内自己以及管理员可见。 PUBLIC：为工作空间所有用户可见。	PRIVATE
ProviderType	string	数据集的数据源来源类型。取值如下： Ecs （默认） Lingjun	Ecs

示例

正常返回示例

JSON格式

{
  "RequestId": "5A14FA81-DD4E-******-6343FE44B941",
  "DatasetId": "d-rbvg5wz****c9ks92",
  "Name": "myName",
  "Description": "用于标注的数据。",
  "GmtCreateTime": "2021-01-30T12:51:33.028Z",
  "GmtModifiedTime": "2021-01-30T12:51:33.028Z",
  "UserId": "2485765****023475",
  "OwnerId": "1631044****3440",
  "Property": "DIRECTORY",
  "DataSourceType": "NAS",
  "Uri": "nas://09f****f2.cn-hangzhou/",
  "Labels": [
    {
      "Key": "env",
      "Value": "test"
    }
  ],
  "DataType": "COMMON",
  "SourceType": "USER",
  "SourceId": "jdnhf***fnrimv",
  "WorkspaceId": "478**",
  "Options": "{\n  \"mountPath\": \"/mnt/data/\"\n}",
  "Accessibility": "PRIVATE",
  "ProviderType": "Ecs"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2023-04-26

OpenAPI 返回结构发生变更

看变更集

变更项	变更内容
出参	OpenAPI 返回结构发生变更