CreateAccessPoint - Object Storage Service

Membuat titik akses.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk membuat titik akses. Untuk membuat titik akses menggunakan pengguna RAM atau Security Token Service (STS), Anda harus memiliki izin oss:CreateAccessPoint.
Anda dapat membuat hingga 1.000 titik akses untuk satu akun Alibaba Cloud.
Anda dapat membuat hingga 100 titik akses untuk satu bucket.

Sintaks permintaan

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

Header permintaan

Semua header dalam permintaan CreateAccessPoint adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header HTTP umum.

Elemen permintaan

Elemen	Tipe	Diperlukan	Contoh	Deskripsi
CreateAccessPointConfiguration	Kontainer	Ya	Tidak tersedia	Kontainer yang menyimpan informasi tentang titik akses. Node induk: tidak ada Node anak: AccessPointName, NetworkOrigin, dan VpcConfiguration
AccessPointName	String	Ya	ap-01	Nama titik akses. Nama titik akses harus memenuhi persyaratan berikut: Nama harus unik di wilayah akun Alibaba Cloud Anda. Nama tidak boleh diakhiri dengan -ossalias. Nama hanya dapat berisi huruf kecil, angka, dan tanda hubung (-). Tidak boleh dimulai atau diakhiri dengan tanda hubung (-). Nama harus terdiri dari 3 hingga 19 karakter. Node induk: CreateAccessPointConfiguration Node anak: tidak ada
NetworkOrigin	String	Ya	vpc	Asal jaringan titik akses. Nilai valid: vpc: Anda dapat menggunakan ID virtual private cloud (VPC) tertentu untuk mengakses titik akses. internet: Anda dapat menggunakan endpoint publik dan endpoint internal untuk mengakses titik akses. Node induk: CreateAccessPointConfiguration Node anak: tidak ada
VpcConfiguration	Kontainer	Tidak	Tidak tersedia	Kontainer yang menyimpan informasi tentang VPC. Node induk: CreateAccessPointConfiguration Node anak: VpcId
VpcId	String	Tidak	vpc-t4nlw426y44rd3iq4xxxx	ID VPC. ID VPC diperlukan hanya jika Anda menetapkan parameter NetworkOrigin ke vpc. Penting Saat Anda menggunakan titik akses untuk membatasi VPC, pastikan wilayah VPC sesuai dengan wilayah endpoint gateway yang didukung oleh OSS. Jika tidak, permintaan otentikasi tidak dapat dikaitkan dengan VPC yang sesuai, yang mengakibatkan kegagalan otentikasi. Untuk informasi lebih lanjut, lihat Wilayah endpoint gateway yang didukung oleh OSS. Node induk: VpcId Node anak: tidak ada

Header respons

Respons terhadap permintaan CreateAccessPoint hanya berisi header respons umum. Untuk informasi lebih lanjut, lihat Header HTTP umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
CreateAccessPointResult	Kontainer	Tidak tersedia	Kontainer yang menyimpan informasi tentang 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 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: OSS qn6q**************:77Dv****************    
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
  	<AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>vpc</NetworkOrigin>
    <VpcConfiguration>
      <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
    </VpcConfiguration>
</CreateAccessPointConfiguration>

Respon sukses 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.