Criar e gerenciar sub-redes

Esta página descreve como criar e gerenciar recursos de sub-rede do Google Distributed Cloud em uma zona conectada do Distributed Cloud.

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

Lembre-se:

  • É possível criar até 138 sub-redes por zona do Distributed Cloud.
  • A sub-rede é uma VLAN dentro da rede mãe. Portanto, cada sub-rede precisa ter um ID de VLAN globalmente exclusivo. O Distributed Cloud conectado não permite a reutilização de IDs de VLAN.
  • Para que o Distributed Cloud conectado atribua um ID de VLAN não utilizado aleatoriamente, especifique 0 como o ID da VLAN ao criar a sub-rede.
  • A sub-rede pode ser acessada por todos os nós na sua zona conectada do Distributed Cloud.

Criar uma sub-rede

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

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

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 essa sub-rede.
  • NETWORK_NAME: a rede que encapsula essa sub-rede.
  • IPV4_RANGE: o intervalo de endereços IPv4 que essa sub-rede abrange no formato de endereço/prefixo IP.
  • VLAN_ID: o ID da VLAN de destino para essa sub-rede.
  • REGION: aregião a que a zona de destino do Distributed Cloud pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud conectado.

API

Faça uma solicitação POST para o 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 de destino. Google Cloud
  • REGION: aregião a que a zona de destino do Distributed Cloud conectado pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud conectado.
  • SUBNETWORK_ID: um ID que identifica exclusivamente essa sub-rede.
  • LABELS: uma lista de rótulos a serem aplicados a esse recurso de sub-rede.
  • NETWORK_NAME: a rede que encapsula essa sub-rede.
  • IPV4_RANGE: o intervalo de endereços IPv4 que essa sub-rede abrange no formato de endereço/prefixo IP.
  • VLAN_ID: o ID da VLAN de destino para essa sub-rede.

Listar sub-redes

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

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

gcloud

Use o comando gcloud edge-cloud networking subnets list:

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

Substitua:

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

API

Faça uma solicitação GET para o 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 de destino. Google Cloud
  • REGION: aregião a que a zona de destino do Distributed Cloud conectado pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud conectado.
  • 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 de nomes de campos separados por vírgulas pelos quais os resultados retornados são classificados. A ordem de classificação padrão é crescente. Para a ordem de classificação 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 receber 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 da rede de borda (roles/edgenetwork.viewer) em seu Google Cloud projeto.

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: aregião a que a zona de destino do Distributed Cloud conectado pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud conectado.

API

Faça uma solicitação GET para o 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 de destino. Google Cloud
  • REGION: aregião a que a zona de destino do Distributed Cloud conectado pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud conectado.
  • 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 provisionamento do recurso ainda não foi iniciado e ele 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 por toda a zona. Ele está pronto para uso.
  • FAILED: o provisionamento do recurso não foi bem-sucedido. O recurso não foi propagado por toda a zona.

Excluir uma sub-rede

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

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

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: aregião a que a zona de destino do Distributed Cloud conectado pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud conectado.

API

Faça uma solicitação DELETE para o 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 de destino. Google Cloud
  • REGION: aregião a que a zona de destino do Distributed Cloud conectado pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud conectado.
  • SUBNETWORK_NAME: o nome da sub-rede de destino.

A seguir