Listar access points chamando a operação ListAccessPoints - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

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

Sintaxe da solicitação

As consultas de access point no nível de usuário e de bucket diferem apenas no host da solicitação. Para access points no nível de usuário, o host é um endpoint público (exemplo: oss-cn-hangzhou.aliyuncs.com) ou interno (exemplo: oss-cn-hangzhou-internal.aliyuncs.com). Para access points no nível de bucket, o host corresponde ao nome de domínio do bucket (exemplo: oss-example.oss-cn-hangzhou.aliyuncs.com).

Consultar informações sobre access points no nível de usuário

GET /?accessPoint&max-keys=10&continuation-token=abcd HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: oss-cn-hangzhou.aliyuncs.com 
Authorization: SignatureValue

Consultar informações sobre access points no nível de bucket

GET /?accessPoint&max-keys=10&continuation-token=abcd 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

A solicitação ListAccessPoints usa apenas cabeçalhos comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.

Elementos da solicitação

Elemento

Tipo

Obrigatório

Exemplo

Descrição

max-keys

String

Não

10

Número máximo de access points retornados. Valores válidos:

Para access points no nível de usuário: (0,1000].
Para access points no nível de bucket: (0,100].

Nota

Se os resultados forem truncados devido ao limite max-keys, a resposta incluirá o elemento NextContinuationToken como token para a próxima solicitação de listagem.

continuation-token

String

Não

abc

Token que define o início da listagem. Obtenha esse valor no elemento NextContinuationToken da resposta anterior.

Cabeçalhos da resposta

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

Elementos da resposta

Elemento	Tipo	Exemplo	Descrição
ListAccessPointsResult	Container	N/A	Contêiner do resultado da listagem. Nós pai: nenhum Nós filho: IsTruncated, NextContinuationToken, AccountId e AccessPoints
IsTruncated	Boolean	true	Indica se os resultados foram truncados. Valores válidos: true: nem todos os resultados foram retornados. false: todos os resultados foram retornados. Nós pai: ListAccessPointsResult Nós filho: nenhum
NextContinuationToken	String	abc	Token para a próxima solicitação de listagem. Defina continuation-token com esse valor para recuperar os resultados subsequentes. Nós pai: ListAccessPointsResult Nós filho: nenhum
AccountId	String	111933544165****	ID da conta Alibaba Cloud proprietária do access point. Nós pai: ListAccessPointsResult Nós filho: nenhum
AccessPoints	Container	N/A	Contêiner de todos os access points. Nós pai: ListAccessPointsResult Nós filho: AccessPoint
AccessPoint	Container	N/A	Contêiner de um único access point. Nós pai: AccessPoints Nós filho: Bucket, AccessPointName, Alias, NetworkOrigin, VpcConfiguration e Status
Bucket	String	oss-example	Nome do bucket associado ao access point. Nós pai: AccessPoint Nós filho: nenhum
AccessPointName	String	ap-01	Nome do access point. Nós pai: AccessPoint Nós filho: nenhum
Alias	String	ap-01-ossalias	Alias do access point. Nós pai: AccessPoint Nós filho: nenhum
NetworkOrigin	String	vpc	Origem de rede do access point. Valores válidos: vpc: o access point é acessível apenas por um ID específico de Virtual Private Cloud (VPC). internet: o access point é acessível por endpoints públicos e internos. Nós pai: AccessPoint Nós filho: nenhum
VpcConfiguration	Container	N/A	Contêiner da configuração de VPC. Nós pai: AccessPoint Nós filho: VpcId
VpcId	String	vpc-t4nlw426y44rd3iq4****	ID da VPC. Nós pai: VpcConfiguration Nós filho: nenhum
Status		ative	Status do access point. Valores válidos: ative: o access point foi criado. disable: o access point está desativado. creating: a criação do access point está em andamento. deleting: a exclusão do access point está em andamento. Nós pai: AccessPoint Nós filho: VpcId

Exemplos

Solicitações de exemplo

Solicitação de exemplo para consultar informações sobre access points no nível de usuário

GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 36
Content-Type: application/xml
Host: oss-cn-hangzhou.aliyuncs.com 
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Solicitação de exemplo para consultar informações sobre access points no nível de bucket

GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 36
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Authorization: OSS qn6q**************:77Dv****************

Resposta de exemplo

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListAccessPointsResult>
  <IsTruncated>true</IsTruncated>
  <NextContinuationToken>abc</NextContinuationToken>
  <AccountId>111933544165****</AccountId>
  <AccessPoints>
    <AccessPoint>
      <Bucket>oss-example</Bucket>
      <AccessPointName>ap-01</AccessPointName>
      <Alias>ap-01-ossalias</Alias>
      <NetworkOrigin>vpc</NetworkOrigin>
      <VpcConfiguration>
        <VpcId>vpc-t4nlw426y44rd3iq4****</VpcId>
      </VpcConfiguration>
      <Status>enable</Status>
    </AccessPoint>
    ...
  </AccessPoints>
</ListAccessPointsResult>

ossutil

Para obter informações sobre o comando ossutil correspondente à operação ListAccessPoints, consulte list-access-points.