Criar e gerenciar sub-redes

Nesta página, descrevemos como criar e gerenciar recursos de sub-rede do Google Distributed Cloud em uma zona do Distributed Cloud.

Nos servidores do Distributed Cloud, só é possível configurar sub-redes com IDs de VLAN. As sub-redes baseadas em CIDR não são compatíveis com os servidores do Distributed Cloud.

Para mais informações sobre sub-redes do Distributed Cloud, consulte Como o Distributed Cloud funciona.

Lembre-se:

  • É possível criar até 20 sub-redes em cada rede.
  • A sub-rede é uma VLAN na rede principal. Portanto, cada sub-rede precisa ter um ID de VLAN globalmente exclusivo. O Distributed Cloud não permite a reutilização de IDs de VLAN.
  • Para que o Distributed Cloud atribua um ID da VLAN não utilizado de forma aleatória, especifique 0 como o ID da VLAN ao criar a sub-rede.
  • A sub-rede é acessível a todos os nós na sua zona do Distributed Cloud.

Criar uma sub-rede

Para criar uma sub-rede do Distributed Cloud, siga as etapas nesta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) no projeto Google Cloud .

gcloud

Use o 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

Substitua:

  • SUBNETWORK_NAME: um nome descritivo que identifica exclusivamente esta sub-rede.
  • NETWORK_NAME: a rede que encapsula esta sub-rede.
  • IPV4_RANGE: o intervalo de endereços IPv4 que esta sub-rede abrange no formato de endereço IP/prefixo.
  • VLAN_ID: o ID da VLAN de destino para essa sub-rede.
  • REGION: a Google Cloud região a que a zona de destino do Distributed Cloud pertence.
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.

API

Faça uma solicitação POST ao 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,
   },
 }

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud de destino.
  • REGION: a região Google Cloud a que a zona de destino do Distributed Cloud pertence.
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.
  • SUBNETWORK_ID: um ID que identifica exclusivamente essa sub-rede.
  • LABELS: uma lista de rótulos a serem aplicados a este recurso de sub-rede.
  • NETWORK_NAME: a rede que encapsula esta sub-rede.
  • IPV4_RANGE: o intervalo de endereços IPv4 que esta sub-rede abrange no formato de endereço IP/prefixo.
  • VLAN_ID: o ID da VLAN de destino para essa sub-rede.

Listar sub-redes

Para listar as sub-redes provisionadas em uma zona do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de Visualizador de rede de borda (roles/edgenetwork.viewer) no seu projeto Google Cloud .

gcloud

Use o comando gcloud edge-cloud networking subnets list:

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

Substitua:

  • REGION: a região Google Cloud a que a zona de destino do Distributed Cloud pertence.
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.

API

Faça uma solicitação GET ao 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

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud de destino.
  • REGION: a região Google Cloud a que a zona de destino do Distributed Cloud pertence.
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.
  • FILTER: uma expressão que restringe os resultados retornados a valores específicos.
  • PAGE_SIZE: o número de resultados a serem retornados por página.
  • SORT_BY: uma lista delimitada por vírgulas de nomes de campos pelos quais os resultados retornados são classificados. A ordem de classificação padrão é crescente. Para classificar em ordem decrescente, adicione o prefixo ~ ao campo desejado.
  • PAGE_TOKEN: um token recebido na resposta à última solicitação de lista no campo nextPageToken da resposta. Envie esse token para receber uma página de resultados.

Receber informações sobre uma sub-rede

Para informações sobre uma sub-rede do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de Visualizador de rede de borda (roles/edgenetwork.viewer) no seu projeto Google Cloud .

gcloud

Use o comando gcloud edge-cloud networking subnets describe:

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

Substitua:

  • SUBNETWORK_NAME: o nome da sub-rede de destino.
  • REGION: a região Google Cloud a que a zona de destino do Distributed Cloud pertence.
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.

API

Faça uma solicitação GET ao método projects.locations.zones.subnets.get:

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

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud de destino.
  • REGION: a Google Cloud região a que a zona de destino do Distributed Cloud pertence.
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.
  • SUBNETWORK_NAME: o nome da sub-rede de destino.

Essa operação retorna informações detalhadas sobre o recurso, incluindo o estado de provisionamento:

  • PENDING: o recurso ainda não começou o provisionamento e ainda não foi propagado por toda a zona.
  • PROVISIONING: o recurso está sendo provisionado. Aguarde até que ele seja propagado por toda a zona.
  • RUNNING: o recurso foi provisionado e propagado com sucesso em toda a zona e está pronto para uso.
  • FAILED: o provisionamento do recurso não foi concluído. Ele não foi propagado por toda a zona.

Excluir uma sub-rede

Para excluir uma sub-rede do Distributed Cloud, siga as etapas nesta seção.

Para concluir essa tarefa, você precisa ter o papel de administrador da rede de borda (roles/edgenetwork.admin) no projeto Google Cloud .

gcloud

Use o comando gcloud edge-cloud networking subnets delete:

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

Substitua:

  • SUBNETWORK_NAME: o nome da sub-rede de destino.
  • REGION: a Google Cloud região a que a zona de destino do Distributed Cloud pertence.
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.

API

Faça uma solicitação DELETE ao método projects.locations.zones.subnets.delete:

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

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud de destino.
  • REGION: a Google Cloud região a que a zona de destino do Distributed Cloud pertence.
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.
  • SUBNETWORK_NAME: o nome da sub-rede de destino.

A seguir