ListVectorBuckets - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

İzinler

Varsayılan olarak Alibaba Cloud hesabı kendi kaynakları üzerinde tam izinlere sahiptir. RAM kullanıcıları ve RAM rolleri varsayılan olarak hiçbir izne sahip değildir. Bir RAM kullanıcısının veya RAM rolünün bu işlemi çağırabilmesi için bir Alibaba Cloud hesabının veya RAM yöneticisinin gerekli izinleri ilgili RAM kullanıcısına veya rolüne bir RAM ilkesi veya bir paket ilkesi ile vermesi gerekir.

API	Action	Description
ListVectorBuckets	`oss:ListVectorBuckets`	Vector paketlerini listeler.

İstek sözdizimi

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

İstek üst bilgileri

Bu işlem yalnızca ortak istek üst bilgilerini kullanır. Daha fazla bilgi için bkz. Ortak HTTP Üst Bilgileri.

İstek parametreleri

Parameter	Type	Required	Example	Description
prefix	String	No	my	Döndürülen vector paketi adlarının başlaması gereken ön ek.
marker	String	No	mybucket	Sonuç kümesinin başlangıç konumu. Sonuçlar, belirtilen işaretleyiciden hemen sonraki girdiden başlayarak alfabetik sırayla döndürülür.
max-keys	Number	No	100	Döndürülecek maksimum vector paketi sayısı. Geçerli değerler: 1-1000. Varsayılan değer: 100.

Yanıt üst bilgileri

Bu işlem yalnızca ortak yanıt üst bilgilerini kullanır. Daha fazla bilgi için bkz. Ortak HTTP Üst Bilgileri.

Yanıt öğeleri

Not

ListVectorBuckets işlemini çağırdığınızda tüm paketler döndürülüyorsa yanıt Prefix, Marker, MaxKeys, IsTruncated ve NextMarker yanıt öğelerini içermez.

Parameter	Type	Example	Description
ListAllMyBucketsResult	Container	N/A	ListVectorBuckets yanıtı için kapsayıcı.
Prefix	String	my	İstekte belirtilen ön ek. Üst düğüm: ListAllMyBucketsResult
Marker	String	mybucket	ListVectorBuckets sorgusu için başlangıç konumu. Üst düğüm: ListAllMyBucketsResult
MaxKeys	Number	10	Yanıta dahil edilecek maksimum vector paketi sayısı. Üst düğüm: ListAllMyBucketsResult
IsTruncated	Boolean	true	Tüm vector paketlerinin döndürülüp döndürülmediğini belirtir. Geçerli değerler: true: Tüm vector paketleri döndürülmemiştir. false: Tüm vector paketleri döndürülmüştür. Üst düğüm: ListAllMyBucketsResult
NextMarker	String	mybucket10	IsTruncated değeri true ise bu öğe sonraki sayfanın işaretleyicisini gösterir. Sonraki sayfayı almak için bu değeri sonraki bir ListVectorBuckets isteğinde `marker` parametresi olarak kullanın. Üst düğüm: ListAllMyBucketsResult
Buckets	Container	N/A	Vector paketi ayrıntıları için kapsayıcı. Üst düğüm: ListAllMyBucketsResult
Name	String	acs:ossvector:cn-shanghai:103735:test-bucket-3	Bir paket ARN'si olarak döndürülen vector paketi tanımlayıcısı. Üst düğüm: Buckets
CreationDate	String	2014-02-07T18:12:43.000Z	Vector paketinin oluşturulma zamanı. Üst düğüm: Buckets
ExtranetEndpoint	String	cn-shanghai.oss-vectors.aliyuncs.com	Vector paketinin genel uç noktası. Üst düğüm: Buckets
IntranetEndpoint	String	cn-shanghai-internal.oss-vectors.aliyuncs.com	Vector paketinin dahili uç noktası. Üst düğüm: Buckets
Location	String	oss-cn-shanghai	OSS'e özel bölge kimliği. Üst düğüm: Buckets
Region	String	cn-shanghai	Genel amaçlı Alibaba Cloud bölge kimliği. Üst düğüm: Buckets

Örnekler

Örnek istek

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

Örnek yanıt

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

ListVectorBuckets işlemini aşağıdaki SDK'ları kullanarak çağırabilirsiniz:

ossutil komut satırı aracı

ListVectorBuckets işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. list-vector-buckets.

Hata kodları

Error code	HTTP status code	Description
AccessDenied	403	İstek, kimlik doğrulama bilgileri eksik olduğu için reddedilir.