全部產品
Search
文件中心

Object Storage Service:PutVectorBucket

更新時間:Sep 25, 2025

調用PutVectorBucket介面建立向量 Bucket。

注意事項

單個 UID 在單個地區最多建立 10 個向量 Bucket。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM PolicyBucket Policy授予操作許可權。

API

Action

說明

PutVectorBucket

oss:PutVectorBucket

建立向量Bucket。單一 UID 在同地區內的 Vector Bucket 命名具有唯一性,長度 3~32 個字元。只允許小寫字母、數字、虛線(-),且不能以虛線開頭或結尾。

請求文法

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

要求標頭

此介面僅包含公用要求標頭。更多資訊,請參見公用HTTP頭定義

回應標頭

名稱

類型

樣本值

描述

Location

字串

/examplebucket

向量Bucket的地址。由/加上向量Bucket名稱組成。

預設值:無

此介面還涉及其他公用回應標頭。更多資訊,請參見公用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

錯誤碼

錯誤碼

HTTP狀態代碼

描述

InvalidVectorBucketName

400

建立向量Bucket時,定義的名稱不符合命名規範。

AccessDenied

403

返回該錯誤的可能原因如下:

  • 發起PutBucket請求時沒有傳入使用者驗證資訊。

  • 沒有操作許可權。

TooManyBuckets

400

建立的向量Bucket數量超過上限。同一阿里雲帳號在同一地區(Region)內最多可建立10個向量Bucket。

BucketNameNotAvailable

409

  • 在Bucket已刪除的情況下,建立相同名稱的Bucket的時間不符合要求。

    刪除Bucket後,需要等待數小時(通常為4~8小時)才能再次建立同名的Bucket。

  • 在Bucket已存在的情況下,使用RAM使用者或者STS等方式調用PutBucket再次重複建立相同名稱的Bucket。

    僅支援使用阿里雲帳號再次重複建立相同名稱Bucket。