Method: projects.locations.instances.create

Crea una nuova istanza in un determinato progetto e posizione.

Richiesta HTTP

POST https://memorystore.googleapis.com/v1/{parent=projects/*/locations/*}/instances

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. La risorsa principale in cui verrà creata questa istanza. Formato: projects/{project}/locations/{location}

Parametri di query

Parametri
instanceId

string

Obbligatorio. L'ID da utilizzare per l'istanza, che diventerà il componente finale del nome della risorsa dell'istanza.

Questo valore è soggetto alle seguenti limitazioni:

  • Deve avere una lunghezza compresa tra 4 e 63 caratteri
  • Deve iniziare con una lettera o un numero
  • Deve contenere solo lettere minuscole, cifre e trattini
  • Non deve terminare con un trattino
  • Deve essere univoco all'interno di una località
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 ignorarla se è già stata completata. Il server lo garantisce 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, i clienti non possono creare accidentalmente impegni duplicati.

L'ID richiesta deve essere un UUID valido, ad eccezione del fatto che l'UUID zero non è supportato (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 appena creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM sulla risorsa parent:

  • memorystore.instances.create

Per ulteriori informazioni, consulta la documentazione di IAM.