ListBuckets--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

ListBuckets

最近更新时间：2024.08.01 20:30:27首次发布时间：2021.10.13 16:14:07

功能描述

此接口用于查询当前请求用户拥有的所有桶。

请求消息样式

GET / HTTP/1.1
Host: tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求会返回用户拥有的桶列表。

名称	参数类型	示例值	说明
Buckets	Array	-	您拥有的桶列表信息。
Name	String	bucketName	桶名。
CreationDate	String	2021-08-19T09:16:05.000Z	桶的创建时间。
Location	String	cn-beijing	桶所在区域。
ExtranetEndpoint	String	tos-cn-beijing.volces.com	外部域名。
IntranetEndpoint	String	tos-cn-beijing.ivolces.com	内部域名。
ProjectName	String	default	桶关联的项目名称。
Owner	Object	-	桶的所有者。
ID	String	accountID	账号ID。

请求示例

GET / HTTP/1.1
Host: tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 13:53:55 +0000
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2021 13:53:55 GMT
Server: TosServer
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
Content-Length: 643

{
    "Buckets": [
        {
            "CreationDate": "2021-08-19T09:16:05.000Z",
            "Name": "buckettest001",
            "Location": "cn-beijing",
            "ExtranetEndpoint": "tos-cn-beijing.volces.com",
            "IntranetEndpoint": "tos-cn-beijing.ivolces.com",
            "ProjectName": "default"
        },
        {
            "CreationDate": "2021-05-06T02:27:04.000Z",
            "Name": "lynch-peking-bucket",
            "Location": "cn-beijing",
            "ExtranetEndpoint": "tos-cn-beijing.volces.com",
            "IntranetEndpoint": "tos-cn-beijing.ivolces.com",
            "ProjectName": "default"
        },
        {
            "CreationDate": "2021-08-19T03:58:02.000Z",
            "Name": "lynch-peking-bucket1",
            "Location": "cn-beijing",
            "ExtranetEndpoint": "tos-cn-beijing.volces.com",
            "IntranetEndpoint": "tos-cn-beijing.ivolces.com",
            "ProjectName": "default"
        }
    ],
    "Owner": {
        "ID": "AccountID"
    }
}