pulumi-aws-kotlin/com.pulumi.aws.directconnect.kotlin/Connection

Connection

class Connection : KotlinCustomResource

Provides a Connection of Direct Connect.

Example Usage

Create a connection

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.directconnect.Connection;
import com.pulumi.aws.directconnect.ConnectionArgs;
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 hoge = new Connection("hoge", ConnectionArgs.builder()
            .bandwidth("1Gbps")
            .location("EqDC2")
            .build());
    }
}

Request a MACsec-capable connection

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.directconnect.Connection;
import com.pulumi.aws.directconnect.ConnectionArgs;
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 example = new Connection("example", ConnectionArgs.builder()
            .bandwidth("10Gbps")
            .location("EqDA2")
            .requestMacsec(true)
            .build());
    }
}

Configure encryption mode for MACsec-capable connections

NOTE: You can only specify the encryption_mode argument once the connection is in an Available state.

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.directconnect.Connection;
import com.pulumi.aws.directconnect.ConnectionArgs;
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 example = new Connection("example", ConnectionArgs.builder()
            .bandwidth("10Gbps")
            .encryptionMode("must_encrypt")
            .location("EqDC2")
            .requestMacsec(true)
            .build());
    }
}

Import

Direct Connect connections can be imported using the connection id, e.g.,

$ pulumi import aws:directconnect/connection:Connection test_connection dxcon-ffre0ec3

Properties

arn

val arn: Output<String>

The ARN of the connection.

awsDevice

val awsDevice: Output<String>

The Direct Connect endpoint on which the physical connection terminates.

bandwidth

val 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 100Gbps. Case sensitive.

encryptionMode

val encryptionMode: Output<String>

The connection MAC Security (MACsec) encryption mode. MAC Security (MACsec) is only available on dedicated connections. Valid values are no_encrypt, should_encrypt, and must_encrypt.

hasLogicalRedundancy

val hasLogicalRedundancy: Output<String>

Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).

val id: Output<String>

jumboFrameCapable

val jumboFrameCapable: Output<Boolean>

Boolean value representing if jumbo frames have been enabled for this connection.

location

val location: Output<String>

The AWS Direct Connect location where the connection is located. See DescribeLocations for the list of AWS Direct Connect locations. Use locationCode.

macsecCapable

val macsecCapable: Output<Boolean>

Boolean value indicating whether the connection supports MAC Security (MACsec).

name

val name: Output<String>

The name of the connection.

ownerAccountId

val ownerAccountId: Output<String>

The ID of the AWS account that owns the connection.

partnerName

val partnerName: Output<String>

The name of the AWS Direct Connect service provider associated with the connection.

portEncryptionStatus

val portEncryptionStatus: Output<String>

The MAC Security (MACsec) port link status of the connection.

providerName

val providerName: Output<String>

The name of the service provider associated with the connection.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

requestMacsec

val requestMacsec: Output<Boolean>?

Boolean value indicating whether you want the connection to support MAC Security (MACsec). MAC Security (MACsec) is only available on dedicated connections. See MACsec prerequisites for more information about MAC Security (MACsec) prerequisites. Default value: false.

skipDestroy

val skipDestroy: Output<Boolean>?

Set to true if you do not wish the connection to be deleted at destroy time, and instead just removed from the state.