すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetVectorBucket

最終更新日:May 31, 2026

GetVectorBucket API は、ベクターバケットの詳細情報を取得します。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Resource Access Management (RAM) ユーザーおよび RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントの所有者または管理者は、RAM ポリシーの概要またはバケットポリシーを使用して、この操作の権限を付与する必要があります。

API

アクション

説明

GetVectorBucket

oss: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

ベクターバケットの名前が命名規則に従っていません。