获取桶的加密规则

此 GET 操作用于获取存储空间（Bucket）的加密规则。

请求

  • 请求语法

    • 内容

        Get /?encryption HTTP/1.1
  Host: {BucketName}.{Endpoint}
  Date: {date}
  Authorization: {SignatureValue}

    • 描述

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

  • 请求参数

    无

  • 非公共请求头

    无

  • 请求体

    无

响应

  • 非公共响应头

    无

  • 响应体

名称 类型 是否必须 描述
ServerSideEncryptionConfiguration 容器 是 服务器端加密规则的容器。
父节点：无
Rule 容器 是 服务器端加密规则。
父节点: ServerSideEncryptionConfiguration
ApplyServerSideEncryptionByDefault 容器 是 加密规则容器 父节点：Rule
SSEAlgorithm 字符串 是 加密算法类型。
父节点：ApplyServerSideEncryptionByDefault
KMSMasterKeyID 字符串 否 加密算法类型为KMS时不能为空。
父节点：ApplyServerSideEncryptionByDefault

示例

  • 请求

      Get /?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

  • 响应 

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

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

错误码

错误码 状态码 描述
NoSuchBucket 404 指定获取加密规则对应的Bucket不存在。
AccessDenied 403 无获取Bucket加密规则的权限。
NoSuchServerSideEncryptionRule 400 Bucket未设置加密规则。