Rds
data class RdsUpgradeDbInstanceArgs(val acl: Output<String>? = null, val autoUpgradeMinorVersion: Output<String>? = null, val caType: Output<String>? = null, val certificate: Output<String>? = null, val clientCaCert: Output<String>? = null, val clientCaEnabled: Output<Int>? = null, val clientCertRevocationList: Output<String>? = null, val clientCrlEnabled: Output<Int>? = null, val collectStatMode: Output<String>? = null, val connectionStringPrefix: Output<String>? = null, val dbInstanceClass: Output<String>? = null, val dbInstanceDescription: Output<String>? = null, val dbInstanceStorage: Output<Int>? = null, val dbInstanceStorageType: Output<String>? = null, val dbName: Output<String>? = null, val dedicatedHostGroupId: Output<String>? = null, val deletionProtection: Output<Boolean>? = null, val direction: Output<String>? = null, val effectiveTime: Output<String>? = null, val encryptionKey: Output<String>? = null, val engine: Output<String>? = null, val engineVersion: Output<String>? = null, val forceRestart: Output<Boolean>? = null, val haMode: Output<String>? = null, val instanceNetworkType: Output<String>? = null, val maintainTime: Output<String>? = null, val parameters: Output<List<RdsUpgradeDbInstanceParameterArgs>>? = null, val password: Output<String>? = null, val paymentType: Output<String>? = null, val pgHbaConfs: Output<List<RdsUpgradeDbInstancePgHbaConfArgs>>? = null, val port: Output<String>? = null, val privateIpAddress: Output<String>? = null, val privateKey: Output<String>? = null, val releasedKeepPolicy: Output<String>? = null, val replicationAcl: Output<String>? = null, val resourceGroupId: Output<String>? = null, val roleArn: Output<String>? = null, val securityIps: Output<List<String>>? = null, val serverCert: Output<String>? = null, val serverKey: Output<String>? = null, val sourceBiz: Output<String>? = null, val sourceDbInstanceId: Output<String>? = null, val sslEnabled: Output<Int>? = null, val switchOver: Output<String>? = null, val switchTime: Output<String>? = null, val switchTimeMode: Output<String>? = null, val syncMode: Output<String>? = null, val targetMajorVersion: Output<String>? = null, val tcpConnectionType: Output<String>? = null, val tdeStatus: Output<String>? = null, val vpcId: Output<String>? = null, val vswitchId: Output<String>? = null, val zoneId: Output<String>? = null, val zoneIdSlave1: Output<String>? = null) : ConvertibleToJava<RdsUpgradeDbInstanceArgs>
Provides a RDS Upgrade DB Instance resource. For information about RDS Upgrade DB Instance and how to use it, see What is ApsaraDB for RDS.
NOTE: Available since v1.153.0+.
Example Usage
Create a RDS PostgreSQL upgrade instance
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const example = alicloud.rds.getZones({
engine: "PostgreSQL",
engineVersion: "13.0",
instanceChargeType: "PostPaid",
category: "HighAvailability",
dbInstanceStorageType: "cloud_essd",
});
const exampleGetInstanceClasses = example.then(example => alicloud.rds.getInstanceClasses({
zoneId: example.zones?.[0]?.id,
engine: "PostgreSQL",
engineVersion: "13.0",
category: "HighAvailability",
dbInstanceStorageType: "cloud_essd",
instanceChargeType: "PostPaid",
}));
const exampleGetCrossRegions = alicloud.rds.getCrossRegions({});
const exampleNetwork = new alicloud.vpc.Network("example", {
vpcName: "terraform-example",
cidrBlock: "172.16.0.0/16",
});
const exampleSwitch = new alicloud.vpc.Switch("example", {
vpcId: exampleNetwork.id,
cidrBlock: "172.16.0.0/24",
zoneId: example.then(example => example.zones?.[0]?.id),
vswitchName: "terraform-example",
});
const exampleInstance = new alicloud.rds.Instance("example", {
engine: "PostgreSQL",
engineVersion: "13.0",
dbInstanceStorageType: "cloud_essd",
instanceType: exampleGetInstanceClasses.then(exampleGetInstanceClasses => exampleGetInstanceClasses.instanceClasses?.[0]?.instanceClass),
instanceStorage: exampleGetInstanceClasses.then(exampleGetInstanceClasses => exampleGetInstanceClasses.instanceClasses?.[0]?.storageRange?.min),
instanceChargeType: "Postpaid",
instanceName: "terraform-example",
vswitchId: exampleSwitch.id,
monitoringPeriod: 60,
});
const exampleRdsUpgradeDbInstance = new alicloud.rds.RdsUpgradeDbInstance("example", {
sourceDbInstanceId: exampleInstance.id,
targetMajorVersion: "14.0",
dbInstanceClass: exampleInstance.instanceType,
dbInstanceStorage: exampleInstance.instanceStorage,
dbInstanceStorageType: exampleInstance.dbInstanceStorageType,
instanceNetworkType: "VPC",
collectStatMode: "After",
switchOver: "false",
paymentType: "PayAsYouGo",
dbInstanceDescription: "terraform-example",
vswitchId: exampleSwitch.id,
});Content copied to clipboard
import pulumi
import pulumi_alicloud as alicloud
example = alicloud.rds.get_zones(engine="PostgreSQL",
engine_version="13.0",
instance_charge_type="PostPaid",
category="HighAvailability",
db_instance_storage_type="cloud_essd")
example_get_instance_classes = alicloud.rds.get_instance_classes(zone_id=example.zones[0].id,
engine="PostgreSQL",
engine_version="13.0",
category="HighAvailability",
db_instance_storage_type="cloud_essd",
instance_charge_type="PostPaid")
example_get_cross_regions = alicloud.rds.get_cross_regions()
example_network = alicloud.vpc.Network("example",
vpc_name="terraform-example",
cidr_block="172.16.0.0/16")
example_switch = alicloud.vpc.Switch("example",
vpc_id=example_network.id,
cidr_block="172.16.0.0/24",
zone_id=example.zones[0].id,
vswitch_name="terraform-example")
example_instance = alicloud.rds.Instance("example",
engine="PostgreSQL",
engine_version="13.0",
db_instance_storage_type="cloud_essd",
instance_type=example_get_instance_classes.instance_classes[0].instance_class,
instance_storage=example_get_instance_classes.instance_classes[0].storage_range.min,
instance_charge_type="Postpaid",
instance_name="terraform-example",
vswitch_id=example_switch.id,
monitoring_period=60)
example_rds_upgrade_db_instance = alicloud.rds.RdsUpgradeDbInstance("example",
source_db_instance_id=example_instance.id,
target_major_version="14.0",
db_instance_class=example_instance.instance_type,
db_instance_storage=example_instance.instance_storage,
db_instance_storage_type=example_instance.db_instance_storage_type,
instance_network_type="VPC",
collect_stat_mode="After",
switch_over="false",
payment_type="PayAsYouGo",
db_instance_description="terraform-example",
vswitch_id=example_switch.id)Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var example = AliCloud.Rds.GetZones.Invoke(new()
{
Engine = "PostgreSQL",
EngineVersion = "13.0",
InstanceChargeType = "PostPaid",
Category = "HighAvailability",
DbInstanceStorageType = "cloud_essd",
});
var exampleGetInstanceClasses = AliCloud.Rds.GetInstanceClasses.Invoke(new()
{
ZoneId = example.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
Engine = "PostgreSQL",
EngineVersion = "13.0",
Category = "HighAvailability",
DbInstanceStorageType = "cloud_essd",
InstanceChargeType = "PostPaid",
});
var exampleGetCrossRegions = AliCloud.Rds.GetCrossRegions.Invoke();
var exampleNetwork = new AliCloud.Vpc.Network("example", new()
{
VpcName = "terraform-example",
CidrBlock = "172.16.0.0/16",
});
var exampleSwitch = new AliCloud.Vpc.Switch("example", new()
{
VpcId = exampleNetwork.Id,
CidrBlock = "172.16.0.0/24",
ZoneId = example.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
VswitchName = "terraform-example",
});
var exampleInstance = new AliCloud.Rds.Instance("example", new()
{
Engine = "PostgreSQL",
EngineVersion = "13.0",
DbInstanceStorageType = "cloud_essd",
InstanceType = exampleGetInstanceClasses.Apply(getInstanceClassesResult => getInstanceClassesResult.InstanceClasses[0]?.InstanceClass),
InstanceStorage = exampleGetInstanceClasses.Apply(getInstanceClassesResult => getInstanceClassesResult.InstanceClasses[0]?.StorageRange?.Min),
InstanceChargeType = "Postpaid",
InstanceName = "terraform-example",
VswitchId = exampleSwitch.Id,
MonitoringPeriod = 60,
});
var exampleRdsUpgradeDbInstance = new AliCloud.Rds.RdsUpgradeDbInstance("example", new()
{
SourceDbInstanceId = exampleInstance.Id,
TargetMajorVersion = "14.0",
DbInstanceClass = exampleInstance.InstanceType,
DbInstanceStorage = exampleInstance.InstanceStorage,
DbInstanceStorageType = exampleInstance.DbInstanceStorageType,
InstanceNetworkType = "VPC",
CollectStatMode = "After",
SwitchOver = "false",
PaymentType = "PayAsYouGo",
DbInstanceDescription = "terraform-example",
VswitchId = exampleSwitch.Id,
});
});Content copied to clipboard
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/rds"
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := rds.GetZones(ctx, &rds.GetZonesArgs{
Engine: pulumi.StringRef("PostgreSQL"),
EngineVersion: pulumi.StringRef("13.0"),
InstanceChargeType: pulumi.StringRef("PostPaid"),
Category: pulumi.StringRef("HighAvailability"),
DbInstanceStorageType: pulumi.StringRef("cloud_essd"),
}, nil)
if err != nil {
return err
}
exampleGetInstanceClasses, err := rds.GetInstanceClasses(ctx, &rds.GetInstanceClassesArgs{
ZoneId: pulumi.StringRef(example.Zones[0].Id),
Engine: pulumi.StringRef("PostgreSQL"),
EngineVersion: pulumi.StringRef("13.0"),
Category: pulumi.StringRef("HighAvailability"),
DbInstanceStorageType: pulumi.StringRef("cloud_essd"),
InstanceChargeType: pulumi.StringRef("PostPaid"),
}, nil)
if err != nil {
return err
}
_, err = rds.GetCrossRegions(ctx, nil, nil)
if err != nil {
return err
}
exampleNetwork, err := vpc.NewNetwork(ctx, "example", &vpc.NetworkArgs{
VpcName: pulumi.String("terraform-example"),
CidrBlock: pulumi.String("172.16.0.0/16"),
})
if err != nil {
return err
}
exampleSwitch, err := vpc.NewSwitch(ctx, "example", &vpc.SwitchArgs{
VpcId: exampleNetwork.ID(),
CidrBlock: pulumi.String("172.16.0.0/24"),
ZoneId: pulumi.String(example.Zones[0].Id),
VswitchName: pulumi.String("terraform-example"),
})
if err != nil {
return err
}
exampleInstance, err := rds.NewInstance(ctx, "example", &rds.InstanceArgs{
Engine: pulumi.String("PostgreSQL"),
EngineVersion: pulumi.String("13.0"),
DbInstanceStorageType: pulumi.String("cloud_essd"),
InstanceType: pulumi.String(exampleGetInstanceClasses.InstanceClasses[0].InstanceClass),
InstanceStorage: pulumi.String(exampleGetInstanceClasses.InstanceClasses[0].StorageRange.Min),
InstanceChargeType: pulumi.String("Postpaid"),
InstanceName: pulumi.String("terraform-example"),
VswitchId: exampleSwitch.ID(),
MonitoringPeriod: pulumi.Int(60),
})
if err != nil {
return err
}
_, err = rds.NewRdsUpgradeDbInstance(ctx, "example", &rds.RdsUpgradeDbInstanceArgs{
SourceDbInstanceId: exampleInstance.ID(),
TargetMajorVersion: pulumi.String("14.0"),
DbInstanceClass: exampleInstance.InstanceType,
DbInstanceStorage: exampleInstance.InstanceStorage,
DbInstanceStorageType: exampleInstance.DbInstanceStorageType,
InstanceNetworkType: pulumi.String("VPC"),
CollectStatMode: pulumi.String("After"),
SwitchOver: pulumi.String("false"),
PaymentType: pulumi.String("PayAsYouGo"),
DbInstanceDescription: pulumi.String("terraform-example"),
VswitchId: exampleSwitch.ID(),
})
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.rds.RdsFunctions;
import com.pulumi.alicloud.rds.inputs.GetZonesArgs;
import com.pulumi.alicloud.rds.inputs.GetInstanceClassesArgs;
import com.pulumi.alicloud.rds.inputs.GetCrossRegionsArgs;
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.rds.Instance;
import com.pulumi.alicloud.rds.InstanceArgs;
import com.pulumi.alicloud.rds.RdsUpgradeDbInstance;
import com.pulumi.alicloud.rds.RdsUpgradeDbInstanceArgs;
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 example = RdsFunctions.getZones(GetZonesArgs.builder()
.engine("PostgreSQL")
.engineVersion("13.0")
.instanceChargeType("PostPaid")
.category("HighAvailability")
.dbInstanceStorageType("cloud_essd")
.build());
final var exampleGetInstanceClasses = RdsFunctions.getInstanceClasses(GetInstanceClassesArgs.builder()
.zoneId(example.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
.engine("PostgreSQL")
.engineVersion("13.0")
.category("HighAvailability")
.dbInstanceStorageType("cloud_essd")
.instanceChargeType("PostPaid")
.build());
final var exampleGetCrossRegions = RdsFunctions.getCrossRegions();
var exampleNetwork = new Network("exampleNetwork", NetworkArgs.builder()
.vpcName("terraform-example")
.cidrBlock("172.16.0.0/16")
.build());
var exampleSwitch = new Switch("exampleSwitch", SwitchArgs.builder()
.vpcId(exampleNetwork.id())
.cidrBlock("172.16.0.0/24")
.zoneId(example.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
.vswitchName("terraform-example")
.build());
var exampleInstance = new Instance("exampleInstance", InstanceArgs.builder()
.engine("PostgreSQL")
.engineVersion("13.0")
.dbInstanceStorageType("cloud_essd")
.instanceType(exampleGetInstanceClasses.applyValue(getInstanceClassesResult -> getInstanceClassesResult.instanceClasses()[0].instanceClass()))
.instanceStorage(exampleGetInstanceClasses.applyValue(getInstanceClassesResult -> getInstanceClassesResult.instanceClasses()[0].storageRange().min()))
.instanceChargeType("Postpaid")
.instanceName("terraform-example")
.vswitchId(exampleSwitch.id())
.monitoringPeriod("60")
.build());
var exampleRdsUpgradeDbInstance = new RdsUpgradeDbInstance("exampleRdsUpgradeDbInstance", RdsUpgradeDbInstanceArgs.builder()
.sourceDbInstanceId(exampleInstance.id())
.targetMajorVersion("14.0")
.dbInstanceClass(exampleInstance.instanceType())
.dbInstanceStorage(exampleInstance.instanceStorage())
.dbInstanceStorageType(exampleInstance.dbInstanceStorageType())
.instanceNetworkType("VPC")
.collectStatMode("After")
.switchOver("false")
.paymentType("PayAsYouGo")
.dbInstanceDescription("terraform-example")
.vswitchId(exampleSwitch.id())
.build());
}
}Content copied to clipboard
resources:
exampleNetwork:
type: alicloud:vpc:Network
name: example
properties:
vpcName: terraform-example
cidrBlock: 172.16.0.0/16
exampleSwitch:
type: alicloud:vpc:Switch
name: example
properties:
vpcId: ${exampleNetwork.id}
cidrBlock: 172.16.0.0/24
zoneId: ${example.zones[0].id}
vswitchName: terraform-example
exampleInstance:
type: alicloud:rds:Instance
name: example
properties:
engine: PostgreSQL
engineVersion: '13.0'
dbInstanceStorageType: cloud_essd
instanceType: ${exampleGetInstanceClasses.instanceClasses[0].instanceClass}
instanceStorage: ${exampleGetInstanceClasses.instanceClasses[0].storageRange.min}
instanceChargeType: Postpaid
instanceName: terraform-example
vswitchId: ${exampleSwitch.id}
monitoringPeriod: '60'
exampleRdsUpgradeDbInstance:
type: alicloud:rds:RdsUpgradeDbInstance
name: example
properties:
sourceDbInstanceId: ${exampleInstance.id}
targetMajorVersion: '14.0'
dbInstanceClass: ${exampleInstance.instanceType}
dbInstanceStorage: ${exampleInstance.instanceStorage}
dbInstanceStorageType: ${exampleInstance.dbInstanceStorageType}
instanceNetworkType: VPC
collectStatMode: After
switchOver: 'false'
paymentType: PayAsYouGo
dbInstanceDescription: terraform-example
vswitchId: ${exampleSwitch.id}
variables:
example:
fn::invoke:
Function: alicloud:rds:getZones
Arguments:
engine: PostgreSQL
engineVersion: '13.0'
instanceChargeType: PostPaid
category: HighAvailability
dbInstanceStorageType: cloud_essd
exampleGetInstanceClasses:
fn::invoke:
Function: alicloud:rds:getInstanceClasses
Arguments:
zoneId: ${example.zones[0].id}
engine: PostgreSQL
engineVersion: '13.0'
category: HighAvailability
dbInstanceStorageType: cloud_essd
instanceChargeType: PostPaid
exampleGetCrossRegions:
fn::invoke:
Function: alicloud:rds:getCrossRegions
Arguments: {}Content copied to clipboard
Import
RDS Upgrade DB Instance can be imported using the id, e.g.
$ pulumi import alicloud:rds/rdsUpgradeDbInstance:RdsUpgradeDbInstance example <id>Content copied to clipboard
Constructors
Link copied to clipboard
fun RdsUpgradeDbInstanceArgs(acl: Output<String>? = null, autoUpgradeMinorVersion: Output<String>? = null, caType: Output<String>? = null, certificate: Output<String>? = null, clientCaCert: Output<String>? = null, clientCaEnabled: Output<Int>? = null, clientCertRevocationList: Output<String>? = null, clientCrlEnabled: Output<Int>? = null, collectStatMode: Output<String>? = null, connectionStringPrefix: Output<String>? = null, dbInstanceClass: Output<String>? = null, dbInstanceDescription: Output<String>? = null, dbInstanceStorage: Output<Int>? = null, dbInstanceStorageType: Output<String>? = null, dbName: Output<String>? = null, dedicatedHostGroupId: Output<String>? = null, deletionProtection: Output<Boolean>? = null, direction: Output<String>? = null, effectiveTime: Output<String>? = null, encryptionKey: Output<String>? = null, engine: Output<String>? = null, engineVersion: Output<String>? = null, forceRestart: Output<Boolean>? = null, haMode: Output<String>? = null, instanceNetworkType: Output<String>? = null, maintainTime: Output<String>? = null, parameters: Output<List<RdsUpgradeDbInstanceParameterArgs>>? = null, password: Output<String>? = null, paymentType: Output<String>? = null, pgHbaConfs: Output<List<RdsUpgradeDbInstancePgHbaConfArgs>>? = null, port: Output<String>? = null, privateIpAddress: Output<String>? = null, privateKey: Output<String>? = null, releasedKeepPolicy: Output<String>? = null, replicationAcl: Output<String>? = null, resourceGroupId: Output<String>? = null, roleArn: Output<String>? = null, securityIps: Output<List<String>>? = null, serverCert: Output<String>? = null, serverKey: Output<String>? = null, sourceBiz: Output<String>? = null, sourceDbInstanceId: Output<String>? = null, sslEnabled: Output<Int>? = null, switchOver: Output<String>? = null, switchTime: Output<String>? = null, switchTimeMode: Output<String>? = null, syncMode: Output<String>? = null, targetMajorVersion: Output<String>? = null, tcpConnectionType: Output<String>? = null, tdeStatus: Output<String>? = null, vpcId: Output<String>? = null, vswitchId: Output<String>? = null, zoneId: Output<String>? = null, zoneIdSlave1: Output<String>? = null)
Functions
Properties
Link copied to clipboard
This parameter is only supported by the RDS PostgreSQL cloud disk version. This parameter indicates the authentication method. It is allowed only when the public key of the client certificate authority is enabled. Valid values: cert and perfer and verify-ca and verify-full (supported by RDS PostgreSQL above 12).
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
Link copied to clipboard
Link copied to clipboard
The storage capacity of the new instance. Unit: GB. The storage capacity increases in increments of 5 GB. For more information, see Primary ApsaraDB RDS instance types.
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Set of parameters needs to be set after DB instance was launched. Available parameters can refer to the latest docs View database parameter templates. See parameters below.
Link copied to clipboard
The configuration of AD domain . See pg_hba_conf below.
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
This parameter is only supported by the RDS PostgreSQL cloud disk version, indicating the authentication method of the replication permission. It is only allowed when the public key of the client certificate authority is enabled. Valid values: cert and perfer and verify-ca and verify-full (supported by RDS PostgreSQL above 12).
Link copied to clipboard
Link copied to clipboard
The Alibaba Cloud Resource Name (ARN) of a RAM role. A RAM role is a virtual RAM identity that you can create within your Alibaba Cloud account. For more information, see RAM role overview.
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
Link copied to clipboard
The ID of the zone to which the secondary instance of the new instance belongs. You can specify this parameter only when the original instance runs RDS High-availability Edition. You can select a zone that belongs to the region where the original instance resides. You can call the DescribeRegions operation to query zone IDs.