GET Bucket encryption

Last updated: 2020-06-30 17:44:59

    Description

    This API (GET Bucket encryption) is used to query the default encryption configuration of the specified bucket.

    To call this API, you must have the GetBucketEncryption permission. By default, the bucket owner has direct permission to use this API and can grant such permission to other users.

    Request

    Sample request

    GET /?encryption HTTP 1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
    Date: GMT Date
    Authorization: Auth String

    Request parameters

    This API does not use any request parameter.

    Request headers

    This API only uses common request headers. For more information, please see Common Request Headers.

    Request body

    This API does not have a request body.

    Response

    Response headers

    This API only returns common response headers. For more information, please see Common Response Headers.

    Response body

    The following response elements will be returned:

    Element Name Parent Node Description Type
    ServerSideEncryptionConfiguration None This contains the default encryption configuration parameters Container
    Rules ServerSideEncryptionConfiguration Default server-side encryption configuration rule Container
    ApplyServerSideEncryptionByDefault Rules Default configuration information of server-side encryption Container
    SSEAlgorithm ApplyServerSideEncryptionByDefault Server-side encryption algorithm to be used. Enumerated value: AES256 String

    Error codes

    This API uses standardized error responses and error codes. For more information, see Error Codes .

    Use Cases

    Request

    GET /?encryption HTTP 1.1
    Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
    Date: Mon, 17 Jun 2019 08:37:35 GMT
    Authorization: signatureValue

    Response

    HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: xxxx
    Date: Mon, 17 Jun 2019 08:37:36 GMT
    Server: tencent-cos
    x-cos-request-id: NWQwNzUxNTBfMzdiMDJhMDlfOWM0Nl85NDFk****
    
    <?xml version = "1.0" encoding = "UTF-8">
    <ServerSideEncryptionConfiguration>
       <Rule>
          <ApplySideEncryptionConfiguration>
             <SSEAlgorithm>AES256</SSEAlgorithm>
          </ApplySideEncryptionConfiguration>
       </Rule>
    </ServerSideEncryptionConfiguration>

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help