对象存储

产品文档

对象存储

帮助中心 > OpenAPI & SDK > 对象存储 > Put Bucket encryption

PUT Bucket encryption

该功能用于设定bucket默认加密方式。仅支持SSE-KMS。 参见服务器域名

请求语法


PUT /?encryption  HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Wed, 06 Sep 2018 12:00:00 GMT
Authorization: authorization string  (使用签名版本4)
Content-Length:  length 

default encryption configuration in the request body

请求参数

不需要请求参数。

请求头

不需要特殊请求头。

请求体

加密方式信息存在request body中,以xml的形式展现。下面的例子展示了设置bucket默认为SSE-KMS。


<ServerSideEncryptionConfiguration>
  <Rule>
    <ApplyServerSideEncryptionByDefault>
            <SSEAlgorithm>aws:kms</SSEAlgorithm>
    </ApplyServerSideEncryptionByDefault>
  </Rule>
</ServerSideEncryptionConfiguration>

加密设置XML 元素描述

名称 描述 是否必须
ApplyServerSideEncryptionByDefault 服务器端默认bucket加密方式的集合
子节点:SSEAlgorithm, KMSMasterKeyID
父节点:Rule
Rule 服务器端默认bucket加密方式的配置集合
子节点:ApplyServerSideEncryptionByDefault
父节点:ServerSideEncryptionConfiguration
ServerSideEncryptionConfiguration 服务器端默认bucket加密方式的具体配置集合
子节点:Rule
父节点:无
SSEAlgorithm 服务器端默认bucket的加密算法
有效值:aws:kms
限制:只能用于ApplyServerSideEncryptionByDefault之内
父节点:ApplyServerSideEncryptionByDefault

响应

响应头

无特殊Header。

响应元素

无响应元素。

特殊错误

无特殊错误。

示例:

请求示例:


PUT /?encryption HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Wed, 06 Sep 2017 12:00:00 GMT
Authorization: authorization string
Content-Length: length

<ServerSideEncryptionConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/" >
  <Rule>
    <ApplyServerSideEncryptionByDefault>
        <SSEAlgorithm>aws:kms</SSEAlgorithm>
    </ApplyServerSideEncryptionByDefault>
  </Rule>
</ServerSideEncryptionConfiguration>

  

返回示例:


HTTP/1.1 200 OK
Server: JDCloudOSS
Date: Wed, 14 Nov 2018 03:50:29 GMT
Content-Length: 0
Connection: keep-alive
x-req-id: A8D4BE3AD5D9B626
x-amz-request-id: A8D4BE3AD5D9B626
更新时间:2021-09-01 19:17:05
文档反馈 docs feedback