Crea y administra subredes

En esta página, se describe cómo crear y administrar recursos de subred de Google Distributed Cloud en una zona de Distributed Cloud.

En los servidores de Distributed Cloud, solo puedes configurar subredes con IDs de VLAN. Las subredes basadas en CIDR no son compatibles con los servidores de Distributed Cloud.

Para obtener más información sobre las subredes de Distributed Cloud, consulta Cómo funciona Distributed Cloud.

Ten en cuenta lo siguiente:

  • Puedes crear hasta 20 subredes dentro de cada red.
  • La subred es una VLAN dentro de la red principal. Por lo tanto, cada subred debe tener un ID de VLAN único a nivel global. Distributed Cloud no permite reutilizar los IDs de VLAN.
  • Para que Distributed Cloud asigne un ID de VLAN no utilizado de forma aleatoria, especifica 0 como el ID de VLAN cuando crees la subred.
  • Se puede acceder a la subred desde todos los nodos de tu zona de Distributed Cloud.

Crear una subred

Para crear una subred de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu proyecto Google Cloud .

gcloud

Usa el comando gcloud edge-cloud networking subnets create:

gcloud edge-cloud networking subnets create SUBNETWORK_NAME \
    --network=NETWORK_NAME \
    --ipv4-range=IPV4_RANGE \
    --vlan-id=VLAN_ID \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • SUBNETWORK_NAME: Es un nombre descriptivo que identifica de forma única esta subred.
  • NETWORK_NAME: Es la red que encapsula esta subred.
  • IPV4_RANGE: Es el rango de direcciones IPv4 que abarca esta subred en el formato de dirección IP o prefijo.
  • VLAN_ID: Es el ID de VLAN de destino para esta subred.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

API

Realiza una solicitud POST al método projects.locations.zones.subnets.create:

 POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?subnetId=SUBNETWORK_ID
 {
  "labels": { LABELS,
   },
  "network": { NETWORK_NAME,
   },
  "ipv4Cidr": { IPV4_RANGE,
   },
  "vlanId": { VLAN_ID,
   },
 }

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • SUBNETWORK_ID: Es un ID que identifica de forma única esta subred.
  • LABELS: Es una lista de etiquetas que se aplicarán a este recurso de subred.
  • NETWORK_NAME: Es la red que encapsula esta subred.
  • IPV4_RANGE: Es el rango de direcciones IPv4 que abarca esta subred en el formato de dirección IP o prefijo.
  • VLAN_ID: Es el ID de VLAN de destino para esta subred.

Mostrar lista de subredes

Para enumerar las subredes aprovisionadas dentro de una zona de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de red perimetral (roles/edgenetwork.viewer) en tu proyecto Google Cloud .

gcloud

Usa el comando gcloud edge-cloud networking subnets list:

gcloud edge-cloud networking subnets list \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

API

Realiza una solicitud GET al método projects.locations.zones.subnets.list:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • FILTER: Es una expresión que limita los resultados devueltos a valores específicos.
  • PAGE_SIZE: Es la cantidad de resultados que se mostrarán por página.
  • SORT_BY: Es una lista delimitada por comas de los nombres de los campos por los que se ordenan los resultados devueltos. El orden de clasificación predeterminado es ascendente. Para obtener un orden de clasificación descendente, agrega el prefijo ~ al campo deseado.
  • PAGE_TOKEN: Es un token que se recibe en la respuesta a la última solicitud de lista en el campo nextPageToken de la respuesta. Envía este token para recibir una página de resultados.

Obtén información sobre una subred

Para obtener información sobre una subred de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de red perimetral (roles/edgenetwork.viewer) en tu proyecto Google Cloud .

gcloud

Usa el comando gcloud edge-cloud networking subnets describe:

gcloud edge-cloud networking subnets describe SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • SUBNETWORK_NAME: Es el nombre de la subred de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

API

Realiza una solicitud GET al método projects.locations.zones.subnets.get:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • SUBNETWORK_NAME: Es el nombre de la subred de destino.

Esta operación devuelve información detallada sobre el recurso, incluido su estado de aprovisionamiento:

  • PENDING: El recurso aún no comenzó el aprovisionamiento y aún no se propagó por toda la zona.
  • PROVISIONING: Se está aprovisionando el recurso. Debes esperar hasta que se propague por toda la zona.
  • RUNNING: El recurso se aprovisionó y propagó correctamente en toda la zona, y está listo para usarse.
  • FAILED: El aprovisionamiento del recurso no se realizó correctamente; el recurso no se propagó por toda la zona.

Borrar una subred

Para borrar una subred de Distributed Cloud, completa los pasos que se indican en esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu proyecto Google Cloud .

gcloud

Usa el comando gcloud edge-cloud networking subnets delete:

gcloud edge-cloud networking subnets delete SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Reemplaza lo siguiente:

  • SUBNETWORK_NAME: Es el nombre de la subred de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

API

Realiza una solicitud DELETE al método projects.locations.zones.subnets.delete:

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • SUBNETWORK_NAME: Es el nombre de la subred de destino.

¿Qué sigue?