GetAccessPointPublicAccessBlock - Query Block Public Access configurations of an access point - Object Storage Service

Usage notes

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

Request syntax

GET /?publicAccessBlock&x-oss-access-point-name=ap-01 HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Request headers

A GetAccessPointPublicAccessBlock request uses only common request headers. For more information, see Common request headers.

Request elements

Element	Type	Required	Example	Description
x-oss-access-point-name	String	Yes	ap-01	The name of the access point.

Response headers

A GetAccessPointPublicAccessBlock response contains only common response headers. For more information, see Common response headers.

Response elements

Element

Type

Example

Description

PublicAccessBlockConfiguration

Container

N/A

The container that stores the Block Public Access configurations.

Parent nodes: none

Child nodes: BlockPublicAccess

BlockPublicAccess

Boolean

true

Indicates whether Block Public Access is enabled for the access point.

true: Block Public Access is enabled.
false: Block Public Access is disabled.

Examples

Sample request

GET /?publicAccessBlock&x-oss-access-point-name=ap-01 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 use OSS SDKs for the following programming languages to call GetAccessPointPublicAccessBlock:

ossutil

For information about the ossutil command that corresponds to the GetAccessPointPublicAccessBlock operation, see get-access-point-public-access-block.