GetVectorBucket

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy概述或Bucket Policy授予操作許可權。

API	Action	說明
GetVectorBucket	`oss: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的名稱不符合命名規範。