Method: projects.locations.dataStores.patch

Aktualisiert die Parameter eines einzelnen DataStore.

dataStores.patch, dataStores.importDocuments und dataStores.purgeDocuments werden jeweils einzeln pro DataStore ausgeführt. Während ein Vorgang ausgeführt wird, kann ein weiterer warten. Alle weiteren Anfragen schlagen mit ABORTED fehl, bis der laufende Vorgang abgeschlossen ist.

HTTP-Anfrage

PATCH https://vectorsearch.googleapis.com/v1beta/{dataStore.name}

Pfadparameter

Parameter
dataStore.name

string

ID. Der vollständig qualifizierte Ressourcenname des DataStore.

Format: projects/{project}/locations/{location}/dataStores/{dataStoreId}

Suchparameter

Parameter
updateMask

string (FieldMask format)

Optional. Mit der Feldmaske werden die Felder angegeben, die in der DataStore-Ressource durch die Aktualisierung überschrieben werden sollen. Die in „updateMask“ angegebenen Felder beziehen sich auf die Ressource und nicht auf die vollständige Anfrage. Ein Feld wird überschrieben, wenn es in der Maske enthalten ist. Ein Pfad, der eine Nachricht benennt, ersetzt die gesamte Nachricht: Unterfelder, die in der Anfrage weggelassen werden, werden gelöscht und unter processingConfig auf ihre Standardwerte zurückgesetzt.

Wenn der Nutzer keine Maske angibt, wird jedes Feld überschrieben, das in der Anfrage auf einen anderen Wert als den Standardwert gesetzt ist. Nachrichten, die leer gesendet werden (z. B. layoutParsingConfig: {}), und Felder, die auf ihren Standardwert gesetzt sind (z. B. false), werden nicht angewendet. Geben Sie sie stattdessen in der Maske an.

Die folgenden Felder unterstützen Aktualisierungen: displayName, description, labels, processingConfig und documentMetadataSchema. documentMetadataSchema muss als Ganzes aktualisiert werden (der Maskenpfad ist documentMetadataSchema) und nur durch Hinzufügen von Properties. Vorhandene Properties können nicht entfernt oder geändert werden.

Wenn * in der updateMask angegeben ist, wird ein vollständiger Ersatz durchgeführt.

Dies ist eine kommagetrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

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 DataStore.

Antworttext

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.