All Products
Search

This Product

    Object Storage Service:PutVectorBucket

    Document Center

    Object Storage Service:PutVectorBucket

    Last Updated:Jan 10, 2026

    Call the PutVectorBucket operation to create a vector bucket.

    Notes

    A single Alibaba Cloud account can create a maximum of 10 vector buckets in a single region. To increase this quota, contact Technical Support.

    Permissions

    By default, an Alibaba Cloud account has all permissions. A Resource Access Management (RAM) user or RAM role has no permissions by default. The Alibaba Cloud account owner or an administrator must grant permissions using 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.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 address of the vector bucket. The address consists of a forward slash (/) followed by the vector bucket name.

    Default value: none

    This API also includes other common response headers. For more information, see Common HTTP Header Definitions.

    Examples

    Request example

    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

    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 PutVectorBucket operation is supported by the following SDKs:

    ossutil command-line interface

    For the ossutil command that corresponds to the PutVectorBucket operation, see put-vector-bucket.

    Error codes

    Error code

    HTTP status code

    Description

    InvalidVectorBucketName

    400

    The specified name for the vector bucket does not follow the naming conventions.

    AccessDenied

    403

    This error is returned for the following possible reasons:

    • The request to create the bucket does not contain user authentication information.

    • You do not have the required permissions for the operation.

    TooManyBuckets

    400

    The number of vector buckets that you created has reached the upper limit. A single Alibaba Cloud account can create a maximum of 10 vector buckets in the same region.

    BucketNameNotAvailable

    409

    • You are trying to create a bucket with the same name as a recently deleted bucket too soon.

      After a bucket is deleted, you must wait for several hours, typically 4 to 8 hours, before you can create another bucket with the same name.

    • You are using 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 make a request to create a bucket with the same name again.