DbInstance

class DbInstance : KotlinCustomResource

Provides a SelectDB DBInstance resource. For information about SelectDB DBInstance and how to use it, see What is DBInstance.

NOTE: Available since v1.229.0.

Example Usage

Basic 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 name = config.get("name") || "terraform_example";
const defaultGetNetworks = alicloud.vpc.getNetworks({
nameRegex: "^default-NODELETING$",
});
const defaultGetSwitches = Promise.all([defaultGetNetworks, _default]).then(([defaultGetNetworks, _default]) => alicloud.vpc.getSwitches({
vpcId: defaultGetNetworks.ids?.[0],
zoneId: _default.zones?.[0]?.id,
}));
const defaultDbInstance = new alicloud.selectdb.DbInstance("default", {
dbInstanceClass: "selectdb.xlarge",
dbInstanceDescription: name,
cacheSize: 200,
paymentType: "PayAsYouGo",
engineMinorVersion: "3.0.12",
vpcId: defaultGetSwitches.then(defaultGetSwitches => defaultGetSwitches.vswitches?.[0]?.vpcId),
zoneId: defaultGetSwitches.then(defaultGetSwitches => defaultGetSwitches.vswitches?.[0]?.zoneId),
vswitchId: defaultGetSwitches.then(defaultGetSwitches => defaultGetSwitches.vswitches?.[0]?.id),
});
import pulumi
import pulumi_alicloud as alicloud
default = alicloud.get_zones(available_resource_creation="VSwitch")
config = pulumi.Config()
name = config.get("name")
if name is None:
name = "terraform_example"
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],
zone_id=default.zones[0].id)
default_db_instance = alicloud.selectdb.DbInstance("default",
db_instance_class="selectdb.xlarge",
db_instance_description=name,
cache_size=200,
payment_type="PayAsYouGo",
engine_minor_version="3.0.12",
vpc_id=default_get_switches.vswitches[0].vpc_id,
zone_id=default_get_switches.vswitches[0].zone_id,
vswitch_id=default_get_switches.vswitches[0].id)
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 name = config.Get("name") ?? "terraform_example";
var defaultGetNetworks = AliCloud.Vpc.GetNetworks.Invoke(new()
{
NameRegex = "^default-NODELETING$",
});
var defaultGetSwitches = AliCloud.Vpc.GetSwitches.Invoke(new()
{
VpcId = defaultGetNetworks.Apply(getNetworksResult => getNetworksResult.Ids[0]),
ZoneId = @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
});
var defaultDbInstance = new AliCloud.SelectDB.DbInstance("default", new()
{
DbInstanceClass = "selectdb.xlarge",
DbInstanceDescription = name,
CacheSize = 200,
PaymentType = "PayAsYouGo",
EngineMinorVersion = "3.0.12",
VpcId = defaultGetSwitches.Apply(getSwitchesResult => getSwitchesResult.Vswitches[0]?.VpcId),
ZoneId = defaultGetSwitches.Apply(getSwitchesResult => getSwitchesResult.Vswitches[0]?.ZoneId),
VswitchId = defaultGetSwitches.Apply(getSwitchesResult => getSwitchesResult.Vswitches[0]?.Id),
});
});
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/selectdb"
"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 {
_default, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
AvailableResourceCreation: pulumi.StringRef("VSwitch"),
}, nil)
if err != nil {
return err
}
cfg := config.New(ctx, "")
name := "terraform_example"
if param := cfg.Get("name"); param != "" {
name = 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]),
ZoneId: pulumi.StringRef(_default.Zones[0].Id),
}, nil)
if err != nil {
return err
}
_, err = selectdb.NewDbInstance(ctx, "default", &selectdb.DbInstanceArgs{
DbInstanceClass: pulumi.String("selectdb.xlarge"),
DbInstanceDescription: pulumi.String(name),
CacheSize: pulumi.Int(200),
PaymentType: pulumi.String("PayAsYouGo"),
EngineMinorVersion: pulumi.String("3.0.12"),
VpcId: pulumi.String(defaultGetSwitches.Vswitches[0].VpcId),
ZoneId: pulumi.String(defaultGetSwitches.Vswitches[0].ZoneId),
VswitchId: pulumi.String(defaultGetSwitches.Vswitches[0].Id),
})
if err != nil {
return err
}
return nil
})
}
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.selectdb.DbInstance;
import com.pulumi.alicloud.selectdb.DbInstanceArgs;
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 name = config.get("name").orElse("terraform_example");
final var defaultGetNetworks = VpcFunctions.getNetworks(GetNetworksArgs.builder()
.nameRegex("^default-NODELETING$")
.build());
final var defaultGetSwitches = VpcFunctions.getSwitches(GetSwitchesArgs.builder()
.vpcId(defaultGetNetworks.ids()[0])
.zoneId(default_.zones()[0].id())
.build());
var defaultDbInstance = new DbInstance("defaultDbInstance", DbInstanceArgs.builder()
.dbInstanceClass("selectdb.xlarge")
.dbInstanceDescription(name)
.cacheSize(200)
.paymentType("PayAsYouGo")
.engineMinorVersion("3.0.12")
.vpcId(defaultGetSwitches.vswitches()[0].vpcId())
.zoneId(defaultGetSwitches.vswitches()[0].zoneId())
.vswitchId(defaultGetSwitches.vswitches()[0].id())
.build());
}
}
configuration:
name:
type: string
default: terraform_example
resources:
defaultDbInstance:
type: alicloud:selectdb:DbInstance
name: default
properties:
dbInstanceClass: selectdb.xlarge
dbInstanceDescription: ${name}
cacheSize: 200
paymentType: PayAsYouGo
engineMinorVersion: 3.0.12
vpcId: ${defaultGetSwitches.vswitches[0].vpcId}
zoneId: ${defaultGetSwitches.vswitches[0].zoneId}
vswitchId: ${defaultGetSwitches.vswitches[0].id}
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]}
zoneId: ${default.zones[0].id}

Import

SelectDB DBInstance can be imported using the id, e.g.

$ pulumi import alicloud:selectdb/dbInstance:DbInstance example <id>

Properties

Link copied to clipboard
val adminPass: Output<String>?

The password for DBInstance using admin account.

Link copied to clipboard
val cacheSize: Output<Int>

The cache size in DBInstance on creating default cluster. The number should be divided by 100.

Link copied to clipboard
val cacheSizePostpaid: Output<Int>

The sum of cache size for every PayAsYouGo clusters in DBInstance.

Link copied to clipboard
val cacheSizePrepaid: Output<Int>

The sum of cache size for every Subscription clusters in DBInstance.

Link copied to clipboard

The sum of cluster counts for PayAsYouGo clusters in DBInstance.

Link copied to clipboard

The sum of cluster counts for Subscription clusters in DBInstance.

Link copied to clipboard
val cpuPostpaid: Output<Int>

The sum of cpu resource amount for every PayAsYouGo clusters in DBInstance.

Link copied to clipboard
val cpuPrepaid: Output<Int>

The sum of cpu resource amount for every Subscription clusters in DBInstance.

Link copied to clipboard
val dbInstanceClass: Output<String>

The class for default cluster in DBInstance. db_cluster_class has a range of class from selectdb.xlarge to selectdb.256xlarge.

Link copied to clipboard

The DBInstance description.

Link copied to clipboard

The modified IP address whitelists. See desired_security_ip_lists below.

Link copied to clipboard

If DBInstance need to open public network, set it to true.

Link copied to clipboard
val engine: Output<String>

The engine of DBInstance. Always selectdb.

Link copied to clipboard

The DBInstance minor version. Valid values: 3.0.12,4.0.4.

Link copied to clipboard
val gmtCreated: Output<String>

The time when DBInstance is created.

Link copied to clipboard
val gmtExpired: Output<String>

The time when DBInstance will be expired. Available on Subscription DBInstance.

Link copied to clipboard
val gmtModified: Output<String>

The time when DBInstance is modified.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard

The net infos for instances.

Link copied to clipboard
val lockMode: Output<String>

The lock mode of the instance. Set the value to lock, which specifies that the instance is locked when it automatically expires or has an overdue payment.

Link copied to clipboard
val lockReason: Output<String>

The reason why the instance is locked.

Link copied to clipboard
val memoryPostpaid: Output<Int>

The sum of memory resource amount offor every PayAsYouGo clusters in DBInstance.

Link copied to clipboard
val memoryPrepaid: Output<Int>

The sum of memory resource amount offor every Subscription clusters in DBInstance.

Link copied to clipboard
val paymentType: Output<String>

The payment type of the resource. Valid values: PayAsYouGo,Subscription.

Link copied to clipboard
val period: Output<String>?

It is valid when payment_type is Subscription. Valid values are Year, Month.

Link copied to clipboard
val periodTime: Output<Int>?

The duration that you will buy DBInstance. It is valid when payment_type is Subscription. Valid values: 1~9, 12, 24, 36.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val regionId: Output<String>

The region ID of the instance.

Link copied to clipboard

The details about each IP address whitelist returned.

Link copied to clipboard
val status: Output<String>

The status of the resource. Valid values: ACTIVATION,STOPPED,STARTING,RESTART.

Link copied to clipboard
val subDomain: Output<String>

The sub domain of DBInstance.

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

A mapping of tags to assign to the resource.

Link copied to clipboard

Field upgraded_engine_minor_version has been deprecated from provider version 1.248.0. New field engine_minor_version instead.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val vpcId: Output<String>

The ID of the VPC for DBInstance.

Link copied to clipboard
val vswitchId: Output<String>

The ID of vswitch for DBInstance.

Link copied to clipboard
val zoneId: Output<String>

The ID of zone for DBInstance.