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
TargetGrants	授权信息的容器。(暂不支持该功能) 类型: Container 父节点: 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: 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" />