华为云计算 云知识 获取桶的加密配置GetBucketEncryption
获取桶的加密配置GetBucketEncryption

 

接口说明

OBS使用GET操作来获取指定桶的加密配置。

要正确执行此操作,需要确保执行者有GetEncryptionConfiguration权限。缺省情况下只有桶的所有者可以执行此操作,也可以通过设置桶策略或用户策略授权给其他用户。

有关权限控制的更多信息请参考《 对象存储服务 权限配置指南》的OBS权限控制概述章节。

URL
GET  https://obs.cn-north-4.myhuaweicloud.com/ 
请求参数
名称 类型 IN 必选 描述
Authorization
 
string header

请求消息中可带的签名信息。

Date
 
string header

请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默认值:无。 条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。

bucket_name
 
string query

请求的桶名称。

encryption
 
string query

encryption表示请求桶的加密配置API。

返回参数
返回码: 200

请求成功响应消息。

名称 类型 必选 描述
Content-Length
 
string

响应消息体的字节长度。

Connection
 
string

指明与服务器的连接是长连接还是短连接。

Date
 
string

OBS系统响应的时间。

ETag
 
string

对象的base64编码的128位MD5摘要。ETag是对象内容的唯一标识,可以通过该值识别对象内容是否有变化。比如上传对象时ETag为A,下载对象时ETag为B,则说明对象内容发生了变化。实际的ETag是对象的哈希值。ETag只反映变化的内容,而不是其元数据。上传的对象或拷贝操作创建的对象,通过MD5加密后都有唯一的ETag。如果通过多段上传对象,则无论加密方法如何,MD5会拆分ETag,此类情况ETag就不是MD5的摘要。

x-obs-id-2
 
string

帮助定位问题的特殊符号。

x-obs-request-id
 
string

由OBS创建来唯一确定本次请求的值,可以通过该值来定位问题。

名称 类型 必选 描述
ServerSideEncryptionConfiguration
 
SetBucketEncryptionRequestBody object

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

200 ServerSideEncryptionConfiguration
名称 类型 必选 描述
Rule
 
ServerSideEncryptionConfigurationRule object

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

200 ServerSideEncryptionConfiguration.Rule
名称 类型 必选 描述
ApplyServerSideEncryptionByDefault
 
ApplyServerSideEncryptionByDefault object

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

200 ServerSideEncryptionConfiguration.Rule.ApplyServerSideEncryptionByDefault
名称 类型 必选 描述
SSEAlgorithm
 
string

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

KMSMasterKeyID
 
string

SSE-KMS加密方式下使用的KMS主密钥,如果用户没有提供该头域,那么默认的主密钥将会被使用。

类型:字符串

有效值支持两种格式:

regionID:domainID(帐号ID):key/key_id key_id 其中:

regionID是使用密钥所属region的ID,可在地区和 终端节点 页面获取; domainID是使用密钥所属帐号的帐号ID,获取方法参见获取帐号ID和用户ID; key_id是从 数据加密 服务创建的密钥ID,获取方法请参见查看密钥

ProjectID
 
string

SSE-KMS加密方式下KMS主秘钥所属的项目ID。 有效值:

与KMSMasterKeyID相匹配的项目ID。 在未设置KMSMasterKeyID的情况下,不可设置项目ID。 父元素:ApplyServerSideEncryptionByDefault

返回码: 400

请求失败响应消息。

名称 类型 必选 描述
Code
 
string

错误响应消息体XML中错误响应对应的HTTP消息返回码,具体的错误码请参见错误码-表2

Message
 
string

错误响应消息体XML中具体错误更全面、详细的英文解释,具体的错误消息请参见错误码-表2

RequestId
 
string

本次错误请求的请求ID,用于错误定位。

HostId
 
string

返回该消息的服务端ID。

Resource
 
string

该错误相关的桶或对象资源。

返回码: 404

请求失败响应消息。 除了公共的错误码外,此接口还会返回一些其他的错误码。下面列出本接口的一些常见错误,以及可能原因。

错误码 描述 HTTP状态码
NoSuchEncryptionConfiguration 指定的桶没有设置加密配置。 404 Not Found
名称 类型 必选 描述
Code
 
string

错误响应消息体XML中错误响应对应的HTTP消息返回码,具体的错误码请参见错误码-表2

Message
 
string

错误响应消息体XML中具体错误更全面、详细的英文解释,具体的错误消息请参见错误码-表2

RequestId
 
string

本次错误请求的请求ID,用于错误定位。

HostId
 
string

返回该消息的服务端ID。

Resource
 
string

该错误相关的桶或对象资源。

请求示例
示例 1
 
"/?encryption"
 
"GET /?encryption HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: Thu, 21 Feb 2019 03:05:34 GMT\nAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:DpSAlmLX/BTdjxU5HOEwflhM0WI=\n"
返回示例
返回码:200

请求成功响应消息。

示例 1
 
HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF26000001643670AC06E7B9A7767921 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAA BCS vK6z8HV6nrJh49gsB5vqzpgtohkiFm Date: Thu, 21 Feb 2019 03:05:34 GMT Content-Length: 788 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ServerSideEncryptionConfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/"> <Rule> <ApplyServerSideEncryptionByDefault> <SSEAlgorithm>kms</SSEAlgorithm> <KMSMasterKeyID>4f1cd4de-ab64-4807-920a-47fc42e7f0d0</KMSMasterKeyID> </ApplyServerSideEncryptionByDefault> </Rule> </ServerSideEncryptionConfiguration>
错误码
请参考 错误码说明

 

上一篇:智能知识中心-数据统计 下一篇:修改文件系统绑定的安全组ChangeSecurityGroup

对象存储服务 OBS     

对象存储服务(Object Storage Service)是一款稳定、安全、高效、易用的云存储服务,具备标准Restful API接口,可存储任意数量和形式的非结构化数据。