Créer un point d'accès OSS - API CreateAccessPoint - Object Storage Service

Notes d'utilisation

Un compte Alibaba Cloud dispose de cette autorisation par défaut. Pour utiliser un utilisateur RAM ou STS, vous devez disposer de l'autorisation oss:CreateAccessPoint.
Jusqu'à 1 000 points d'accès par compte Alibaba Cloud.
Jusqu'à 100 points d'accès par bucket.

Syntaxe de la requête

PUT /?accessPoint HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
  	<AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>vpc</NetworkOrigin>
    <VpcConfiguration>
      <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
    </VpcConfiguration>
</CreateAccessPointConfiguration>

En-têtes de requête

Cette opération utilise uniquement les en-têtes de requête communs.

Éléments de requête

Élément	Type	Obligatoire	Exemple	Description
CreateAccessPointConfiguration	Container	Oui	N/A	Conteneur pour la configuration du point d'accès. Nœuds parents : aucun Nœuds enfants : AccessPointName, NetworkOrigin et VpcConfiguration
AccessPointName	String	Oui	ap-01	Nom du point d'accès. Exigences de dénomination : Doit être unique au sein d'une région de votre compte Alibaba Cloud. Ne peut pas se terminer par -ossalias. Peut contenir uniquement des lettres minuscules, des chiffres et des traits d'union (-). Ne peut pas commencer ni se terminer par un trait d'union. Doit comporter entre 3 et 19 caractères. Nœuds parents : CreateAccessPointConfiguration Nœuds enfants : aucun
NetworkOrigin	String	Oui	vpc	Origine du réseau. Valeurs valides : vpc : Accédez au point d'accès via un cloud privé virtuel (VPC) spécifique. internet : Accédez au point d'accès via des endpoints publics ou internes. Nœuds parents : CreateAccessPointConfiguration Nœuds enfants : aucun
VpcConfiguration	Container	Non	N/A	Conteneur pour la configuration du VPC. Nœuds parents : CreateAccessPointConfiguration Nœuds enfants : VpcId
VpcId	String	Non	vpc-t4nlw426y44rd3iq4xxxx	ID du VPC. Requis uniquement lorsque NetworkOrigin est défini sur vpc. Important Lorsque vous restreignez l'accès au VPC avec un point d'accès, assurez-vous que la région du VPC correspond à la région de l'endpoint de passerelle OSS. Des régions non concordantes entraînent des échecs d'authentification. Pour plus d'informations, consultez Régions des endpoints de passerelle prises en charge par OSS. Nœuds parents : VpcId Nœuds enfants : aucun

En-têtes de réponse

Cette opération renvoie uniquement les en-têtes de réponse communs.

Éléments de réponse

Élément

Type

Exemple

Description

CreateAccessPointResult

Container

N/A

Conteneur pour le résultat de la création du point d'accès.

Nœuds enfants : AccessPointArn et Alias

AccessPointArn

String

acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01

Alibaba Cloud Resource Name (ARN) du point d'accès.

Alias

String

ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias

Alias du point d'accès.

Exemples

Exemple de requête

PUT /?accessPoint HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 0
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e    
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
  	<AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>vpc</NetworkOrigin>
    <VpcConfiguration>
      <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
    </VpcConfiguration>
</CreateAccessPointConfiguration>

Exemple de réponse

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2Dxxxx
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointResult>
  <AccessPointArn>acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01</AccessPointArn>
  <Alias>ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias</Alias>
</CreateAccessPointResult>

ossutil

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