Crie um ponto de acesso do OSS - API CreateAccessPoint - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

A conta Alibaba Cloud tem essa permissão por padrão. Para usar um usuário RAM ou STS, você precisa da permissão oss:CreateAccessPoint.
Limite de 1.000 access points por conta Alibaba Cloud.
Máximo de 100 access points por bucket.

Sintaxe da solicitação

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>

Cabeçalhos da solicitação

Esta operação usa apenas cabeçalhos de solicitação comuns.

Elementos da solicitação

Elemento	Tipo	Obrigatório	Exemplo	Descrição
CreateAccessPointConfiguration	Container	Sim	N/A	Container da configuração do access point. Nós pai: nenhum Nós filho: AccessPointName, NetworkOrigin e VpcConfiguration
AccessPointName	String	Sim	ap-01	Nome do access point. Requisitos: Deve ser único na região da sua conta Alibaba Cloud. Não pode terminar com -ossalias. Aceita apenas letras minúsculas, dígitos e hifens (-). Não pode começar nem terminar com hífen. Deve ter de 3 a 19 caracteres. Nós pai: CreateAccessPointConfiguration Nós filho: nenhum
NetworkOrigin	String	Sim	vpc	Origem da rede. Valores válidos: vpc: acessa o access point por uma virtual private cloud (VPC) específica. internet: acessa o access point por endpoints públicos ou internos. Nós pai: CreateAccessPointConfiguration Nós filho: nenhum
VpcConfiguration	Container	Não	N/A	Container da configuração da VPC. Nós pai: CreateAccessPointConfiguration Nós filho: VpcId
VpcId	String	Não	vpc-t4nlw426y44rd3iq4xxxx	ID da VPC. Obrigatório apenas quando NetworkOrigin é definido como vpc. Importante Ao restringir o acesso à VPC com um access point, verifique se a região da VPC corresponde à região do endpoint de gateway do OSS. Regiões diferentes causam falhas de autenticação. Para mais informações, consulte Regiões de endpoints de gateway suportadas pelo OSS. Nós pai: VpcId Nós filho: nenhum

Cabeçalhos da resposta

Esta operação retorna apenas cabeçalhos de resposta comuns.

Elementos da resposta

Elemento	Tipo	Exemplo	Descrição
CreateAccessPointResult	Container	N/A	Container do resultado da criação do access point. Nós filho: AccessPointArn e Alias
AccessPointArn	String	acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01	Alibaba Cloud Resource Name (ARN) do access point.
Alias	String	ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias	Alias do access point.

Exemplos

Exemplo de solicitação

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>

Exemplo de resposta

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 obter informações sobre o comando do ossutil correspondente à operação CreateAccessPoint, consulte create-access-point.