pulumi-alicloud-kotlin/com.pulumi.alicloud.rds.kotlin/ReadWriteSplittingConnectionArgs

ReadWriteSplittingConnectionArgs

data class ReadWriteSplittingConnectionArgs(val connectionPrefix: Output<String>? = null, val distributionType: Output<String>? = null, val instanceId: Output<String>? = null, val maxDelayTime: Output<Int>? = null, val port: Output<Int>? = null, val weight: Output<Map<String, Any>>? = null) : ConvertibleToJava<ReadWriteSplittingConnectionArgs>

Provides an RDS read write splitting connection resource to allocate an Intranet connection string for RDS instance, see What is DB Read Write Splitting Connection.

NOTE: Available since v1.48.0.

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.rds.RdsFunctions;
import com.pulumi.alicloud.rds.inputs.GetZonesArgs;
import com.pulumi.alicloud.rds.inputs.GetInstanceClassesArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.ecs.SecurityGroup;
import com.pulumi.alicloud.ecs.SecurityGroupArgs;
import com.pulumi.alicloud.rds.Instance;
import com.pulumi.alicloud.rds.InstanceArgs;
import com.pulumi.alicloud.rds.ReadOnlyInstance;
import com.pulumi.alicloud.rds.ReadOnlyInstanceArgs;
import com.pulumi.alicloud.rds.ReadWriteSplittingConnection;
import com.pulumi.alicloud.rds.ReadWriteSplittingConnectionArgs;
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) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("tf-example");
        final var exampleZones = RdsFunctions.getZones(GetZonesArgs.builder()
            .engine("MySQL")
            .engineVersion("5.7")
            .category("HighAvailability")
            .dbInstanceStorageType("local_ssd")
            .build());
        final var exampleInstanceClasses = RdsFunctions.getInstanceClasses(GetInstanceClassesArgs.builder()
            .zoneId(exampleZones.applyValue(getZonesResult -> getZonesResult.ids()[0]))
            .engine("MySQL")
            .engineVersion("5.7")
            .category("HighAvailability")
            .dbInstanceStorageType("local_ssd")
            .build());
        var exampleNetwork = new Network("exampleNetwork", NetworkArgs.builder()
            .vpcName(name)
            .cidrBlock("172.16.0.0/16")
            .build());
        var exampleSwitch = new Switch("exampleSwitch", SwitchArgs.builder()
            .vpcId(exampleNetwork.id())
            .cidrBlock("172.16.0.0/24")
            .zoneId(exampleZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
            .vswitchName(name)
            .build());
        var exampleSecurityGroup = new SecurityGroup("exampleSecurityGroup", SecurityGroupArgs.builder()
            .vpcId(exampleNetwork.id())
            .build());
        var exampleInstance = new Instance("exampleInstance", InstanceArgs.builder()
            .engine("MySQL")
            .engineVersion("5.7")
            .category("HighAvailability")
            .instanceType(exampleInstanceClasses.applyValue(getInstanceClassesResult -> getInstanceClassesResult.instanceClasses()[0].instanceClass()))
            .instanceStorage(exampleInstanceClasses.applyValue(getInstanceClassesResult -> getInstanceClassesResult.instanceClasses()[0].storageRange().min()))
            .instanceChargeType("Postpaid")
            .dbInstanceStorageType("local_ssd")
            .instanceName(name)
            .vswitchId(exampleSwitch.id())
            .securityIps(
                "10.168.1.12",
                "100.69.7.112")
            .build());
        var exampleReadOnlyInstance = new ReadOnlyInstance("exampleReadOnlyInstance", ReadOnlyInstanceArgs.builder()
            .zoneId(exampleInstance.zoneId())
            .masterDbInstanceId(exampleInstance.id())
            .engineVersion(exampleInstance.engineVersion())
            .instanceStorage(exampleInstance.instanceStorage())
            .instanceType(exampleInstance.instanceType())
            .instanceName(String.format("%sreadonly", name))
            .vswitchId(exampleSwitch.id())
            .build());
        var exampleReadWriteSplittingConnection = new ReadWriteSplittingConnection("exampleReadWriteSplittingConnection", ReadWriteSplittingConnectionArgs.builder()
            .instanceId(exampleReadOnlyInstance.masterDbInstanceId())
            .connectionPrefix("example-con-123")
            .distributionType("Standard")
            .build());
    }
}

Import

RDS read write splitting connection can be imported using the id, e.g.

$ pulumi import alicloud:rds/readWriteSplittingConnection:ReadWriteSplittingConnection example abc12345678

Constructors

ReadWriteSplittingConnectionArgs

fun ReadWriteSplittingConnectionArgs(connectionPrefix: Output<String>? = null, distributionType: Output<String>? = null, instanceId: Output<String>? = null, maxDelayTime: Output<Int>? = null, port: Output<Int>? = null, weight: Output<Map<String, Any>>? = null)

Functions

toJava

open override fun toJava(): ReadWriteSplittingConnectionArgs

Properties

connectionPrefix

val connectionPrefix: Output<String>? = null

Prefix of an Internet connection string. It must be checked for uniqueness. It may consist of lowercase letters, numbers, and underlines, and must start with a letter and have no more than 30 characters. Default to + 'rw'.

distributionType

val distributionType: Output<String>? = null

Read weight distribution mode. Values are as follows: Standard indicates automatic weight distribution based on types, Custom indicates custom weight distribution.

instanceId

val instanceId: Output<String>? = null

The Id of instance that can run database.

maxDelayTime

val maxDelayTime: Output<Int>? = null

Delay threshold, in seconds. The value range is 0 to 7200. Default to 30. Read requests are not routed to the read-only instances with a delay greater than the threshold.

port

val port: Output<Int>? = null

Intranet connection port. Valid value: 3001-3999. Default to 3306.

weight

val weight: Output<Map<String, Any>>? = null

Read weight distribution. Read weights increase at a step of 100 up to 10,000. Enter weights in the following format: {"Instanceid":"Weight","Instanceid":"Weight"}. This parameter must be set when distribution_type is set to Custom.