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

Erstellt ein Steuerelement.

Standardmäßig sind 1.000 Steuerelemente für einen Datenspeicher zulässig. Es kann eine Anfrage zur Anpassung dieses Limits gesendet werden. Wenn die zu erstellende Control bereits vorhanden ist, wird ein ALREADY_EXISTS-Fehler zurückgegeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Vollständiger Ressourcenname des übergeordneten Datenspeichers. Format: projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} oder projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}.

Abfrageparameter

Parameter
controlId

string

Erforderlich. Die für die Kontrollgruppe zu verwendende ID, die die letzte Komponente des Ressourcennamens der Kontrollgruppe darstellt.

Dieser Wert muss zwischen 1 und 63 Zeichen lang sein. Gültige Zeichen sind /[a–z][0–9]–_/.

Anfragetext

Der Anfragetext enthält eine Instanz von Control.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine neu erstellte Instanz von Control.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • discoveryengine.controls.create

Weitere Informationen finden Sie in der IAM-Dokumentation.