Interroger les informations sur un point d'accès en appelant l'opération GetAccessPoint - Object Storage Service

Notes d'utilisation

Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour interroger les informations sur les points d'accès. Pour utiliser un utilisateur RAM ou le Security Token Service (STS), vous devez disposer de l'autorisation oss:GetAccessPoint.

Syntaxe de la requête

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

En-têtes de requête

En-tête

Type

Obligatoire

Exemple

Description

x-oss-access-point-name

String

Oui

ap-01

Nom du point d'accès.

Cette requête inclut également des en-têtes de requête courants tels que Date et Authorization. Pour plus d'informations, consultez la section En-têtes de requête courants.

En-têtes de réponse

La réponse contient uniquement des en-têtes de réponse courants. Pour plus d'informations, consultez la section En-têtes de réponse courants.

Éléments de réponse

Élément	Type	Exemple	Description
GetAccessPointResult	Container	N/A	Conteneur des informations relatives au point d'accès. Nœuds parents : aucun Nœuds enfants : AccessPointName, Bucket, AccountId, NetworkOrigin, VpcConfiguration, AccessPointArn, CreationDate, Alias, Status et Endpoints
AccessPointName	String	ap-01	Nom du point d'accès. Nœuds parents : GetAccessPointResult Nœuds enfants : aucun
Bucket	String	oss-example	Nom du bucket associé au point d'accès. Nœuds parents : GetAccessPointResult Nœuds enfants : aucun
AccountId	String	111933544165xxxx	ID du compte Alibaba Cloud propriétaire du point d'accès. Nœuds parents : GetAccessPointResult Nœuds enfants : aucun
NetworkOrigin	String	vpc	Origine réseau du point d'accès. Valeurs possibles : vpc : Accès au point d'accès via un ID de Virtual Private Cloud (VPC) spécifique. internet : Accès au point d'accès via des endpoints publics et internes. Nœuds parents : GetAccessPointResult Nœuds enfants : aucun
VpcConfiguration	Container	N/A	Conteneur des informations relatives au VPC. Nœuds parents : GetAccessPointResult Nœuds enfants : VpcId
VpcId	String	vpc-t4nlw426y44rd3iq4xxxx	ID du VPC. Nœuds parents : VpcConfiguration Nœuds enfants : aucun
AccessPointArn	String	arn:acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01	Alibaba Cloud Resource Name (ARN) du point d'accès. Nœuds parents : GetAccessPointResult Nœuds enfants : aucun
CreationDate	String	1626769503	Heure de création du point d'accès, au format horodatage Unix. Nœuds parents : GetAccessPointResult Nœuds enfants : aucun
Alias	String	ap-01-ossalias	Alias du point d'accès. Nœuds parents : GetAccessPointResult Nœuds enfants : aucun
Status		enable	État du point d'accès. Valeurs possibles : 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 : GetAccessPointResult Nœuds enfants : aucun
Endpoints	Container	N/A	Conteneur des informations relatives aux endpoints du point d'accès. Nœuds parents : GetAccessPointResult Nœuds enfants : PublicEndpoint et InternalEndpoint
PublicEndpoint	String	ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com	Endpoint public du point d'accès. Nœuds parents : Endpoints Nœuds enfants : aucun
InternalEndpoint	String	ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com	Endpoint interne du point d'accès. Nœuds parents : Endpoints Nœuds enfants : aucun
PublicAccessBlockConfiguration	Container	N/A	Conteneur des configurations Block Public Access. Nœuds parents : GetAccessPointResult Nœuds enfants : BlockPublicAccess
BlockPublicAccess	Boolean	true	Indique si la fonctionnalité Block Public Access est activée pour le point d'accès. true : La fonctionnalité Block Public Access est activée. false : La fonctionnalité Block Public Access est désactivée. Nœuds parents : PublicAccessBlockConfiguration Nœuds enfants : aucun

Exemples

Exemple de requête

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

Exemple de réponse réussie

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

Pour obtenir des informations sur la commande ossutil correspondant à l'opération GetAccessPoint, consultez la section get-access-point.