pulumi-gcp-kotlin/com.pulumi.gcp.edgenetwork.kotlin/InterconnectAttachment

InterconnectAttachment

class InterconnectAttachment : KotlinCustomResource

A Distributed Cloud Edge interconnect attachment, which connects routers to the northbound network. To get more information about InterconnectAttachment, see:

Example Usage

Edgenetwork Interconnect Attachment

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const exampleNetwork = new gcp.edgenetwork.Network("example_network", {
    networkId: "example-network",
    location: "us-west1",
    zone: "",
    description: "Example network.",
    mtu: 9000,
});
const exampleInterconnectAttachment = new gcp.edgenetwork.InterconnectAttachment("example_interconnect_attachment", {
    interconnectAttachmentId: "example-interconnect-attachment",
    location: "us-west1",
    zone: "",
    description: "Example interconnect attachment.",
    network: exampleNetwork.id,
    interconnect: "11111111-2222-3333-4444-555555555555",
    vlanId: 55,
    mtu: 9000,
    labels: {
        environment: "dev",
    },
});
Content copied to clipboard
import pulumi
import pulumi_gcp as gcp
example_network = gcp.edgenetwork.Network("example_network",
    network_id="example-network",
    location="us-west1",
    zone="",
    description="Example network.",
    mtu=9000)
example_interconnect_attachment = gcp.edgenetwork.InterconnectAttachment("example_interconnect_attachment",
    interconnect_attachment_id="example-interconnect-attachment",
    location="us-west1",
    zone="",
    description="Example interconnect attachment.",
    network=example_network.id,
    interconnect="11111111-2222-3333-4444-555555555555",
    vlan_id=55,
    mtu=9000,
    labels={
        "environment": "dev",
    })
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
    var exampleNetwork = new Gcp.EdgeNetwork.Network("example_network", new()
    {
        NetworkId = "example-network",
        Location = "us-west1",
        Zone = "",
        Description = "Example network.",
        Mtu = 9000,
    });
    var exampleInterconnectAttachment = new Gcp.EdgeNetwork.InterconnectAttachment("example_interconnect_attachment", new()
    {
        InterconnectAttachmentId = "example-interconnect-attachment",
        Location = "us-west1",
        Zone = "",
        Description = "Example interconnect attachment.",
        Network = exampleNetwork.Id,
        Interconnect = "11111111-2222-3333-4444-555555555555",
        VlanId = 55,
        Mtu = 9000,
        Labels =
        {
            { "environment", "dev" },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/edgenetwork"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleNetwork, err := edgenetwork.NewNetwork(ctx, "example_network", &edgenetwork.NetworkArgs{
			NetworkId:   pulumi.String("example-network"),
			Location:    pulumi.String("us-west1"),
			Zone:        pulumi.String(""),
			Description: pulumi.String("Example network."),
			Mtu:         pulumi.Int(9000),
		})
		if err != nil {
			return err
		}
		_, err = edgenetwork.NewInterconnectAttachment(ctx, "example_interconnect_attachment", &edgenetwork.InterconnectAttachmentArgs{
			InterconnectAttachmentId: pulumi.String("example-interconnect-attachment"),
			Location:                 pulumi.String("us-west1"),
			Zone:                     pulumi.String(""),
			Description:              pulumi.String("Example interconnect attachment."),
			Network:                  exampleNetwork.ID(),
			Interconnect:             pulumi.String("11111111-2222-3333-4444-555555555555"),
			VlanId:                   pulumi.Int(55),
			Mtu:                      pulumi.Int(9000),
			Labels: pulumi.StringMap{
				"environment": pulumi.String("dev"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.edgenetwork.Network;
import com.pulumi.gcp.edgenetwork.NetworkArgs;
import com.pulumi.gcp.edgenetwork.InterconnectAttachment;
import com.pulumi.gcp.edgenetwork.InterconnectAttachmentArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var exampleNetwork = new Network("exampleNetwork", NetworkArgs.builder()
            .networkId("example-network")
            .location("us-west1")
            .zone("")
            .description("Example network.")
            .mtu(9000)
            .build());
        var exampleInterconnectAttachment = new InterconnectAttachment("exampleInterconnectAttachment", InterconnectAttachmentArgs.builder()
            .interconnectAttachmentId("example-interconnect-attachment")
            .location("us-west1")
            .zone("")
            .description("Example interconnect attachment.")
            .network(exampleNetwork.id())
            .interconnect("11111111-2222-3333-4444-555555555555")
            .vlanId(55)
            .mtu(9000)
            .labels(Map.of("environment", "dev"))
            .build());
    }
}
Content copied to clipboard
resources:
  exampleInterconnectAttachment:
    type: gcp:edgenetwork:InterconnectAttachment
    name: example_interconnect_attachment
    properties:
      interconnectAttachmentId: example-interconnect-attachment
      location: us-west1
      zone: ""
      description: Example interconnect attachment.
      network: ${exampleNetwork.id}
      interconnect: 11111111-2222-3333-4444-555555555555
      vlanId: 55
      mtu: 9000
      labels:
        environment: dev
  exampleNetwork:
    type: gcp:edgenetwork:Network
    name: example_network
    properties:
      networkId: example-network
      location: us-west1
      zone: ""
      description: Example network.
      mtu: 9000
Content copied to clipboard

Import

InterconnectAttachment can be imported using any of these accepted formats:

  • projects/{{project}}/locations/{{location}}/zones/{{zone}}/interconnectAttachment/{{interconnect_attachment_id}}

  • {{project}}/{{location}}/{{zone}}/{{interconnect_attachment_id}}

  • {{location}}/{{zone}}/{{interconnect_attachment_id}}

  • {{location}}/{{interconnect_attachment_id}}

  • {{name}} When using the pulumi import command, InterconnectAttachment can be imported using one of the formats above. For example:

$ pulumi import gcp:edgenetwork/interconnectAttachment:InterconnectAttachment default projects/{{project}}/locations/{{location}}/zones/{{zone}}/interconnectAttachment/{{interconnect_attachment_id}}
Content copied to clipboard
$ pulumi import gcp:edgenetwork/interconnectAttachment:InterconnectAttachment default {{project}}/{{location}}/{{zone}}/{{interconnect_attachment_id}}
Content copied to clipboard
$ pulumi import gcp:edgenetwork/interconnectAttachment:InterconnectAttachment default {{location}}/{{zone}}/{{interconnect_attachment_id}}
Content copied to clipboard
$ pulumi import gcp:edgenetwork/interconnectAttachment:InterconnectAttachment default {{location}}/{{interconnect_attachment_id}}
Content copied to clipboard
$ pulumi import gcp:edgenetwork/interconnectAttachment:InterconnectAttachment default {{name}}
Content copied to clipboard

Properties

Link copied to clipboard
val createTime: Output<String>

The time when the resource was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: 2014-10-02T15:01:23Z and 2014-10-02T15:01:23.045123456Z.

Link copied to clipboard
val description: Output<String>?

A free-text description of the resource. Max length 1024 characters.

Link copied to clipboard
val effectiveLabels: Output<Map<String, String>>

All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val interconnect: Output<String>

The ID of the underlying interconnect that this attachment's traffic will traverse through.

Link copied to clipboard
val interconnectAttachmentId: Output<String>

A unique ID that identifies this interconnect attachment.

Link copied to clipboard
val labels: Output<Map<String, String>>?

Labels associated with this resource. Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

Link copied to clipboard
val location: Output<String>

The Google Cloud region to which the target Distributed Cloud Edge zone belongs.

Link copied to clipboard
val mtu: Output<Int>?

IP (L3) MTU value of the virtual edge cloud. Default value is 1500. Possible values are: 1500, 9000.

Link copied to clipboard
val name: Output<String>

The canonical name of this resource, with format projects/{{project}}/locations/{{location}}/zones/{{zone}}/interconnectAttachments/{{interconnect_attachment_id}}

Link copied to clipboard
val network: Output<String>

The ID of the network to which this interconnect attachment belongs. Must be of the form: projects/{{project}}/locations/{{location}}/zones/{{zone}}/networks/{{network_id}}

Link copied to clipboard
val project: Output<String>

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
val pulumiLabels: Output<Map<String, String>>

The combination of labels configured directly on the resource and default labels configured on the provider.

Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val updateTime: Output<String>

The time when the resource was last updated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: 2014-10-02T15:01:23Z and 2014-10-02T15:01:23.045123456Z.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val vlanId: Output<Int>

VLAN ID provided by user. Must be site-wise unique.

Link copied to clipboard
val zone: Output<String>

The name of the target Distributed Cloud Edge zone.