Crea y administra archivos adjuntos de interconexión

En esta página, se describe cómo crear y administrar recursos de adjuntos de interconexión de Google Distributed Cloud en una zona de Distributed Cloud.

Para obtener más información sobre los adjuntos de interconexión de Distributed Cloud, consulta Cómo funciona Distributed Cloud.

Ten en cuenta lo siguiente:

  • Te recomendamos que crees un adjunto de interconexión junto con su router correspondiente al mismo tiempo. Para obtener más información, consulta Crea un router.
  • De manera opcional, puedes especificar un ID de VLAN para etiquetar los paquetes que pasan por el adjunto de interconexión.
  • El ID de VLAN que especificas para el etiquetado de paquetes es local para el adjunto de interconexión. En otras palabras, un adjunto de interconexión determinado no forma parte del mismo dominio de capa 2 que los adjuntos de interconexión asociados con otras interconexiones o subredes que no están asociadas con ningún adjunto de interconexión. Por lo tanto, si bien el ID de VLAN especificado para el etiquetado de paquetes debe ser único en todos los adjuntos de interconexión creados en la interconexión de destino, se puede volver a usar en otras interconexiones y en subredes que no estén asociadas con un adjunto de interconexión.

Crea un adjunto de interconexión

Para crear un adjunto de interconexión de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el 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

Reemplaza lo siguiente:

  • ATTACHMENT_NAME: Es un nombre descriptivo que identifica de forma única este adjunto de interconexión.
  • INTERCONNECT_NAME: Es el nombre de la interconexión a la que se conecta este adjunto de interconexión.
  • NETWORK_NAME: Es el nombre de la red de Distributed Cloud que entrega este recurso de adjunto de interconexión.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • VLAN_ID (opcional): Es el ID de VLAN con el que se etiquetan los paquetes que pasan por este adjunto de interconexión. Los valores válidos están entre 2 y 4095. Si omites este valor o lo configuras en 0, los paquetes no se etiquetan.
  • MTU_SIZE: Es el tamaño de la unidad de transmisión máxima (MTU) para la subred que instancia este adjunto de interconexión. Los valores válidos son 1500 y 9000.

API

Realiza una solicitud POST al 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,
   },       
 }

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de destino Google Cloud .
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • ATTACHMENT_ID: Es un ID que identifica de forma única este adjunto de interconexión.
  • LABELS: Es una lista de etiquetas para aplicar a este recurso de adjunto de interconexión.
  • INTERCONNECT_NAME: Es el nombre de la interconexión a la que se conecta este adjunto de interconexión.
  • NETWORK_NAME: Es la red que entrega este recurso de adjunto de interconexión.
  • VLAN_ID: Es el ID de VLAN para la subred que instancia este adjunto de interconexión en el router. Los valores válidos están entre 2 y 4095. Un valor de 0 configura la subred como no etiquetada.
  • MTU_SIZE: Es el tamaño de la unidad de transmisión máxima (MTU) para la subred que instancia este adjunto de interconexión. Los valores válidos son 1500 y 9000.

Mostrar lista de archivos adjuntos de interconexión

Para enumerar los adjuntos de interconexión de Distributed Cloud en una zona de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de red perimetral (roles/edgenetwork.viewer) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking interconnects attachments list:

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

Reemplaza lo siguiente:

  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

API

Realiza una solicitud GET al 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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de destino Google Cloud .
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.
  • FILTER: Es una expresión que restringe los resultados que se muestran a valores específicos.
  • PAGE_SIZE: Es la cantidad de resultados que se mostrarán por página.
  • SORT_BY: Es una lista de nombres de campos delimitados por comas por los que se ordenan los resultados que se muestran. El orden de clasificación predeterminado es ascendente. Para el orden de clasificación descendente, antepón el campo deseado con ~.
  • PAGE_TOKEN: Es un token que se recibe en la respuesta a la última solicitud de lista en el campo nextPageToken de la respuesta. Envía este token para recibir la siguiente página de resultados.

Obtén información sobre un adjunto de interconexión

Para obtener información sobre un adjunto de interconexión de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de red perimetral (roles/edgenetwork.viewer) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking interconnects attachments describe:

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

Reemplaza lo siguiente:

  • ATTACHMENT_NAME: Es el nombre del adjunto de interconexión de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

API

Realiza una solicitud GET al método projects.locations.zones.interconnectAttachments.get:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de destino Google Cloud .
  • ATTACHMENT_ID: Es el nombre del adjunto de interconexión de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

Esta operación devuelve información detallada sobre el recurso, incluido su estado de aprovisionamiento, de la siguiente manera:

  • PENDING: El recurso aún no comenzó el aprovisionamiento y aún no se propagó por toda la zona.
  • PROVISIONING: Se está aprovisionando el recurso. Debes esperar hasta que se propague por toda la zona.
  • RUNNING: El recurso se aprovisionó y propagó correctamente por toda la zona. Está listo para usarse.
  • FAILED: No se pudo aprovisionar el recurso. El recurso no se propagó por toda la zona.

Borra un adjunto de interconexión

Para borrar un adjunto de interconexión de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de red perimetral (roles/edgenetwork.admin) en tu Google Cloud proyecto.

gcloud

Usa el comando gcloud edge-cloud networking interconnects attachments delete:

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

Reemplaza lo siguiente:

  • ATTACHMENT_NAME: Es el nombre del adjunto de interconexión de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

API

Realiza una solicitud DELETE al método projects.locations.zones.interconnectAttachments.delete:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de destino Google Cloud .
  • ATTACHMENT_NAME: Es el nombre del adjunto de interconexión de destino.
  • REGION: Es la Google Cloud región a la que pertenece la zona de Distributed Cloud de destino.
  • ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino.

¿Qué sigue?