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

文档中心

对象存储

桶基础操作

GetBucketInfo

功能描述

此接口用于查询存储桶的配置信息。

请求消息样式

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

请求参数和消息头

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

名称	位置	参数类型	是否必选	示例值	说明
bucketInfo	Query	String	是	-	代表 GetBucketInfo 请求的特殊标识。

请求元素

该请求不使用请求消息元素。

响应消息头

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

响应元素

名称	参数类型	示例值	说明
Bucket	Object	-	存储桶信息。
Name	String	tos-example	存储桶的名称。父节点：Bucket
Owner	Object	-	存储桶所属账号信息。父节点：Bucket
ID	String	20012****	存储桶所属的账号 ID。父节点： Owner
DisplayName	String	user-name	存储桶所属的账号名称。父节点： Owner
CreationDate	String	2025-01-17T04:25:18.000Z	存储桶的创建时间，格式为 UTC 时间。父节点：Bucket
StorageClass	String	STANDARD	存储桶的默认存储类型，取值说明如下： `STANDARD`：标准存储。 `IA`：低频访问存储。 `INTELLIGENT_TIERING`：智能分层存储 `ARCHIVE_FR`：归档闪回存储。 `ARCHIVE`：归档存储。 `COLD_ARCHIVE`：冷归档存储。 `DEEP_COLD_ARCHIVE`：深度冷归档存储。父节点：Bucket
Type	String	fns	存储桶的类型，取值说明如下： `fns`：扁平桶。 `hns`：分层桶。详细介绍，请参见存储桶类型。父节点：Bucket
ProjectName	String	default	存储桶所属项目。父节点：Bucket
Location	String	cn-beijing	存储桶所在地域父节点：Bucket
AzRedundancy	String	single-az	存储桶的 AZ 冗余类型，取值说明如下： `single-az`：单 AZ 冗余。 `multi-az`：多 AZ 冗余。父节点：Bucket
ExtranetEndpoint	String	tos-cn-beijing.volces.com	存储桶的 TOS 协议公网访问域名。父节点：Bucket
IntranetEndpoint	String	tos-cn-beijing.ivolces.com	存储桶的 TOS 协议私网访问域名。父节点：Bucket
ExtranetS3Endpoint	String	tos-s3-cn-beijing.volces.com	存储桶的 S3 协议公网访问域名。父节点：Bucket
IntranetS3Endpoint	String	tos-s3-cn-beijing.ivolces.com	存储桶的 S3 协议私网访问域名。父节点：Bucket
Versioning	String	Enabled	存储桶的版本控制状态，取值说明如下： `Enabled`：开启版本控制功能。 `Suspended`：暂停版本控制功能。空：未开启版本控制功能。父节点：Bucket
CrossRegionReplication	String	Enabled	存储桶的跨区域复制状态，取值说明如下： `Enabled`：启用跨区域复制功能。 `Disabled`：未启用跨区域复制功能。父节点：Bucket
TransferAcceleration	String	Enabled	存储桶的传输加速状态，取值说明如下： `Enabled`：启用传输加速功能。 `Disabled`：未启用传输加速功能。父节点：Bucket
AccessMonitor	String	Enabled	存储桶的访问跟踪状态，取值说明如下： `Enabled`：启用访问跟踪功能。 `Disabled`：未启用访问跟踪功能。父节点：Bucket
ServerSideEncryptionConfiguration	Object	-	存储桶的服务端加密配置信息。父节点：Bucket
Rule	Array	-	服务端加密规则。父节点：ServerSideEncryptionConfiguration
ApplyServerSideEncryptionByDefault	Array	-	服务端加密配置信息。父节点：Rule
SSEAlgorithm	String	AES256	服务端加密方式，取值说明如下： `kms`：使用 SSE-KMS 加密方式。 `AES256`：使用 SSE-TOS 加密方式。空：未开启服务端加密功能。父节点：ApplyServerSideEncryptionByDefault
KMSMasterKeyID	String	trn:kms:cn-beijing:200000*****:keyrings/ring-test/keys/key-test	使用 SSE-KMS 加密时使用的主密钥。说明当 `SSEAlgorithm` 值为 `kms` 时，才会返回 `KMSMasterKeyID` 参数。父节点：ApplyServerSideEncryptionByDefault

请求示例

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

响应示例

HTTP/1.1 200 OK
Date: Wed, 09 Apr 2025 09:01:45 GMT
Server: TosServer
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
Content-Length: 643
{
    "Bucket": {
        "Name": "test",
        "Owner": {
            "ID": "214748****",
            "DisplayName": "214748****"
        },
        "CreationDate": "2025-04-02T06:09:12.000Z",
        "StorageClass": "STANDARD",
        "ProjectName": "default",
        "Type": "fns",
        "Location": "cn-beijing",
        "AzRedundancy": "single-az",
        "ExtranetEndpoint": "tos-cn-beijing.volces.com",
        "IntranetEndpoint": "tos-cn-beijing.ivolces.com",
        "ExtranetS3Endpoint": "tos-s3-cn-beijing.volces.com",
        "IntranetS3Endpoint": "tos-s3-cn-beijing.ivolces.com",
        "Versioning": "",
        "CrossRegionReplication": "Disabled",
        "TransferAcceleration": "Disabled",
        "AccessMonitor": "Disabled",
        "ServerSideEncryptionConfiguration": {
            "Rule": {
                "ApplyServerSideEncryptionByDefault": {
                    "SSEAlgorithm": ""
                }
            }
        }
    }
}

最近更新时间：2025.04.27 16:35:09

这个页面对您有帮助吗？

有用

无用