ListVectorBuckets

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy概述或Bucket Policy授予操作許可權。

API	Action	說明
ListVectorBuckets	`oss:ListVectorBuckets`	列舉向量Bucket。

請求文法

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

要求標頭

此介面僅包含公用要求標頭。更多資訊，請參見公用HTTP頭定義。

請求參數

名稱	類型	是否必選	樣本值	描述
prefix	字串	否	my	向量Bucket名稱的首碼匹配。只有向量Bucket名稱匹配該首碼的向量Bucket才會被返回。
marker	字串	否	mybucket	設定結果從marker之後按字母排序的第一個開始返回。
max-keys	數值	否	100	指定返迴向量Bucket的最大數目。取值範圍：1~1000，預設值：100。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用HTTP頭定義。

響應元素

說明

調用ListBuckets（GetService）介面時，如果所有Bucket已返回，則返回的JSON中不包含Prefix、Marker、MaxKeys、IsTruncated和NextMarker響應元素。

名稱	類型	樣本值	描述
ListAllMyBucketsResult	容器	不涉及	儲存ListVectorBuckets請求結果的容器。
Prefix	字串	my	本次查詢結果的首碼。父節點：ListAllMyBucketsResult
Marker	字串	mybucket	本次ListVectorBuckets的起點。父節點：ListAllMyBucketsResult
MaxKeys	數值	10	響應請求內返回結果的最大數目。父節點：ListAllMyBucketsResult
IsTruncated	布爾值	true	是否所有的結果都已經返回。取值範圍如下： true：表示本次沒有返回全部結果。 false：表示本次已經返回了全部結果。父節點：ListAllMyBucketsResult
NextMarker	字串	mybucket10	用於繼續查詢時給marker賦值。表示下一次ListVectorBuckets以此為marker，將未返回的結果返回。父節點：ListAllMyBucketsResult
Buckets	容器	不適用	儲存多個向量Bucket資訊的容器。父節點：ListAllMyBucketsResult
Name	字串	acs:ossvector:cn-shanghai:103735**********:test-bucket-3	向量 Bucket 的標識資訊，返回 Bucket ARN。父節點：Buckets
CreationDate	字串	2014-02-07T18:12:43.000Z	向量Bucket建立時間。父節點：Buckets
ExtranetEndpoint	字串	cn-shanghai.oss-vectors.aliyuncs.com	向量Bucket的公網訪問網域名稱。父節點：Buckets
IntranetEndpoint	字串	cn-shanghai-internal.oss-vectors.aliyuncs.com	向量Bucket的內網訪問網域名稱。父節點：Buckets
Location	字串	oss-cn-shanghai	OSS專用Region ID。父節點：Buckets
Region	字串	cn-shanghai	阿里雲通用Region ID。父節點：Buckets

樣本

請求樣本

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

返回樣本

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介面所對應的各語言SDK如下：

命令列工具ossutil

ListVectorBuckets介面所對應的ossutil命令，請參見list-vector-buckets。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
AccessDenied	403	請求中沒有使用者驗證資訊（即匿名訪問）。