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