Use the PutVectorBucket API to create a vector bucket - Object Storage Service - Alibaba Cloud - Object Storage Service

Notes

An Alibaba Cloud account can create a maximum of 100 vector buckets in a single region. To increase this quota, contact technical support.

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.