Créer un réseau VMware Engine

Créer un réseau VMware Engine

Les réseaux VMware Engine gèrent les connexions vers et depuis des clouds privés selon une règle de réseau que vous définissez séparément.

Avant de commencer

Exigences concernant la Google Cloud CLI et les API

Pour gérer vos ressources VMware Engine à l'aide de l'outil de ligne de commande gcloud ou de l'API, nous vous recommandons de configurer les outils comme décrit ci-dessous.

gcloud

  1. Définissez votre ID de projet par défaut :

    gcloud config set project PROJECT_ID

  2. Définissez une région et/ou une zone par défaut:

    gcloud config set compute/region REGION
    gcloud config set compute/zone ZONE

Pour en savoir plus sur l'outil gcloud vmware, consultez la documentation de référence de Cloud SDK Cloud.

API

Les exemples d'API de cet ensemble de documentation utilisent l'outil de ligne de commande cURL pour interroger l'API. La requête cURL requiert un jeton d'accès valide. Il existe de nombreuses façons d'obtenir un jeton d'accès valide. Les étapes suivantes font appel à l'outil gcloud pour générer un jeton d'accès:

  1. Se connecter à Google Cloud

    gcloud auth login

  2. Générer un jeton d'accès et exporter vers TOKEN

    export TOKEN=`gcloud auth print-access-token`

  3. Vérifier que TOKEN est correctement défini

    echo $TOKEN

Output:
TOKEN

À présent, utilisez le jeton d'autorisation dans vos requêtes adressées à l'API. Exemple :

curl -X GET -H "Authorization: Bearer \"$TOKEN\""  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

Les exemples de code Python présentés dans cette documentation utilisent la bibliothèque VMware Engine pour communiquer avec l'API. Pour que vous puissiez utiliser cette approche, la bibliothèque doit être installée et les identifiants par défaut de l'application doivent être configurés.

  1. Télécharger et installer la bibliothèque Python

     pip install google-cloud-vmwareengine

  2. Configurez les informations ADC en exécutant ces commandes dans votre shell.

      gcloud auth application-default login

    ou utiliser un fichier de clé de compte de service

      export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"

Pour en savoir plus sur la bibliothèque, consultez la page de référence ou affichez des exemples de code sur GitHub.

Créer un réseau VMware Engine

Créez un réseau VMware Engine à l'aide de gcloud CLI ou de l'API VMware Engine:

gcloud

Pour créer un réseau VMware Engine à l'aide de gcloud CLI:

  1. Exécutez la commande gcloud vmware networks create:

    gcloud vmware networks create NETWORK_ID \
  --type=STANDARD \
  --description="DESCRIPTION"

    Remplacez les éléments suivants :

    • NETWORK_ID: nom du réseau pour cette requête
    • DESCRIPTION: description de ce réseau

  2. Facultatif: Si vous souhaitez répertorier tous les réseaux VMware Engine pour confirmer la création du nouveau réseau, utilisez la commande gcloud vmware networks list:

    gcloud vmware networks list \
  --location=global

API

Pour créer un réseau VMware Engine à l'aide de l'API VMware Engine, procédez comme suit:

  1. Pour créer un réseau VMware Engine, exécutez une requête POST:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks?vmware_engine_network_id=NETWORKD_ID"

'{
  "type": "standard",
  "description": "DESCRIPTION"
}'

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet pour cette requête.
    • NETWORK_ID: nom du réseau pour cette requête.
    • DESCRIPTION: description du réseau.

  2. Facultatif: Pour répertorier tous les réseaux VMware Engine et confirmer la création du nouveau réseau, envoyez une requête GET. Remplacez PROJECT_ID par l'ID du projet pour cette requête.

    GET https://vmwareengine.googleapis.com/v1/projects//locations/global/vmwareEngineNetworks

Mettre à jour un réseau VMware Engine

Mettez à jour un réseau VMware Engine à l'aide de gcloud CLI ou de l'API VMware Engine:

gcloud

Pour mettre à jour un réseau VMware Engine à l'aide de gcloud CLI, procédez comme suit:

  1. Mettez à jour la description d'un réseau VMware Engine en exécutant la commande gcloud vmware networks update:

    gcloud vmware networks update NETWORK_ID \
  --description='DESCRIPTION'

    Remplacez les éléments suivants :

    • NETWORK_ID: nom du réseau pour cette requête.
    • DESCRIPTION: description mise à jour de ce réseau.

  2. Facultatif: Si vous souhaitez afficher l'attribut mis à jour, exécutez la commande gcloud vmware networks describe suivante:

    gcloud vmware networks describe NETWORK_ID

    Remplacez NETWORK_ID par le nom du réseau pour cette requête.

API

Pour mettre à jour un réseau VMware Engine à l'aide de l'API VMware Engine, procédez comme suit:

  1. Pour mettre à jour la description d'un réseau VMware Engine, exécutez une requête PATCH:

    PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/vmwareEngineNetworks/NETWORK_ID?update_mask=description"

'{
  "description":"DESCRIPTION"
}'

    Remplacez les éléments suivants :

    • PROJECT_ID: projet pour cette requête
    • LOCATION: emplacement du réseau (global pour les anciens réseaux ou région pour les réseaux standards)
    • NETWORK_ID: nom du réseau pour cette requête
    • DESCRIPTION: nouvelle description de ce réseau

  2. Facultatif: Si vous souhaitez afficher l'attribut mis à jour, exécutez une requête GET:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks/NETWORK_ID"

Étapes suivantes