Object Storage Service:GetBucketPublicAccessBlock

Usage notes

By default, an Alibaba Cloud account has the permissions to query the Block Public Access configuration of a bucket. To perform this operation as a RAM user or by using Security Token Service (STS) credentials, you must have the oss:GetBucketPublicAccessBlock permission. For more information, see Common examples of RAM policies.

Request syntax

GET /?publicAccessBlock HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Request headers

This operation uses only common request headers. For more information, see Common request headers.

Response headers

This operation returns only common response headers. For more information, see Common response headers.

Response elements

Examples

• Sample request

  GET /?publicAccessBlock HTTP/1.1
  Date: Mon, 19 Feb 2024 08:40:17 GMT
  Content-Length: 0
  Content-Type: application/xml
  Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

• Sample success response

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674E88A4D8906****
  Date: Mon, 19 Feb 2024 08:40:17 GMT
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>

OSS SDKs

You can call GetBucketPublicAccessBlock by using the following OSS SDKs:

• Go V2

ossutil

For the ossutil command that corresponds to this operation, see get-bucket-public-access-block.