PutBucketPublicAccessBlock - Ative Block Public Access for an OSS bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

As contas Alibaba Cloud têm essa permissão por padrão. Para usar um usuário RAM ou credenciais STS, você precisa da permissão oss:PutBucketPublicAccessBlock. Para mais informações, consulte Exemplos comuns de políticas do RAM.
Quando ativado, o recurso ignora todas as permissões de acesso público existentes e impede a configuração de novas permissões desse tipo. Quando desativado, as permissões vigentes voltam a valer e podem ser configuradas novamente.

Sintaxe da solicitação

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

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

Cabeçalhos da solicitação

Esta operação usa apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.

Elementos da solicitação

Elemento

Tipo

Obrigatório

Exemplo

Descrição

PublicAccessBlockConfiguration

Container

Sim

N/A

O container das configurações do Block Public Access.

Nós pai: nenhum

Nós filho: BlockPublicAccess

BlockPublicAccess

Boolean

Não

true

Define se o Block Public Access deve ser ativado para o bucket.

true: ativa o Block Public Access.
false (padrão): desativa o Block Public Access.

Exemplos

Exemplo de solicitação

PUT /?publicAccessBlock HTTP/1.1
Date: Mon, 19 Feb 2024 08:40:17 GMT
Content-Length: 148
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

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

Exemplo de resposta de sucesso

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

SDKs do OSS

Os seguintes SDKs do OSS oferecem suporte ao PutBucketPublicAccessBlock:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação PutBucketPublicAccessBlock, consulte put-bucket-public-access-block.