Criar e gerenciar redes

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

Os servidores do Distributed Cloud são enviados com uma única rede pré-configurada, a rede padrão do Distributed Cloud. Os servidores 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 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 de destino do Distributed Cloud pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.
  • MTU_SIZE: o tamanho da unidade máxima de transmissão (MTU) para essa 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 de destino do Distributed Cloud pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.
  • 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) para essa rede. Os valores válidos são 1500 e 9000.

Listar redes

Para listar as redes do Distributed Cloud 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) 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 de destino do Distributed Cloud pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.

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

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

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

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 de destino do Distributed Cloud pertence. Google Cloud
  • ZONE_NAME: o nome da zona de destino do Distributed Cloud.
  • NETWORK_ID: o ID da rede de destino.

A seguir