ListVectorBuckets - Object Storage Service

Panggil ListVectorBuckets untuk menampilkan semua vector bucket dalam Akun Alibaba Cloud Anda. Anda juga dapat memfilter hasil dengan menentukan parameter prefix, marker, atau max-keys.

Permissions

Secara default, Akun Alibaba Cloud memiliki izin penuh. Pengguna RAM dan role RAM tidak memiliki izin secara default. Untuk memberikan izin, Akun Alibaba Cloud atau administrator akun harus menyambungkan RAM Policy atau Bucket Policy ke pengguna atau role RAM tersebut.

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

Sintaksis permintaan

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

Request headers

Operasi ini hanya menggunakan Common request headers.

Parameter permintaan

Name	Type	Required	Example	Description
prefix	String	No	my	Awalan yang harus dimiliki oleh nama vector bucket. Hanya vector bucket yang namanya diawali dengan awalan ini yang dikembalikan.
marker	String	No	mybucket	Mulai menampilkan hasil dari entri pertama yang mengikuti marker, dalam urutan alfabetis.
max-keys	Value	No	100	Jumlah maksimum vector bucket yang dikembalikan. Nilai valid: 1 hingga 1000. Nilai default: 100.

Response headers

Operasi ini hanya mengembalikan Common response headers.

Elemen respons

Catatan

Ketika Anda memanggil ListBuckets (GetService), respons JSON tidak menyertakan elemen Prefix, Marker, MaxKeys, IsTruncated, atau NextMarker jika semua bucket telah dikembalikan.

Name	Type	Example	Description
ListAllMyBucketsResult	Container	N/A	Container untuk respons ListVectorBuckets.
Prefix	String	my	Awalan yang digunakan dalam kueri ini. Parent node: ListAllMyBucketsResult
Marker	String	mybucket	Posisi awal permintaan ListVectorBuckets ini. Parent node: ListAllMyBucketsResult
MaxKeys	Value	10	Jumlah maksimum entri yang dikembalikan dalam respons. Parent node: ListAllMyBucketsResult
IsTruncated	Boolean	true	Menunjukkan apakah semua hasil telah dikembalikan. Nilai valid: true: Tidak semua hasil dikembalikan. false: Semua hasil telah dikembalikan. Parent node: ListAllMyBucketsResult
NextMarker	String	mybucket10	Marker yang digunakan dalam permintaan berikutnya. Tetapkan parameter marker ke nilai ini pada permintaan ListVectorBuckets berikutnya untuk mengambil sisa hasil. Parent node: ListAllMyBucketsResult
Buckets	Container	N/A	Container untuk informasi tentang multiple vector bucket. Parent node: ListAllMyBucketsResult
Name	String	acs:ossvector:cn-shanghai:103735**********:test-bucket-3	Identifier vector bucket. Mengembalikan ARN bucket. Parent node: Buckets
CreationDate	String	2014-02-07T18:12:43.000Z	Waktu saat vector bucket dibuat. Parent node: Buckets
ExtranetEndpoint	String	cn-shanghai.oss-vectors.aliyuncs.com	Titik akhir publik vector bucket. Parent node: Buckets
IntranetEndpoint	String	cn-shanghai-internal.oss-vectors.aliyuncs.com	Titik akhir internal vector bucket. Parent node: Buckets
Location	String	oss-cn-shanghai	ID wilayah khusus untuk OSS. Parent node: Buckets
Region	String	cn-shanghai	ID wilayah umum Alibaba Cloud. Parent node: 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.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

Gunakan salah satu SDK berikut untuk memanggil ListVectorBuckets:

Perintah ossutil

Untuk memanggil ListVectorBuckets menggunakan ossutil, lihat list-vector-buckets.

Kode error

Error code	HTTP status code	Description
AccessDenied	403	Permintaan bersifat anonim dan tidak berisi informasi otentikasi pengguna.