Class InterconnectAttachment

Represents an InterconnectAttachment (VLAN attachment) resource. For more information, see Creating VLAN Attachments.

Example Usage - Interconnect Attachment Basic

using Pulumi;
using Gcp = Pulumi.Gcp;

class MyStack : Stack
{
public MyStack()
{
    var foobar = new Gcp.Compute.Router(&quot;foobar&quot;, new Gcp.Compute.RouterArgs
    {
        Network = google_compute_network.Foobar.Name,
    });
    var onPrem = new Gcp.Compute.InterconnectAttachment(&quot;onPrem&quot;, new Gcp.Compute.InterconnectAttachmentArgs
    {
        Interconnect = &quot;my-interconnect-id&quot;,
        Router = foobar.Id,
    });
}

}

Inheritance

System.Object

Resource

CustomResource

InterconnectAttachment

Inherited Members

CustomResource.Id

Resource.GetResourceType()

Resource.GetResourceName()

Resource.Urn

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Pulumi.Gcp.Compute

Assembly: Pulumi.Gcp.dll

Syntax

public class InterconnectAttachment : CustomResource

Constructors

View Source

InterconnectAttachment(String, InterconnectAttachmentArgs, CustomResourceOptions)

Create a InterconnectAttachment resource with the given unique name, arguments, and options.

Declaration

public InterconnectAttachment(string name, InterconnectAttachmentArgs args, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resource
InterconnectAttachmentArgs	args	The arguments used to populate this resource's properties
CustomResourceOptions	options	A bag of options that control this resource's behavior

Properties

View Source

AdminEnabled

Whether the VLAN attachment is enabled or disabled. When using PARTNER type this will Pre-Activate the interconnect attachment

Declaration

public Output<bool?> AdminEnabled { get; }

Property Value

Type	Description
Output<System.Nullable<System.Boolean>>

View Source

Bandwidth

Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, Defaults to BPS_10G

Declaration

public Output<string> Bandwidth { get; }

Property Value

Type	Description
Output<System.String>

View Source

CandidateSubnets

Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.

Declaration

public Output<ImmutableArray<string>> CandidateSubnets { get; }

Property Value

Type	Description
Output<System.Collections.Immutable.ImmutableArray<System.String>>

View Source

CloudRouterIpAddress

IPv4 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment.

Declaration

public Output<string> CloudRouterIpAddress { get; }

Property Value

Type	Description
Output<System.String>

View Source

CreationTimestamp

Creation timestamp in RFC3339 text format.

Declaration

public Output<string> CreationTimestamp { get; }

Property Value

Type	Description
Output<System.String>

View Source

CustomerRouterIpAddress

IPv4 address + prefix length to be configured on the customer router subinterface for this interconnect attachment.

Declaration

public Output<string> CustomerRouterIpAddress { get; }

Property Value

Type	Description
Output<System.String>

View Source

Description

An optional description of this resource.

Declaration

public Output<string> Description { get; }

Property Value

Type	Description
Output<System.String>

View Source

EdgeAvailabilityDomain

Desired availability domain for the attachment. Only available for type PARTNER, at creation time. For improved reliability, customers should configure a pair of attachments with one per availability domain. The selected availability domain will be provided to the Partner via the pairing key so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.

Declaration

public Output<string> EdgeAvailabilityDomain { get; }

Property Value

Type	Description
Output<System.String>

View Source

GoogleReferenceId

Google reference ID, to be used when raising support tickets with Google or otherwise to debug backend connectivity issues.

Declaration

public Output<string> GoogleReferenceId { get; }

Property Value

Type	Description
Output<System.String>

View Source

Interconnect

URL of the underlying Interconnect object that this attachment's traffic will traverse through. Required if type is DEDICATED, must not be set if type is PARTNER.

Declaration

public Output<string> Interconnect { get; }

Property Value

Type	Description
Output<System.String>

View Source

Name

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.

Declaration

public Output<string> Name { get; }

Property Value

Type	Description
Output<System.String>

View Source

PairingKey

[Output only for type PARTNER. Not present for DEDICATED]. The opaque identifier of an PARTNER attachment used to initiate provisioning with a selected partner. Of the form "XXXXX/region/domain"

Declaration

public Output<string> PairingKey { get; }

Property Value

Type	Description
Output<System.String>

View Source

PartnerAsn

[Output only for type PARTNER. Not present for DEDICATED]. Optional BGP ASN for the router that should be supplied by a layer 3 Partner if they configured BGP on behalf of the customer.

Declaration

public Output<string> PartnerAsn { get; }

Property Value

Type	Description
Output<System.String>

View Source

PrivateInterconnectInfo

Information specific to an InterconnectAttachment. This property is populated if the interconnect that this is attached to is of type DEDICATED.

Declaration

public Output<InterconnectAttachmentPrivateInterconnectInfo> PrivateInterconnectInfo { get; }

Property Value

Type	Description
Output<InterconnectAttachmentPrivateInterconnectInfo>

View Source

Project

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

Declaration

public Output<string> Project { get; }

Property Value

Type	Description
Output<System.String>

View Source

Region

Region where the regional interconnect attachment resides.

Declaration

public Output<string> Region { get; }

Property Value

Type	Description
Output<System.String>

View Source

Router

URL of the cloud router to be used for dynamic routing. This router must be in the same region as this InterconnectAttachment. The InterconnectAttachment will automatically connect the Interconnect to the network & region within which the Cloud Router is configured.

Declaration

public Output<string> Router { get; }

Property Value

Type	Description
Output<System.String>

View Source

SelfLink

The URI of the created resource.

Declaration

public Output<string> SelfLink { get; }

Property Value

Type	Description
Output<System.String>

View Source

State

[Output Only] The current state of this attachment's functionality.

Declaration

public Output<string> State { get; }

Property Value

Type	Description
Output<System.String>

View Source

Type

The type of InterconnectAttachment you wish to create. Defaults to DEDICATED.

Declaration

public Output<string> Type { get; }

Property Value

Type	Description
Output<System.String>

View Source

VlanTag8021q

The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4094. When using PARTNER type this will be managed upstream.

Declaration

public Output<int> VlanTag8021q { get; }

Property Value

Type	Description
Output<System.Int32>

Methods

View Source

Get(String, Input<String>, InterconnectAttachmentState, CustomResourceOptions)

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

Declaration

public static InterconnectAttachment Get(string name, Input<string> id, InterconnectAttachmentState state = null, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resulting resource.
Input<System.String>	id	The unique provider ID of the resource to lookup.
InterconnectAttachmentState	state	Any extra arguments used during the lookup.
CustomResourceOptions	options	A bag of options that control this resource's behavior

Returns

Type	Description
InterconnectAttachment