查询绑定关系列表

最近更新时间:2024-05-15 12:21:12

我的收藏

功能描述

查询数据集和对象存储(COS)Bucket 绑定关系列表。

授权说明

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

请求

请求示例

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

请求头

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

请求参数

具体参数如下:
参数名称
描述
类型
是否必选
datasetname
数据集名称,同一个账户下唯一。
String
maxresults
返回绑定关系的最大个数,取值范围为0~200。不设置此参数或者设置为0时,则默认值为100。
Integer
nexttoken
当绑定关系总数大于设置的 MaxResults 时,用于翻页的 token。从 NextToken 开始按字典序返回绑定关系信息列表。第一次调用此接口时,设置为空。
String

请求体

该请求无请求体。

响应

响应头

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

响应体

{
"Bindings": [{
"CreateTime": "2023-12-25 19:18:19.809729971 +0800 CST",
"DatasetName": "test",
"State": "Running",
"URI": "cos://examplebucket1-1250000000",
"UpdateTime": "2023-12-25 19:18:19.809730114 +0800 CST"
}, {
"CreateTime": "2023-12-25 19:18:19.809729971 +0800 CST",
"DatasetName": "test",
"State": "Running",
"URI": "cos://examplebucket2-1250000000",
"UpdateTime": "2023-12-25 19:18:19.809730114 +0800 CST"
}],
"NextToken": "2:1250000000:test",
"RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"
}
响应包体具体数据内容如下:
参数名称
类型
描述
Bindings
Container Array
数据集和 COS Bucket 绑定关系信息的列表。
NextToken
String
当绑定关系总数大于设置的 MaxResults 时,用于翻页的 token。下一次列出绑定关系信息时以此值为 NextToken,将未返回的结果返回。当绑定关系未全部返回时,此参数才有值。
RequestId
String
请求 ID。
Bindings 节点内容:
参数名称
类型
描述
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。
创建绑定关系后,如果未暂停或者未重启过绑定关系,则绑定关系修改时间的时间戳和绑定关系创建时间的时间戳相同。