Répertorier les points d'accès en appelant l'opération ListAccessPoints - Object Storage Service

Notes d'utilisation

Par défaut, un compte Alibaba Cloud est autorisé à interroger les informations sur les points d'accès. Pour effectuer cette opération en tant qu'utilisateur RAM ou via Security Token Service (STS), vous devez disposer de l'autorisation oss:ListAccessPoints.

Syntaxe de la requête

Les requêtes de points d'accès au niveau de l'utilisateur et au niveau du bucket ne diffèrent que par l'hôte de la requête. Pour les points d'accès au niveau de l'utilisateur, l'hôte est un endpoint public (exemple : oss-cn-hangzhou.aliyuncs.com) ou un endpoint interne (exemple : oss-cn-hangzhou-internal.aliyuncs.com). Pour les points d'accès au niveau du bucket, l'hôte est un nom de domaine de bucket (exemple : oss-example.oss-cn-hangzhou.aliyuncs.com).

Interroger les informations sur les points d'accès au niveau de l'utilisateur

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

Interroger les informations sur les points d'accès au niveau du 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

En-têtes de requête

Une requête ListAccessPoints utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Éléments de requête

Élément

Type

Obligatoire

Exemple

Description

max-keys

String

Non

10

Nombre maximal de points d'accès à renvoyer. Valeurs valides :

Pour les points d'accès au niveau de l'utilisateur : (0,1000].
Pour les points d'accès au niveau du bucket : (0 100].

Remarque

Si les résultats sont tronqués en raison de la limite max-keys, la réponse inclut l'élément NextContinuationToken comme jeton pour la prochaine requête de liste.

continuation-token

String

Non

abc

Jeton indiquant le point de départ de la liste. Récupérez ce jeton à partir de l'élément NextContinuationToken dans la réponse précédente.

En-têtes de réponse

Une réponse ListAccessPoints contient uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Éléments de réponse

Élément	Type	Exemple	Description
ListAccessPointsResult	Container	N/A	Conteneur pour le résultat de la liste. Nœuds parents : aucun Nœuds enfants : IsTruncated, NextContinuationToken, AccountId et AccessPoints
IsTruncated	Boolean	true	Indique si les résultats sont tronqués. Valeurs valides : true : Tous les résultats ne sont pas renvoyés. false : Tous les résultats sont renvoyés. Nœuds parents : ListAccessPointsResult Nœuds enfants : aucun
NextContinuationToken	String	abc	Jeton à utiliser pour la prochaine requête de liste. Définissez continuation-token sur cette valeur pour récupérer les résultats suivants. Nœuds parents : ListAccessPointsResult Nœuds enfants : aucun
AccountId	String	111933544165****	ID du compte Alibaba Cloud propriétaire du point d'accès. Nœuds parents : ListAccessPointsResult Nœuds enfants : aucun
AccessPoints	Container	N/A	Conteneur pour tous les points d'accès. Nœuds parents : ListAccessPointsResult Nœuds enfants : AccessPoint
AccessPoint	Container	N/A	Conteneur pour un seul point d'accès. Nœuds parents : AccessPoints Nœuds enfants : Bucket, AccessPointName, Alias, NetworkOrigin, VpcConfiguration et Status
Bucket	String	oss-example	Nom du bucket associé au point d'accès. Nœuds parents : AccessPoint Nœuds enfants : aucun
AccessPointName	String	ap-01	Nom du point d'accès. Nœuds parents : AccessPoint Nœuds enfants : aucun
Alias	String	ap-01-ossalias	Alias du point d'accès. Nœuds parents : AccessPoint Nœuds enfants : aucun
NetworkOrigin	String	vpc	Origine réseau du point d'accès. Valeurs valides : vpc : Le point d'accès est accessible uniquement depuis un ID de Virtual Private Cloud (VPC) spécifié. internet : Le point d'accès est accessible depuis des endpoints publics et internes. Nœuds parents : AccessPoint Nœuds enfants : aucun
VpcConfiguration	Container	N/A	Conteneur pour la configuration VPC. Nœuds parents : AccessPoint Nœuds enfants : VpcId
VpcId	String	vpc-t4nlw426y44rd3iq4****	ID du VPC. Nœuds parents : VpcConfiguration Nœuds enfants : aucun
Status		enable	Statut du point d'accès. Valeurs valides : enable : Le point d'accès est créé. disable : Le point d'accès est désactivé. creating : Le point d'accès est en cours de création. deleting : Le point d'accès est en cours de suppression. Nœuds parents : AccessPoint Nœuds enfants : VpcId

Exemples

Exemples de requêtes

Exemple de requête pour interroger les informations sur les points d'accès au niveau de l'utilisateur

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

Exemple de requête pour interroger les informations sur les points d'accès au niveau du 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****************

Exemple de réponse

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

Pour plus d'informations sur la commande ossutil correspondant à l'opération ListAccessPoints, consultez la section list-access-points.