Criar e gerenciar redes

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

Os servidores conectados do Distributed Cloud são enviados com uma única rede pré-configurada, a rede padrão do Distributed Cloud. Os servidores conectados do Distributed Cloud não oferecem suporte à configuração de redes adicionais.

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

Lembre-se:

  • É possível criar até 20 redes por zona do Distributed Cloud.
  • Uma rede é uma rede privada virtual instanciada na zona de destino.
  • A rede é instanciada como uma função de roteamento virtual (VRF, na sigla em inglês).
  • Os pacotes são roteados de forma independente dentro de uma rede.

Criar uma rede

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

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

gcloud

Use o comando gcloud edge-cloud networking networks create:

gcloud edge-cloud networking networks create NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --mtu=MTU_SIZE

Substitua:

  • NETWORK_NAME: um nome descritivo que identifica exclusivamente essa rede.
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • MTU_SIZE: o tamanho da unidade máxima de transmissão (MTU, na sigla em inglês) dessa rede. Os valores válidos são 1500 e 9000. Esse valor precisa corresponder ao tamanho da MTU da rede default e ser igual para todas as redes.

API

Faça uma solicitação POST para o método projects.locations.zones.networks.create:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?networkId=NETWORK_ID
{
 "labels": { LABELS,
  },
 "mtu": { MTU_SIZE,
  },
}

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona do Distributed Cloud de destino.
  • NETWORK_ID: um ID exclusivo que identifica essa rede.
  • LABELS: uma lista de rótulos a serem aplicados a esse recurso de rede.
  • MTU_SIZE: o tamanho da unidade máxima de transmissão (MTU, na sigla em inglês) dessa rede. Os valores válidos são 1500 e 9000.

Listar redes

Para listar as redes do Distributed Cloud 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 de rede de borda (roles/edgenetwork.viewer) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking networks list:

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

Substitua:

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

API

Faça uma solicitação GET para o método projects.locations.zones.networks.list:

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

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona do Distributed Cloud de destino.
  • 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 separada por vírgulas de nomes de campos 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 campo desejado com ~.
  • PAGE_TOKEN: um token recebido na resposta à última solicitação de lista no campo nextPageToken na resposta. Envie esse token para receber uma página de resultados.

Receber informações sobre uma rede

Para receber informações sobre uma 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) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking networks describe:

gcloud edge-cloud networking networks describe NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

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

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • NETWORK_ID: o ID da rede de destino.

Verificar o status operacional de uma rede

Para verificar o status operacional de uma 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) em seu Google Cloud projeto.

gcloud

Use o comando gcloud edge-cloud networking networks get-status:

gcloud edge-cloud networking networks get-status NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

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

API

Faça uma solicitação GET para o método projects.locations.zones.networks.diagnose:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID:diagnose

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • NETWORK_ID: o ID da rede de destino.

Excluir uma rede

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

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

gcloud

Use o comando gcloud edge-cloud networking networks delete:

gcloud edge-cloud networking networks delete NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

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

API

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

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID

Substitua:

  • PROJECT_ID: o ID doprojeto de destino. Google Cloud
  • REGION: aregião a que a zona conectada do Distributed Cloud de destino pertence. Google Cloud
  • ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino.
  • NETWORK_ID: o ID da rede de destino.

A seguir