GetBucketEncryption

Notes

The oss:GetBucketEncryption permission is required to query the encryption rules configured for a bucket by calling GetBucketEncryption. For more information, see Common examples of RAM policies.

Request structure

Get /? encryption HTTP/1.1
Date: GMT Date
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

Request headers

A GetBucketEncryption request contains only common request headers. For more information, see Common request headers.

Response headers

The response to a GetBucketEncryption request contains only common response headers. For more information, see Common response headers.

Response elements

Examples

• Sample request

  Get /? encryption HTTP/1.1
  Date: Tue, 20 Dec 2018 11:20:10 GMT
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Authorization: OSS qn6q**************:77Dv****************

• Sample response

  The following response indicates that SSE-KMS is configured for the bucket.

  HTTP/1.1 204 NoContent
  x-oss-request-id: 5C1B138A109F4E405B2D8AEF
  Date: Tue, 20 Dec 2018 11:22:05 GMT
  <? xml version="1.0" encoding="UTF-8"? >
  <ServerSideEncryptionRule>
    <ApplyServerSideEncryptionByDefault>
      <SSEAlgorithm>KMS</SSEAlgorithm>
      <KMSMasterKeyID>9468da86-3509-4f8d-a61e-6eab1eac****</KMSMasterKeyID>
    </ApplyServerSideEncryptionByDefault>
  </ServerSideEncryptionRule>

SDK

You can use OSS SDKs for the following programming languages to call GetBucketEncryption:

• Java

• Python

• Go V2

• C++

• PHP

• .NET

• Node.js

ossutil

For information about the ossutil command that corresponds to the GetBucketEncryption operation, see get-bucket-encryption.

Errors codes