GET Bucket logging

描述

此 GET 操作使用 logging 资源来返回用户空间的日志记录状态。

若使用此接口需要用户是此空间的拥有者。

请求

语法

GET /?logging HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

注意：

• endpoint与Region对应关系
• SignatureValue签名算法

请求参数

该接口不使用请求参数。

请求头部

该接口只使用常用请求头部。获取更多信息，请点击常用请求头部。

请求内容

该接口不使用请求内容。

响应

响应头部

该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。

响应内容

名称	描述
BucketLoggingStatus	响应信息的容器。 类型: Container 父节点: 无
LoggingEnabled	日志信息的容器。启用日志时，该容器及其子节点会出现，否则，消失。 类型: Container 父节点: BucketLoggingStatus
TargetBucket	指定需要返回日志信息的用户空间。 类型: String 父节点: BucketLoggingStatus.LoggingEnabled
TargetPrefix	指定日志文件被存放的键值(逻辑分层+文件名)的前缀。 类型: String 父节点: BucketLoggingStatus.LoggingEnabled

特殊错误

该接口不返回任何特殊错误。

示例

请求示例

GET /?logging HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 25 Nov 2009 12:00:00 GMT
Authorization: authorization string

启用日志响应示例

HTTP/1.1 200 OK
Date: Wed, 25 Nov 2009 12:00:00 GMT
Connection: keep-alive
x-kss-request-id: f86o2tegmekoa87cstib1no5lntk78lt
Server: KS3

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <LoggingEnabled>
        <TargetBucket>ks3-example</TargetBucket>
        <TargetPrefix>mybucket-access_log-/</TargetPrefix>
    </LoggingEnabled>
</BucketLoggingStatus>

不启用日志响应示例

HTTP/1.1 200 OK
Date: Wed, 25 Nov 2009 12:00:00 GMT
Connection: keep-alive
x-kss-request-id: f86o0tegmekoa87dd5ib7no5ln16out7
Server: KS3

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://s3.amazonaws.com/doc/2006-03-01/" />