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());
    }
}
Content copied to clipboard

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());
    }
}
Content copied to clipboard

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());
    }
}
Content copied to clipboard

Import

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

$ pulumi import aws:directconnect/connection:Connection test_connection dxcon-ffre0ec3
Content copied to clipboard

Constructors

Link copied to clipboard
constructor(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)

Properties

Link copied to clipboard
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.

Link copied to clipboard
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.

Link copied to clipboard
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.

Link copied to clipboard
val name: Output<String>? = null

The name of the connection.

Link copied to clipboard
val providerName: Output<String>? = null

The name of the service provider associated with the connection.

Link copied to clipboard
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.

Link copied to clipboard
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.

Link copied to clipboard
val tags: Output<Map<String, String>>? = null

A map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

Functions

Link copied to clipboard
open override fun toJava(): ConnectionArgs