ListVectorBuckets - Object Storage Service

Operasi ListVectorBuckets mencantumkan semua bucket vektor dalam akun Anda. Anda juga dapat menetapkan parameter `prefix`, `marker`, atau `max-keys` untuk mencantumkan bucket vektor yang memenuhi kondisi tertentu.

Izin

Akun Alibaba Cloud memiliki semua izin secara default. Pengguna Resource Access Management (RAM) atau Peran RAM tidak memiliki izin secara default. Akun Alibaba Cloud atau administrator harus memberikan izin melalui Kebijakan RAM atau Kebijakan Bucket.

API	Action	Deskripsi
ListVectorBuckets	`oss:ListVectorBuckets`	Mencantumkan bucket vektor.

Sintaks permintaan

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

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Parameter permintaan

Nama	Tipe	Diperlukan	Contoh	Deskripsi
prefix	String	Tidak	my	Awalan yang harus terkandung dalam nama bucket vektor. Hanya bucket vektor yang namanya mengandung awalan ini yang dikembalikan.
marker	String	Tidak	mybucket	Posisi dari mana kueri dimulai. Hasil dikembalikan dalam urutan abjad, mulai dari entri setelah marker.
max-keys	Nilai	Tidak	100	Jumlah maksimum bucket vektor yang akan dikembalikan. Rentang nilai: 1 hingga 1.000. Nilai default: 100.

Header tanggapan

Operasi ini hanya mengembalikan header tanggapan umum. Untuk informasi lebih lanjut, lihat Header Tanggapan Umum.

Elemen tanggapan

Catatan

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

Nama	Tipe	Contoh	Deskripsi
ListAllMyBucketsResult	Kontainer	N/A	Kontainer untuk hasil permintaan ListVectorBuckets.
Prefix	String	my	Awalan dari hasil kueri. Node induk: ListAllMyBucketsResult
Marker	String	mybucket	Posisi awal dari kueri ListVectorBuckets. Node induk: ListAllMyBucketsResult
MaxKeys	Nilai	10	Jumlah maksimum hasil yang dikembalikan dalam tanggapan. Node induk: ListAllMyBucketsResult
IsTruncated	Boolean	true	Menunjukkan apakah semua hasil telah dikembalikan. Nilai valid: true: Tidak semua hasil dikembalikan. false: Semua hasil dikembalikan. Node induk: ListAllMyBucketsResult
NextMarker	String	mybucket10	Penanda untuk digunakan pada kueri halaman berikutnya. Anda dapat menggunakan nilai ini untuk parameter `marker` dalam permintaan ListVectorBuckets berikutnya untuk mengambil halaman hasil berikutnya. Node induk: ListAllMyBucketsResult
Buckets	Kontainer	N/A	Kontainer untuk informasi tentang beberapa bucket vektor. Node induk: ListAllMyBucketsResult
Name	String	acs:ossvector:cn-shanghai:103735**********:test-bucket-3	Pengenal bucket vektor. ARN Bucket dikembalikan. Node induk: Buckets
CreationDate	String	2014-02-07T18:12:43.000Z	Waktu ketika bucket vektor dibuat. Node induk: Buckets
ExtranetEndpoint	String	cn-shanghai.oss-vectors.aliyuncs.com	Titik akhir publik bucket vektor. Node induk: Buckets
IntranetEndpoint	String	cn-shanghai-internal.oss-vectors.aliyuncs.com	Titik akhir internal bucket vektor. Node induk: Buckets
Location	String	oss-cn-shanghai	ID wilayah khusus untuk OSS. Node induk: Buckets
Region	String	cn-shanghai	ID wilayah tujuan umum Alibaba Cloud. Node induk: Buckets

Contoh

Permintaan Sampel

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

Tanggapan Sampel

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"
        }
    ]
  }
}

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
AccessDenied	403	Permintaan adalah permintaan anonim dan tidak berisi informasi otentikasi pengguna.