ListAccessPoints - Object Storage Service

Mengambil informasi tentang titik akses tingkat pengguna atau tingkat bucket.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk mengambil informasi tentang titik akses. Untuk menggunakan pengguna RAM atau Security Token Service (STS), Anda harus memiliki izin oss:ListAccessPoints.

Sintaks permintaan

Perbedaan antara permintaan informasi tentang titik akses tingkat pengguna dan tingkat bucket terletak pada host permintaan. Host permintaan untuk titik akses tingkat pengguna adalah Titik akhir publik (contoh: oss-cn-hangzhou.aliyuncs.com) atau Titik akhir internal (contoh: oss-cn-hangzhou-internal.aliyuncs.com). Host permintaan untuk titik akses tingkat bucket adalah nama domain bucket (contoh: oss-example.oss-cn-hangzhou.aliyuncs.com).

Meminta informasi tentang titik akses tingkat pengguna

GET /?accessPoint&max-keys=10&continuation-token=abcd HTTP/1.1
Date: Tanggal GMT
Content-Length: PanjangKonten
Content-Type: application/xml
Host: oss-cn-hangzhou.aliyuncs.com 
Authorization: NilaiTandaTangan

Meminta informasi tentang titik akses tingkat bucket

GET /?accessPoint&max-keys=10&continuation-token=abcd HTTP/1.1
Date: Tanggal GMT
Content-Length: PanjangKonten
Content-Type: application/xml
Host: NamaBucket.oss-cn-hangzhou.aliyuncs.com 
Authorization: NilaiTandaTangan

Header permintaan

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

Elemen permintaan

Elemen

Tipe

Diperlukan

Contoh

Deskripsi

max-keys

String

Tidak

Jumlah maksimum titik akses yang dapat dikembalikan. Nilai valid:

Untuk titik akses tingkat pengguna: (0,1000].
Untuk titik akses tingkat bucket: (0,100].

Catatan

Jika daftar tidak dapat selesai dalam satu waktu karena konfigurasi elemen max-keys, elemen NextContinuationToken disertakan dalam respons sebagai token untuk daftar berikutnya.

continuation-token

String

Tidak

abc

Token dari mana operasi daftar harus dimulai. Anda dapat memperoleh token ini dari elemen NextContinuationToken dalam respons.

Header respons

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

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
ListAccessPointsResult	Container	N/A	Wadah yang menyimpan informasi tentang hasil daftar. Node induk: none Node anak: IsTruncated, NextContinuationToken, AccountId, dan AccessPoints
IsTruncated	Boolean	true	Menunjukkan apakah hasil yang dikembalikan dipotong. Nilai valid: true: menunjukkan bahwa tidak semua hasil dikembalikan untuk permintaan. false: menunjukkan bahwa semua hasil dikembalikan untuk permintaan. Node induk: ListAccessPointsResult Node anak: none
NextContinuationToken	String	abc	Menunjukkan bahwa permintaan ListAccessPoints ini berisi hasil berikutnya. Anda harus mengatur NextContinuationToken ke continuation-token untuk melanjutkan mendapatkan hasil daftar. Node induk: ListAccessPointsResult Node anak: none
AccountId	String	111933544165****	ID akun Alibaba Cloud tempat titik akses tersebut berada. Node induk: ListAccessPointsResult Node anak: none
AccessPoints	Container	N/A	Wadah yang menyimpan informasi tentang semua titik akses. Node induk: ListAccessPointsResult Node anak: AccessPoint
AccessPoint	Container	N/A	Wadah yang menyimpan informasi tentang sebuah titik akses. Node induk: AccessPoints Node anak: Bucket, AccessPointName, Alias, NetworkOrigin, VpcConfiguration, dan Status
Bucket	String	oss-example	Nama bucket untuk mana titik akses dikonfigurasikan. Node induk: AccessPoint Node anak: none
AccessPointName	String	ap-01	Nama titik akses. Node induk: AccessPoint Node anak: none
Alias	String	ap-01-ossalias	Alias titik akses. Node induk: AccessPoint Node anak: none
NetworkOrigin	String	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 Titik akhir publik dan Titik akhir internal untuk mengakses titik akses. Node induk: AccessPoint Node anak: none
VpcConfiguration	Container	N/A	Wadah yang menyimpan informasi tentang VPC. Node induk: AccessPoint Node anak: VpcId
VpcId	String	vpc-t4nlw426y44rd3iq4****	ID VPC. Node induk: VpcConfiguration Node anak: none
Status		enable	Status titik akses. Nilai valid: enable: Titik akses telah dibuat. disable: Titik akses dinonaktifkan. creating: Titik akses sedang dibuat. deleting: Titik akses dihapus. Node induk: AccessPoint Node anak: VpcId

Contoh

Permintaan Sampel

Permintaan sampel untuk meminta informasi tentang titik akses tingkat pengguna

GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 36
Content-Type: application/xml
Host: oss-cn-hangzhou.aliyuncs.com 
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Permintaan sampel untuk meminta informasi tentang titik akses tingkat bucket

GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 36
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Authorization: OSS qn6q**************:77Dv****************

Respons Sampel

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListAccessPointsResult>
  <IsTruncated>true</IsTruncated>
  <NextContinuationToken>abc</NextContinuationToken>
  <AccountId>111933544165****</AccountId>
  <AccessPoints>
    <AccessPoint>
      <Bucket>oss-example</Bucket>
      <AccessPointName>ap-01</AccessPointName>
      <Alias>ap-01-ossalias</Alias>
      <NetworkOrigin>vpc</NetworkOrigin>
      <VpcConfiguration>
        <VpcId>vpc-t4nlw426y44rd3iq4****</VpcId>
      </VpcConfiguration>
      <Status>enable</Status>
    </AccessPoint>
    ...
  </AccessPoints>
</ListAccessPointsResult>

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ListAccessPoints, lihat list-access-points.