Method: projects.locations.collections.create

Erstellt eine neue Sammlung in einem bestimmten Projekt und an einem bestimmten Standort.

HTTP-Anfrage

POST https://vectorsearch.googleapis.com/v1/{parent}/collections

Pfadparameter

Parameter
parent

string

Erforderlich. Wert für das übergeordnete Element.

Suchparameter

Parameter
collectionId

string

Erforderlich. ID der zu erstellenden Sammlung. Die ID muss zwischen 1 und 63 Zeichen lang sein und RFC1035 entsprechen. Er muss zwischen 1 und 63 Zeichen lang sein und dem regulären Ausdruck [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? entsprechen.

requestId

string

Optional. Eine optionale Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde und wiederholt wird. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Nehmen wir an, Sie senden eine erste Anfrage, deren Zeitlimit überschritten wird. Wenn Sie die Anfrage mit derselben Anfrage-ID erneut senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. So wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, es sei denn, UUIDs mit Nullen werden nicht unterstützt (00000000-0000-0000-0000-000000000000).

Anfragetext

Der Anfragetext enthält eine Instanz von Collection.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

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

  • vectorsearch.collections.create

Weitere Informationen finden Sie in der IAM-Dokumentation.