Instance
data class InstanceArgs(val description: Output<String>? = null, val instanceChargeType: Output<String>? = null, val instanceSeries: Output<String>? = null, val mysqlVersion: Output<Int>? = null, val specification: Output<String>? = null, val vpcId: Output<String>? = null, val vswitchId: Output<String>? = null, val zoneId: Output<String>? = null) : ConvertibleToJava<InstanceArgs>
Distributed Relational Database Service (DRDS) is a lightweight (stateless), flexible, stable, and efficient middleware product independently developed by Alibaba Group to resolve scalability issues with single-host relational databases. With its compatibility with MySQL protocols and syntaxes, DRDS enables database/table sharding, smooth scaling, configuration upgrade/downgrade, transparent read/write splitting, and distributed transactions, providing O&M capabilities for distributed databases throughout their entire lifecycle. For information about DRDS and how to use it, see What is DRDS.
NOTE: Available since v1.24.0. NOTE: At present, DRDS instance only can be supported in the regions: cn-shenzhen, cn-beijing, cn-hangzhou, cn-hongkong, cn-qingdao, ap-southeast-1. NOTE: Currently, this resource only support
Domestic Site Account.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const _default = alicloud.getZones({
availableResourceCreation: "VSwitch",
});
const config = new pulumi.Config();
const instanceSeries = config.get("instanceSeries") || "drds.sn1.4c8g";
const defaultGetNetworks = alicloud.vpc.getNetworks({
nameRegex: "default-NODELETING",
});
const defaultGetSwitches = defaultGetNetworks.then(defaultGetNetworks => alicloud.vpc.getSwitches({
vpcId: defaultGetNetworks.ids?.[0],
}));
const defaultInstance = new alicloud.drds.Instance("default", {
description: "drds instance",
instanceChargeType: "PostPaid",
zoneId: defaultGetSwitches.then(defaultGetSwitches => defaultGetSwitches.vswitches?.[0]?.zoneId),
vswitchId: defaultGetSwitches.then(defaultGetSwitches => defaultGetSwitches.vswitches?.[0]?.id),
instanceSeries: instanceSeries,
specification: "drds.sn1.4c8g.8C16G",
});Content copied to clipboard
import pulumi
import pulumi_alicloud as alicloud
default = alicloud.get_zones(available_resource_creation="VSwitch")
config = pulumi.Config()
instance_series = config.get("instanceSeries")
if instance_series is None:
instance_series = "drds.sn1.4c8g"
default_get_networks = alicloud.vpc.get_networks(name_regex="default-NODELETING")
default_get_switches = alicloud.vpc.get_switches(vpc_id=default_get_networks.ids[0])
default_instance = alicloud.drds.Instance("default",
description="drds instance",
instance_charge_type="PostPaid",
zone_id=default_get_switches.vswitches[0].zone_id,
vswitch_id=default_get_switches.vswitches[0].id,
instance_series=instance_series,
specification="drds.sn1.4c8g.8C16G")Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var @default = AliCloud.GetZones.Invoke(new()
{
AvailableResourceCreation = "VSwitch",
});
var config = new Config();
var instanceSeries = config.Get("instanceSeries") ?? "drds.sn1.4c8g";
var defaultGetNetworks = AliCloud.Vpc.GetNetworks.Invoke(new()
{
NameRegex = "default-NODELETING",
});
var defaultGetSwitches = AliCloud.Vpc.GetSwitches.Invoke(new()
{
VpcId = defaultGetNetworks.Apply(getNetworksResult => getNetworksResult.Ids[0]),
});
var defaultInstance = new AliCloud.Drds.Instance("default", new()
{
Description = "drds instance",
InstanceChargeType = "PostPaid",
ZoneId = defaultGetSwitches.Apply(getSwitchesResult => getSwitchesResult.Vswitches[0]?.ZoneId),
VswitchId = defaultGetSwitches.Apply(getSwitchesResult => getSwitchesResult.Vswitches[0]?.Id),
InstanceSeries = instanceSeries,
Specification = "drds.sn1.4c8g.8C16G",
});
});Content copied to clipboard
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/drds"
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
AvailableResourceCreation: pulumi.StringRef("VSwitch"),
}, nil)
if err != nil {
return err
}
cfg := config.New(ctx, "")
instanceSeries := "drds.sn1.4c8g"
if param := cfg.Get("instanceSeries"); param != "" {
instanceSeries = param
}
defaultGetNetworks, err := vpc.GetNetworks(ctx, &vpc.GetNetworksArgs{
NameRegex: pulumi.StringRef("default-NODELETING"),
}, nil)
if err != nil {
return err
}
defaultGetSwitches, err := vpc.GetSwitches(ctx, &vpc.GetSwitchesArgs{
VpcId: pulumi.StringRef(defaultGetNetworks.Ids[0]),
}, nil)
if err != nil {
return err
}
_, err = drds.NewInstance(ctx, "default", &drds.InstanceArgs{
Description: pulumi.String("drds instance"),
InstanceChargeType: pulumi.String("PostPaid"),
ZoneId: pulumi.String(defaultGetSwitches.Vswitches[0].ZoneId),
VswitchId: pulumi.String(defaultGetSwitches.Vswitches[0].Id),
InstanceSeries: pulumi.String(instanceSeries),
Specification: pulumi.String("drds.sn1.4c8g.8C16G"),
})
if err != nil {
return err
}
return nil
})
}Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.AlicloudFunctions;
import com.pulumi.alicloud.inputs.GetZonesArgs;
import com.pulumi.alicloud.vpc.VpcFunctions;
import com.pulumi.alicloud.vpc.inputs.GetNetworksArgs;
import com.pulumi.alicloud.vpc.inputs.GetSwitchesArgs;
import com.pulumi.alicloud.drds.Instance;
import com.pulumi.alicloud.drds.InstanceArgs;
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 default = AlicloudFunctions.getZones(GetZonesArgs.builder()
.availableResourceCreation("VSwitch")
.build());
final var instanceSeries = config.get("instanceSeries").orElse("drds.sn1.4c8g");
final var defaultGetNetworks = VpcFunctions.getNetworks(GetNetworksArgs.builder()
.nameRegex("default-NODELETING")
.build());
final var defaultGetSwitches = VpcFunctions.getSwitches(GetSwitchesArgs.builder()
.vpcId(defaultGetNetworks.ids()[0])
.build());
var defaultInstance = new Instance("defaultInstance", InstanceArgs.builder()
.description("drds instance")
.instanceChargeType("PostPaid")
.zoneId(defaultGetSwitches.vswitches()[0].zoneId())
.vswitchId(defaultGetSwitches.vswitches()[0].id())
.instanceSeries(instanceSeries)
.specification("drds.sn1.4c8g.8C16G")
.build());
}
}Content copied to clipboard
configuration:
instanceSeries:
type: string
default: drds.sn1.4c8g
resources:
defaultInstance:
type: alicloud:drds:Instance
name: default
properties:
description: drds instance
instanceChargeType: PostPaid
zoneId: ${defaultGetSwitches.vswitches[0].zoneId}
vswitchId: ${defaultGetSwitches.vswitches[0].id}
instanceSeries: ${instanceSeries}
specification: drds.sn1.4c8g.8C16G
variables:
default:
fn::invoke:
function: alicloud:getZones
arguments:
availableResourceCreation: VSwitch
defaultGetNetworks:
fn::invoke:
function: alicloud:vpc:getNetworks
arguments:
nameRegex: default-NODELETING
defaultGetSwitches:
fn::invoke:
function: alicloud:vpc:getSwitches
arguments:
vpcId: ${defaultGetNetworks.ids[0]}Content copied to clipboard
Import
Distributed Relational Database Service (DRDS) can be imported using the id, e.g.
$ pulumi import alicloud:drds/instance:Instance example drds-abc123456Content copied to clipboard
Constructors
Link copied to clipboard
constructor(description: Output<String>? = null, instanceChargeType: Output<String>? = null, instanceSeries: Output<String>? = null, mysqlVersion: Output<Int>? = null, specification: Output<String>? = null, vpcId: Output<String>? = null, vswitchId: Output<String>? = null, zoneId: Output<String>? = null)
Properties
Link copied to clipboard
Description of the DRDS instance, This description can have a string of 2 to 256 characters.
Link copied to clipboard
Valid values are PrePaid, PostPaid, Default to PostPaid.
Link copied to clipboard
The parameter of the instance series. NOTE: drds.sn1.4c8g,drds.sn1.8c16g,drds.sn1.16c32g,drds.sn1.32c64g are no longer supported. Valid values:
Link copied to clipboard
The MySQL version supported by the instance, with the following range of values. 5: Fully compatible with MySQL 5.x (default) 8: Fully compatible with MySQL 8.0. This parameter takes effect when the primary instance is created, and the read-only instance has the same MySQL version as the primary instance by default.
Link copied to clipboard
User-defined DRDS instance specification. Value range: