GetVectorBucket 操作を呼び出して、ベクターバケットの詳細情報を取得します。
権限
Alibaba Cloud アカウント (root ユーザー) はデフォルトで完全な管理権限を持ちます。RAM ユーザーおよび RAM ロールは、デフォルトで権限を持ちません。Alibaba Cloud アカウントまたは管理者が、RAM ポリシー または バケットポリシー を使用して権限を付与する必要があります。
API | Action | 説明 |
GetVectorBucket |
| ベクターバケットの情報を取得します。 |
リクエスト構文
GET /?bucketInfo HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: GMT 日付
Authorization: SignatureValueリクエストヘッダー
この操作では、共通のリクエストヘッダーのみを使用します。詳細については、「共通の HTTP ヘッダー」をご参照ください。
レスポンスヘッダー
この操作では、共通のレスポンスヘッダーのみを使用します。詳細については、「共通の HTTP ヘッダー」をご参照ください。
レスポンス要素
名前 | 型 | 例 | 説明 |
BucketInfo | コンテナー | 該当なし | ベクターバケットの情報を格納するコンテナーです。 |
CreationDate | String | 2013-07-31T10:56:21.000Z | ベクターバケットが作成された時刻(GMT 形式)です。 親ノード:BucketInfo |
ExtranetEndpoint | String | cn-hangzhou.oss-vectors.aliyuncs.com | ベクターバケットにアクセスするためのパブリックエンドポイントです。 親ノード:BucketInfo |
IntranetEndpoint | String | cn-hangzhou-internal.oss-vectors.aliyuncs.com | ベクターバケットにアクセスするための内部エンドポイントです。 親ノード:BucketInfo |
Location | String | oss-cn-hangzhou | OSS 固有のリージョン ID 形式で表される、ベクターバケットが配置されているリージョンです。 親ノード:BucketInfo |
Region | String | cn-hangzhou | Alibaba Cloud 全般のリージョン ID 形式で表される、ベクターバケットが配置されているリージョンです。 親ノード:BucketInfo |
Name | String | acs:ossvector:cn-shanghai:103735**********:test-bucket-3 | ベクターバケットの ID(ARN 形式で返されます)です。 親ノード:BucketInfo |
例
リクエストの例
GET /?bucketInfo HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 07:51:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eレスポンスの例
HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2025 07:51:28 GMT
Connection: keep-alive
Content-Length: 531
Server: AliyunOSS
{
"BucketInfo": {
"CreationDate": "2013-07-31T10:56:21.000Z",
"ExtranetEndpoint": "cn-hangzhou.oss-vectors.aliyuncs.com",
"IntranetEndpoint": "cn-hangzhou-internal.oss-vectors.aliyuncs.com",
"Location": "oss-cn-hangzhou",
"Name": "acs:ossvector:cn-shanghai:103735**********:examplebucket",
"Region": "cn-hangzhou"
}
}SDK
以下の SDK で GetVectorBucket 操作がサポートされています。
ossutil コマンドラインツール
GetVectorBucket 操作に対応する ossutil コマンドの詳細については、「get-vector-bucket」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
NoSuchBucket | 404 | 指定されたベクターバケットが存在しません。 |
AccessDenied | 403 | このバケットの情報を表示する権限がありません。バケットのオーナーのみが情報を表示できます。 |
InvalidVectorBucketName | 400 | ベクターバケット名が命名要件を満たしていません。 |