GetDatasetVersion - 获取数据集版本_人工智能平台 PAI(PAI)-阿里云帮助中心

获取指定版本的数据集信息。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

paidataset:GetDatasetVersion

get

*全部资源

*

无

请求语法

GET /api/v1/datasets/{DatasetId}/versions/{VersionName} HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
DatasetId	string	是	数据集 ID。如何获取数据集 ID，详情请参见 ListDatasets 。	d-lfd60v0p****ujtsdx
VersionName	string	是	软件版本名称。	v1

返回参数

名称	类型	描述	示例值
	object	返回体。
RequestId	string	Id of the request	C55DF3DA-F120-5E37-A374-F49365531701
DatasetId	string	资源一级 ID	d-dkdbnnap0g7b6su4yg
VersionName	string	数据集版本	v1
Property	string	数据集的属性。	DIRECTORY
GmtCreateTime	string	创建时间。	2023-12-13T10:22:05.694Z
GmtModifiedTime	string	最后修改时间。	2023-12-13T10:22:05.694Z
DataSourceType	string	数据源类型。	OSS
Uri	string	Uri 配置样例	oss://ai4d-br7hx9ngzelo2o6uip.oss-cn-shanghai.aliyuncs.com/365349/data-1157703270994901/datasets/aka108o/
Labels	array	资源标签
	Label	标签。
Options	string	扩展字段。	{ "mountPath": "/mnt/data/" }
SourceType	string	数据来源类型枚举值： PAI_PUBLIC_DATASET : PAI_PUBLIC_DATASET ITAG : ITAG USER : USER	USER
Description	string	版本描述	This is a description of the dataset version.
SourceId	string	数据集来源 ID。	d-rbvg5wzljzjhc9ks92
DataCount	integer	数据量	10000
DataSize	integer	数据集大小。	10000
MountAccess	string	该数据集被挂载时的权限。 RO：只读挂载 RW：读写挂载	RO
ImportInfo	string	数据集的存储导入配置信息，支持 OSS/NAS/CPFS 等。 OSS { "region": "${region}",//地域 ID "bucket": "${bucket}",//bucket 名称 "path": "${path}" //文件路径 } NAS CPFS 区块内容智算 CPFS 区块内容	{ "region": "cn-wulanchabu", "fileSystemId": "bmcpfs-xxxxxxxxxxx", "path": "/mnt", "mountTarget": "cpfs-xxxxxxxxxxxx-vpc-gacs9f.cn-wulanchabu.cpfs.aliyuncs.com", "isVpcMount": true }

示例

正常返回示例

JSON格式

{
  "RequestId": "C55DF3DA-F120-5E37-A374-F49365531701",
  "DatasetId": "d-dkdbnnap0g7b6su4yg",
  "VersionName": "v1",
  "Property": "DIRECTORY",
  "GmtCreateTime": "2023-12-13T10:22:05.694Z",
  "GmtModifiedTime": "2023-12-13T10:22:05.694Z",
  "DataSourceType": "OSS",
  "Uri": "oss://ai4d-br7hx9ngzelo2o6uip.oss-cn-shanghai.aliyuncs.com/365349/data-1157703270994901/datasets/aka108o/",
  "Labels": [
    {
      "Key": "env",
      "Value": "test"
    }
  ],
  "Options": "{\n  \"mountPath\": \"/mnt/data/\"\n}",
  "SourceType": "USER",
  "Description": "This is a description of the dataset version.",
  "SourceId": "d-rbvg5wzljzjhc9ks92",
  "DataCount": 10000,
  "DataSize": 10000,
  "MountAccess": "RO",
  "ImportInfo": "{\n    \"region\": \"cn-wulanchabu\",\n    \"fileSystemId\": \"bmcpfs-xxxxxxxxxxx\",\n    \"path\": \"/mnt\",\n    \"mountTarget\": \"cpfs-xxxxxxxxxxxx-vpc-gacs9f.cn-wulanchabu.cpfs.aliyuncs.com\",\n    \"isVpcMount\": true\n}"
}

错误码

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

变更历史

更多信息，参考变更详情。