PutVectorBucket-Object Storage Service(OSS)-阿里云帮助中心

Notes

A single Alibaba Cloud account can create a maximum of 100 vector buckets in a region.

Permissions

An Alibaba Cloud account has all permissions by default. RAM users and RAM roles have no permissions by default and must be granted access through a RAM policy or a bucket policy.

API	Action	Description
PutVectorBucket	`oss:PutVectorBucket`	Creates a vector bucket. The name of a vector bucket must be unique for a UID within the same region. The name must be 3 to 32 characters in length. It can contain only lowercase letters, digits, and hyphens (-). The name cannot start or end with a hyphen.

Request syntax

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

Request headers

This operation uses only common request headers. For more information, see Common request headers.

Response headers

Name

Type

Example

Description

Location

String

/examplebucket

The vector bucket address, consisting of a forward slash (/) followed by the vector bucket name.

Default value: none

This operation also returns common response headers. For more information, see Common HTTP Header Definitions.

Examples

Request example

PUT / HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.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

Response example

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

The following SDKs support the PutVectorBucket operation:

ossutil command-line interface

For the corresponding ossutil command, see put-vector-bucket.

Error codes

Error code	HTTP status code	Description
InvalidVectorBucketName	400	The vector bucket name does not follow the naming conventions.
AccessDenied	403	Possible reasons: The request does not contain user authentication information. You do not have the required permissions.
TooManyBuckets	400	The number of vector buckets has reached the upper limit. A single Alibaba Cloud account can create a maximum of 10 vector buckets in the same region.
BucketNameNotAvailable	409	A bucket with the same name was recently deleted. You must wait several hours, typically 4 to 8 hours, before creating a bucket with the same name. You used a RAM user or Security Token Service (STS) to create a bucket that already exists. Only the Alibaba Cloud account that owns the bucket can create a bucket with the same name again.