GetVectorBucket API は、ベクターバケットの詳細情報を取得します。
権限
デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Resource Access Management (RAM) ユーザーおよび RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントの所有者または管理者は、RAM ポリシーの概要またはバケットポリシーを使用して、この操作の権限を付与する必要があります。
|
API |
アクション |
説明 |
|
GetVectorBucket |
|
ベクターバケットの情報を取得します。 |
リクエスト構文
Get /?bucketInfo HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
リクエストヘッダー
この操作では、共通のリクエストヘッダーのみを使用します。 詳細については、「共通 HTTP ヘッダー」をご参照ください。
レスポンスヘッダー
この操作では、共通のレスポンスヘッダーのみを使用します。 詳細については、「共通 HTTP ヘッダー」をご参照ください。
レスポンス要素
|
名前 |
タイプ |
例 |
説明 |
|
BucketInfo |
Container |
N/A |
ベクターバケットの情報を格納するコンテナーです。 |
|
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-hangzhou:103735**********:test-bucket-3 |
ベクターバケットの ID です。 この値はバケット ARN です。 親ノード: BucketInfo |
例
リクエストの例
Get /?bucketInfo HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.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-hangzhou:103735**********:test-bucket-3",
"Region": "cn-hangzhou"
}
}
SDK
以下の SDK が GetVectorBucket API をサポートしています。
ossutil コマンドラインインターフェイス
GetVectorBucket 操作の ossutil コマンドについては、「get-vector-bucket」をご参照ください。
エラーコード
|
エラーコード |
HTTP ステータスコード |
説明 |
|
NoSuchBucket |
404 |
指定されたベクターバケットは存在しません。 |
|
AccessDenied |
403 |
バケット情報を表示する権限が拒否されました。 バケット所有者のみがバケット情報を表示できます。 |
|
InvalidVectorBucketName |
400 |
ベクターバケットの名前が命名規則に従っていません。 |