设置桶的加密规则

此 PUT 操作用于设置存储空间（Bucket）的加密规则。

请求

  • 请求语法

    • 内容

        PUT /?encryption HTTP/1.1
  Host: {BucketName}.{Endpoint}
  Date: {date}
  x-oss-server-side-encryption-kms-mode:{kms_mode}
  Authorization: {SignatureValue} 

  <?xml version="1.0" encoding="UTF-8"?>
  <ServerSideEncryptionConfiguration>
      <Rule>
          <ApplyServerSideEncryptionByDefault>
              <SSEAlgorithm>AES256</SSEAlgorithm>
              <KMSMasterKeyID></KMSMasterKeyID>
          </ApplyServerSideEncryptionByDefault>
      </Rule>
  </ServerSideEncryptionConfiguration>

    • 描述

        Endpoint：参考与region地域的关系
  SignatureValue：参考签名算法

  • 请求参数

    无

  • 非公共请求头

名称 类型 是否必须 描述
x-oss-server-side-encryption-kms-mode 字符串 否 当加密算法类型为KMS时，可以指定KMS的模式。
为空时使用默认模式，不为空时只能指定为AES。
  • 请求体
名称 类型 是否必须 描述
ServerSideEncryptionConfiguration 容器 是 服务器端加密规则的容器。
父节点：无
Rule 容器 是 服务器端加密规则。
父节点: ServerSideEncryptionConfiguration
ApplyServerSideEncryptionByDefault 容器 是 加密规则容器 父节点：Rule
SSEAlgorithm 字符串 是 加密算法类型。
父节点：ApplyServerSideEncryptionByDefault
KMSMasterKeyID 字符串 否 加密算法类型为KMS时不能为空。
父节点：ApplyServerSideEncryptionByDefault

响应

  • 非公共响应头

    无

  • 响应体

    无

示例

  • 请求

      PUT /?encryption HTTP/1.1
  Host: oss-example.oss-cn-beijing.inspurcloud.com
  Authorization: authorization string
  Content-Length: {length}
  Date: Wed, 29 Oct 2020 22:32:00 GMT    

  <?xml version="1.0" encoding="UTF-8"?>
  <ServerSideEncryptionConfiguration>
      <Rule>
          <ApplyServerSideEncryptionByDefault>
              <SSEAlgorithm>AES256</SSEAlgorithm>
              <KMSMasterKeyID></KMSMasterKeyID>
          </ApplyServerSideEncryptionByDefault>
      </Rule>
  </ServerSideEncryptionConfiguration>

  • 响应 

      HTTP/1.1 200 OK
  Date: Wed, 29 Oct 2020 22:32:00 GMT
  Connection: keep-alive

错误码

错误码 状态码 描述
... ... ...