Gunakan ListVectorBuckets untuk mencantumkan bucket vektor - Object Storage Service - Alibaba Cloud - Object Storage Service

Panggil operasi ListVectorBuckets untuk menampilkan semua vector bucket dalam akun Anda. Anda juga dapat menentukan parameter seperti prefix, marker, dan max-keys guna memfilter vector bucket yang ditampilkan sesuai kondisi tertentu.

Permissions

Secara default, Akun Alibaba Cloud memiliki izin penuh atas sumber dayanya. Pengguna RAM dan peran RAM tidak memiliki izin secara default. Untuk mengizinkan pengguna RAM atau peran RAM memanggil operasi ini, Akun Alibaba Cloud atau administrator RAM harus memberikan izin yang diperlukan melalui RAM policy atau bucket policy.

API	Action	Description
ListVectorBuckets	`oss:ListVectorBuckets`	Menampilkan vector bucket.

Sintaksis permintaan

GET / HTTP/1.1
Host: cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Common HTTP Headers.

Parameter permintaan

Parameter	Type	Required	Example	Description
prefix	String	No	my	Menentukan awalan yang harus dimiliki oleh nama vector bucket yang dikembalikan.
marker	String	No	mybucket	Menentukan posisi awal untuk set hasil. Kueri mengembalikan vector bucket secara alfabetis, dimulai dari entri tepat setelah marker yang ditentukan.
max-keys	Number	No	100	Jumlah maksimum vector bucket yang akan dikembalikan. Nilai valid: 1 hingga 1000. Nilai default: 100.

Header respons

Operasi ini hanya menggunakan header respons umum. Untuk informasi selengkapnya, lihat Common HTTP Headers.

Elemen respons

Catatan

Ketika Anda memanggil operasi ListVectorBuckets, jika semua bucket telah dikembalikan, respons tidak menyertakan elemen Prefix, Marker, MaxKeys, IsTruncated, dan NextMarker.

Parameter	Type	Example	Description
ListAllMyBucketsResult	Container	N/A	Kontainer untuk hasil permintaan ListVectorBuckets.
Prefix	String	my	Awalan yang ditentukan dalam permintaan. Node induk: ListAllMyBucketsResult
Marker	String	mybucket	Posisi awal untuk kueri ListVectorBuckets. Node induk: ListAllMyBucketsResult
MaxKeys	Number	10	Jumlah maksimum vector bucket yang dikembalikan dalam respons. Node induk: ListAllMyBucketsResult
IsTruncated	Boolean	true	Menunjukkan apakah semua vector bucket untuk kueri telah dikembalikan. Nilai valid: true: Tidak semua vector bucket dikembalikan. false: Semua vector bucket dikembalikan. Node induk: ListAllMyBucketsResult
NextMarker	String	mybucket10	Jika IsTruncated bernilai true, elemen ini menunjukkan marker untuk halaman berikutnya dari vector bucket. Gunakan nilai ini sebagai parameter `marker` dalam permintaan ListVectorBuckets berikutnya untuk mengambil halaman berikutnya. Node induk: ListAllMyBucketsResult
Buckets	Container	N/A	Kontainer untuk informasi tentang beberapa vector bucket. Node induk: ListAllMyBucketsResult
Name	String	acs:ossvector:cn-shanghai:103735**********:test-bucket-3	Identifikasi vector bucket. ARN bucket dikembalikan. Node induk: Buckets
CreationDate	String	2014-02-07T18:12:43.000Z	Waktu pembuatan vector bucket. Node induk: Buckets
ExtranetEndpoint	String	cn-shanghai.oss-vectors.aliyuncs.com	Titik akhir publik vector bucket. Node induk: Buckets
IntranetEndpoint	String	cn-shanghai-internal.oss-vectors.aliyuncs.com	Titik akhir internal vector bucket. Node induk: Buckets
Location	String	oss-cn-shanghai	ID wilayah spesifik OSS. Node induk: Buckets
Region	String	cn-shanghai	ID wilayah Alibaba Cloud umum. Node induk: Buckets

Contoh

Permintaan contoh

GET /?prefix=my&marker=mybucket&max-keys=10 HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: cn-hangzhou-internal.oss-vectors.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respons contoh

HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-type: application/json
Content-Length: 545
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****

{
  "ListAllMyBucketsResult": {
    "Prefix": "my",
    "Marker": "mybucket",
    "MaxKeys": 10,
    "IsTruncated": true,
    "NextMarker": "mybucket10",
    "Buckets": [
        {
          "CreationDate": "2014-02-07T18:12:43.000Z",
          "ExtranetEndpoint": "cn-shanghai.oss-vectors.aliyuncs.com",
          "IntranetEndpoint": "cn-shanghai-internal.oss-vectors.aliyuncs.com",
          "Location": "oss-cn-shanghai",
          "Name": "acs:ossvector:cn-shanghai:103735**********:test-bucket-3",
          "Region": "cn-shanghai"
        },
        {
          "CreationDate": "2014-02-05T11:21:04.000Z",
          "ExtranetEndpoint": "cn-shanghai.oss-vectors.aliyuncs.com",
          "IntranetEndpoint": "cn-shanghai-internal.oss-vectors.aliyuncs.com",
          "Location": "oss-cn-hangzhou",
          "Name": "acs:ossvector:cn-shanghai:103735**********:test-bucket-4",
          "Region": "cn-hangzhou"
        }
    ]
  }
}

SDK

Anda dapat memanggil operasi ListVectorBuckets menggunakan SDK berikut:

Alat baris perintah ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ListVectorBuckets, lihat list-vector-buckets.

Kode error

Error code	HTTP status code	Description
AccessDenied	403	Permintaan bersifat anonim karena tidak menyertakan informasi autentikasi pengguna.