Method: projects.locations.collections.patch

Aggiorna i parametri di una singola raccolta.

Richiesta HTTP

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

Parametri del percorso

Parametri
collection.name

string

Identifier. name of resource

Parametri di query

Parametri
updateMask

string (FieldMask format)

Facoltativo. La maschera del campo viene utilizzata per specificare i campi da sovrascrivere nella risorsa Collection con l'aggiornamento. I campi specificati in updateMask si riferiscono alla risorsa, non all'intera richiesta. Un campo verrà sovrascritto se si trova nella maschera. Se l'utente non fornisce una maschera, tutti i campi presenti nella richiesta verranno sovrascritti.

I seguenti campi supportano l'aggiornamento: displayName, description, labels, dataSchema, vectorSchema. Per dataSchema e vectorSchema, i campi possono essere solo aggiunti, non eliminati, ma vertexEmbeddingConfig in vectorSchema può essere aggiunto o rimosso. Gli aggiornamenti parziali per dataSchema e vectorSchema sono supportati anche utilizzando i percorsi dei sottocampi in updateMask, ad esempio dataSchema.properties.foo o vectorSchema.my_vector_field.

Se * viene fornito in updateMask, verrà eseguita la sostituzione completa.

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

requestId

string

Facoltativo. Un ID richiesta facoltativo per identificare le richieste. Specifica un ID richiesta univoco in modo che, se devi riprovare a inviare la richiesta, il server sappia che deve ignorarla se è già stata completata. Il server garantirà di ignorare la seconda richiesta per almeno 60 minuti dopo la prima.

Ad esempio, considera una situazione in cui effettui una richiesta iniziale e questa scade. Se effettui nuovamente la richiesta con lo stesso ID richiesta, il server può verificare se l'operazione originale con lo stesso ID richiesta è stata ricevuta e, in caso affermativo, ignorerà la seconda richiesta. In questo modo, i client non creano impegni duplicati per errore.

L'ID richiesta deve essere un UUID valido, ad eccezione dell'UUID zero, che non è supportato (00000000-0000-0000-0000-000000000000).

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Collection.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • vectorsearch.collections.update

Per saperne di più, consulta la documentazione di IAM.