Method: projects.locations.vmwareEngineNetworks.create

Erstellt ein neues VMware Engine-Netzwerk, das von einer privaten Cloud verwendet werden kann.

HTTP-Anfrage

POST https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*}/vmwareEngineNetworks

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname des Standorts, an dem das neue VMware Engine-Netzwerk erstellt werden soll. Ein VMware Engine-Netzwerk vom Typ LEGACY ist eine regionale Ressource und ein VMware Engine-Netzwerk vom Typ STANDARD ist eine globale Ressource. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names entsprechen. Beispiele: projects/my-project/locations/global

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • vmwareengine.vmwareEngineNetworks.create

Suchparameter

Parameter
vmwareEngineNetworkId

string

Erforderlich. Die vom Nutzer angegebene Kennung des neuen VMware Engine-Netzwerks. Diese Kennung muss unter den VMware Engine-Netzwerkressourcen innerhalb des übergeordneten Elements eindeutig sein und wird zum letzten Token im Namens-URI. Die Kennung muss die folgenden Anforderungen erfüllen:

  • Für Netzwerke vom Typ LEGACY wird das Format {region-id}-default verwendet. Ersetzen Sie {region-id} durch die Region, in der Sie das VMware Engine-Netzwerk erstellen möchten. Beispiel: „us-central1-default“.
  • Darf nur 1 bis 63 alphanumerische Zeichen und Bindestriche enthalten
  • Beginnt mit einem Buchstaben
  • Endet mit einem Zeichen, das kein Bindestrich ist
  • Nicht als UUID formatiert
  • Entspricht RFC 1034 (Abschnitt 3.5)
requestId

string

Optional. Eine 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 Sie sie wiederholen müssen. Der Server garantiert, dass eine Anfrage mindestens 60 Minuten lang nicht zur Erstellung doppelter Zusagen führt.

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

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.