更新时间:2025-04-27 GMT+08:00
分享

获取桶公共状态

功能介绍

获取OBS桶的公共状态。

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

请求消息样式

GET /?bucketStatus HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com
Date: date
Authorization: authorization
Content-Type: application/xml
Content-Length: length

请求消息参数

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

请求消息头

该请求使用公共消息头,具体参见表3

请求消息元素

该请求消息中不使用消息元素。

响应消息样式

HTTP/1.1 status_code
Date: date
x-obs-request-id: 000001934E7A99E2530672D3A3903140
x-obs-id-2: 36AAAQAAEAABAAAQAAEAABAAAQAAEAABAAAaI=AAAAAAAAAAAAAAAAAAAAAAAAAA
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BucketStatus xmlns="http://obs.myhwclouds.com/doc/2015-06-30/">
  <IsPublic>boolean</IsPublic>
</BucketStatus>

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

响应消息元素

该请求的响应中以消息元素的形式返回桶公开状态,元素的具体意义如表1所示。

表1 响应消息元素

元素名称

元素类型

描述

BucketStatus

XML

参数解释:

桶的公开状态。

IsPublic

Boolean

参数解释:

桶的公开状态。

取值范围:

  • true:公开
  • false:非公开

错误响应消息

此请求可能的特殊错误如下表2描述。

错误码

描述

HTTP状态码

MethodNotAllowed

不允许使用该方法(特性开关未开启)

405

其余错误已经包含在表2中。

请求示例

GET /?bucketStatus HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.cn-north-4.myhuaweicloud.com
Accept: */*
Date: Sat, 16 Nov 2024 08:59:07 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=

响应示例

HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: Sat, 16 Nov 2024 08:59:08 GMT
Content-Length: 160

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BucketStatus xmlns="http://obs.myhwclouds.com/doc/2015-06-30/">
  <IsPublic>false</IsPublic>
</BucketStatus>

相关文档