功能描述
GET Bucket logging 用于获取源存储桶的日志配置信息。
注意
只有源存储桶拥有者才可进行该请求操作。
请求
请求示例
GET /?logging HTTP 1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth String
说明
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com,其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字,例如 examplebucket-1250000000,详情请参见 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档;<Region> 为 COS 的可用地域,详情请参见 地域和访问域名 文档。
Authorization: Auth String(详情请参见 请求签名 文档)。
请求头
请求体
该请求的请求体为空。
响应
响应头
响应体
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<BucketLoggingStatus><LoggingEnabled><TargetBucket>examplebucket-1250000000</TargetBucket><TargetPrefix>prefix</TargetPrefix></LoggingEnabled></BucketLoggingStatus>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
BucketLoggingStatus | 无 | 存储桶日志状态信息 | Container |
Container 节点 BucketLoggingStatus 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
LoggingEnabled | BucketLoggingStatus | 存储桶日志记录配置详细信息 | Container |
Container 节点 LoggingEnabled 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
TargetBucket | LoggingEnabled | 存放日志的目标存储桶,可以是同一个存储桶(但不推荐),或同一账户下、同一地域的存储桶 | String |
TargetPrefix | LoggingEnabled | 日志存放在目标存储桶的指定路径 | String |
错误码
实际案例
请求
GET /?logging HTTP 1.1Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Wed, 28 Oct 2017 21:32:00 GMTAuthorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5O****&q-sign-time=1484815944;32557711944&q-key-time=1484815944;32557711944&q-header-list=host&q-url-param-list=accelerate&q-signature=a2d28e1b9023d09f9277982775a4b3b705d0****
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 142Connection: keep-aliveDate: Wed, 28 Oct 2017 21:32:00 GMTServer: tencent-cosx-cos-request-id: NTg4MDdlNGZfNDYyMDRlXzM0YWFf****<BucketLoggingStatus><LoggingEnabled><TargetBucket>examplebucket-1250000000</TargetBucket><TargetPrefix>prefix</TargetPrefix></LoggingEnabled></BucketLoggingStatus>