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

ConnectionArgs

data class ConnectionArgs(val bandwidth: Output<String>? = null, val encryptionMode: Output<String>? = null, val location: Output<String>? = null, val name: Output<String>? = null, val providerName: Output<String>? = null, val requestMacsec: Output<Boolean>? = null, val skipDestroy: Output<Boolean>? = null, val tags: Output<Map<String, String>>? = null) : ConvertibleToJava<ConnectionArgs>

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

Constructors

ConnectionArgs

fun ConnectionArgs(bandwidth: Output<String>? = null, encryptionMode: Output<String>? = null, location: Output<String>? = null, name: Output<String>? = null, providerName: Output<String>? = null, requestMacsec: Output<Boolean>? = null, skipDestroy: Output<Boolean>? = null, tags: Output<Map<String, String>>? = null)

Functions

toJava

open override fun toJava(): ConnectionArgs

Properties

bandwidth

val bandwidth: Output<String>? = null

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>? = null

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.

location

val location: Output<String>? = null

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

name

val name: Output<String>? = null

The name of the connection.

providerName

val providerName: Output<String>? = null

The name of the service provider associated with the connection.

requestMacsec

val requestMacsec: Output<Boolean>? = null

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>? = null

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