查询数据集与存储桶的绑定关系

最近更新时间:2024-06-12 17:46:52

我的收藏

功能描述

查询数据集和某个指定对象存储(COS)Bucket 的绑定关系。

授权说明

授权策略中 action 设置为 ci:DescribeDatasetBinding 。查看所有 action

请求

请求示例

GET /datasetbinding?datasetname=test&uri=cos%3A%2F%2Fexample-1250000000 HTTP/1.1
Host: <AppId>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: Auth String
Accept: application/json
说明:
Authorization: Auth String(详情请参见 请求签名 文档)。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求参数

参数名称
描述
类型
是否必选
datasetname
数据集名称,同一个账户下唯一。
String
uri
资源标识字段,表示需要查询与数据集绑定关系的资源,当前仅支持 COS 存储桶,字段规则:cos://<BucketName>,其中 BucketName 表示 COS 存储桶名称,例如(需要进行 urlencode):cos%3A%2F%2Fexample-1250000000
String

请求体

该请求的请求体为空。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

{
"Binding": {
"CreateTime": "2023-12-26 17:28:33.617269703 +0800 CST",
"DatasetName": "test",
"State": "Running",
"URI": "cos://examplebucket2-1250000000",
"UpdateTime": "2023-12-26 17:28:33.617269858 +0800 CST"
},
"RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"
}
响应包体具体数据内容如下:
参数名称
类型
描述
Binding
Container
数据集和 COS Bucket 绑定关系信息。
RequestId
String
请求 ID。
Binding 节点内容:
参数名称
类型
描述
CreateTime
String
数据集和 COS Bucket 绑定关系创建时间的时间戳,格式为 RFC3339Nano。
DatasetName
String
数据集名称。
State
String
数据集和 COS Bucket 绑定关系的状态。取值范围如下:
Running:绑定关系运行中。
URI
String
资源标识字段,表示需要查询与数据集绑定关系的资源,当前仅支持 COS 存储桶,字段规则:cos://<BucketName>,其中 BucketName 表示 COS 存储桶名称,例如:cos://examplebucket-1250000000
UpdateTime
String
数据集和 COS Bucket 的绑定关系修改时间的时间戳,格式为 RFC3339Nano。
创建绑定关系后,如果未暂停或者未重启过绑定关系,则绑定关系修改时间的时间戳和绑定关系创建时间的时间戳相同。