HostedConnection class

Provides a hosted connection on the specified interconnect or a link aggregation group (LAG) of interconnects. Intended for use by AWS Direct Connect Partners only.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const hosted = new aws.directconnect.HostedConnection("hosted", {
    connectionId: "dxcon-ffabc123",
    bandwidth: "100Mbps",
    name: "tf-dx-hosted-connection",
    ownerAccountId: "123456789012",
    vlan: 1,
});
import pulumi
import pulumi_aws as aws

hosted = aws.directconnect.HostedConnection("hosted",
    connection_id="dxcon-ffabc123",
    bandwidth="100Mbps",
    name="tf-dx-hosted-connection",
    owner_account_id="123456789012",
    vlan=1)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var hosted = new Aws.DirectConnect.HostedConnection("hosted", new()
    {
        ConnectionId = "dxcon-ffabc123",
        Bandwidth = "100Mbps",
        Name = "tf-dx-hosted-connection",
        OwnerAccountId = "123456789012",
        Vlan = 1,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/directconnect"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := directconnect.NewHostedConnection(ctx, "hosted", &directconnect.HostedConnectionArgs{
			ConnectionId:   pulumi.String("dxcon-ffabc123"),
			Bandwidth:      pulumi.String("100Mbps"),
			Name:           pulumi.String("tf-dx-hosted-connection"),
			OwnerAccountId: pulumi.String("123456789012"),
			Vlan:           pulumi.Int(1),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_directconnect_hostedconnection" "hosted" {
  connection_id    = "dxcon-ffabc123"
  bandwidth        = "100Mbps"
  name             = "tf-dx-hosted-connection"
  owner_account_id = "123456789012"
  vlan             = 1
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.directconnect.HostedConnection;
import com.pulumi.aws.directconnect.HostedConnectionArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 hosted = new HostedConnection("hosted", HostedConnectionArgs.builder()
            .connectionId("dxcon-ffabc123")
            .bandwidth("100Mbps")
            .name("tf-dx-hosted-connection")
            .ownerAccountId("123456789012")
            .vlan(1)
            .build());

    }
}
resources:
  hosted:
    type: aws:directconnect:HostedConnection
    properties:
      connectionId: dxcon-ffabc123
      bandwidth: 100Mbps
      name: tf-dx-hosted-connection
      ownerAccountId: '123456789012'
      vlan: 1

Constructors

HostedConnection(String name, {HostedConnectionArgs? args, CustomResourceOptions? options})
Creates a new HostedConnection. name The Pulumi resource name. args Arguments used to configure this HostedConnection. The set of arguments for HostedConnection. options Resource options controlling this resource's behavior.
HostedConnection.reference(String urn)
Creates a typed reference to an existing HostedConnection resource.

Properties

awsDevice ↔ Output<String>
The Direct Connect endpoint on which the physical connection terminates.
latefinal
bandwidth ↔ Output<String>
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps, 10Gbps, and 25Gbps. Case sensitive. Refer to the AWS Direct Connection supported bandwidths for Hosted Connections.
latefinal
childResources → Set<Resource>
finalinherited
completionSources ↔ Map<String, IOutputCompletionSource>
latefinalinherited
connectionId ↔ Output<String>
The ID of the interconnect or LAG.
latefinal
connectionRegion ↔ Output<String>
The AWS Region where the connection is located.
latefinal
hashCode → int
The hash code for this object.
no setterinherited
hasLogicalRedundancy ↔ Output<String>
Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
latefinal
id ↔ Output<String>
getter/setter pairinherited
isCustom → bool
Returns whether this resource is provider-managed.
no setterinherited
isProtected → bool
Returns whether this resource is protected from deletion.
no setterinherited
isRemote → bool
Whether this resource is registered as remote.
no setterinherited
isResourceReference → bool
Whether this instance represents a resource value returned over RPC.
finalinherited
jumboFrameCapable ↔ Output<bool>
Boolean value representing if jumbo frames have been enabled for this connection.
latefinal
lagId ↔ Output<String>
The ID of the LAG.
latefinal
loaIssueTime ↔ Output<String>
The time of the most recent call to DescribeLoa for this connection.
latefinal
location ↔ Output<String>
The location of the connection.
latefinal
name ↔ Output<String>
The name of the connection.
latefinal
ownerAccountId ↔ Output<String>
The ID of the AWS account of the customer for the connection.
latefinal
partnerName ↔ Output<String>
The name of the AWS Direct Connect service provider associated with the connection.
latefinal
providerName ↔ Output<String>
The name of the service provider associated with the connection.
latefinal
region ↔ Output<String>
(Deprecated) The AWS Region where the connection is located. Use connectionRegion instead.
latefinal
resourceTransforms → List<ResourceTransform>
Inherited/explicit async transforms.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
state ↔ Output<String>
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
latefinal
transformations → List<ResourceTransformation>
Inherited/explicit legacy transformations.
no setterinherited
urn ↔ Output<String>
latefinalinherited
vlan ↔ Output<int>
The dedicated VLAN provisioned to the hosted connection.
latefinal

Methods

failId(Object error) → void
Completes this resource ID with an error when registration fails.
inherited
failOutputs(Object error) → void
Completes all output properties with error.
inherited
failUrn(Object error) → void
Completes this resource URN with an error when registration fails.
inherited
getProvider(String moduleMember) → ProviderResource?
Returns provider for moduleMember's package, if configured.
inherited
getResourceName() → String
Returns this resource's logical name.
inherited
getResourceType() → String
Returns this resource's Pulumi type token.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
registerOutput<T>(String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output<T>
Registers a dynamic output property for this resource.
inherited
resolveId(String? value, {required bool isKnown}) → void
Resolves the provider-assigned ID for this resource.
inherited
resolveOutputs(Struct outputs) → void
Resolves all output properties from a monitor response payload.
inherited
resolveUrn(String value) → void
Resolves this resource's URN once assigned by the engine.
inherited
serializeProperties(Map<String, dynamic> properties) → Future<Struct>
Serializes resource properties for RPC transmission.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

get(String name, Input<String> id, {HostedConnectionState? state, CustomResourceOptions? options}) → HostedConnection
Gets an existing HostedConnection resource's state with the given name and id.