ListAccessPoints - Object Storage Service - Centro de documentación de Alibaba Cloud

Consulta información de access points a nivel de usuario o de bucket.

Notas de uso

Una cuenta de Alibaba Cloud tiene permisos para consultar información de access points de forma predeterminada. Para ejecutar esta operación como usuario de RAM o mediante Security Token Service (STS), debe contar con el permiso oss:ListAccessPoints.

Sintaxis de la solicitud

Las consultas de access points a nivel de usuario y a nivel de bucket difieren únicamente en el host de la solicitud. Para los access points a nivel de usuario, el host es un endpoint público (ejemplo: oss-cn-hangzhou.aliyuncs.com) o un endpoint interno (ejemplo: oss-cn-hangzhou-internal.aliyuncs.com). Para los access points a nivel de bucket, el host es un nombre de dominio de bucket (ejemplo: oss-example.oss-cn-hangzhou.aliyuncs.com).

Consulta de información de access points a nivel de usuario

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

Consulta de información de access points a nivel 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

Encabezados de solicitud

Una solicitud ListAccessPoints utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common HTTP headers.

Elementos de solicitud

Elemento

Tipo

Obligatorio

Ejemplo

Descripción

max-keys

String

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

Para access points a nivel de usuario: (0,1000].
Para access points a nivel de bucket: (0,100].

Nota

Si los resultados se truncan debido al límite de max-keys, la respuesta incluye el elemento NextContinuationToken como token para la siguiente solicitud de listado.

continuation-token

String

abc

Token desde el cual comienza el listado. Obtenga este token del elemento NextContinuationToken en la respuesta anterior.

Encabezados de respuesta

Una respuesta de ListAccessPoints contiene únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common HTTP headers.

Elementos de respuesta

Elemento	Tipo	Ejemplo	Descripción
ListAccessPointsResult	Container	N/A	Contenedor del resultado del listado. Nodos padre: Ninguna Nodos hijo: IsTruncated, NextContinuationToken, AccountId y AccessPoints
IsTruncated	Boolean	true	Indica si los resultados están truncados. Valores válidos: true: No se devolvieron todos los resultados. false: Se devolvieron todos los resultados. Nodos padre: ListAccessPointsResult Nodos hijo: Ninguna
NextContinuationToken	String	abc	Token para la siguiente solicitud de listado. Establezca continuation-token con este valor para recuperar los resultados subsiguientes. Nodos padre: ListAccessPointsResult Nodos hijo: Ninguna
AccountId	String	111933544165****	ID de la cuenta de Alibaba Cloud propietaria del access point. Nodos padre: ListAccessPointsResult Nodos hijo: Ninguna
AccessPoints	Container	N/A	Contenedor de todos los access points. Nodos padre: ListAccessPointsResult Nodos hijo: AccessPoint
AccessPoint	Container	N/A	Contenedor de un solo access point. Nodos padre: AccessPoints Nodos hijo: Bucket, AccessPointName, Alias, NetworkOrigin, VpcConfiguration y Status
Bucket	String	oss-example	Nombre del bucket asociado al access point. Nodos padre: AccessPoint Nodos hijo: Ninguna
AccessPointName	String	ap-01	Nombre del access point. Nodos padre: AccessPoint Nodos hijo: Ninguna
Alias	String	ap-01-ossalias	Alias del access point. Nodos padre: AccessPoint Nodos hijo: Ninguna
NetworkOrigin	String	vpc	Origen de red del access point. Valores válidos: vpc: El access point solo es accesible desde un ID de virtual private cloud (VPC) específico. internet: El access point es accesible desde endpoints públicos e internos. Nodos padre: AccessPoint Nodos hijo: Ninguna
VpcConfiguration	Container	N/A	Contenedor de la configuración de VPC. Nodos padre: AccessPoint Nodos hijo: VpcId
VpcId	String	vpc-t4nlw426y44rd3iq4****	ID de la VPC. Nodos padre: VpcConfiguration Nodos hijo: Ninguna
Status		enable	Estado del access point. Valores válidos: enable: El access point está creado. disable: El access point está deshabilitado. creating: El access point se está creando. deleting: El access point se está eliminando. Nodos padre: AccessPoint Nodos hijo: VpcId

Ejemplos

Solicitudes de ejemplo

Solicitud de ejemplo para consultar información de access points a nivel de usuario

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

Solicitud de ejemplo para consultar información de access points a nivel 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****************

Respuesta de ejemplo

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 obtener información sobre el comando de ossutil correspondiente a la operación ListAccessPoints, consulte list-access-points.