全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

Put Bucket Encryption

最近更新时间:2025-04-02 10:57:57

描述

此接口用于为存储桶设置服务端加密。在存储桶设置服务端加密后,上传文件时,若没有指定文件的服务端加密方式,文件会默认继承存储桶的服务端加密方式。

创建桶加密必须是桶所有者(BucketOwner)或者拥有PutBucketEncryption权限。

关于服务端加密的更多信息,请参见加密

请求

请求语法

PUT /?encryption HTTP/1.1
Host: {Bucketname}.{endpoint} 
Authorization: {SignatureValue}
Content-Type: application/xml
Content-Length: {length}
Date: {date}

<ServerSideEncryptionConfiguration>
    <Rule>
        <ApplyServerSideEncryptionByDefault>
            <SSEAlgorithm>AES256</SSEAlgorithm>
        </ApplyServerSideEncryptionByDefault>
    </Rule>
</ServerSideEncryptionConfiguration>

请求参数

该请求消息中不使用消息参数。

请求消息头

该请求使用公共消息头。

请求体(XML)

<ServerSideEncryptionConfiguration>
    <Rule>
        <ApplyServerSideEncryptionByDefault>
            <SSEAlgorithm>AES256</SSEAlgorithm>
        </ApplyServerSideEncryptionByDefault>
    </Rule>
</ServerSideEncryptionConfiguration>

参数名称

是否必选

参数描述

ServerSideEncryptionConfiguration

桶的默认加密配置的根元素。

类型:Container

父元素:无

子元素:Rule

Rule

桶的默认加密配置的子元素。

类型:Container

父元素:ServerSideEncryptionConfiguration

子元素:ApplyServerSideEncryptionByDefault

ApplyServerSideEncryptionByDefault

桶的默认加密配置的子元素。

类型:Container

父元素:Rule

子元素:SSEAlgorithm

SSEAlgorithm

桶的默认加密配置要使用的服务端加密算法。

类型:String

有效值:AES256

父元素:ApplyServerSideEncryptionByDefault

响应示例

HTTP/1.1 200 Ok
Server: ks3
Date: Tue, 07 Jul 2020 07:29:13 GMT
Content-Length: 11

报错信息

状态码

报错信息

错误原因

403 Forbidden

Access Denied

没有权限/缺少权限。

403 Forbidden

SignatureDoesNotMatch

签名计算有误;AK/SK填写错误。

400 BadRequest

MalformedXML

设置的桶加密的XML格式有误。

400 BadParameter

InvalidArgument

参数写错,例如AES256写成AES255。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容