Todos os produtos
Search
Central de documentação

Object Storage Service:GetVectorBucket

Última atualização: Jul 03, 2026

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

oss: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.