调用GetVectorBucket接口获取向量Bucket详细信息-对象存储-阿里云

调用GetVectorBucket接口获取向量Bucket的详细信息。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

API	Action	说明
GetVectorBucket	`oss:GetVectorBucket`	获取向量Bucket信息。

请求语法

Get /?bucketInfo HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息，请参见公共HTTP头定义。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共HTTP头定义。

响应元素

名称	类型	示例值	描述
BucketInfo	容器	不适用	保存向量Bucket信息的容器。
CreationDate	字符串	2013-07-31T10:56:21.000Z	向量Bucket的创建时间，格式为GMT时间。父节点：BucketInfo
ExtranetEndpoint	字符串	cn-hangzhou.oss-vectors.aliyuncs.com	向量Bucket的公网访问域名。父节点：BucketInfo
IntranetEndpoint	字符串	cn-hangzhou-internal.oss-vectors.aliyuncs.com	向量Bucket的内网访问域名。父节点：BucketInfo
Location	字符串	oss-cn-hangzhou	向量Bucket所在的地域，格式为OSS专用Region ID。父节点：BucketInfo
Region	字符串	cn-hangzhou	向量Bucket所在的地域，格式为阿里云通用Region ID。父节点：BucketInfo
Name	字符串	acs:ossvector:cn-shanghai:103735**********:test-bucket-3	向量 Bucket 的标识信息，返回 Bucket ARN。父节点：BucketInfo

示例

请求示例

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

返回示例

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"
    }
}

错误码

错误码	HTTP状态码	描述
NoSuchBucket	404	目标向量Bucket不存在。
AccessDenied	403	没有查看该Bucket信息的权限。只有Bucket的拥有者才能查看Bucket的信息。
InvalidVectorBucketName	400	向量Bucket的名称不符合命名规范。