Administrar subredes

En este documento, se describe cómo administrar subredes en VMware Engine. Las subredes de administración son subredes de solo lectura que puedes ver con Google Cloud CLI o la API. También puedes actualizar las subredes de tipo userDefined.

Requisitos de Google Cloud CLI y las APIs

Si quieres usar la herramienta de línea de comandos de gcloud o la API para administrar los recursos de VMware Engine, recomendamos configurar las herramientas como se describe a continuación.

gcloud

  1. Configura tu ID del proyecto predeterminado:

    gcloud config set project PROJECT_ID

  2. Establece una región o zona predeterminada:

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

Para obtener más información sobre la herramienta de gcloud vmware, revisa los documentos de referencia del SDK de Cloud.

API

Los ejemplos de API en este conjunto de documentación usan la herramienta de línea de comandos de cURL para consultar la API. Se requiere un token de acceso válido como parte de la solicitud cURL. Existen muchas formas de obtener un token de acceso válido. En los siguientes pasos, se usa la herramienta de gcloud para generar un token de acceso:

  1. Accede a Google Cloud

    gcloud auth login

  2. Genera un token de acceso y exporta a TOKEN

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

  3. Verifica que el TOKEN esté configurado correctamente.

    echo $TOKEN

Output:
TOKEN

Ahora, usa el token de autorización en tus solicitudes a la API. Por ejemplo:

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

Las muestras de código de Python en esta documentación usan la biblioteca de VMware Engine para comunicarse con la API. Para poder usar este enfoque, se debe instalar la biblioteca y se deben configurar las credenciales predeterminadas de la aplicación.

  1. Descarga e instala la biblioteca de Python

     pip install google-cloud-vmwareengine

  2. Configura la información del ADC ejecutando esos comandos en tu shell

      gcloud auth application-default login

    o usar un archivo de claves de cuenta de servicio

      export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"

Para obtener más información sobre la biblioteca, visita la página de referencia o consulta muestras de código en GitHub.

Edita una subred userDefined

Puedes editar una subred userDefined con Google Cloud CLI o la API de VMware Engine. Ambos métodos requieren el nombre de la subred y la nube privada.

gcloud

Para editar una subred con Google Cloud CLI, ingresa el comando gcloud vmware private-clouds subnets update: 

     gcloud vmware private-clouds subnets update SUBNET_NAME 

        --private-cloud=PC_NAME --location=ZONE 

        --ip-cidr-range=10.0.0.0/24

Reemplaza lo siguiente:

  • SUBNET_NAME: Es el nombre de la subred que se actualizará en esta nube privada.
  • PC_NAME: Es el nombre de la nube privada.
  • ZONE: Es la zona de la nube privada.

API

Para editar una subred con la API de VMware Engine, realiza una solicitud PATCH:

 curl -sSL -XPATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json; charset=utf-8"
 "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_NAME/subnets/SUBNET_NAME?update_mask=ip_cidr_range" -d '{
    "ip_cidr_range": "10.0.0.0/24"
 }'

Reemplaza lo siguiente:

  • PROJECT_ID: Es el nombre del proyecto para esta solicitud.
  • ZONE: Es la zona de la nube privada.
  • PC_NAME: Es el nombre de la nube privada.
  • SUBNET_NAME: Es el nombre de la subred que se actualizará en esta nube privada.

Enumerar subredes de administración

Puedes enumerar las subredes de administración de nubes privadas de VMware Engine si ingresas el siguiente comando con Google Cloud CLI o la API de VMware Engine. Este comando requiere el nombre de la subred y la nube privada.

gcloud

Obtén una subred con Google Cloud CLI. Para ello, ingresa el comando gcloud vmware private-clouds subnets list: 

     gcloud vmware private-clouds subnets list --private-cloud=PC_NAME 

         --location=ZONE

Reemplaza lo siguiente:

  • PC_NAME: Es el nombre de la nube privada.
  • ZONE: Es la zona de la nube privada.

API

Para enumerar una subred con la API de VMware Engine, realiza una solicitud GET:

 curl -sSL -XGET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json; charset=utf-8"
 "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds/PC_NAME/subnets"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el nombre del proyecto para esta solicitud.
  • ZONE: Es la zona de la nube privada.
  • PC_NAME: Es el nombre de la nube privada.

Describir una subred de administración

Para obtener una descripción de cualquier subred de administración, ingresa el siguiente comando:

gcloud

Para obtener la descripción de una subred con Google Cloud CLI, ingresa el comando gcloud vmware private-clouds subnets update: 

     gcloud vmware private-clouds subnets describe SUBNET_NAME-pcon 

         --private-cloud=PC_NAME 

         --location=ZONE

Reemplaza lo siguiente:

  • SUBNET_NAME: Es el nombre de la subred que se actualizará en esta nube privada.
  • PC_NAME: Es el nombre de la nube privada.
  • ZONE: Es la zona de la nube privada.

API

Para obtener la descripción de una subred con la API de VMware Engine, realiza una solicitud GET:

  curl -sSL -XGET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json; charset=utf-8"
  "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/privateClouds/PC_NAME/subnets/SUBNET_NAME"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el nombre del proyecto para esta solicitud.
  • REGION: Es la región de la red.
  • PC_NAME: Es el nombre de la nube privada.
  • SUBNET_NAME: Es el nombre de la subred que se actualizará en esta nube privada.

¿Qué sigue?