GetBucketLogging__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

Get Bucket Logging用于查看Bucket的访问日志配置情况。

请求语法

GET /?logging HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

响应元素(Response Elements)

名称	描述
BucketLoggingStatus	访问日志状态信息的容器类型: 容器子元素: LoggingEnabled 父元素: 无
LoggingEnabled	访问日志信息的容器。这个元素在开启时需要，关闭时不需要。类型: 容器子元素: TargetBucket, TargetPrefix 父元素: BucketLoggingStatus
TargetBucket	指定存放访问日志的Bucket。类型: 字符子元素: 无父元素: BucketLoggingStatus.LoggingEnabled
TargetPrefix	指定最终被保存的访问日志文件前缀。类型: 字符子元素: None 父元素: BucketLoggingStatus.LoggingEnabled

细节分析

如果Bucket不存在，返回404 no content错误。错误码：NoSuchBucket。
只有Bucket的拥有者才能查看Bucket的访问日志配置情况，否则返回403 Forbidden错误,错误码：AccessDenied。
如果源Bucket未设置Logging规则，OSS仍然返回一个XML消息体，但其中的BucketLoggingStatus元素为空。

示例

请求示例：

Get /?logging HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Fri, 04 May 2012 05:31:04 GMT  
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3naA=

已设置LOG规则的返回示例：

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906008B
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 210  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns=”https://doc.oss-cn-hangzhou.aliyuncs.com”>
    <LoggingEnabled>
        <TargetBucket>mybucketlogs</TargetBucket>
        <TargetPrefix>mybucket-access_log/</TargetPrefix>
    </LoggingEnabled>
</BucketLoggingStatus>

未设置LOG规则的返回示例：

HTTP/1.1 200 
x-oss-request-id: 534B371674E88A4D8906008B
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 110  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns=”https://doc.oss-cn-hangzhou.aliyuncs.com”>
</BucketLoggingStatus>

最后更新：2016-11-23 17:16:08

GetBucketLogging__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

请求语法

响应元素(Response Elements)

细节分析

示例

上一篇： GetBucketInfo__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

下一篇： GetBucketWebsite__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

相关内容

热门内容

最新内容