Method: projects.locations.collections.engines.controls.create

Crée un contrôle.

Par défaut, 1 000 contrôles sont autorisés pour un data store. Vous pouvez demander à ajuster cette limite. Si le Control à créer existe déjà, une erreur ALREADY_EXISTS est renvoyée.

Requête HTTP

POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/controls

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom complet de la ressource du data store parent. Format : projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} ou projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}.

Paramètres de requête

Paramètres
controlId

string

Obligatoire. ID à utiliser pour le contrôle, qui constituera le composant final du nom de ressource du contrôle.

Cette valeur doit comporter entre 1 et 63 caractères. Les caractères valides sont /[a-z][0-9]-_/.

Corps de la requête

Le corps de la requête contient une instance de Control.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Control.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • discoveryengine.controls.create

Pour en savoir plus, consultez la documentation IAM.