GET Bucket Logging

最近更新时间:2022-12-30 15:57:13

描述

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

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

请求

语法

GET /?logging HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {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/" />

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈