调用GetVectorBucket接口获取向量Bucket的详细信息。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy概述或Bucket Policy授予操作权限。
|
API |
Action |
说明 |
|
GetVectorBucket |
|
获取向量Bucket信息。 |
请求语法
Get /?bucketInfo HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.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-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返回示例
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
GetVectorBucket接口所对应的各语言SDK如下：
命令行工具ossutil
GetVectorBucket接口所对应的ossutil命令，请参见get-vector-bucket。
错误码
|
错误码 |
HTTP状态码 |
描述 |
|
NoSuchBucket |
404 |
目标向量Bucket不存在。 |
|
AccessDenied |
403 |
没有查看该Bucket信息的权限。只有Bucket的拥有者才能查看Bucket的信息。 |
|
InvalidVectorBucketName |
400 |
向量Bucket的名称不符合命名规范。 |