ListVectorBuckets - Object Storage Service: Central de Documentação do Alibaba Cloud

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais sobre seus recursos. Usuários RAM e funções RAM não possuem permissões por padrão. Para permitir que um usuário RAM ou uma função RAM chame esta operação, uma conta Alibaba Cloud ou um administrador RAM deve conceder as permissões necessárias ao usuário ou à função RAM por meio de uma política do RAM ou de uma política de bucket.

API	Action	Descrição
ListVectorBuckets	`oss:ListVectorBuckets`	Lista vector buckets.

Sintaxe da solicitação

GET / HTTP/1.1
Host: cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

Esta operação utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
prefix	String	Não	my	Prefixo obrigatório nos nomes dos vector buckets retornados.
marker	String	Não	mybucket	Posição inicial do conjunto de resultados. Os resultados são retornados em ordem alfabética, a partir da entrada imediatamente posterior ao marker especificado.
max-keys	Number	Não	100	Número máximo de vector buckets a retornar. Valores válidos: 1 a 1000. Valor padrão: 100.

Cabeçalhos da resposta

Esta operação utiliza apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.

Elementos da resposta

Nota

Ao chamar a operação ListVectorBuckets, se todos os buckets forem retornados, a resposta não incluirá os elementos Prefix, Marker, MaxKeys, IsTruncated e NextMarker.

Parâmetro	Tipo	Exemplo	Descrição
ListAllMyBucketsResult	Container	N/A	Contêiner da resposta do ListVectorBuckets.
Prefix	String	my	Prefixo especificado na solicitação. Nó pai: ListAllMyBucketsResult
Marker	String	mybucket	Posição inicial da consulta ListVectorBuckets. Nó pai: ListAllMyBucketsResult
MaxKeys	Number	10	Número máximo de vector buckets a retornar na resposta. Nó pai: ListAllMyBucketsResult
IsTruncated	Boolean	true	Indica se todos os vector buckets foram retornados. Valores válidos: true: Nem todos os vector buckets foram retornados. false: Todos os vector buckets foram retornados. Nó pai: ListAllMyBucketsResult
NextMarker	String	mybucket10	Se IsTruncated for true, este elemento indica o marker da próxima página. Use este valor como parâmetro `marker` em uma solicitação ListVectorBuckets subsequente para recuperar a próxima página. Nó pai: ListAllMyBucketsResult
Buckets	Container	N/A	Contêiner dos detalhes dos vector buckets. Nó pai: ListAllMyBucketsResult
Name	String	acs:ossvector:cn-shanghai:103735:test-bucket-3	Identificador do vector bucket, retornado como ARN de bucket. Nó pai: Buckets
CreationDate	String	2014-02-07T18:12:43.000Z	Data de criação do vector bucket. Nó pai: Buckets
ExtranetEndpoint	String	cn-shanghai.oss-vectors.aliyuncs.com	Endpoint público do vector bucket. Nó pai: Buckets
IntranetEndpoint	String	cn-shanghai-internal.oss-vectors.aliyuncs.com	Endpoint interno do vector bucket. Nó pai: Buckets
Location	String	oss-cn-shanghai	ID da região específica do OSS. Nó pai: Buckets
Region	String	cn-shanghai	ID da região de uso geral da Alibaba Cloud. Nó pai: Buckets

Exemplos

Solicitação de exemplo

GET /?prefix=my&marker=mybucket&max-keys=10 HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: cn-hangzhou-internal.oss-vectors.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Resposta de exemplo

HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-type: application/json
Content-Length: 545
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****

{
  "ListAllMyBucketsResult": {
    "Prefix": "my",
    "Marker": "mybucket",
    "MaxKeys": 10,
    "IsTruncated": true,
    "NextMarker": "mybucket10",
    "Buckets": [
        {
          "CreationDate": "2014-02-07T18:12:43.000Z",
          "ExtranetEndpoint": "cn-shanghai.oss-vectors.aliyuncs.com",
          "IntranetEndpoint": "cn-shanghai-internal.oss-vectors.aliyuncs.com",
          "Location": "oss-cn-shanghai",
          "Name": "acs:ossvector:cn-shanghai:103735**********:test-bucket-3",
          "Region": "cn-shanghai"
        },
        {
          "CreationDate": "2014-02-05T11:21:04.000Z",
          "ExtranetEndpoint": "cn-shanghai.oss-vectors.aliyuncs.com",
          "IntranetEndpoint": "cn-shanghai-internal.oss-vectors.aliyuncs.com",
          "Location": "oss-cn-hangzhou",
          "Name": "acs:ossvector:cn-shanghai:103735**********:test-bucket-4",
          "Region": "cn-hangzhou"
        }
    ]
  }
}

SDK

Chame a operação ListVectorBuckets com os seguintes SDKs:

Ferramenta de linha de comando ossutil

Para obter informações sobre o comando ossutil correspondente à operação ListVectorBuckets, consulte list-vector-buckets.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
AccessDenied	403	Solicitação rejeitada devido à falta de informações de autenticação.