All Products
Search

This Product

    Object Storage Service:GetVectorBucket

    Document Center

    Object Storage Service:GetVectorBucket

    Last Updated:Jun 23, 2026

    Retrieves detailed information about a vector bucket, such as the creation time, endpoints, location, and bucket ARN.

    Permissions

    An Alibaba Cloud account has all permissions by default. RAM users and RAM roles have no permissions by default. An account owner or administrator must grant the required permissions by using a RAM policy overview or a bucket policy.

    API

    Action

    Description

    GetVectorBucket

    oss:GetVectorBucket

    Gets information about a vector bucket.

    Request syntax

    Get /?bucketInfo HTTP/1.1
Host: examplebucket-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 HTTP headers.

    Response headers

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

    Response elements

    Name

    Type

    Example

    Description

    BucketInfo

    Container

    N/A

    The container that stores vector bucket information.

    CreationDate

    String

    2013-07-31T10:56:21.000Z

    The time when the vector bucket was created, in GMT.

    Parent node: BucketInfo

    ExtranetEndpoint

    String

    cn-hangzhou.oss-vectors.aliyuncs.com

    The public endpoint of the vector bucket.

    Parent node: BucketInfo

    IntranetEndpoint

    String

    cn-hangzhou-internal.oss-vectors.aliyuncs.com

    The internal endpoint of the vector bucket.

    Parent node: BucketInfo

    Location

    String

    oss-cn-hangzhou

    The region of the vector bucket. The value is an OSS-specific region ID.

    Parent node: BucketInfo

    Region

    String

    cn-hangzhou

    The region of the vector bucket. The value is a common Alibaba Cloud region ID.

    Parent node: BucketInfo

    Name

    String

    acs:ossvector:cn-shanghai:103735**********:test-bucket-3

    The identity of the vector bucket, expressed as a bucket ARN.

    Parent node: BucketInfo

    Examples

    Sample request

    Get /?bucketInfo HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com  
Date: Thu, 17 Apr 2025 07:51:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Sample response

    HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2025 07:51:28 GMT
Connection: keep-alive
Content-Length: 531  
Server: AliyunOSS
{
  "BucketInfo": {
      "CreationDate": "2013-07-31T10:56:21.000Z",
      "ExtranetEndpoint": "cn-hangzhou.oss-vectors.aliyuncs.com",
      "IntranetEndpoint": "cn-hangzhou-internal.oss-vectors.aliyuncs.com",
      "Location": "oss-cn-hangzhou",
      "Name": "acs:ossvector:cn-shanghai:103735**********:examplebucket",
      "Region": "cn-hangzhou"
    }
}

    SDK

    The following SDKs support the GetVectorBucket operation:

    ossutil command line interface

    For information about the ossutil command for the GetVectorBucket operation, see get-vector-bucket.

    Error codes

    Error code

    HTTP status code

    Description

    NoSuchBucket

    404

    The specified vector bucket does not exist.

    AccessDenied

    403

    You do not have permission to view the bucket information. Only the bucket owner can view the bucket information.

    InvalidVectorBucketName

    400

    The vector bucket name does not follow the naming conventions.