View VLAN attachments

You can view a list of all the VLAN attachments in your project and the details about each one. For example, you can view the name of an attachment, whether it's an attachment for Dedicated Interconnect or Partner Interconnect, and its associated Cloud Router.

Console

  1. In the Google Cloud console, go to the Cloud Interconnect VLAN attachments tab.

    Go to VLAN attachments

  2. Select a VLAN attachment to view its details.

gcloud

  1. List all VLAN attachments that are in your project:

    gcloud compute interconnects attachments list

    The output is similar to the following:

    NAME: my-attachment
REGION: us-east1
TYPE: PARTNER
INTERCONNECT: some-partner-interconnect
ROUTER: my-router

NAME: my-second-attachment
REGION: us-west1
TYPE: DEDICATED
INTERCONNECT: some-dedicated-interconnect
ROUTER: my-second-router
...

  2. Describe the VLAN attachment to view more information about it:

    gcloud compute interconnects attachments describe NAME

    Replace NAME with the name of your VLAN attachment.

    The output is similar to the following for IPv4 VLAN attachments:

    adminEnabled: false
edgeAvailabilityDomain: AVAILABILITY_DOMAIN_1
bandwidth: BPS_1G
cloudRouterIpAddress: 169.254.67.201/29
creationTimestamp: '2017-12-01T08:29:09.886-08:00'
customerRouterIpAddress: 169.254.67.202/29
id: '7976913826166357434'
kind: compute#interconnectAttachment
labelFingerprint: 42WmSpB8rSM=
name: NAME
pairingKey: 7e51371e-72a3-40b5-b844-2e3efefaee59/us-central1/2
partnerMetadata:
  interconnectName: New York (2)
  partnerName: My Service Provider Inc
  portalUrl: https://service-provider-portal.com
region: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-central1
router: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-central1/routers/my-router
selfLink: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-central1/interconnectAttachments/NAME
stackType: IPV4_ONLY
state: PENDING_CUSTOMER
type: PARTNER
vlanTag8021q: 1000

    The output is similar to the following for IPv4 and IPv6 (dual stack) VLAN attachments:

    adminEnabled: true
edgeAvailabilityDomain: AVAILABILITY_DOMAIN_1
bandwidth: BPS_1G
cloudRouterIpAddress: 169.254.67.201/29
cloudRouterIpv6Address: 2600:2d00:0:1::1/125
creationTimestamp: '2017-12-01T08:31:11.580-08:00'
customerRouterIpAddress: 169.254.67.202/29
customerRouterIpv6Address: 2600:2d00:0:1::2/125
description: Interconnect for Customer 1
id: '7193021941765913888'
interconnect: https://www.googleapis.com/compute/alpha/projects/partner-project/global/interconnects/lga-2
kind: compute#interconnectAttachment
labelFingerprint: 42WmSpB8rSM=
name: partner-attachment
partnerMetadata:
  interconnectName: New York (2)
  partnerName: Partner Inc
  portalUrl: https://partner-portal.com
region: https://www.googleapis.com/compute/alpha/projects/partner-project/regions/us-central1
selfLink: https://www.googleapis.com/compute/alpha/projects/partner-project/regions/us-central1/interconnectAttachments/customer-attachment
stackType: IPV4_IPV6
state: ACTIVE
type: PARTNER
vlanTag8021q: 1000

Check the Dataplane version of an attachment

After you create a VLAN attachment, you can check the Dataplane version for the attachment.

You can only check the Dataplane version of a VLAN attachment with the Google Cloud CLI and the Compute Engine API. The Dataplane version of an attachment does not appear in the Google Cloud console.

You might need to verify that your attachment is using Dataplane v2 before you enable specific features such as Bidirectional Forwarding Detection (BFD).

gcloud

To check the Dataplane version of the attachment, run the following command:

gcloud compute interconnects attachments describe ATTACHMENT_NAME

Replace ATTACHMENT_NAME with the name of the attachment you are checking.

In the output, look for the dataplaneVersion field with a value of 2.

If the dataplaneVersion field does not appear in the output, the VLAN attachment is using version 1.

The following example output shows a VLAN attachment that uses Dataplane v2.

    adminEnabled: false
    edgeAvailabilityDomain: AVAILABILITY_DOMAIN_1
    bandwidth: BPS_1G
    cloudRouterIpAddress: 169.254.67.201/29
    creationTimestamp: '2017-12-01T08:29:09.886-08:00'
    customerRouterIpAddress: 169.254.67.202/29
    dataplaneVersion: 2
    id: '7976913826166357434'
    kind: compute#interconnectAttachment
    labelFingerprint: 42WmSpB8rSM=
    name: my-attachment
    pairingKey: 7e51371e-72a3-40b5-b844-2e3efefaee59/us-central1/2
    partnerMetadata:
      interconnectName: New York (2)
      partnerName: My Service Provider Inc
      portalUrl: https://service-provider-portal.com
    region: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-central1
    router: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-central1/routers/my-router
    selfLink: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-central1/interconnectAttachments/ATTACHMENT_NAME
    state: PENDING_CUSTOMER
    type: PARTNER
    vlanTag8021q: 1000

API

Use the interconnectAttachments.get method to obtain the value of the dataplaneVersion field.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/interconnectAttachments/ATTACHMENT_NAME

Replace the following:

  • PROJECT_ID: the project that contains the VLAN attachment
  • REGION: the region where the VLAN attachment is located
  • ATTACHMENT_NAME: the name of the VLAN attachment

In the output, look for the dataplaneVersion field with a value of 2.

If the dataplaneVersion field does not appear in the output, the VLAN attachment is using version 1.

What's next