Todos os produtos
Search
Central de documentação

Object Storage Service:PutAccessPointPublicAccessBlock

Última atualização: Jul 03, 2026

Ativa o Block Public Access em um access point para impedir o acesso público por meio dele.

Observações de uso

  • Por padrão, a conta Alibaba Cloud tem permissão para ativar o Block Public Access em um access point. Para executar essa operação como usuário RAM ou com credenciais do Security Token Service (STS), você precisa da permissão oss:PutAccessPointPublicAccessBlock. Para mais informações, consulte Exemplos comuns de políticas RAM.

  • Quando o Block Public Access está ativado, o sistema ignora todas as permissões de acesso público existentes e impede a configuração de novas permissões desse tipo. Se o Block Public Access estiver desativado, as permissões de acesso público vigentes entrarão em vigor e poderão ser configuradas.

Sintaxe da solicitação

PUT /?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

<?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

x-oss-access-point-name

String

Sim

ap-01

Nome do access point.

PublicAccessBlockConfiguration

Container

Sim

N/A

Contêiner que armazena as 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 no access point.

  • true: ativa o Block Public Access.

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

Cabeçalhos da resposta

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

Exemplos

  • Exemplo de solicitação

    PUT /?publicAccessBlock&x-oss-access-point-name=ap-01 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

Chame PutAccessPointPublicAccessBlock usando os SDKs do OSS nas seguintes linguagens de programação:

ossutil

Para obter o comando ossutil correspondente a esta operação, consulte put-access-point-public-access-block.