Method: projects.locations.instances.create

Erstellt eine neue Instanz in einem angegebenen Projekt und an einem angegebenen Ort.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die übergeordnete Ressource, in der diese Instanz erstellt wird. Format: projects/{projekt}/locations/{location}

Suchparameter

Parameter
instanceId

string

Erforderlich. Die für die Instanz zu verwendende ID, die als letzte Komponente des Ressourcennamens der Instanz verwendet wird.

Für diesen Wert gelten die folgenden Einschränkungen:

  • Muss zwischen 4 und 63 Zeichen lang sein
  • Muss mit einem Buchstaben oder einer Ziffer beginnen
  • Darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten
  • Darf nicht mit einem Bindestrich enden
  • Darf innerhalb eines Standorts nur einmal vorkommen
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, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal 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. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).

Anfragetext

Der Anfragetext enthält eine Instanz von Instance.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

IAM-Berechtigungen

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

  • memorystore.instances.create

Weitere Informationen finden Sie in der IAM-Dokumentation.