Interconnect
Represents an Interconnect resource. The Interconnect resource is a dedicated connection between Google's network and your on-premises network. To get more information about Interconnect, see:
How-to Guides
Example Usage
Compute Interconnect Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const project = gcp.organizations.getProject({});
const example_interconnect = new gcp.compute.Interconnect("example-interconnect", {
name: "example-interconnect",
customerName: "example_customer",
interconnectType: "DEDICATED",
linkType: "LINK_TYPE_ETHERNET_10G_LR",
location: project.then(project => `https://www.googleapis.com/compute/v1/projects/${project.name}/global/interconnectLocations/iad-zone1-1`),
requestedLinkCount: 1,
});import pulumi
import pulumi_gcp as gcp
project = gcp.organizations.get_project()
example_interconnect = gcp.compute.Interconnect("example-interconnect",
name="example-interconnect",
customer_name="example_customer",
interconnect_type="DEDICATED",
link_type="LINK_TYPE_ETHERNET_10G_LR",
location=f"https://www.googleapis.com/compute/v1/projects/{project.name}/global/interconnectLocations/iad-zone1-1",
requested_link_count=1)using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var project = Gcp.Organizations.GetProject.Invoke();
var example_interconnect = new Gcp.Compute.Interconnect("example-interconnect", new()
{
Name = "example-interconnect",
CustomerName = "example_customer",
InterconnectType = "DEDICATED",
LinkType = "LINK_TYPE_ETHERNET_10G_LR",
Location = $"https://www.googleapis.com/compute/v1/projects/{project.Apply(getProjectResult => getProjectResult.Name)}/global/interconnectLocations/iad-zone1-1",
RequestedLinkCount = 1,
});
});package main
import (
"fmt"
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/organizations"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
project, err := organizations.LookupProject(ctx, &organizations.LookupProjectArgs{}, nil)
if err != nil {
return err
}
_, err = compute.NewInterconnect(ctx, "example-interconnect", &compute.InterconnectArgs{
Name: pulumi.String("example-interconnect"),
CustomerName: pulumi.String("example_customer"),
InterconnectType: pulumi.String("DEDICATED"),
LinkType: pulumi.String("LINK_TYPE_ETHERNET_10G_LR"),
Location: pulumi.Sprintf("https://www.googleapis.com/compute/v1/projects/%v/global/interconnectLocations/iad-zone1-1", project.Name),
RequestedLinkCount: pulumi.Int(1),
})
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.gcp.organizations.OrganizationsFunctions;
import com.pulumi.gcp.organizations.inputs.GetProjectArgs;
import com.pulumi.gcp.compute.Interconnect;
import com.pulumi.gcp.compute.InterconnectArgs;
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 project = OrganizationsFunctions.getProject(GetProjectArgs.builder()
.build());
var example_interconnect = new Interconnect("example-interconnect", InterconnectArgs.builder()
.name("example-interconnect")
.customerName("example_customer")
.interconnectType("DEDICATED")
.linkType("LINK_TYPE_ETHERNET_10G_LR")
.location(String.format("https://www.googleapis.com/compute/v1/projects/%s/global/interconnectLocations/iad-zone1-1", project.name()))
.requestedLinkCount(1)
.build());
}
}resources:
example-interconnect:
type: gcp:compute:Interconnect
properties:
name: example-interconnect
customerName: example_customer
interconnectType: DEDICATED
linkType: LINK_TYPE_ETHERNET_10G_LR
location: https://www.googleapis.com/compute/v1/projects/${project.name}/global/interconnectLocations/iad-zone1-1
requestedLinkCount: 1
variables:
project:
fn::invoke:
function: gcp:organizations:getProject
arguments: {}Import
Interconnect can be imported using any of these accepted formats:
projects/{{project}}/global/interconnects/{{name}}{{project}}/{{name}}{{name}}When using thepulumi importcommand, Interconnect can be imported using one of the formats above. For example:
$ pulumi import gcp:compute/interconnect:Interconnect default projects/{{project}}/global/interconnects/{{name}}$ pulumi import gcp:compute/interconnect:Interconnect default {{project}}/{{name}}$ pulumi import gcp:compute/interconnect:Interconnect default {{name}}Constructors
Properties
Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true.
Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect. This field is required for Dedicated and Partner Interconnect, should not be specified for cross-cloud interconnect.
An optional description of this resource. Provide this property when you create the resource.
Type of interconnect. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED. Can take one of the following values:
Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty. 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.
Configuration that enables Media Access Control security (MACsec) on the Cloud Interconnect connection between Google and your on-premises router. Structure is documented below.
Enable or disable MACsec on this Interconnect connection. MACsec enablement fails if the MACsec object is not specified.
Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression a-z? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation.
Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to.
interconnects.list of features requested for this Interconnect connection. Options: IF_MACSEC ( If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available). Note that MACSEC is still technically allowed for compatibility reasons, but it does not work with the API, and will be removed in an upcoming major version. Each value may be one of: MACSEC, IF_MACSEC.
Target number of physical links in the link bundle, as requested by the customer.