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. You can also check its Dataplane version.

View VLAN attachments and their details

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

    Output:

    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 my-attachment

    Output:

    adminEnabled: true
bandwidth: BPS_10G
cloudRouterIpAddress: 169.254.194.169/29
creationTimestamp: '2022-03-04T10:08:51.610-08:00'
customerRouterIpAddress: 169.254.194.170/29
dataplaneVersion: 2
id: '8652605636960316252'
interconnect: https://www.googleapis.com/compute/v1/projects/customer-project/global/interconnects/some-dedicated-interconnect
kind: compute#interconnectAttachment
mtu: 1460
name: my-second-attachment
operationalStatus: OS_ACTIVE
privateInterconnectInfo:
  tag8021q: 1101
region: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-west1
router: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-west1/routers/my-second-router
selfLink: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-west1/interconnectAttachments/my-second-attachment
state: ACTIVE
type: DEDICATED
vlanTag8021q: 1101

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: true
bandwidth: BPS_10G
cloudRouterIpAddress: 169.254.132.105/29
creationTimestamp: '2022-03-04T10:08:11.526-08:00'
customerRouterIpAddress: 169.254.132.106/29
dataplaneVersion: 2
id: '8542849272424426340'
interconnect: https://www.googleapis.com/compute/v1/projects/customer-project/global/interconnects/my-interconnect
kind: compute#interconnectAttachment
mtu: 1460
name: my-attachment
operationalStatus: OS_ACTIVE
privateInterconnectInfo:
  tag8021q: 1100
region: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-west1
router: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-west1/routers/ipv6-cf-test-1
selfLink: https://www.googleapis.com/compute/v1/projects/customer-project/regions/us-west1/interconnectAttachments/my-attachment
state: ACTIVE
type: DEDICATED
vlanTag8021q: 1100

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