GET Bucket logging

最近更新时间:2019-01-14 10:10:57

GET Bucket logging


描述

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

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

请求

语法

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

注意:

请求参数

该接口不使用请求参数。

请求头部

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

请求内容

该接口不使用请求内容。

响应

响应头部

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

响应内容

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

特殊错误

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

示例

请求示例

    GET /?logging HTTP/1.1
    Host: ks3-example.ks3-cn-beijing.ksyun.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: close
    Server: Tengine

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

不启用日志响应示例

    HTTP/1.1 200 OK
    Date: Wed, 25 Nov 2009 12:00:00 GMT
    Connection: close
    Server: KS3

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

金山云,开启您的云计算之旅

立即注册