全部产品
Search
文档中心

Object Storage Service:ListResourcePoolBuckets

更新时间:Jun 26, 2025

Gunakan operasi ListResourcePoolBuckets untuk mengambil daftar Bucket OSS dalam resource pool yang ditentukan.

Catatan

  • QoS Resource Pool berada dalam pratinjau undangan. Jika throughput Bucket OSS Anda di suatu wilayah telah mencapai atau melebihi 500 Gbit/s, Anda dapat menghubungi dukungan teknis untuk mengajukan fitur ini.

  • Secara default, akun Alibaba Cloud memiliki izin untuk mengambil daftar Bucket OSS dalam resource pool tertentu. Untuk mengakses daftar ini melalui pengguna RAM atau Security Token Service, Anda harus memiliki izin oss:ListResourcePoolBuckets. Untuk instruksi terperinci, lihat contoh umum kebijakan RAM.

Sintaks permintaan

GET /?resourcePoolBuckets&resourcePool=ResourcePoolName&max-keys=2&continuation-token=abc
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Header permintaan

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

Elemen permintaan

Nama

Tipe

Diperlukan

Nilai contoh

Deskripsi

resourcePool

String

Ya

resource-pool-for-ai

Nama dari resource pool.

max-keys

Integer

Tidak

10

Jumlah maksimum bucket yang akan dikembalikan dalam permintaan ini.

continuation-token

String

Tidak

rp-bucket-01

Bucket tempat mulai mengembalikan informasi.

Header respons

Operasi ini hanya menggunakan header respons umum. Untuk informasi lebih lanjut, lihat header respons umum.

Elemen respons

Nama

Tipe

Nilai contoh

Deskripsi

ListResourcePoolBucketsResult

Container

N/A

Kontainer yang menyimpan hasil permintaan.

Node induk: tidak ada

ContinuationToken

String

abcd

ContinuationToken yang digunakan dalam permintaan ListResourcePoolBuckets ini.

Node induk: ListResourcePoolBucketsResult

NextContinuationToken

String

xyz

Menunjukkan bahwa permintaan ListResourcePoolBuckets ini berisi hasil selanjutnya. Nilai NextContinuationToken digunakan sebagai nilai ContinuationToken untuk menanyakan hasil selanjutnya.

Node induk: ListResourcePoolBucketsResult

IsTruncated

Nilai Boolean

true

Menunjukkan apakah hasil yang diminta dipotong.

  • true menunjukkan bahwa tidak semua hasil dikembalikan kali ini.

  • false menunjukkan bahwa semua hasil dikembalikan kali ini.

Node induk: ListResourcePoolBucketsResult

ResourcePoolBucket

Container

N/A

Kontainer yang menyimpan hasil daftar bucket dalam resource pool.

Node induk: ListResourcePoolBucketsResult

Name

String

rp-bucket-01

Nama bucket.

Node induk: ResourcePoolBucket

Group

String

test-group-1

Nama grup bucket.

JoinTime

String

2024-11-29T08:42:32.000Z

Waktu ketika bucket bergabung dengan resource pool, dalam format ISO8601.

Node induk: ResourcePoolBucket

Contoh

  • Contoh kueri

    GET /?resourcePoolBuckets&resourcePool=resource-pool-for-ai&continuation-token=abc&maxKeys=2
    Host: oss-cn-hangzhou.aliyuncs.com
    Date: Fri, 27 Dec 2024 03:21:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • Contoh respons sukses

    HTTP/1.1 200 OK
    Date: Sun, 11 Aug 2024 17:45:00 GMT
    Content-Length: 510
    Content-Type: application/xml
    
    <?xml version="1.0" encoding="UTF-8"?>
    <ListResourcePoolBucketsResult>
      <ResourcePool>resource-pool-for-ai</ResourcePool>
      <ContinuationToken>abcd</ContinuationToken>
      <NextContinuationToken>defg</NextContinuationToken>
      <IsTruncated>true</IsTruncated>
      <ResourcePoolBucket>
        <Name>rp-bucket-01</Name>
        <Group>test-group-1</Group>
        <JoinTime>2024-11-29T08:42:32.000Z</JoinTime>
      </ResourcePoolBucket>
      <ResourcePoolBucket>
        <Name>rp-bucket-02</Name>
        <Group>test-group-1</Group>
        <JoinTime>2024-11-29T08:42:32.000Z</JoinTime>
      </ResourcePoolBucket>
    </ListResourcePoolBucketsResult>

SDK OSS

Anda dapat menggunakan SDK OSS untuk bahasa pemrograman berikut untuk memanggil ListResourcePoolBuckets:

Alat baris perintah ossutil

Untuk perintah ossutil yang sesuai dengan operasi ListResourcePoolBuckets, lihat list-resource-pool-buckets.