調用GetVectorBucket介面擷取向量Bucket的詳細資料。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
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的名稱不符合命名規範。 |