Method: projects.locations.instances.patch

Aggiorna i parametri di una singola istanza.

Richiesta HTTP

PATCH https://memorystore.googleapis.com/v1alpha/{instance.name=projects/*/locations/*/instances/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
instance.name

string

Identificatore. Nome univoco dell'istanza. Formato: projects/{project}/locations/{location}/instances/{instance}

Parametri di query

Parametri
updateMask

string (FieldMask format)

Facoltativo. L'elenco di campi da aggiornare sull'istanza. È necessario specificare almeno un campo.

Si tratta di un elenco di nomi completi dei campi separati da virgole. 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, il server saprà di ignorare la richiesta se è già stata completata. Il server lo garantirà per almeno 60 minuti dalla prima richiesta.

Ad esempio, prendi in considerazione una situazione in cui effettui una richiesta iniziale e questa scade. Se effettui di nuovo la richiesta con lo stesso ID richiesta, il server può verificare se è stata ricevuta l'operazione originale con lo stesso ID richiesta e, in questo caso, ignora la seconda richiesta. In questo modo si evita che i client creino accidentalmente impegni duplicati.

L'ID richiesta deve essere un UUID valido, tranne per il fatto che non è supportato alcun UUID zero (00000000-0000-0000-0000-000000000000).

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Instance.

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

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM sulla risorsa name:

  • memorystore.instances.update

Per saperne di più, consulta la documentazione IAM.