GetBucketLogging
更新时间 2026-04-10 20:09:09
最近更新时间: 2026-04-10 20:09:09
功能说明
GetBucketLogging请求获取存储桶的日志转存配置。
请求消息样式
GET /{Bucket}?logging HTTP/1.1
Host: xxxx.zos.ctyun.cn
Accept-Encoding: identity
X-Amz-Content-SHA256: Content-SHA256
X-Amz-Date: 20220412T100505Z
Authorization: string请求消息参数
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释: 桶的名称。 | String | 是 |
请求消息头
该请求使用公共的请求消息头,请参见如何调用API-构造请求-请求消息头。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx000000000000000000011-00624e4d20-5e72-default
Content-Type: application/xml
Content-Length: 129
Date: Thu, 07 Apr 2022 02:32:16 GMT
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
<LoggingEnabled>
<TargetBucket>string</TargetBucket>
<TargetGrants>
<Grant>
<Grantee>
<DisplayName>string</DisplayName>
<EmailAddress>string</EmailAddress>
<ID>string</ID>
<xsi:type>string</xsi:type>
</Grantee>
<Permission>string</Permission>
</Grant>
</TargetGrants>
<TargetPrefix>string</TargetPrefix>
</LoggingEnabled>
</BucketLoggingStatus>响应消息头
该请求的响应消息使用公共的响应消息头,请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| BucketLoggingStatus | 参数解释: 日志状态信息。若此参数置为空,则表示关闭日志转存功能。 | Container | 是 |
表 BucketLoggingStatus
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| LoggingEnabled | 参数解释: 描述日志存储位置和日志对象前缀。 | Container | 否 |
表 LoggingEnabled
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| TargetBucket | 参数解释: 日志存储位置。可以将日志存放到任意用户拥有的桶中,包含源存储桶。用户可以配置多个源桶的日志均投放到同一个目标存储桶中,在这种情况下,用户可以使用 TargetPrefix 区分日志来自哪个源存储桶。 | String | 是 |
| TargetGrants | 参数解释: 授权信息。 | Container | 否 |
| TargetPrefix | 参数解释: 日志对象前缀。若多个源存储桶的日志均写到同一个目标存储桶中,则可以通过目标前缀来区分日志来自哪一个源存储桶。 | String | 是 |
表 TargetGrants
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| Grant | 参数解释: 授权许可。 | Container | 否 |
表 Grant
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| Grantee | 参数解释: 授权许可。 | Container | 否 |
| Permission | 参数解释: 日志访问许可。 取值范围: - FULL_CONTROL:完全控制权限 - READ:读权限 - WRITE:写权限 | String | 否 |
表 Grantee
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| DisplayName | 参数解释: 展示名字。 | String | 否 |
| EmailAddress | 参数解释: 邮件地址。 | String | 否 |
| ID | 参数解释: 授权用户 ID。 | String | 否 |
| Type | 参数解释: 授权类型。 取值范围: - CanonicalUser:普通用户 - AmazonCustomerByEmail:邮箱用户 | String | 否 |
错误码
请参见调用前必知-错误码-全局错误码。