Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Equinix
  3. API Docs
  4. metal
  5. Interconnection
Equinix v0.18.0 published on Monday, Sep 23, 2024 by Equinix
equinix/pulumi-equinix

equinix.metal.Interconnection

Explore with Pulumi AI

equinix logo
Equinix v0.18.0 published on Monday, Sep 23, 2024 by Equinix
equinix/pulumi-equinix

    Use this resource to request the creation an Interconnection asset to connect with other parties using Equinix Fabric - software-defined interconnections.

    Equinix Metal connection with with Service Token A-side / Z-side (service_token_type) is not generally available and may not be enabled yet for your organization.

    Example Usage

    example shared metal fabric connection from fcr

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Equinix = Pulumi.Equinix;

return await Deployment.RunAsync(() => 
{
    var example1 = new Equinix.Metal.Vlan("example1", new()
    {
        ProjectId = myProjectId,
        Metro = "SV",
    });

    var example = new Equinix.Metal.Interconnection("example", new()
    {
        Name = "tf-port-to-metal-legacy",
        ProjectId = myProjectId,
        Metro = "SV",
        Redundancy = "primary",
        Type = "shared_port_vlan",
        ContactEmail = "username@example.com",
        Vlans = new[]
        {
            example1.Vxlan,
        },
    });

    var exampleConnection = new Equinix.Fabric.Connection("exampleConnection", new()
    {
        Name = "tf-NIMF-metal-2-aws-legacy",
        Type = "IP_VC",
        Notifications = new[]
        {
            new Equinix.Fabric.Inputs.ConnectionNotificationArgs
            {
                Type = Equinix.Fabric.NotificationsType.All,
                Emails = "sername@example.com",
            },
        },
        Project = new Equinix.Fabric.Inputs.ConnectionProjectArgs
        {
            ProjectId = fabricProjectId,
        },
        Bandwidth = 200,
        Order = new Equinix.Fabric.Inputs.ConnectionOrderArgs
        {
            PurchaseOrderNumber = "1-323292",
        },
        ASide = new Equinix.Fabric.Inputs.ConnectionASideArgs
        {
            AccessPoint = new Equinix.Fabric.Inputs.ConnectionASideAccessPointArgs
            {
                Type = "CLOUD_ROUTER",
                Router = new Equinix.Fabric.Inputs.ConnectionASideAccessPointRouterArgs
                {
                    Uuid = cloudRouterUuid,
                },
            },
        },
        ZSide = new Equinix.Fabric.Inputs.ConnectionZSideArgs
        {
            AccessPoint = new Equinix.Fabric.Inputs.ConnectionZSideAccessPointArgs
            {
                Type = "METAL_NETWORK",
                AuthenticationKey = example.AuthorizationCode,
            },
        },
    });

});

    package main

import (
	"github.com/equinix/pulumi-equinix/sdk/go/equinix/fabric"
	"github.com/equinix/pulumi-equinix/sdk/go/equinix/metal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example1, err := metal.NewVlan(ctx, "example1", &metal.VlanArgs{
			ProjectId: pulumi.Any(myProjectId),
			Metro:     pulumi.String("SV"),
		})
		if err != nil {
			return err
		}
		example, err := metal.NewInterconnection(ctx, "example", &metal.InterconnectionArgs{
			Name:         pulumi.String("tf-port-to-metal-legacy"),
			ProjectId:    pulumi.Any(myProjectId),
			Metro:        pulumi.String("SV"),
			Redundancy:   pulumi.String("primary"),
			Type:         pulumi.String("shared_port_vlan"),
			ContactEmail: pulumi.String("username@example.com"),
			Vlans: pulumi.IntArray{
				example1.Vxlan,
			},
		})
		if err != nil {
			return err
		}
		_, err = fabric.NewConnection(ctx, "exampleConnection", &fabric.ConnectionArgs{
			Name: pulumi.String("tf-NIMF-metal-2-aws-legacy"),
			Type: pulumi.String("IP_VC"),
			Notifications: fabric.ConnectionNotificationArray{
				&fabric.ConnectionNotificationArgs{
					Type:   pulumi.String(fabric.NotificationsTypeAll),
					Emails: pulumi.StringArray("sername@example.com"),
				},
			},
			Project: &fabric.ConnectionProjectArgs{
				ProjectId: pulumi.Any(fabricProjectId),
			},
			Bandwidth: pulumi.Int(200),
			Order: &fabric.ConnectionOrderArgs{
				PurchaseOrderNumber: pulumi.String("1-323292"),
			},
			ASide: &fabric.ConnectionASideArgs{
				AccessPoint: &fabric.ConnectionASideAccessPointArgs{
					Type: pulumi.String("CLOUD_ROUTER"),
					Router: &fabric.ConnectionASideAccessPointRouterArgs{
						Uuid: pulumi.Any(cloudRouterUuid),
					},
				},
			},
			ZSide: &fabric.ConnectionZSideArgs{
				AccessPoint: &fabric.ConnectionZSideAccessPointArgs{
					Type:              pulumi.String("METAL_NETWORK"),
					AuthenticationKey: example.AuthorizationCode,
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.equinix.metal.Vlan;
import com.pulumi.equinix.metal.VlanArgs;
import com.pulumi.equinix.metal.Interconnection;
import com.pulumi.equinix.metal.InterconnectionArgs;
import com.pulumi.equinix.fabric.Connection;
import com.pulumi.equinix.fabric.ConnectionArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionNotificationArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionProjectArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionOrderArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionASideArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionASideAccessPointArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionASideAccessPointRouterArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionZSideArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionZSideAccessPointArgs;
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 example1 = new Vlan("example1", VlanArgs.builder()
            .projectId(myProjectId)
            .metro("SV")
            .build());

        var example = new Interconnection("example", InterconnectionArgs.builder()
            .name("tf-port-to-metal-legacy")
            .projectId(myProjectId)
            .metro("SV")
            .redundancy("primary")
            .type("shared_port_vlan")
            .contactEmail("username@example.com")
            .vlans(example1.vxlan())
            .build());

        var exampleConnection = new Connection("exampleConnection", ConnectionArgs.builder()
            .name("tf-NIMF-metal-2-aws-legacy")
            .type("IP_VC")
            .notifications(ConnectionNotificationArgs.builder()
                .type("ALL")
                .emails("sername@example.com")
                .build())
            .project(ConnectionProjectArgs.builder()
                .projectId(fabricProjectId)
                .build())
            .bandwidth("200")
            .order(ConnectionOrderArgs.builder()
                .purchaseOrderNumber("1-323292")
                .build())
            .aSide(ConnectionASideArgs.builder()
                .accessPoint(ConnectionASideAccessPointArgs.builder()
                    .type("CLOUD_ROUTER")
                    .router(ConnectionASideAccessPointRouterArgs.builder()
                        .uuid(cloudRouterUuid)
                        .build())
                    .build())
                .build())
            .zSide(ConnectionZSideArgs.builder()
                .accessPoint(ConnectionZSideAccessPointArgs.builder()
                    .type("METAL_NETWORK")
                    .authenticationKey(example.authorizationCode())
                    .build())
                .build())
            .build());

    }
}

    import pulumi
import pulumi_equinix as equinix

example1 = equinix.metal.Vlan("example1",
    project_id=my_project_id,
    metro="SV")
example = equinix.metal.Interconnection("example",
    name="tf-port-to-metal-legacy",
    project_id=my_project_id,
    metro="SV",
    redundancy="primary",
    type="shared_port_vlan",
    contact_email="username@example.com",
    vlans=[example1.vxlan])
example_connection = equinix.fabric.Connection("exampleConnection",
    name="tf-NIMF-metal-2-aws-legacy",
    type="IP_VC",
    notifications=[{
        "type": equinix.fabric.NotificationsType.ALL,
        "emails": "sername@example.com",
    }],
    project={
        "project_id": fabric_project_id,
    },
    bandwidth=200,
    order={
        "purchase_order_number": "1-323292",
    },
    a_side={
        "access_point": {
            "type": "CLOUD_ROUTER",
            "router": {
                "uuid": cloud_router_uuid,
            },
        },
    },
    z_side={
        "access_point": {
            "type": "METAL_NETWORK",
            "authentication_key": example.authorization_code,
        },
    })

    import * as pulumi from "@pulumi/pulumi";
import * as equinix from "@equinix-labs/pulumi-equinix";

const example1 = new equinix.metal.Vlan("example1", {
    projectId: myProjectId,
    metro: "SV",
});
const example = new equinix.metal.Interconnection("example", {
    name: "tf-port-to-metal-legacy",
    projectId: myProjectId,
    metro: "SV",
    redundancy: "primary",
    type: "shared_port_vlan",
    contactEmail: "username@example.com",
    vlans: [example1.vxlan],
});
const exampleConnection = new equinix.fabric.Connection("exampleConnection", {
    name: "tf-NIMF-metal-2-aws-legacy",
    type: "IP_VC",
    notifications: [{
        type: equinix.fabric.NotificationsType.All,
        emails: "sername@example.com",
    }],
    project: {
        projectId: fabricProjectId,
    },
    bandwidth: 200,
    order: {
        purchaseOrderNumber: "1-323292",
    },
    aSide: {
        accessPoint: {
            type: "CLOUD_ROUTER",
            router: {
                uuid: cloudRouterUuid,
            },
        },
    },
    zSide: {
        accessPoint: {
            type: "METAL_NETWORK",
            authenticationKey: example.authorizationCode,
        },
    },
});

    resources:
  example1:
    type: equinix:metal:Vlan
    properties:
      projectId: ${myProjectId}
      metro: SV
  example:
    type: equinix:metal:Interconnection
    properties:
      name: tf-port-to-metal-legacy
      projectId: ${myProjectId}
      metro: SV
      redundancy: primary
      type: shared_port_vlan
      contactEmail: username@example.com
      vlans:
        - ${example1.vxlan}
  exampleConnection:
    type: equinix:fabric:Connection
    name: example
    properties:
      name: tf-NIMF-metal-2-aws-legacy
      type: IP_VC
      notifications:
        - type: ALL
          emails: sername@example.com
      project:
        projectId: ${fabricProjectId}
      bandwidth: '200'
      order:
        purchaseOrderNumber: 1-323292
      aSide:
        accessPoint:
          type: CLOUD_ROUTER
          router:
            uuid: ${cloudRouterUuid}
      zSide:
        accessPoint:
          type: METAL_NETWORK
          authenticationKey: ${example.authorizationCode}

    example shared metal fabric connection to csp

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Equinix = Pulumi.Equinix;

return await Deployment.RunAsync(() => 
{
    var zside = Equinix.Fabric.GetServiceProfiles.Invoke(new()
    {
        Filter = new Equinix.Fabric.Inputs.GetServiceProfilesFilterInputArgs
        {
            Property = "/name",
            Operator = "=",
            Values = new[]
            {
                "AWS Direct Connect",
            },
        },
    });

    var example1 = new Equinix.Metal.Vlan("example1", new()
    {
        ProjectId = myProjectId,
        Metro = "SV",
    });

    var example = new Equinix.Metal.Interconnection("example", new()
    {
        Name = "tf-port-to-metal-legacy",
        ProjectId = myProjectId,
        Metro = "SV",
        Redundancy = "primary",
        Type = "shared_port_vlan",
        ContactEmail = "username@example.com",
        Vlans = new[]
        {
            example1.Vxlan,
        },
    });

    var exampleConnection = new Equinix.Fabric.Connection("exampleConnection", new()
    {
        Name = "tf-NIMF-metal-2-aws-legacy",
        Type = Equinix.Fabric.ConnectionType.EVPL,
        Notifications = new[]
        {
            new Equinix.Fabric.Inputs.ConnectionNotificationArgs
            {
                Type = Equinix.Fabric.NotificationsType.All,
                Emails = "sername@example.com",
            },
        },
        Project = new Equinix.Fabric.Inputs.ConnectionProjectArgs
        {
            ProjectId = fabricProjectId,
        },
        Bandwidth = 200,
        Order = new Equinix.Fabric.Inputs.ConnectionOrderArgs
        {
            PurchaseOrderNumber = "1-323292",
        },
        ASide = new Equinix.Fabric.Inputs.ConnectionASideArgs
        {
            AccessPoint = new Equinix.Fabric.Inputs.ConnectionASideAccessPointArgs
            {
                Type = "METAL_NETWORK",
                AuthenticationKey = example.AuthorizationCode,
            },
        },
        ZSide = new Equinix.Fabric.Inputs.ConnectionZSideArgs
        {
            AccessPoint = new Equinix.Fabric.Inputs.ConnectionZSideAccessPointArgs
            {
                Type = Equinix.Fabric.AccessPointType.SP,
                AuthenticationKey = awsAccountId,
                SellerRegion = "us-west-1",
                Profile = new Equinix.Fabric.Inputs.ConnectionZSideAccessPointProfileArgs
                {
                    Type = Equinix.Fabric.ProfileType.L2Profile,
                    Uuid = zside.Apply(getServiceProfilesResult => getServiceProfilesResult.Id),
                },
                Location = new Equinix.Fabric.Inputs.ConnectionZSideAccessPointLocationArgs
                {
                    MetroCode = Equinix.Metro.SiliconValley,
                },
            },
        },
    });

});

    package main

import (
	"github.com/equinix/pulumi-equinix/sdk/go/equinix"
	"github.com/equinix/pulumi-equinix/sdk/go/equinix/fabric"
	"github.com/equinix/pulumi-equinix/sdk/go/equinix/metal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		zside, err := fabric.GetServiceProfiles(ctx, &fabric.GetServiceProfilesArgs{
			Filter: fabric.GetServiceProfilesFilter{
				Property: "/name",
				Operator: "=",
				Values: []string{
					"AWS Direct Connect",
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		example1, err := metal.NewVlan(ctx, "example1", &metal.VlanArgs{
			ProjectId: pulumi.Any(myProjectId),
			Metro:     pulumi.String("SV"),
		})
		if err != nil {
			return err
		}
		example, err := metal.NewInterconnection(ctx, "example", &metal.InterconnectionArgs{
			Name:         pulumi.String("tf-port-to-metal-legacy"),
			ProjectId:    pulumi.Any(myProjectId),
			Metro:        pulumi.String("SV"),
			Redundancy:   pulumi.String("primary"),
			Type:         pulumi.String("shared_port_vlan"),
			ContactEmail: pulumi.String("username@example.com"),
			Vlans: pulumi.IntArray{
				example1.Vxlan,
			},
		})
		if err != nil {
			return err
		}
		_, err = fabric.NewConnection(ctx, "exampleConnection", &fabric.ConnectionArgs{
			Name: pulumi.String("tf-NIMF-metal-2-aws-legacy"),
			Type: pulumi.String(fabric.ConnectionTypeEVPL),
			Notifications: fabric.ConnectionNotificationArray{
				&fabric.ConnectionNotificationArgs{
					Type:   pulumi.String(fabric.NotificationsTypeAll),
					Emails: pulumi.StringArray("sername@example.com"),
				},
			},
			Project: &fabric.ConnectionProjectArgs{
				ProjectId: pulumi.Any(fabricProjectId),
			},
			Bandwidth: pulumi.Int(200),
			Order: &fabric.ConnectionOrderArgs{
				PurchaseOrderNumber: pulumi.String("1-323292"),
			},
			ASide: &fabric.ConnectionASideArgs{
				AccessPoint: &fabric.ConnectionASideAccessPointArgs{
					Type:              pulumi.String("METAL_NETWORK"),
					AuthenticationKey: example.AuthorizationCode,
				},
			},
			ZSide: &fabric.ConnectionZSideArgs{
				AccessPoint: &fabric.ConnectionZSideAccessPointArgs{
					Type:              pulumi.String(fabric.AccessPointTypeSP),
					AuthenticationKey: pulumi.Any(awsAccountId),
					SellerRegion:      pulumi.String("us-west-1"),
					Profile: &fabric.ConnectionZSideAccessPointProfileArgs{
						Type: pulumi.String(fabric.ProfileTypeL2Profile),
						Uuid: pulumi.String(zside.Id),
					},
					Location: &fabric.ConnectionZSideAccessPointLocationArgs{
						MetroCode: pulumi.String(equinix.MetroSiliconValley),
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.equinix.fabric.FabricFunctions;
import com.pulumi.equinix.fabric.inputs.GetServiceProfilesArgs;
import com.pulumi.equinix.fabric.inputs.GetServiceProfilesFilterArgs;
import com.pulumi.equinix.metal.Vlan;
import com.pulumi.equinix.metal.VlanArgs;
import com.pulumi.equinix.metal.Interconnection;
import com.pulumi.equinix.metal.InterconnectionArgs;
import com.pulumi.equinix.fabric.Connection;
import com.pulumi.equinix.fabric.ConnectionArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionNotificationArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionProjectArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionOrderArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionASideArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionASideAccessPointArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionZSideArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionZSideAccessPointArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionZSideAccessPointProfileArgs;
import com.pulumi.equinix.fabric.inputs.ConnectionZSideAccessPointLocationArgs;
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) {
        final var zside = FabricFunctions.getServiceProfiles(GetServiceProfilesArgs.builder()
            .filter(GetServiceProfilesFilterArgs.builder()
                .property("/name")
                .operator("=")
                .values("AWS Direct Connect")
                .build())
            .build());

        var example1 = new Vlan("example1", VlanArgs.builder()
            .projectId(myProjectId)
            .metro("SV")
            .build());

        var example = new Interconnection("example", InterconnectionArgs.builder()
            .name("tf-port-to-metal-legacy")
            .projectId(myProjectId)
            .metro("SV")
            .redundancy("primary")
            .type("shared_port_vlan")
            .contactEmail("username@example.com")
            .vlans(example1.vxlan())
            .build());

        var exampleConnection = new Connection("exampleConnection", ConnectionArgs.builder()
            .name("tf-NIMF-metal-2-aws-legacy")
            .type("EVPL_VC")
            .notifications(ConnectionNotificationArgs.builder()
                .type("ALL")
                .emails("sername@example.com")
                .build())
            .project(ConnectionProjectArgs.builder()
                .projectId(fabricProjectId)
                .build())
            .bandwidth("200")
            .order(ConnectionOrderArgs.builder()
                .purchaseOrderNumber("1-323292")
                .build())
            .aSide(ConnectionASideArgs.builder()
                .accessPoint(ConnectionASideAccessPointArgs.builder()
                    .type("METAL_NETWORK")
                    .authenticationKey(example.authorizationCode())
                    .build())
                .build())
            .zSide(ConnectionZSideArgs.builder()
                .accessPoint(ConnectionZSideAccessPointArgs.builder()
                    .type("SP")
                    .authenticationKey(awsAccountId)
                    .sellerRegion("us-west-1")
                    .profile(ConnectionZSideAccessPointProfileArgs.builder()
                        .type("L2_PROFILE")
                        .uuid(zside.applyValue(getServiceProfilesResult -> getServiceProfilesResult.id()))
                        .build())
                    .location(ConnectionZSideAccessPointLocationArgs.builder()
                        .metroCode("SV")
                        .build())
                    .build())
                .build())
            .build());

    }
}

    import pulumi
import pulumi_equinix as equinix

zside = equinix.fabric.get_service_profiles_output(filter={
    "property": "/name",
    "operator": "=",
    "values": ["AWS Direct Connect"],
})
example1 = equinix.metal.Vlan("example1",
    project_id=my_project_id,
    metro="SV")
example = equinix.metal.Interconnection("example",
    name="tf-port-to-metal-legacy",
    project_id=my_project_id,
    metro="SV",
    redundancy="primary",
    type="shared_port_vlan",
    contact_email="username@example.com",
    vlans=[example1.vxlan])
example_connection = equinix.fabric.Connection("exampleConnection",
    name="tf-NIMF-metal-2-aws-legacy",
    type=equinix.fabric.ConnectionType.EVPL,
    notifications=[{
        "type": equinix.fabric.NotificationsType.ALL,
        "emails": "sername@example.com",
    }],
    project={
        "project_id": fabric_project_id,
    },
    bandwidth=200,
    order={
        "purchase_order_number": "1-323292",
    },
    a_side={
        "access_point": {
            "type": "METAL_NETWORK",
            "authentication_key": example.authorization_code,
        },
    },
    z_side={
        "access_point": {
            "type": equinix.fabric.AccessPointType.SP,
            "authentication_key": aws_account_id,
            "seller_region": "us-west-1",
            "profile": {
                "type": equinix.fabric.ProfileType.L2_PROFILE,
                "uuid": zside.id,
            },
            "location": {
                "metro_code": equinix.Metro.SILICON_VALLEY,
            },
        },
    })

    import * as pulumi from "@pulumi/pulumi";
import * as equinix from "@equinix-labs/pulumi-equinix";
import * as equinix from "@pulumi/equinix";

const zside = equinix.fabric.getServiceProfilesOutput({
    filter: {
        property: "/name",
        operator: "=",
        values: ["AWS Direct Connect"],
    },
});
const example1 = new equinix.metal.Vlan("example1", {
    projectId: myProjectId,
    metro: "SV",
});
const example = new equinix.metal.Interconnection("example", {
    name: "tf-port-to-metal-legacy",
    projectId: myProjectId,
    metro: "SV",
    redundancy: "primary",
    type: "shared_port_vlan",
    contactEmail: "username@example.com",
    vlans: [example1.vxlan],
});
const exampleConnection = new equinix.fabric.Connection("exampleConnection", {
    name: "tf-NIMF-metal-2-aws-legacy",
    type: equinix.fabric.ConnectionType.EVPL,
    notifications: [{
        type: equinix.fabric.NotificationsType.All,
        emails: "sername@example.com",
    }],
    project: {
        projectId: fabricProjectId,
    },
    bandwidth: 200,
    order: {
        purchaseOrderNumber: "1-323292",
    },
    aSide: {
        accessPoint: {
            type: "METAL_NETWORK",
            authenticationKey: example.authorizationCode,
        },
    },
    zSide: {
        accessPoint: {
            type: equinix.fabric.AccessPointType.SP,
            authenticationKey: awsAccountId,
            sellerRegion: "us-west-1",
            profile: {
                type: equinix.fabric.ProfileType.L2Profile,
                uuid: zside.apply(zside => zside.id),
            },
            location: {
                metroCode: equinix.index.Metro.SiliconValley,
            },
        },
    },
});

    resources:
  example1:
    type: equinix:metal:Vlan
    properties:
      projectId: ${myProjectId}
      metro: SV
  example:
    type: equinix:metal:Interconnection
    properties:
      name: tf-port-to-metal-legacy
      projectId: ${myProjectId}
      metro: SV
      redundancy: primary
      type: shared_port_vlan
      contactEmail: username@example.com
      vlans:
        - ${example1.vxlan}
  exampleConnection:
    type: equinix:fabric:Connection
    name: example
    properties:
      name: tf-NIMF-metal-2-aws-legacy
      type: EVPL_VC
      notifications:
        - type: ALL
          emails: sername@example.com
      project:
        projectId: ${fabricProjectId}
      bandwidth: '200'
      order:
        purchaseOrderNumber: 1-323292
      aSide:
        accessPoint:
          type: METAL_NETWORK
          authenticationKey: ${example.authorizationCode}
      zSide:
        accessPoint:
          type: SP
          authenticationKey: ${awsAccountId}
          sellerRegion: us-west-1
          profile:
            type: L2_PROFILE
            uuid: ${zside.id}
          location:
            metroCode: SV
variables:
  zside:
    fn::invoke:
      Function: equinix:fabric:getServiceProfiles
      Arguments:
        filter:
          property: /name
          operator: =
          values:
            - AWS Direct Connect

    Create Interconnection Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Interconnection(name: string, args: InterconnectionArgs, opts?: CustomResourceOptions);
    @overload
def Interconnection(resource_name: str,
                    args: InterconnectionArgs,
                    opts: Optional[ResourceOptions] = None)

@overload
def Interconnection(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    redundancy: Optional[str] = None,
                    type: Optional[str] = None,
                    organization_id: Optional[str] = None,
                    metro: Optional[str] = None,
                    mode: Optional[str] = None,
                    name: Optional[str] = None,
                    contact_email: Optional[str] = None,
                    project_id: Optional[str] = None,
                    facility: Optional[str] = None,
                    service_token_type: Optional[str] = None,
                    speed: Optional[str] = None,
                    tags: Optional[Sequence[str]] = None,
                    description: Optional[str] = None,
                    vlans: Optional[Sequence[int]] = None,
                    vrfs: Optional[Sequence[str]] = None)
    func NewInterconnection(ctx *Context, name string, args InterconnectionArgs, opts ...ResourceOption) (*Interconnection, error)
    public Interconnection(string name, InterconnectionArgs args, CustomResourceOptions? opts = null)
    public Interconnection(String name, InterconnectionArgs args)
public Interconnection(String name, InterconnectionArgs args, CustomResourceOptions options)

    type: equinix:metal:Interconnection
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args InterconnectionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args InterconnectionArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args InterconnectionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args InterconnectionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args InterconnectionArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var interconnectionResource = new Equinix.Metal.Interconnection("interconnectionResource", new()
{
    Redundancy = "string",
    Type = "string",
    OrganizationId = "string",
    Metro = "string",
    Mode = "string",
    Name = "string",
    ContactEmail = "string",
    ProjectId = "string",
    ServiceTokenType = "string",
    Speed = "string",
    Tags = new[]
    {
        "string",
    },
    Description = "string",
    Vlans = new[]
    {
        0,
    },
    Vrfs = new[]
    {
        "string",
    },
});

    example, err := metal.NewInterconnection(ctx, "interconnectionResource", &metal.InterconnectionArgs{
	Redundancy:       pulumi.String("string"),
	Type:             pulumi.String("string"),
	OrganizationId:   pulumi.String("string"),
	Metro:            pulumi.String("string"),
	Mode:             pulumi.String("string"),
	Name:             pulumi.String("string"),
	ContactEmail:     pulumi.String("string"),
	ProjectId:        pulumi.String("string"),
	ServiceTokenType: pulumi.String("string"),
	Speed:            pulumi.String("string"),
	Tags: pulumi.StringArray{
		pulumi.String("string"),
	},
	Description: pulumi.String("string"),
	Vlans: pulumi.IntArray{
		pulumi.Int(0),
	},
	Vrfs: pulumi.StringArray{
		pulumi.String("string"),
	},
})

    var interconnectionResource = new Interconnection("interconnectionResource", InterconnectionArgs.builder()
    .redundancy("string")
    .type("string")
    .organizationId("string")
    .metro("string")
    .mode("string")
    .name("string")
    .contactEmail("string")
    .projectId("string")
    .serviceTokenType("string")
    .speed("string")
    .tags("string")
    .description("string")
    .vlans(0)
    .vrfs("string")
    .build());

    interconnection_resource = equinix.metal.Interconnection("interconnectionResource",
    redundancy="string",
    type="string",
    organization_id="string",
    metro="string",
    mode="string",
    name="string",
    contact_email="string",
    project_id="string",
    service_token_type="string",
    speed="string",
    tags=["string"],
    description="string",
    vlans=[0],
    vrfs=["string"])

    const interconnectionResource = new equinix.metal.Interconnection("interconnectionResource", {
    redundancy: "string",
    type: "string",
    organizationId: "string",
    metro: "string",
    mode: "string",
    name: "string",
    contactEmail: "string",
    projectId: "string",
    serviceTokenType: "string",
    speed: "string",
    tags: ["string"],
    description: "string",
    vlans: [0],
    vrfs: ["string"],
});

    type: equinix:metal:Interconnection
properties:
    contactEmail: string
    description: string
    metro: string
    mode: string
    name: string
    organizationId: string
    projectId: string
    redundancy: string
    serviceTokenType: string
    speed: string
    tags:
        - string
    type: string
    vlans:
        - 0
    vrfs:
        - string

    Interconnection Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The Interconnection resource accepts the following input properties:

    Redundancy string
    Connection redundancy - redundant or primary.
    Type string
    Connection type - dedicated or shared.
    ContactEmail string
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    Description string
    Description for the connection resource.
    Facility string
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    Metro string
    Metro where the connection will be created.
    Mode string
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    Name string
    Name of the connection resource
    OrganizationId string
    ID of the organization where the connection is scoped to.
    ProjectId string
    ID of the project where the connection is scoped to, must be set for.
    ServiceTokenType string
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    Speed string
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    Tags List<string>
    String list of tags.
    Vlans List<int>
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    Vrfs List<string>
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    Redundancy string
    Connection redundancy - redundant or primary.
    Type string
    Connection type - dedicated or shared.
    ContactEmail string
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    Description string
    Description for the connection resource.
    Facility string
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    Metro string
    Metro where the connection will be created.
    Mode string
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    Name string
    Name of the connection resource
    OrganizationId string
    ID of the organization where the connection is scoped to.
    ProjectId string
    ID of the project where the connection is scoped to, must be set for.
    ServiceTokenType string
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    Speed string
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    Tags []string
    String list of tags.
    Vlans []int
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    Vrfs []string
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    redundancy String
    Connection redundancy - redundant or primary.
    type String
    Connection type - dedicated or shared.
    contactEmail String
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    description String
    Description for the connection resource.
    facility String
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    metro String
    Metro where the connection will be created.
    mode String
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    name String
    Name of the connection resource
    organizationId String
    ID of the organization where the connection is scoped to.
    projectId String
    ID of the project where the connection is scoped to, must be set for.
    serviceTokenType String
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    speed String
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    tags List<String>
    String list of tags.
    vlans List<Integer>
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    vrfs List<String>
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    redundancy string
    Connection redundancy - redundant or primary.
    type string
    Connection type - dedicated or shared.
    contactEmail string
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    description string
    Description for the connection resource.
    facility string
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    metro string
    Metro where the connection will be created.
    mode string
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    name string
    Name of the connection resource
    organizationId string
    ID of the organization where the connection is scoped to.
    projectId string
    ID of the project where the connection is scoped to, must be set for.
    serviceTokenType string
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    speed string
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    tags string[]
    String list of tags.
    vlans number[]
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    vrfs string[]
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    redundancy str
    Connection redundancy - redundant or primary.
    type str
    Connection type - dedicated or shared.
    contact_email str
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    description str
    Description for the connection resource.
    facility str
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    metro str
    Metro where the connection will be created.
    mode str
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    name str
    Name of the connection resource
    organization_id str
    ID of the organization where the connection is scoped to.
    project_id str
    ID of the project where the connection is scoped to, must be set for.
    service_token_type str
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    speed str
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    tags Sequence[str]
    String list of tags.
    vlans Sequence[int]
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    vrfs Sequence[str]
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    redundancy String
    Connection redundancy - redundant or primary.
    type String
    Connection type - dedicated or shared.
    contactEmail String
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    description String
    Description for the connection resource.
    facility String
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    metro String
    Metro where the connection will be created.
    mode String
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    name String
    Name of the connection resource
    organizationId String
    ID of the organization where the connection is scoped to.
    projectId String
    ID of the project where the connection is scoped to, must be set for.
    serviceTokenType String
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    speed String
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    tags List<String>
    String list of tags.
    vlans List<Number>
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    vrfs List<String>
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Interconnection resource produces the following output properties:

    AuthorizationCode string
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    Id string
    The provider-assigned unique ID for this managed resource.
    Ports List<InterconnectionPort>
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    ServiceTokens List<InterconnectionServiceToken>
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    Status string
    Status of the connection resource.
    Token string
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    AuthorizationCode string
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    Id string
    The provider-assigned unique ID for this managed resource.
    Ports []InterconnectionPort
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    ServiceTokens []InterconnectionServiceToken
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    Status string
    Status of the connection resource.
    Token string
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    authorizationCode String
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    id String
    The provider-assigned unique ID for this managed resource.
    ports List<InterconnectionPort>
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    serviceTokens List<InterconnectionServiceToken>
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    status String
    Status of the connection resource.
    token String
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    authorizationCode string
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    id string
    The provider-assigned unique ID for this managed resource.
    ports InterconnectionPort[]
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    serviceTokens InterconnectionServiceToken[]
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    status string
    Status of the connection resource.
    token string
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    authorization_code str
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    id str
    The provider-assigned unique ID for this managed resource.
    ports Sequence[InterconnectionPort]
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    service_tokens Sequence[InterconnectionServiceToken]
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    status str
    Status of the connection resource.
    token str
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    authorizationCode String
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    id String
    The provider-assigned unique ID for this managed resource.
    ports List<Property Map>
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    serviceTokens List<Property Map>
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    status String
    Status of the connection resource.
    token String
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    Look up Existing Interconnection Resource

    Get an existing Interconnection resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: InterconnectionState, opts?: CustomResourceOptions): Interconnection
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        authorization_code: Optional[str] = None,
        contact_email: Optional[str] = None,
        description: Optional[str] = None,
        facility: Optional[str] = None,
        metro: Optional[str] = None,
        mode: Optional[str] = None,
        name: Optional[str] = None,
        organization_id: Optional[str] = None,
        ports: Optional[Sequence[InterconnectionPortArgs]] = None,
        project_id: Optional[str] = None,
        redundancy: Optional[str] = None,
        service_token_type: Optional[str] = None,
        service_tokens: Optional[Sequence[InterconnectionServiceTokenArgs]] = None,
        speed: Optional[str] = None,
        status: Optional[str] = None,
        tags: Optional[Sequence[str]] = None,
        token: Optional[str] = None,
        type: Optional[str] = None,
        vlans: Optional[Sequence[int]] = None,
        vrfs: Optional[Sequence[str]] = None) -> Interconnection
    func GetInterconnection(ctx *Context, name string, id IDInput, state *InterconnectionState, opts ...ResourceOption) (*Interconnection, error)
    public static Interconnection Get(string name, Input<string> id, InterconnectionState? state, CustomResourceOptions? opts = null)
    public static Interconnection get(String name, Output<String> id, InterconnectionState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AuthorizationCode string
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    ContactEmail string
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    Description string
    Description for the connection resource.
    Facility string
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    Metro string
    Metro where the connection will be created.
    Mode string
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    Name string
    Name of the connection resource
    OrganizationId string
    ID of the organization where the connection is scoped to.
    Ports List<InterconnectionPort>
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    ProjectId string
    ID of the project where the connection is scoped to, must be set for.
    Redundancy string
    Connection redundancy - redundant or primary.
    ServiceTokenType string
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    ServiceTokens List<InterconnectionServiceToken>
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    Speed string
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    Status string
    Status of the connection resource.
    Tags List<string>
    String list of tags.
    Token string
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    Type string
    Connection type - dedicated or shared.
    Vlans List<int>
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    Vrfs List<string>
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    AuthorizationCode string
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    ContactEmail string
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    Description string
    Description for the connection resource.
    Facility string
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    Metro string
    Metro where the connection will be created.
    Mode string
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    Name string
    Name of the connection resource
    OrganizationId string
    ID of the organization where the connection is scoped to.
    Ports []InterconnectionPortArgs
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    ProjectId string
    ID of the project where the connection is scoped to, must be set for.
    Redundancy string
    Connection redundancy - redundant or primary.
    ServiceTokenType string
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    ServiceTokens []InterconnectionServiceTokenArgs
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    Speed string
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    Status string
    Status of the connection resource.
    Tags []string
    String list of tags.
    Token string
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    Type string
    Connection type - dedicated or shared.
    Vlans []int
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    Vrfs []string
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    authorizationCode String
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    contactEmail String
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    description String
    Description for the connection resource.
    facility String
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    metro String
    Metro where the connection will be created.
    mode String
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    name String
    Name of the connection resource
    organizationId String
    ID of the organization where the connection is scoped to.
    ports List<InterconnectionPort>
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    projectId String
    ID of the project where the connection is scoped to, must be set for.
    redundancy String
    Connection redundancy - redundant or primary.
    serviceTokenType String
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    serviceTokens List<InterconnectionServiceToken>
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    speed String
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    status String
    Status of the connection resource.
    tags List<String>
    String list of tags.
    token String
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    type String
    Connection type - dedicated or shared.
    vlans List<Integer>
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    vrfs List<String>
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    authorizationCode string
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    contactEmail string
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    description string
    Description for the connection resource.
    facility string
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    metro string
    Metro where the connection will be created.
    mode string
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    name string
    Name of the connection resource
    organizationId string
    ID of the organization where the connection is scoped to.
    ports InterconnectionPort[]
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    projectId string
    ID of the project where the connection is scoped to, must be set for.
    redundancy string
    Connection redundancy - redundant or primary.
    serviceTokenType string
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    serviceTokens InterconnectionServiceToken[]
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    speed string
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    status string
    Status of the connection resource.
    tags string[]
    String list of tags.
    token string
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    type string
    Connection type - dedicated or shared.
    vlans number[]
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    vrfs string[]
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    authorization_code str
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    contact_email str
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    description str
    Description for the connection resource.
    facility str
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    metro str
    Metro where the connection will be created.
    mode str
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    name str
    Name of the connection resource
    organization_id str
    ID of the organization where the connection is scoped to.
    ports Sequence[InterconnectionPortArgs]
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    project_id str
    ID of the project where the connection is scoped to, must be set for.
    redundancy str
    Connection redundancy - redundant or primary.
    service_token_type str
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    service_tokens Sequence[InterconnectionServiceTokenArgs]
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    speed str
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    status str
    Status of the connection resource.
    tags Sequence[str]
    String list of tags.
    token str
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    type str
    Connection type - dedicated or shared.
    vlans Sequence[int]
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    vrfs Sequence[str]
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection
    authorizationCode String
    Fabric Authorization code to configure the Metal-Fabric Integration connection with Cloud Service Provider through Equinix Fabric with the equinix.fabric.Connection resource from the Equinix Developer Portal.
    contactEmail String
    The preferred email used for communication and notifications about the Equinix Fabric interconnection. Required when using a Project API key. Optional and defaults to the primary user email address when using a User API key.
    description String
    Description for the connection resource.
    facility String
    Facility where the connection will be created. Use metro instead; read the facility to metro migration guide

    Deprecated: Use metro instead of facility. For more information, read the migration guide.

    metro String
    Metro where the connection will be created.
    mode String
    Mode for connections in IBX facilities with the dedicated type - standard or tunnel. Default is standard.
    name String
    Name of the connection resource
    organizationId String
    ID of the organization where the connection is scoped to.
    ports List<Property Map>
    List of connection ports - primary (ports[0]) and secondary (ports[1]). Schema of port is described in documentation of the equinix.metal.Interconnection datasource.
    projectId String
    ID of the project where the connection is scoped to, must be set for.
    redundancy String
    Connection redundancy - redundant or primary.
    serviceTokenType String
    Only used with shared connection. Type of service token to use for the connection, a_side or z_side
    serviceTokens List<Property Map>
    List of connection service tokens with attributes required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. Scehma of service_token is described in documentation of the equinix.metal.Interconnection datasource.
    speed String
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    status String
    Status of the connection resource.
    tags List<String>
    String list of tags.
    token String
    (Deprecated) Fabric Token required to configure the connection in Equinix Fabric with the equinix.fabric.Connection resource or from the Equinix Fabric Portal. If your organization already has connection service tokens enabled, use service_tokens instead.

    Deprecated: If your organization already has connection service tokens enabled, use service_tokens instead

    type String
    Connection type - dedicated or shared.
    vlans List<Number>
    Only used with shared connection. Vlans to attach. Pass one vlan for Primary/Single connection and two vlans for Redundant connection.
    vrfs List<String>
    Only used with shared connection. VRFs to attach. Pass one VRF for Primary/Single connection and two VRFs for Redundant connection

    Supporting Types

    InterconnectionPort, InterconnectionPortArgs

    Id string
    LinkStatus string
    Name string
    Name of the connection resource
    Role string
    Speed int
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    Status string
    Status of the connection resource.
    VirtualCircuitIds List<string>
    Id string
    LinkStatus string
    Name string
    Name of the connection resource
    Role string
    Speed int
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    Status string
    Status of the connection resource.
    VirtualCircuitIds []string
    id String
    linkStatus String
    name String
    Name of the connection resource
    role String
    speed Integer
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    status String
    Status of the connection resource.
    virtualCircuitIds List<String>
    id string
    linkStatus string
    name string
    Name of the connection resource
    role string
    speed number
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    status string
    Status of the connection resource.
    virtualCircuitIds string[]
    id str
    link_status str
    name str
    Name of the connection resource
    role str
    speed int
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    status str
    Status of the connection resource.
    virtual_circuit_ids Sequence[str]
    id String
    linkStatus String
    name String
    Name of the connection resource
    role String
    speed Number
    Connection speed - Values must be in the format 'Mbps' or 'Gpbs', for example '100Mbps' or '50Gbps'. Actual supported values will depend on the connection type and whether the connection uses VLANs or VRF.
    status String
    Status of the connection resource.
    virtualCircuitIds List<String>

    InterconnectionServiceToken, InterconnectionServiceTokenArgs

    ExpiresAt string
    Id string
    MaxAllowedSpeed string
    Role string
    State string
    Type string
    Connection type - dedicated or shared.
    ExpiresAt string
    Id string
    MaxAllowedSpeed string
    Role string
    State string
    Type string
    Connection type - dedicated or shared.
    expiresAt String
    id String
    maxAllowedSpeed String
    role String
    state String
    type String
    Connection type - dedicated or shared.
    expiresAt string
    id string
    maxAllowedSpeed string
    role string
    state string
    type string
    Connection type - dedicated or shared.
    expires_at str
    id str
    max_allowed_speed str
    role str
    state str
    type str
    Connection type - dedicated or shared.
    expiresAt String
    id String
    maxAllowedSpeed String
    role String
    state String
    type String
    Connection type - dedicated or shared.

    Package Details

    Repository
    equinix equinix/pulumi-equinix
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the equinix Terraform Provider.
    equinix logo
    Equinix v0.18.0 published on Monday, Sep 23, 2024 by Equinix
    equinix/pulumi-equinix