Recupera informações detalhadas sobre um vector bucket, como data de criação, endpoints, localização e ARN do bucket.
Permissões
Uma conta Alibaba Cloud tem todas as permissões por padrão. Usuários e funções RAM não têm permissões por padrão. O proprietário ou administrador da conta deve conceder as permissões necessárias por meio de uma visão geral de políticas RAM ou de uma política de bucket.
|
API |
Ação |
Descrição |
|
GetVectorBucket |
|
Obtém informações sobre um vector bucket. |
Sintaxe da requisição
Get /?bucketInfo HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Cabeçalhos da requisição
Esta operação usa apenas cabeçalhos de requisição comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.
Cabeçalhos da resposta
Esta operação usa apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.
Elementos da resposta
|
Nome |
Tipo |
Exemplo |
Descrição |
|
BucketInfo |
Container |
N/A |
Container que armazena as informações do vector bucket. |
|
CreationDate |
String |
2013-07-31T10:56:21.000Z |
Data e hora de criação do vector bucket, em GMT. Nó pai: BucketInfo |
|
ExtranetEndpoint |
String |
cn-hangzhou.oss-vectors.aliyuncs.com |
Endpoint público do vector bucket. Nó pai: BucketInfo |
|
IntranetEndpoint |
String |
cn-hangzhou-internal.oss-vectors.aliyuncs.com |
Endpoint interno do vector bucket. Nó pai: BucketInfo |
|
Location |
String |
oss-cn-hangzhou |
Região do vector bucket. O valor é um ID de região específico do OSS. Nó pai: BucketInfo |
|
Region |
String |
cn-hangzhou |
Região do vector bucket. O valor é um ID de região comum da Alibaba Cloud. Nó pai: BucketInfo |
|
Name |
String |
acs:ossvector:cn-shanghai:103735:test-bucket-3 |
Identidade do vector bucket, expressa como ARN de bucket. Nó pai: BucketInfo |
Exemplos
Exemplo de requisição
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
Exemplo de resposta
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
Os SDKs a seguir oferecem suporte à operação GetVectorBucket:
Interface de linha de comando ossutil
Para obter informações sobre o comando ossutil da operação GetVectorBucket, consulte get-vector-bucket.
Códigos de erro
|
Código de erro |
Código de status HTTP |
Descrição |
|
NoSuchBucket |
404 |
O vector bucket especificado não existe. |
|
AccessDenied |
403 |
Permissão insuficiente para visualizar as informações do bucket. Somente o proprietário pode visualizá-las. |
|
InvalidVectorBucketName |
400 |
O nome do vector bucket não segue as convenções de nomenclatura. |