Todos os produtos
Search

Este produto

    Object Storage Service:GetAccessPoint

    Central de documentação

    Object Storage Service:GetAccessPoint

    Última atualização: Jul 03, 2026

    Consulta a configuração e o status de um access point especificado.

    Observações de uso

    Por padrão, uma conta Alibaba Cloud tem permissão para consultar informações de access point. Para usar um usuário RAM ou Security Token Service (STS), é necessária a permissão oss:GetAccessPoint.

    Sintaxe da solicitação

    GET /?accessPoint HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: ContentType
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: apname
Authorization: SignatureValue

    Cabeçalhos da solicitação

    Cabeçalho

    Tipo

    Obrigatório

    Exemplo

    Descrição

    x-oss-access-point-name

    String

    Sim

    ap-01

    Nome do access point.

    Esta solicitação também inclui cabeçalhos comuns, como Date e Authorization. Para mais informações, consulte Cabeçalhos comuns de solicitação.

    Cabeçalhos da resposta

    A resposta contém apenas cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de resposta.

    Elementos da resposta

    Elemento

    Tipo

    Exemplo

    Descrição

    GetAccessPointResult

    Container

    N/A

    Contêiner das informações do access point.

    Nós pai: nenhum

    Nós filho: AccessPointName, Bucket, AccountId, NetworkOrigin, VpcConfiguration, AccessPointArn, CreationDate, Alias, Status e Endpoints

    AccessPointName

    String

    ap-01

    Nome do access point.

    Nós pai: GetAccessPointResult

    Nós filho: nenhum

    Bucket

    String

    oss-example

    Nome do bucket associado ao access point.

    Nós pai: GetAccessPointResult

    Nós filho: nenhum

    AccountId

    String

    111933544165xxxx

    ID da conta Alibaba Cloud proprietária do access point.

    Nós pai: GetAccessPointResult

    Nós filho: nenhum

    NetworkOrigin

    String

    vpc

    Origem de rede do access point. Valores válidos:

    • vpc: permite acessar o access point por meio de um ID específico de Virtual Private Cloud (VPC).

    • internet: permite acessar o access point por endpoints públicos e internos.

    Nós pai: GetAccessPointResult

    Nós filho: nenhum

    VpcConfiguration

    Container

    N/A

    Contêiner das informações da VPC.

    Nós pai: GetAccessPointResult

    Nós filho: VpcId

    VpcId

    String

    vpc-t4nlw426y44rd3iq4xxxx

    ID da VPC.

    Nós pai: VpcConfiguration

    Nós filho: nenhum

    AccessPointArn

    String

    arn:acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01

    Alibaba Cloud Resource Name (ARN) do access point.

    Nós pai: GetAccessPointResult

    Nós filho: nenhum

    CreationDate

    String

    1626769503

    Data de criação do access point no formato de timestamp Unix.

    Nós pai: GetAccessPointResult

    Nós filho: nenhum

    Alias

    String

    ap-01-ossalias

    Alias do access point.

    Nós pai: GetAccessPointResult

    Nós filho: nenhum

    Status

    ative

    Status do access point. Valores válidos:

    • ative: access point criado.

    • disable: access point desativado.

    • creating: criação do access point em andamento.

    • deleting: access point excluído.

    Nós pai: GetAccessPointResult

    Nós filho: nenhum

    Endpoints

    Container

    N/A

    Contêiner das informações de endpoint do access point.

    Nós pai: GetAccessPointResult

    Nós filho: PublicEndpoint e InternalEndpoint

    PublicEndpoint

    String

    ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com

    Endpoint público do access point.

    Nós pai: Endpoints

    Nós filho: nenhum

    InternalEndpoint

    String

    ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com

    Endpoint interno do access point.

    Nós pai: Endpoints

    Nós filho: nenhum

    PublicAccessBlockConfiguration

    Container

    N/A

    Contêiner das configurações de Block Public Access.

    Nós pai: GetAccessPointResult

    Nós filho: BlockPublicAccess

    BlockPublicAccess

    Boolean

    true

    Indica se o Block Public Access está ativado para o access point.

    • true: Block Public Access ativado.

    • false: Block Public Access desativado.

    Nós pai: PublicAccessBlockConfiguration

    Nós filho: nenhum

    Exemplos

    • Exemplo de solicitação

      GET /?accessPoint HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 10
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: ap-01
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
<?xml version="1.0" encoding="UTF-8"?>
<GetAccessPointResult>
  <AccessPointName>ap-01</AccessPointName>
  <Bucket>oss-example</Bucket>
  <AccountId>111933544165xxxx</AccountId>
  <NetworkOrigin>vpc</NetworkOrigin>
  <VpcConfiguration>
     <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
  </VpcConfiguration>
  <AccessPointArn>arn:acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01</AccessPointArn>
  <CreationDate>1626769503</CreationDate>
  <Alias>ap-01-ossalias</Alias>
  <Status>enable</Status>
  <Endpoints>
    <PublicEndpoint>ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com</PublicEndpoint>
    <InternalEndpoint>ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com</InternalEndpoint>
  </Endpoints>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>
</GetAccessPointResult>

    ossutil

    Para obter informações sobre o comando ossutil correspondente à operação GetAccessPoint, consulte get-access-point.