tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
文档

GET Bucket logging

最后更新时间：2023-12-21 12:41:04

    功能描述

    GET Bucket logging 用于获取源存储桶的日志配置信息。
    注意
    只有源存储桶拥有者才可进行该请求操作。

    请求

    请求示例

    GET /?logging HTTP 1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
    Date: GMT Date
    Authorization: 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.1
    Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
    Date: Wed, 28 Oct 2017 21:32:00 GMT
    Authorization: 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 OK
    Content-Type: application/xml
    Content-Length: 142
    Connection: keep-alive
    Date: Wed, 28 Oct 2017 21:32:00 GMT
    Server: tencent-cos
    x-cos-request-id: NTg4MDdlNGZfNDYyMDRlXzM0YWFf****
    
    <BucketLoggingStatus>
      <LoggingEnabled>
        <TargetBucket>examplebucket-1250000000</TargetBucket>
        <TargetPrefix>prefix</TargetPrefix>
      </LoggingEnabled>
    </BucketLoggingStatus>
    
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    隐私条款服务条款缓存条款