Criar e gerenciar anexos de interconexão

Nesta página, descrevemos como criar e gerenciar recursos de anexo de interconexão do Google Distributed Cloud em uma zona do Distributed Cloud.

Essa funcionalidade está disponível apenas em racks do Distributed Cloud. Os servidores do Distributed Cloud não são compatíveis com recursos de anexo de interconexão.

Para mais informações sobre os anexos de interconexão do Distributed Cloud, consulte Como o Distributed Cloud funciona.

Lembre-se:

  • Recomendamos que você crie um anexo de interconexão e o roteador correspondente ao mesmo tempo. Para mais informações, consulte Criar um roteador.
  • Você pode especificar um ID da VLAN para usar na inclusão de tags nos pacotes que passam pelo anexo de interconexão.
  • O ID da VLAN especificado para inclusão de tags de pacotes é local para o anexo de interconexão. Em outras palavras, um determinado anexo de interconexão não faz parte do mesmo domínio da camada 2 que os anexos de interconexão associados a outras interconexões ou sub-redes que não estão associadas a nenhum anexo de interconexão. Portanto, embora o ID da VLAN especificado para inclusão de tags de pacotes precise ser exclusivo em todos os anexos de interconexão criados na interconexão de destino, ele pode ser reutilizado em outras interconexões e em sub-redes não associadas a um anexo de interconexão.

Criar um anexo de interconexão

Para criar um anexo de interconexão 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 interconnects attachments dedicated create:

gcloud edge-cloud networking interconnects attachments dedicated create ATTACHMENT_NAME \
    --interconnect=INTERCONNECT_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --vlan-id=VLAN_ID \
    --mtu=MTU_SIZE

Substitua:

  • ATTACHMENT_NAME: um nome descritivo que identifica exclusivamente esse anexo do Interconnect.
  • INTERCONNECT_NAME: o nome da interconexão a que este anexo de interconexão se conecta.
  • NETWORK_NAME: o nome da rede do Distributed Cloud que esse recurso de anexo do Interconnect atende.
  • 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.
  • VLAN_ID (opcional): o ID da VLAN com que os pacotes que passam por esse anexo de interconexão são marcados. Os valores válidos estão entre 2 e 4095. Se você omitir esse valor ou defini-lo como 0, os pacotes não serão marcados.
  • MTU_SIZE: o tamanho da unidade máxima de transmissão (MTU) para a sub-rede que este anexo de interconexão instancia. Os valores válidos são 1500 e 9000.

API

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

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?interconnectAttachmentId=ATTACHMENT_ID
 {
  "labels": { LABELS,
   },
  "interconnect": { INTERCONNECT_NAME,
   },
  "network": { NETWORK_NAME,
   },
  "vlanId": { VLAN_ID,
   },
  "mtu": { MTU_SIZE,
   },       
 }

Substitua:

  • PROJECT_ID: o ID do projeto de destino Google Cloud .
  • 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.
  • ATTACHMENT_ID: um ID que identifica exclusivamente esse anexo de interconexão.
  • LABELS: uma lista de rótulos a serem aplicados a este recurso de anexação de interconexão.
  • INTERCONNECT_NAME: o nome da interconexão a que este anexo de interconexão se conecta.
  • NETWORK_NAME: a rede que esse recurso de anexo de interconexão atende.
  • VLAN_ID: o ID da VLAN da sub-rede que este anexo de interconexão instancia no roteador. Os valores válidos estão entre 2 e 4095. Um valor de 0 configura a sub-rede como não identificada.
  • MTU_SIZE: o tamanho da unidade máxima de transmissão (MTU) para a sub-rede que este anexo de interconexão instancia. Os valores válidos são 1.500 e 9.000.

Listar anexos de interconexão

Para listar os anexos de interconexão da nuvem distribuída em uma zona da nuvem distribuída, siga as etapas nesta 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 interconnects attachments list:

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

Substitua:

  • 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 GET ao método projects.locations.zones.interconnectAttachments.list:

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

Substitua:

  • PROJECT_ID: o ID do projeto de destino Google Cloud .
  • 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.
  • 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 a próxima página de resultados.

Receber informações sobre um anexo de interconexão

Para receber informações sobre um anexo de interconexão da nuvem distribuída, 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 interconnects attachments describe:

gcloud edge-cloud networking interconnects attachments describe ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ATTACHMENT_NAME: o nome do anexo de interconexão 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 GET ao método projects.locations.zones.interconnectAttachments.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments/ATTACHMENT_ID

Substitua:

  • PROJECT_ID: o ID do projeto de destino Google Cloud .
  • ATTACHMENT_ID: o nome do anexo de interconexão 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.

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

  • 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 um anexo de interconexão

Para excluir um anexo de interconexão 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) no projeto Google Cloud .

gcloud

Use o comando gcloud edge-cloud networking interconnects attachments delete:

gcloud edge-cloud networking interconnects attachments delete ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Substitua:

  • ATTACHMENT_NAME: o nome do anexo de interconexão 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.interconnectAttachments.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 .
  • ATTACHMENT_NAME: o nome do anexo de interconexão 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.

A seguir