Buat titik akses OSS - API CreateAccessPoint - Object Storage Service

Membuat titik akses untuk sebuah bucket.

Catatan penggunaan

Akun Alibaba Cloud memiliki izin ini secara default. Untuk menggunakan pengguna RAM atau STS, Anda harus memiliki izin oss:CreateAccessPoint.
Maksimal 1.000 titik akses per akun Alibaba Cloud.
Maksimal 100 titik akses per bucket.

Sintaksis permintaan

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>

Header permintaan

Operasi ini hanya menggunakan header permintaan umum.

Elemen permintaan

Elemen	Tipe	Wajib	Contoh	Deskripsi
CreateAccessPointConfiguration	Container	Ya	N/A	Container untuk konfigurasi titik akses. Node induk: none Node anak: AccessPointName, NetworkOrigin, dan VpcConfiguration
AccessPointName	String	Ya	ap-01	Nama titik akses. Persyaratan penamaan: Harus unik dalam satu wilayah akun Alibaba Cloud Anda. Tidak boleh diakhiri dengan -ossalias. Hanya boleh berisi huruf kecil, angka, dan tanda hubung (-). Tidak boleh diawali atau diakhiri dengan tanda hubung. Panjangnya harus antara 3 hingga 19 karakter. Node induk: CreateAccessPointConfiguration Node anak: none
NetworkOrigin	String	Ya	vpc	Asal jaringan. Nilai yang valid: vpc: Akses titik akses melalui virtual private cloud (VPC) tertentu. internet: Akses titik akses melalui titik akhir publik atau internal. Node induk: CreateAccessPointConfiguration Node anak: none
VpcConfiguration	Container	Tidak	N/A	Container untuk konfigurasi VPC. Node induk: CreateAccessPointConfiguration Node anak: VpcId
VpcId	String	Tidak	vpc-t4nlw426y44rd3iq4xxxx	ID VPC. Wajib hanya jika NetworkOrigin diatur ke vpc. Penting Saat membatasi akses VPC menggunakan titik akses, pastikan wilayah VPC sesuai dengan wilayah titik akhir gerbang OSS. Ketidaksesuaian wilayah menyebabkan kegagalan otentikasi. Untuk informasi lebih lanjut, lihat Wilayah titik akhir gerbang yang didukung oleh OSS. Node induk: VpcId Node anak: none

Header respons

Operasi ini hanya mengembalikan header respons umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
CreateAccessPointResult	Container	N/A	Container untuk hasil pembuatan titik akses. Node anak: AccessPointArn dan Alias
AccessPointArn	String	acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01	Nama Sumber Daya Alibaba Cloud (ARN) dari titik akses.
Alias	String	ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias	Alias dari titik akses.

Contoh

Permintaan contoh

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>

Respons contoh

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

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi CreateAccessPoint, lihat create-access-point.