Todos os produtos
Search
Central de documentação

Object Storage Service:put-vector-index

Última atualização: Sep 22, 2026

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

Observações

  • Um único bucket vetorial pode conter no máximo 100 índices vetoriais.

  • O sistema aceita no máximo 5 requisições PutVectorIndex por segundo.

Permissões

Por padrão, contas Alibaba Cloud possuem todas as permissões, enquanto usuários e funções do RAM não possuem nenhuma permissão. A conta Alibaba Cloud ou um administrador deve conceder permissões por meio de uma RAM policy ou de uma bucket policy.

API

Action

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

Nome do bucket vetorial.

--data-type

string

Tipo de dado do vetor. Não há suporte para tipos de dados personalizados. Valor padrão: float32.

--dimension

int

Dimensões do vetor. O valor pode ser um inteiro de 1 a 4096. O valor padrão é 512.

--distance-metric

string

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

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

  • cosine: distância cosseno

--index-name

string

Nome do índice. É possível especifique um nome personalizado. O valor padrão é vazio.

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

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

--metadata

string

Contêiner para a configuração de metadados. Apenas metadados não filtráveis são aceitos. Os limites a seguir se aplicam à configuração de metadados não filtráveis:

  • A quantidade de entradas de metadados deve ser de 1 a 100.

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

Nota

Exemplos de uso

  • Crie um índice chamado index para o bucket examplebucket. O índice tem 512 dimensões vetoriais, usa o tipo de dado 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 dado 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"]}'