对象存储查询绑定关系列表-API 文档-文档中心-腾讯云

功能描述
查询数据集和对象存储（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。
创建绑定关系后，如果未暂停或者未重启过绑定关系，则绑定关系修改时间的时间戳和绑定关系创建时间的时间戳相同。
﻿

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

查询绑定关系列表

本页目录：

功能描述

授权说明

请求

请求示例

请求头

请求参数

请求体

响应

响应头

响应体