Tencent Cloud

Recent Pages

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>