PutVectorBucket

调用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

字符串

/oss-example

向量Bucket的地址。由/加上向量Bucket名称组成。

默认值:无

此接口还涉及其他公共响应头。更多信息,请参见公共HTTP头定义

示例

请求示例

PUT / HTTP/1.1
Host: exampebucket-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: /oss-example

错误码

错误码

HTTP状态码

描述

InvalidBucketName

400

创建Bucket时,定义的Bucket名称不符合命名规范。

AccessDenied

403

返回该错误的可能原因如下:

  • 发起PutBucket请求时没有传入用户验证信息。

  • 没有操作权限。

TooManyBuckets

400

创建的Bucket数量超过上限。同一阿里云账号在同一地域(Region)内最多可创建100个 Bucket。

BucketAlreadyExists

409

  • Bucket已删除的情况下,创建相同名称的Bucket的时间不符合要求。

    删除Bucket后,需要等待数小时(通常为4~8小时)才能再次创建同名的Bucket。

  • Bucket已存在的情况下,使用RAM用户或者STS等方式调用PutBucket再次重复创建相同名称的Bucket。

    仅支持使用阿里云账号再次重复创建相同名称Bucket。

  • 没有权限调用PutBucketAcl接口。请确保通过Bucket Policy或者RAM Policy授予调用者oss:PutBucketAcl的权限。