Method: projects.locations.networkPolicies.create

Crée une règle de réseau dans un réseau VMware Engine donné d'un projet et d'un emplacement (région). Vous ne pouvez pas créer de règle réseau si une autre règle réseau existe déjà dans le même champ d'application.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource de l'emplacement (région) dans lequel créer la règle de réseau. Les noms de ressources sont des URI sans schéma qui suivent les conventions décrites sur https://cloud.google.com/apis/design/resource_names. Par exemple : projects/my-project/locations/us-central1

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • vmwareengine.networkPolicies.create

Paramètres de requête

Paramètres
networkPolicyId

string

Obligatoire. Identifiant fourni par l'utilisateur pour la règle de réseau à créer. Cet identifiant doit être unique dans le projects/{my-project}/locations/{us-central1}/networkPolicies parent et devient le jeton final dans l'URI du nom. L'identifiant doit répondre aux exigences suivantes :

  • Ne contient que 1 à 63 caractères alphanumériques et des tirets
  • Commence par un caractère alphabétique
  • Se termine par un caractère autre qu'un tiret
  • Format non UUID
  • Conforme à la norme RFC 1034 (section 3.5)
requestId

string

Facultatif. ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour indiquer au serveur d'ignorer la requête si vous devez la relancer alors qu'elle a déjà été traitée. Le serveur garantit qu'une requête n'entraîne pas la création d'engagements en double pendant au moins 60 minutes.

Imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez de nouveau la requête avec le même ID, le serveur peut vérifier si une opération initiale avec cet ID de requête a déjà été reçue et, si c'est le cas, ignorer la deuxième requête. Cela permet d'éviter que les clients ne créent accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, sachant qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

Corps de la requête

Le corps de la requête contient une instance de NetworkPolicy.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.