ListVectorBuckets API 呼び出しによるベクトルバケットの一覧表示 - OSS

この API を呼び出して、ご利用の Alibaba Cloud アカウントに属するすべてのベクターバケットを一覧表示します。また、プレフィックス、マーカー、または max-keys パラメーターを指定することで、結果をフィルター処理することもできます。

権限

デフォルトでは、Alibaba Cloud アカウント（root ユーザー）はすべての権限を持ちます。一方、RAM ユーザーおよび RAM ロールは、デフォルトで権限を持ちません。権限を付与するには、Alibaba Cloud アカウントまたはアカウント管理者が、RAM ユーザーまたはロールに対して RAM ポリシーまたはバケットポリシーをアタッチする必要があります。

API	Action	説明
ListVectorBuckets	`oss:ListVectorBuckets`	ベクターバケットを一覧表示します。

リクエスト構文

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

リクエストヘッダー

この操作では、共通リクエストヘッダーのみを使用します。

リクエストパラメーター

名前	型	必須	例	説明
prefix	String	いいえ	my	ベクターバケット名に含める必要があるプレフィックスです。このプレフィックスで始まるベクターバケットのみが返されます。
marker	String	いいえ	mybucket	アルファベット順で、マーカーの次のエントリから結果のリスト表示を開始します。
max-keys	値	いいえ	100	返されるベクターバケットの最大数です。有効な値：1～1000。デフォルト値：100。

応答ヘッダー

この操作では、共通応答ヘッダーのみが返されます。

応答要素

説明

ListBuckets (GetService) を呼び出した場合、すべてのバケットが返されたときは、応答 JSON に Prefix、Marker、MaxKeys、IsTruncated、NextMarker 要素は含まれません。

名前	型	例	説明
ListAllMyBucketsResult	コンテナー	該当なし	ListVectorBuckets 応答のコンテナーです。
Prefix	String	my	このクエリで使用したプレフィックスです。親ノード：ListAllMyBucketsResult
Marker	String	mybucket	この ListVectorBuckets リクエストの開始位置です。親ノード：ListAllMyBucketsResult
MaxKeys	値	10	応答で返されるエントリの最大数です。親ノード：ListAllMyBucketsResult
IsTruncated	ブール値	true	すべての結果が返されたかどうかを示します。有効な値： true：すべての結果が返されていません。 false：すべての結果が返されています。親ノード：ListAllMyBucketsResult
NextMarker	String	mybucket10	次のリクエストで使用するマーカーです。残りの結果を取得するには、次の ListVectorBuckets リクエストで、marker パラメーターをこの値に設定してください。親ノード：ListAllMyBucketsResult
Buckets	コンテナー	該当なし	複数のベクターバケットに関する情報を格納するコンテナーです。親ノード：ListAllMyBucketsResult
Name	String	acs:ossvector:cn-shanghai:103735**********:test-bucket-3	ベクターバケットの識別子です。バケット ARN を返します。親ノード：Buckets
CreationDate	String	2014-02-07T18:12:43.000Z	ベクターバケットが作成された時刻です。親ノード：Buckets
ExtranetEndpoint	String	cn-shanghai.oss-vectors.aliyuncs.com	ベクターバケットのパブリックエンドポイントです。親ノード：Buckets
IntranetEndpoint	String	cn-shanghai-internal.oss-vectors.aliyuncs.com	ベクターバケットの内部エンドポイントです。親ノード：Buckets
Location	String	oss-cn-shanghai	OSS 専用のリージョン ID です。親ノード：Buckets
Region	String	cn-shanghai	Alibaba Cloud の汎用リージョン 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.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 コマンド

ossutil を使用して ListVectorBuckets を呼び出す方法については、「list-vector-buckets」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
AccessDenied	403	匿名リクエストであり、ユーザー認証情報が含まれていません。