Create an OSS access point - CreateAccessPoint API - Object Storage Service

Crea un access point para un bucket.

Notas de uso

Una cuenta de Alibaba Cloud cuenta con este permiso de forma predeterminada. Para utilizar un usuario RAM o STS, debe tener el permiso oss:CreateAccessPoint.
Se admiten hasta 1,000 access points por cuenta de Alibaba Cloud.
Se admiten hasta 100 access points por bucket.

Sintaxis de la solicitud

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>

Encabezados de la solicitud

Esta operación utiliza únicamente common request headers.

Elementos de la solicitud

Elemento	Tipo	Obligatorio	Ejemplo	Descripción
CreateAccessPointConfiguration	Contenedor	Sí	N/A	Contenedor para la configuración del access point. Nodos padre: ninguno Nodos hijo: AccessPointName, NetworkOrigin y VpcConfiguration
AccessPointName	String	Sí	ap-01	Nombre del access point. Requisitos de nomenclatura: Debe ser único dentro de una región de su cuenta de Alibaba Cloud. No puede terminar con -ossalias. Solo puede contener letras minúsculas, dígitos y guiones (-). No puede comenzar ni terminar con un guion. Debe tener entre 3 y 19 caracteres de longitud. Nodos padre: CreateAccessPointConfiguration Nodos hijo: ninguno
NetworkOrigin	String	Sí	vpc	Origen de la red. Valores válidos: vpc: Accede al access point a través de una virtual private cloud (VPC) específica. internet: Accede al access point a través de endpoints públicos o internos. Nodos padre: CreateAccessPointConfiguration Nodos hijo: ninguno
VpcConfiguration	Contenedor	No	N/A	Contenedor para la configuración de la VPC. Nodos padre: CreateAccessPointConfiguration Nodos hijo: VpcId
VpcId	String	No	vpc-t4nlw426y44rd3iq4xxxx	ID de la VPC. Es obligatorio solo cuando NetworkOrigin se establece en vpc. Importante Al restringir el acceso a la VPC mediante un access point, asegúrese de que la región de la VPC coincida con la región del endpoint de puerta de enlace de OSS. Las regiones que no coinciden provocan errores de autenticación. Para obtener más información, consulte Regions of gateway endpoints supported by OSS. Nodos padre: VpcId Nodos hijo: ninguno

Encabezados de la respuesta

Esta operación devuelve únicamente common response headers.

Elementos de la respuesta

Elemento	Tipo	Ejemplo	Descripción
CreateAccessPointResult	Contenedor	N/A	Contenedor del resultado de creación del access point. Nodos hijo: AccessPointArn y Alias
AccessPointArn	String	acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01	Nombre de recurso de Alibaba Cloud (ARN) del access point.
Alias	String	ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias	Alias del access point.

Ejemplos

Solicitudes de ejemplo

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>

Respuesta de ejemplo

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

Para obtener información sobre el comando de ossutil correspondiente a la operación CreateAccessPoint, consulte create-access-point.