更新时间:2025-10-20 GMT+08:00
分享

查询桶是否公开可访问

功能介绍

查询桶是否公开可访问。

URI

POST /v5/check-bucket-public-accessible/{bucket_name}

表1 路径参数

参数

是否必选

参数类型

描述

bucket_name

String

桶名。

最小长度:3

最大长度:63

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

bucket_owner_account

String

待分析桶的所有者账号 ID。

最小长度:1

最大长度:36

bucket_policy

String

待分析桶的桶策略。标准的 OBS 桶策略转义后的字符串。

最小长度:1

最大长度:131072

bucket_acl

String

待分析桶的桶ACL。标准的 OBS 桶 ACL 转义后的字符串。

bucket_access

String

待分析的类型。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

status

BucketStatus object

表明是否公开访问的状态信息。

表4 BucketStatus

参数

参数类型

描述

bucket_is_public

Boolean

整个桶(包括桶策略和 ACL)是否是公开可访问的。

bucket_policy_is_public

Boolean

桶策略是否是公开可访问的。

time_out

Boolean

求解时是否发生超时(超时时对应分析结果会置为 true)。

请求示例

查询桶是否公开可访问

POST https://{hostname}/v5/check-bucket-public-accessible

{
  "bucket_owner_account" : "******",
  "bucket_policy" : "{\\\"Statement\\\":[{\\\"Sid\\\":\\\"公开读-44d8\\\",\\\"Effect\\\":\\\"Deny\\\",\\\"Principal\\\":{\\\"ID\\\":[\\\"*\\\"]},\\\"Action\\\":[\\\"ListBucket\\\",\\\"GetObject\\\",\\\"GetObjectVersion\\\"],\\\"Resource\\\":[\\\"test-public-bucket\\\",\\\"test-public-bucket/*\\\"]}]}",
  "bucket_acl" : "<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?><AccessControlPolicy xmlns=\\\"http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/\\\"><Owner><ID>******</ID></Owner><AccessControlList><Grant><Grantee><ID>******</ID></Grantee><Permission>FULL_CONTROL</Permission></Grant><Grant><Grantee><ID>******</ID></Grantee><Permission>READ</Permission><Delivered>false</Delivered></Grant><Grant><Grantee><Canned>Everyone</Canned></Grantee><Permission>READ_ACP</Permission></Grant></AccessControlList></AccessControlPolicy>"
}

响应示例

状态码:200

OK

{
  "status" : {
    "bucket_is_public" : true,
    "bucket_policy_is_public" : false,
    "time_out" : false
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档