Tous les produits
Search
Centre de documentation

Object Storage Service:put-vector-index

Dernière mise à jour :Sep 22, 2026

La commande put-vector-index crée un index vectoriel dans un compartiment vectoriel.

Notes

  • Un compartiment vectoriel peut contenir au maximum 100 index vectoriels.

  • Le système prend en charge un maximum de 5 requêtes PutVectorIndex par seconde.

Permissions

Par défaut, les comptes Alibaba Cloud disposent de toutes les autorisations, tandis que les utilisateurs et les rôles RAM n'en ont aucune. Le compte Alibaba Cloud ou un administrateur doit accorder les autorisations via une politique RAM ou une politique de compartiment.

API

Action

Description

PutVectorIndex

oss:PutVectorIndex

Crée un index vectoriel.

Format de la commande

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

Paramètres

Paramètre

Type

Description

--bucket

string

Nom du compartiment vectoriel.

--data-type

string

Type de données du vecteur. Les types de données personnalisés ne sont pas pris en charge. Valeur par défaut : float32.

--dimension

int

Dimensions du vecteur. La valeur doit être un entier compris entre 1 et 4096. La valeur par défaut est 512.

--distance-metric

string

Fonction de mesure de distance. Valeurs valides :

  • euclidean : distance euclidienne (par défaut)

  • cosine : distance cosinus

--index-name

string

Nom de l'index. Spécifiez un nom personnalisé. La valeur par défaut est vide.

  • Le nom doit être globalement unique au sein du compartiment vectoriel et comporter entre 1 et 63 caractères.

  • Le nom ne peut contenir que des lettres et des chiffres, et doit commencer par une lettre.

--metadata

string

Conteneur pour la configuration des métadonnées. Seules les métadonnées non filtrables sont prises en charge. Les limites suivantes s'appliquent à la configuration des métadonnées non filtrables :

  • Le nombre d'entrées de métadonnées doit être compris entre 1 et 100.

  • La longueur de chaque nom de clé primaire de métadonnée doit être comprise entre 1 et 63 octets.

Remarque

Exemples d'utilisation

  • Créez un index nommé index pour le compartiment examplebucket. L'index comporte 512 dimensions vectorielles, utilise le type de données float32 et la mesure de distance euclidienne.

    ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean
  • Créez un index nommé index pour le compartiment examplebucket et configurez des métadonnées non filtrables. L'index comporte 512 dimensions vectorielles, utilise le type de données float32 et la mesure de distance euclidienne.

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