此操作用来获得指定Bucket的logging。只有根用户和拥有GET Bucket Logging权限的子用户才能执行此操作,否则会返回403 AccessDenied错误。
请求语法
GET /?logging HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue
请求参数
名称 | 描述 | 是否必须 |
---|---|---|
BucketName | 存储桶名称。 | 是 |
响应结果
名称 | 描述 |
---|---|
BucketLoggingStatus | 响应的容器。 类型:容器。 子节点:LoggingEnabled。 |
LoggingEnabled | 日志信息的容器,当启动日志时,包含这个元素;否则此元素及其子元素都不显示。 类型:容器。 父节点:BucketLoggingStatus。 子节点:TargetBucket、TargetPrefix。 |
TargetBucket | 保存log的bucket,OOS会向此Bucket存储日志。 类型:字符串。 父节点:LoggingEnabled。 |
TargetPrefix | 生成的log文件将以此为前缀命名。 类型:字符串。 父节点:LoggingEnabled。 |
请求示例
GET /?logging HTTP/1.1
Host: docs.oos-cn.ctyunapi.cn
Date: Mon, 03 Sep 2012 12:00:00 GMT
Authorization: SignatureValue
响应示例
以下是设置了日志的响应示例。
HTTP/1.1 200 OK
x-amz-request-id: 7b6bfbc182504e46f26558675c696b7130323c26282a2c2e30
Date: Mon, 03 Sep 2012 12:00:00 GMT
Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01">
<LoggingEnabled>
<TargetBucket>example-bucket</TargetBucket>
<TargetPrefix>mybucket-access_log-/</TargetPrefix>
</LoggingEnabled>
</BucketLoggingStatus>
以下是没有设置日志时的响应示例。
HTTP/1.1 200 OK
x-amz-request-id: ef00a70d4f2b43416ee1d4e3d8e5e7edacaeb7a2a4a6a8aaac
Date: Mon, 03 Sep 2012 12:00:00 GMT
Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/"></BucketLoggingStatus>