查询数据集详情
接口功能介绍
查看数据源信息。
接口约束
无
URI
GET /v4/cwai/dataset/{datasetID}
路径参数
参数 | 是否必填 | 参数类型 | 说明 | 示例值 |
---|---|---|---|---|
datasetID | 是 | String | 数据源唯一ID | 81f7-xxxx-7d5b |
regionID | 是 | String | 区域的唯一ID | xxx-xxx-yyyzzz |
请求参数
无
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例值 | 下级对象 |
---|---|---|---|---|---|
statusCode | 是 | Integer | 请求成功(800)或者失败(900) | 800 | |
errorCode | 否 | String | 错误代码 | Cwai.Api.xxxx | |
message | 否 | String | 错误信息的英文描述 | datasetID is not found | |
returnObj | 否 | Object | 返回资源组信息 | {} | returnObj |
表returnObj
参数 | 是否必填 | 参数类型 | 说明 | 示例值 | 下级对象 |
---|---|---|---|---|---|
name | 是 | String | 数据集名称 | dataset-demo | |
id | 是 | String | 数据集唯一ID | 81f77286-xxx-155d307b | |
resourceGroupID | 是 | String | 数据集资源组唯一ID | d0dc8ddc-xxx-ac110003 | |
regionID | 是 | String | 资源组所属的region的唯一ID | xxx-xxx-yyyzzz | |
dataType | 是 | String | 数据来源的类型 | ZOS,HPFS | |
isAccelerate | 是 | Boolean | 是否进行数据加速 | true | |
status | 是 | String | 数据集状态 | Bound | |
runtimeType | 是 | String | 存储数据进行本地加速的后端实现类型 | Alluxio | |
replicas | 是 | Integer | 将对象存储的数据进行本地加速的分片副本数 | 2 | |
mediumTypes | 是 | Object | 将对象存储的数据进行本地加速的本地缓存设置 | mediumTypes | |
zosEndpoint | 是 | String | 具体ZOS对象存储的远程连接地址 | ||
zosBucket | 是 | String | 包含训练数据的对象存储桶名称 | testBucket | |
Directory | 是 | String | 在对象存储桶下级包含训练数据的具体文件名称 | testData1 | |
sfsUUID | 是 | String | 弹性文件的唯一标识 | xxx-yyy-zzz-kkwowo | |
hpfsID | 是 | String | 弹性文件底层数据的唯一标识 | hpfs-yyy-zzz-wowo | |
sfsSize | 是 | String | 弹性文件的大小 | 500G | |
hpfsSharePath | 是 | String | 远程存储数据集的路径 | /var/tmp/xxxx | |
CreateTime | 是 | String | 数据集创建时间 | 2023-01-02 15:04:05 |
表mediumTypes
参数 | 是否必填 | 参数类型 | 说明 | 示例值 | 下级对象 |
---|---|---|---|---|---|
mediumType | 是 | String | 对象存储的数据进行本地加速的本地缓存类型,只能为’MEM‘,’SSD' 或者 ‘HDD' | MEM | |
path | 是 | String | 数据集进行本地缓存加速的路径 | /var/tmp/xxx | |
quota | 是 | String | 数据集进行本地缓存加速在每个节点上的存储上限 | 10G |
请求示例
GET https://cwai-global.ctapi.ctyun.cn/v4/cwai/dataset/d0dc8ddc-xxx-ac110003
Content-Type:application/json
regionID:81f7728662dd11ec810800155d307d5b
响应示例
正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 800,
"errorCode": "",
"returnObj": {
"name": "test-dataset-03",
"id": "xxxx",
"resourceGroupID": "bde64614-3a45-11ee-968e-525400c96778",
"regionID": "81f7728662dd11ec810800155d307d5b",
"dataType": "ZOS",
"isAccelerate": true,
"status":"Bound",
"runtimeType": "Alluxio",
"replicas": 2,
"mediumTypes": [
{
"mediumType": "MEM",
"path": "/dev/shm",
"quota": "1Gi"
}
],
"zosEndpoint": "http://100.127.xxx.1",
"zosBucket": "bucket-nm8-fluid",
"directory": "test1",
"sfsUUID":"",
"hpfsID":"",
"sfsSize":"",
"hpfsSharePath":"",
"createTime": "2023-01-02 15:04:05",
}
}
错误参数返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 900,
"errorCode": "Cwai.Api.BadRequest",
"message": "***",
}
内部服务错误返回示例
TTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 900,
"errorCode": "Cwai.Api.InternalServerError",
"message": "***",
}
状态码
状态码 | 描述 |
---|---|
200 | 表示请求成功 |
错误码
错误码 | 描述 |
---|---|
Cwai.Api.BadRequest | 错误请求 |
Cwai.Api.NotFound | 资源不存在 |
Cwai.Api.StatusUnauthorized | 状态未授权 |
Cwai.Api.InternalServerError | 内部错误 |