Call the PutPublicAccessBlock operation to enable Block Public Access for OSS resources - Object Storage Service

Enables Block Public Access for Object Storage Service (OSS) resources.

Usage notes

By default, an Alibaba Cloud account has the permissions to enable Block Public Access for OSS resources. If you want to enable Block Public Access for OSS resources by using a RAM user or the access credentials provided by Security Token Service (STS), you must have the oss:PutPublicAccessBlock permission. For more information, see Common examples of RAM policies.
If you enable Block Public Access, existing public access permissions are ignored and you cannot configure public access permissions. If you disable Block Public Access, existing public access permissions take effect and you can configure public access permissions.

Request syntax

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

<?xml version="1.0" encoding="UTF-8"?>
<PublicAccessBlockConfiguration>
  <BlockPublicAccess>true</BlockPublicAccess>
</PublicAccessBlockConfiguration>

Request headers

All headers in a PutPublicAccessBlock request are common request headers. For more information, see Common request headers.

Request elements

Element

Type

Required

Example

Description

PublicAccessBlockConfiguration

Container

Yes

N/A

The container in which the Block Public Access configurations are stored.

Parent nodes: none

Child nodes: BlockPublicAccess

BlockPublicAccess

Boolean

true

Specifies whether to enable Block Public Access.

true: enables Block Public Access.
false (default): disables Block Public Access.

Response headers

The response to a PutPublicAccessBlock request contains only common response headers. For more information, see Common response headers.

Examples

Sample request

PUT /?publicAccessBlock HTTP/1.1
Date: Mon, 19 Feb 2024 08:40:17 GMT
Content-Length: 148
Content-Type: application/xml
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************

<?xml version="1.0" encoding="UTF-8"?>
<PublicAccessBlockConfiguration>
  <BlockPublicAccess>true</BlockPublicAccess>
</PublicAccessBlockConfiguration>

Sample success response

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Mon, 19 Feb 2024 08:40:17 GMT
Server: AliyunOSS