Todos os produtos
Search
Central de documentação

Object Storage Service:put-vector-index

Última atualização: Jun 23, 2026

O comando put-vector-index cria um índice vetorial em um bucket vetorial.

Notas de uso

  • Um único bucket vetorial pode conter no máximo 100 índices vetoriais. Para aumentar essa cota, entre em contato com o suporte técnico.

  • A operação PutVectorIndex oferece suporte a no máximo cinco solicitações por segundo.

Permissões

Uma conta do 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 e devem receber acesso por meio de uma política RAM ou uma política de bucket.

API

Ação

Descrição

PutVectorIndex

oss:PutVectorIndex

Cria um índice vetorial.

Formato do comando

ossutil vectors-api put-vector-index --bucket value --index-name value [flags]

Parâmetros

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket vetorial.

--data-type

string

O tipo de dados do vetor. Tipos de dados personalizados não são compatíveis. Valor padrão: float32.

--dimension

int

As dimensões do vetor. O valor pode ser um número inteiro de 1 a 4096. O valor padrão é 512.

--distance-metric

string

A função de medida de distância. Valores válidos:

  • euclidean: distância euclidiana (padrão)

  • cosine: distância do cosseno

--index-name

string

O nome do índice. Você pode especificar um nome personalizado. O valor padrão é vazio.

  • O nome deve ser globalmente exclusivo dentro do bucket vetorial e deve ter de 1 a 63 caracteres.

  • O nome pode conter apenas letras e dígitos e deve começar com uma letra.

--metadata

string

O contêiner para configuração de metadados. Somente metadados não filtráveis são compatíveis. Os seguintes limites se aplicam à configuração de metadados não filtráveis:

  • O número de entradas de metadados deve ser de 1 a 10.

  • O comprimento de cada nome de chave primária de metadados deve ser de 1 a 63 bytes.

null

Exemplos de uso

  • Crie um índice chamado index para o bucket examplebucket. O índice tem 512 dimensões vetoriais, usa o tipo de dados float32 e a medida de distância euclidiana.

    ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean
  • Crie um índice chamado index para o bucket examplebucket e configure metadados não filtráveis. O índice tem 512 dimensões vetoriais, usa o tipo de dados float32 e a medida de distância euclidiana.

    ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean --metadata '{"nonFilterableMetadataKeys":["owner","createdBy"]}'