PutBucketLogging
更新时间 2026-04-10 20:09:09
最近更新时间: 2026-04-10 20:09:09
功能说明
PutBucketLogging请求设置日志转存参数。所有的日志将会保留到和源存储桶属于同一拥有者的目标存储桶中。桶的拥有者可以设置桶的日志状态。桶的拥有者对所有的日志具有FULL_CONTROL权限，可以通过Grantee授权其他用户，其中Permissions参数指定了用户对日志的访问权限。
请求消息样式
PUT /{Bucket}?logging HTTP/1.1
Host: xxx-zos.ctyun.cn
Accept-Encoding: identity
X-Amz-Content-SHA256: Content-SHA256
X-Amz-Date: 20220412T100505Z
Content-Length: 71
Content-MD5: X2327bngvEFvAU8glXDGWw==
Authorization: string
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<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>请求消息参数
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： 桶的名称。 | String | 是 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用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 | 否 |
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx000000000000000000010-00624e4cea-5e72-default
Content-Type: application/xml
Content-Length: 0
Date: Thu, 07 Apr 2022 02:31:22 GMT
Connection: Keep-Alive响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。
