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