查询已绑定数据万象的存储桶列表-数据万象-文档中心-腾讯云

功能描述
用于查询当前账号下已绑定数据万象服务的存储桶列表。
请求
请求示例
GET /cibuckets?pageNumber=1&pageSize=20 HTTP/1.1
Host: ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Type: application/xml
﻿
说明：
Authorization: Auth String（详情请参见 请求签名 文档）。
Host: 查询全部存储桶列表的域名为 ci.<Region>.myqcloud.com，其中 <Region> 填任意一个 CI 地域即可，详情请参见 地域与域名。
通过子账号使用时，需要授予 [ci: DescribeCIBuckets] 权限，详情请参见 授权粒度详情 文档。
请求头
此接口（DescribeCIBuckets）仅使用公共请求头部，详情请参见 公共请求头部 文档。
请求体
该请求的请求体为空。
请求参数
名称
描述
类型
是否必选
bucketName
存储桶名称前缀，前缀搜索
String
否
tagKey
标签搜索，仅支持搜索单个标签，标签键和标签值之间用分号(;) 分隔，例如：tagKey;tagVal
String
否
pageNumber
第几页，默认值1
String
否
pageSize
每页个数，默认值10
String
否
当存储桶标签授权情况与 DescribeCIBuckets 授权不同时，DescribeCIBuckets 请求的鉴权和返回情况如下。关于标签鉴权的授权方法 ，可参见 授权子账号按照存储桶标签拉取存储桶列表。
存储桶标签授权情况
DescribeCIBuckets 授权情况
DescribeCIBuckets 请求
请求返回
主账号通过存储桶标签授权，授权了子账号存储桶标签 tagA 的资源操作权限。
授权 DescribeCIBuckets 权限，资源选择 bucketA 和 bucketB
携带存储桶标签参数 tagA
设置了存储桶标签 tagA 的存储桶列表
﻿
﻿
不携带标签参数
bucketA、bucketB 以及设置了存储桶标签 tagA 的存储桶列表
﻿
不授权DescribeCIBuckets 权限
携带存储桶标签参数 tagA
设置了存储桶标签 tagA 的存储桶列表
﻿
﻿
不携带标签参数
设置了存储桶标签 tagA 的存储桶列表
主账号没有通过存储桶标签授权，没有授权子账号存储桶标签 tagA 的资源操作权限。
授权 DescribeCIBuckets 权限，资源选择 bucketA 和 bucketB
携带存储桶标签参数 tagA
Access Denied
﻿
﻿
不携带标签参数
bucketA 和 bucketB
﻿
不授权DescribeCIBuckets 权限
携带存储桶标签参数 tagA
Access Denied
﻿
﻿
不携带标签参数
Access Denied
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
<Response>
    <RequestId>NjQwNmZiMGFfMmI1NzMyMWVfMTRlOWM3XXXX</RequestId>
    <TotalCount>5</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <CIBucketList>
        <BucketId>test-cd1-1234567890</BucketId>
        <BucketName>test-cd1</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677576084</CreateTime>
        <Region>ap-chengdu</Region>
        <Status>1</Status>
    </CIBucketList>
    <CIBucketList>
        <BucketId>test-cq-1234567890</BucketId>
        <BucketName>test-cq</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677655284</CreateTime>
        <Region>ap-chongqing</Region>
        <Status>1</Status>
    </CIBucketList>
    <CIBucketList>
        <BucketId>test-cq1-1234567890</BucketId>
        <BucketName>test-cq1</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677658884</CreateTime>
        <Region>ap-chongqing</Region>
        <Status>1</Status>
    </CIBucketList>
    <CIBucketList>
        <BucketId>test-cq2-1234567890</BucketId>
        <BucketName>test-cq2</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677662484</CreateTime>
        <Region>ap-chongqing</Region>
        <Status>1</Status>
    </CIBucketList>
    <CIBucketList>
        <BucketId>test-1234567890</BucketId>
        <BucketName>test</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677666084</CreateTime>
        <Region>ap-chongqing</Region>
        <Status>1</Status>
    </CIBucketList>
    <IsAll>false</IsAll>
</Response>
具体的数据内容如下：
节点名称（关键字）
父节点
描述
类型
Response
无
保存结果的容器
Container
Container 节点 Response 的内容：
节点名称（关键字）
父节点
描述
类型
RequestId
Response
请求的唯一 ID
String
TotalCount
Response
开通了数据万象的存储桶总数
Int
PageNumber
Response
当前页数，同请求中的 pageNumber
Int
PageSize
Response
每页个数，同请求中的 pageSize
Int
IsAll
Response
是否展示了所有资源
bool
CIBucketList
Response
开通了数据万象的存储桶列表
Container 数组
Container 节点 CIBucketList 的内容：
节点名称（关键字）
父节点
描述
类型
BucketId
Response.CIBucketList
存储桶 ID
String
BucketName
Response.CIBucketList
存储桶名称
String
AppId
Response.CIBucketList
账号 AppID
String
CreateTime
Response.CIBucketList
存储桶开通的时间戳
Int
Region
Response.CIBucketList
存储桶所在的地域
String
Status
Response.CIBucketList
存储桶当前状态
0：cos 侧 bucket 已删除
1： 正常
3： 解绑中
Int
错误码
该请求无特有错误信息，常见的错误信息请参见 错误码 文档。
实际案例
请求
GET /cibuckets HTTP/1.1
Host: ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Type: application/xml
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 100
Connection: keep-alive
Date: Thu, 09 Mar 2023 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NjQwNmZiMGFfMmI1NzMyMWVfMTRlOWM3XXXX
﻿
<Response>
    <RequestId>NjQwNmZiMGFfMmI1NzMyMWVfMTRlOWM3XXXX</RequestId>
    <TotalCount>5</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <CIBucketList>
        <BucketId>test-cd1-1234567890</BucketId>
        <BucketName>test-cd1</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677576084</CreateTime>
        <Region>ap-chengdu</Region>
        <Status>1</Status>
    </CIBucketList>
    <CIBucketList>
        <BucketId>test-cq-1234567890</BucketId>
        <BucketName>test-cq</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677655284</CreateTime>
        <Region>ap-chongqing</Region>
        <Status>1</Status>
    </CIBucketList>
    <CIBucketList>
        <BucketId>test-cq1-1234567890</BucketId>
        <BucketName>test-cq1</BucketName>
        <AppId>1253349830</AppId>
        <CreateTime>1677658884</CreateTime>
        <Region>ap-chongqing</Region>
        <Status>1</Status>
    </CIBucketList>
    <CIBucketList>
        <BucketId>test-cq2-1234567890</BucketId>
        <BucketName>test-cq2</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677662484</CreateTime>
        <Region>ap-chongqing</Region>
        <Status>1</Status>
    </CIBucketList>
    <CIBucketList>
        <BucketId>test-1234567890</BucketId>
        <BucketName>test</BucketName>
        <AppId>1234567890</AppId>
        <CreateTime>1677666084</CreateTime>
        <Region>ap-chongqing</Region>
        <Status>1</Status>
    </CIBucketList>
    <IsAll>false</IsAll>
</Response>
﻿

名称	描述	类型	是否必选
bucketName	存储桶名称前缀，前缀搜索	String	否
tagKey	标签搜索，仅支持搜索单个标签，标签键和标签值之间用分号(;) 分隔，例如：tagKey;tagVal	String	否
pageNumber	第几页，默认值1	String	否
pageSize	每页个数，默认值10	String	否

存储桶标签授权情况	DescribeCIBuckets 授权情况	DescribeCIBuckets 请求	请求返回
主账号通过存储桶标签授权，授权了子账号存储桶标签 tagA 的资源操作权限。	授权 DescribeCIBuckets 权限，资源选择 bucketA 和 bucketB	携带存储桶标签参数 tagA	设置了存储桶标签 tagA 的存储桶列表
	授权 DescribeCIBuckets 权限，资源选择 bucketA 和 bucketB			不携带标签参数	bucketA、bucketB 以及设置了存储桶标签 tagA 的存储桶列表
		不授权DescribeCIBuckets 权限	携带存储桶标签参数 tagA	设置了存储桶标签 tagA 的存储桶列表
		不授权DescribeCIBuckets 权限		不携带标签参数	设置了存储桶标签 tagA 的存储桶列表
主账号没有通过存储桶标签授权，没有授权子账号存储桶标签 tagA 的资源操作权限。	授权 DescribeCIBuckets 权限，资源选择 bucketA 和 bucketB	携带存储桶标签参数 tagA	Access Denied
	授权 DescribeCIBuckets 权限，资源选择 bucketA 和 bucketB			不携带标签参数	bucketA 和 bucketB
		不授权DescribeCIBuckets 权限	携带存储桶标签参数 tagA	Access Denied
		不授权DescribeCIBuckets 权限		不携带标签参数	Access Denied

节点名称（关键字）	父节点	描述	类型
Response	无	保存结果的容器	Container

查询已绑定数据万象的存储桶列表

本页目录：

功能描述

请求

请求示例

请求头

请求体

请求参数

响应

响应头

响应体

错误码

实际案例

请求

响应