最近更新时间: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/" />
纯净模式