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

Object Storage Service:PutVectorBucket

最終更新日:Jan 10, 2026

PutVectorBucket 操作を呼び出して、ベクターバケットを作成します。

注意事項

1 つの Alibaba Cloud アカウントで、1 つのリージョンに最大 10 個のベクターバケットを作成できます。 このクォータの引き上げを希望する場合は、テクニカルサポートまでご連絡ください。

権限

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

API

アクション

説明

PutVectorBucket

oss:PutVectorBucket

ベクターバケットを作成します。 ベクターバケットの名前は、同一リージョン内の UID に対して一意である必要があります。 名前の長さは 3~32 文字である必要があります。 小文字、数字、ハイフン (-) のみ使用できます。 名前をハイフンで始めることも、終えることもできません。

リクエスト構文

PUT / HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

名前

タイプ

説明

Location

String

/examplebucket

ベクターバケットのアドレス。 アドレスは、スラッシュ (/) の後にベクターバケット名が続く形式です。

デフォルト値:なし

この API には、他の共通レスポンスヘッダーも含まれます。 詳細については、「共通 HTTP ヘッダーの定義」をご参照ください。

リクエスト例

PUT / HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 03:15:40 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

レスポンス例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
Location: /examplebucket

SDK

PutVectorBucket 操作は、次の SDK でサポートされています。

ossutil コマンドラインインターフェイス

PutVectorBucket 操作に対応する ossutil コマンドについては、「put-vector-bucket」をご参照ください。

エラーコード

エラーコード

HTTP ステータスコード

説明

InvalidVectorBucketName

400

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

AccessDenied

403

このエラーは、次のいずれかの理由で返されます。

  • バケット作成リクエストにユーザー認証情報が含まれていません。

  • この操作に必要な権限がありません。

TooManyBuckets

400

作成したベクターバケットの数が上限に達しました。 1 つの Alibaba Cloud アカウントで、同一リージョンに作成できるベクターバケットは最大 10 個です。

BucketNameNotAvailable

409

  • 最近削除されたバケットと同じ名前のバケットを、短時間のうちに作成しようとしています。

    バケットが削除された後、同じ名前の別のバケットを作成する前に、数時間 (通常は 4~8 時間) 待つ必要があります。

  • RAM ユーザーまたは Security Token Service (STS) を使用して、既存のバケットを作成しようとしています。

    バケットを所有する Alibaba Cloud アカウントのみが、同じ名前のバケットを再度作成するリクエストを行うことができます。