Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketPublicAccessBlock

Última atualização: Jul 03, 2026

Consulta a configuração de Block Public Access de um bucket especificado.

Observações de uso

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

Sintaxe da solicitação

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

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.

Cabeçalhos da resposta

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

Elementos da resposta

Elemento

Tipo

Exemplo

Descrição

PublicAccessBlockConfiguration

Container

N/A

Contêiner que armazena a configuração de Block Public Access.

Nós pai: nenhum

Nós filho: BlockPublicAccess

BlockPublicAccess

Boolean

true

Indica se o Block Public Access está ativado para o bucket.

  • true: Block Public Access ativado.

  • false: Block Public Access desativado.

Exemplos

  • Exemplo de solicitação

    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
  • 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
    
    <?xml version="1.0" encoding="UTF-8"?>
    <PublicAccessBlockConfiguration>
      <BlockPublicAccess>true</BlockPublicAccess>
    </PublicAccessBlockConfiguration>

SDKs do OSS

Use os seguintes SDKs do OSS para chamar a operação GetBucketPublicAccessBlock:

ossutil

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