alicloud.rds.RdsCloneDbInstance
Explore with Pulumi AI
Provides an RDS Clone DB Instance resource.
For information about RDS Clone DB Instance and how to use it, see What is ApsaraDB for RDS.
NOTE: Available since v1.149.0+.
Example Usage
Create an RDS MySQL clone 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 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",
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 exampleRdsBackup = new alicloud.rds.RdsBackup("example", {
dbInstanceId: exampleInstance.id,
removeFromState: true,
});
const exampleRdsCloneDbInstance = new alicloud.rds.RdsCloneDbInstance("example", {
sourceDbInstanceId: exampleInstance.id,
dbInstanceStorageType: "cloud_essd",
paymentType: "PayAsYouGo",
backupId: exampleRdsBackup.backupId,
});
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_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",
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_backup = alicloud.rds.RdsBackup("example",
db_instance_id=example_instance.id,
remove_from_state=True)
example_rds_clone_db_instance = alicloud.rds.RdsCloneDbInstance("example",
source_db_instance_id=example_instance.id,
db_instance_storage_type="cloud_essd",
payment_type="PayAsYouGo",
backup_id=example_rds_backup.backup_id)
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
}
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"),
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
}
exampleRdsBackup, err := rds.NewRdsBackup(ctx, "example", &rds.RdsBackupArgs{
DbInstanceId: exampleInstance.ID(),
RemoveFromState: pulumi.Bool(true),
})
if err != nil {
return err
}
_, err = rds.NewRdsCloneDbInstance(ctx, "example", &rds.RdsCloneDbInstanceArgs{
SourceDbInstanceId: exampleInstance.ID(),
DbInstanceStorageType: pulumi.String("cloud_essd"),
PaymentType: pulumi.String("PayAsYouGo"),
BackupId: exampleRdsBackup.BackupId,
})
if err != nil {
return err
}
return nil
})
}
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 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",
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 exampleRdsBackup = new AliCloud.Rds.RdsBackup("example", new()
{
DbInstanceId = exampleInstance.Id,
RemoveFromState = true,
});
var exampleRdsCloneDbInstance = new AliCloud.Rds.RdsCloneDbInstance("example", new()
{
SourceDbInstanceId = exampleInstance.Id,
DbInstanceStorageType = "cloud_essd",
PaymentType = "PayAsYouGo",
BackupId = exampleRdsBackup.BackupId,
});
});
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.rds.Instance;
import com.pulumi.alicloud.rds.InstanceArgs;
import com.pulumi.alicloud.rds.RdsBackup;
import com.pulumi.alicloud.rds.RdsBackupArgs;
import com.pulumi.alicloud.rds.RdsCloneDbInstance;
import com.pulumi.alicloud.rds.RdsCloneDbInstanceArgs;
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());
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")
.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 exampleRdsBackup = new RdsBackup("exampleRdsBackup", RdsBackupArgs.builder()
.dbInstanceId(exampleInstance.id())
.removeFromState("true")
.build());
var exampleRdsCloneDbInstance = new RdsCloneDbInstance("exampleRdsCloneDbInstance", RdsCloneDbInstanceArgs.builder()
.sourceDbInstanceId(exampleInstance.id())
.dbInstanceStorageType("cloud_essd")
.paymentType("PayAsYouGo")
.backupId(exampleRdsBackup.backupId())
.build());
}
}
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'
instanceType: ${exampleGetInstanceClasses.instanceClasses[0].instanceClass}
instanceStorage: ${exampleGetInstanceClasses.instanceClasses[0].storageRange.min}
instanceChargeType: Postpaid
instanceName: terraform-example
vswitchId: ${exampleSwitch.id}
monitoringPeriod: '60'
exampleRdsBackup:
type: alicloud:rds:RdsBackup
name: example
properties:
dbInstanceId: ${exampleInstance.id}
removeFromState: 'true'
exampleRdsCloneDbInstance:
type: alicloud:rds:RdsCloneDbInstance
name: example
properties:
sourceDbInstanceId: ${exampleInstance.id}
dbInstanceStorageType: cloud_essd
paymentType: PayAsYouGo
backupId: ${exampleRdsBackup.backupId}
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
Create RdsCloneDbInstance Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new RdsCloneDbInstance(name: string, args: RdsCloneDbInstanceArgs, opts?: CustomResourceOptions);
@overload
def RdsCloneDbInstance(resource_name: str,
args: RdsCloneDbInstanceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def RdsCloneDbInstance(resource_name: str,
opts: Optional[ResourceOptions] = None,
db_instance_storage_type: Optional[str] = None,
source_db_instance_id: Optional[str] = None,
payment_type: Optional[str] = None,
parameters: Optional[Sequence[RdsCloneDbInstanceParameterArgs]] = None,
client_ca_cert: Optional[str] = None,
backup_id: Optional[str] = None,
certificate: Optional[str] = None,
period: Optional[str] = None,
client_ca_enabled: Optional[int] = None,
client_cert_revocation_list: Optional[str] = None,
client_crl_enabled: Optional[int] = None,
connection_string_prefix: Optional[str] = None,
db_instance_class: Optional[str] = None,
db_instance_description: Optional[str] = None,
db_instance_storage: Optional[int] = None,
backup_type: Optional[str] = None,
db_name: Optional[str] = None,
db_names: Optional[str] = None,
dedicated_host_group_id: Optional[str] = None,
deletion_protection: Optional[bool] = None,
direction: Optional[str] = None,
effective_time: Optional[str] = None,
encryption_key: Optional[str] = None,
engine: Optional[str] = None,
engine_version: Optional[str] = None,
force_restart: Optional[bool] = None,
ha_mode: Optional[str] = None,
pg_hba_confs: Optional[Sequence[RdsCloneDbInstancePgHbaConfArgs]] = None,
maintain_time: Optional[str] = None,
acl: Optional[str] = None,
password: Optional[str] = None,
category: Optional[str] = None,
ca_type: Optional[str] = None,
instance_network_type: Optional[str] = None,
port: Optional[str] = None,
private_ip_address: Optional[str] = None,
private_key: Optional[str] = None,
released_keep_policy: Optional[str] = None,
replication_acl: Optional[str] = None,
resource_group_id: Optional[str] = None,
restore_table: Optional[str] = None,
restore_time: Optional[str] = None,
role_arn: Optional[str] = None,
security_ips: Optional[Sequence[str]] = None,
server_cert: Optional[str] = None,
server_key: Optional[str] = None,
serverless_configs: Optional[Sequence[RdsCloneDbInstanceServerlessConfigArgs]] = None,
source_biz: Optional[str] = None,
auto_upgrade_minor_version: Optional[str] = None,
ssl_enabled: Optional[int] = None,
switch_time: Optional[str] = None,
sync_mode: Optional[str] = None,
table_meta: Optional[str] = None,
tcp_connection_type: Optional[str] = None,
tde_status: Optional[str] = None,
used_time: Optional[int] = None,
vpc_id: Optional[str] = None,
vswitch_id: Optional[str] = None,
zone_id: Optional[str] = None,
zone_id_slave_a: Optional[str] = None,
zone_id_slave_b: Optional[str] = None)
func NewRdsCloneDbInstance(ctx *Context, name string, args RdsCloneDbInstanceArgs, opts ...ResourceOption) (*RdsCloneDbInstance, error)
public RdsCloneDbInstance(string name, RdsCloneDbInstanceArgs args, CustomResourceOptions? opts = null)
public RdsCloneDbInstance(String name, RdsCloneDbInstanceArgs args)
public RdsCloneDbInstance(String name, RdsCloneDbInstanceArgs args, CustomResourceOptions options)
type: alicloud:rds:RdsCloneDbInstance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args RdsCloneDbInstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args RdsCloneDbInstanceArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args RdsCloneDbInstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args RdsCloneDbInstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args RdsCloneDbInstanceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var rdsCloneDbInstanceResource = new AliCloud.Rds.RdsCloneDbInstance("rdsCloneDbInstanceResource", new()
{
DbInstanceStorageType = "string",
SourceDbInstanceId = "string",
PaymentType = "string",
Parameters = new[]
{
new AliCloud.Rds.Inputs.RdsCloneDbInstanceParameterArgs
{
Name = "string",
Value = "string",
},
},
ClientCaCert = "string",
BackupId = "string",
Certificate = "string",
Period = "string",
ClientCaEnabled = 0,
ClientCertRevocationList = "string",
ClientCrlEnabled = 0,
ConnectionStringPrefix = "string",
DbInstanceClass = "string",
DbInstanceDescription = "string",
DbInstanceStorage = 0,
BackupType = "string",
DbName = "string",
DbNames = "string",
DedicatedHostGroupId = "string",
DeletionProtection = false,
Direction = "string",
EffectiveTime = "string",
EncryptionKey = "string",
Engine = "string",
EngineVersion = "string",
ForceRestart = false,
HaMode = "string",
PgHbaConfs = new[]
{
new AliCloud.Rds.Inputs.RdsCloneDbInstancePgHbaConfArgs
{
Address = "string",
Database = "string",
Method = "string",
PriorityId = 0,
Type = "string",
User = "string",
Mask = "string",
Option = "string",
},
},
MaintainTime = "string",
Acl = "string",
Password = "string",
Category = "string",
CaType = "string",
InstanceNetworkType = "string",
Port = "string",
PrivateIpAddress = "string",
PrivateKey = "string",
ReleasedKeepPolicy = "string",
ReplicationAcl = "string",
ResourceGroupId = "string",
RestoreTable = "string",
RestoreTime = "string",
RoleArn = "string",
SecurityIps = new[]
{
"string",
},
ServerCert = "string",
ServerKey = "string",
ServerlessConfigs = new[]
{
new AliCloud.Rds.Inputs.RdsCloneDbInstanceServerlessConfigArgs
{
MaxCapacity = 0,
MinCapacity = 0,
AutoPause = false,
SwitchForce = false,
},
},
SourceBiz = "string",
AutoUpgradeMinorVersion = "string",
SslEnabled = 0,
SwitchTime = "string",
SyncMode = "string",
TableMeta = "string",
TcpConnectionType = "string",
TdeStatus = "string",
UsedTime = 0,
VpcId = "string",
VswitchId = "string",
ZoneId = "string",
ZoneIdSlaveA = "string",
ZoneIdSlaveB = "string",
});
example, err := rds.NewRdsCloneDbInstance(ctx, "rdsCloneDbInstanceResource", &rds.RdsCloneDbInstanceArgs{
DbInstanceStorageType: pulumi.String("string"),
SourceDbInstanceId: pulumi.String("string"),
PaymentType: pulumi.String("string"),
Parameters: rds.RdsCloneDbInstanceParameterArray{
&rds.RdsCloneDbInstanceParameterArgs{
Name: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
ClientCaCert: pulumi.String("string"),
BackupId: pulumi.String("string"),
Certificate: pulumi.String("string"),
Period: pulumi.String("string"),
ClientCaEnabled: pulumi.Int(0),
ClientCertRevocationList: pulumi.String("string"),
ClientCrlEnabled: pulumi.Int(0),
ConnectionStringPrefix: pulumi.String("string"),
DbInstanceClass: pulumi.String("string"),
DbInstanceDescription: pulumi.String("string"),
DbInstanceStorage: pulumi.Int(0),
BackupType: pulumi.String("string"),
DbName: pulumi.String("string"),
DbNames: pulumi.String("string"),
DedicatedHostGroupId: pulumi.String("string"),
DeletionProtection: pulumi.Bool(false),
Direction: pulumi.String("string"),
EffectiveTime: pulumi.String("string"),
EncryptionKey: pulumi.String("string"),
Engine: pulumi.String("string"),
EngineVersion: pulumi.String("string"),
ForceRestart: pulumi.Bool(false),
HaMode: pulumi.String("string"),
PgHbaConfs: rds.RdsCloneDbInstancePgHbaConfArray{
&rds.RdsCloneDbInstancePgHbaConfArgs{
Address: pulumi.String("string"),
Database: pulumi.String("string"),
Method: pulumi.String("string"),
PriorityId: pulumi.Int(0),
Type: pulumi.String("string"),
User: pulumi.String("string"),
Mask: pulumi.String("string"),
Option: pulumi.String("string"),
},
},
MaintainTime: pulumi.String("string"),
Acl: pulumi.String("string"),
Password: pulumi.String("string"),
Category: pulumi.String("string"),
CaType: pulumi.String("string"),
InstanceNetworkType: pulumi.String("string"),
Port: pulumi.String("string"),
PrivateIpAddress: pulumi.String("string"),
PrivateKey: pulumi.String("string"),
ReleasedKeepPolicy: pulumi.String("string"),
ReplicationAcl: pulumi.String("string"),
ResourceGroupId: pulumi.String("string"),
RestoreTable: pulumi.String("string"),
RestoreTime: pulumi.String("string"),
RoleArn: pulumi.String("string"),
SecurityIps: pulumi.StringArray{
pulumi.String("string"),
},
ServerCert: pulumi.String("string"),
ServerKey: pulumi.String("string"),
ServerlessConfigs: rds.RdsCloneDbInstanceServerlessConfigArray{
&rds.RdsCloneDbInstanceServerlessConfigArgs{
MaxCapacity: pulumi.Float64(0),
MinCapacity: pulumi.Float64(0),
AutoPause: pulumi.Bool(false),
SwitchForce: pulumi.Bool(false),
},
},
SourceBiz: pulumi.String("string"),
AutoUpgradeMinorVersion: pulumi.String("string"),
SslEnabled: pulumi.Int(0),
SwitchTime: pulumi.String("string"),
SyncMode: pulumi.String("string"),
TableMeta: pulumi.String("string"),
TcpConnectionType: pulumi.String("string"),
TdeStatus: pulumi.String("string"),
UsedTime: pulumi.Int(0),
VpcId: pulumi.String("string"),
VswitchId: pulumi.String("string"),
ZoneId: pulumi.String("string"),
ZoneIdSlaveA: pulumi.String("string"),
ZoneIdSlaveB: pulumi.String("string"),
})
var rdsCloneDbInstanceResource = new RdsCloneDbInstance("rdsCloneDbInstanceResource", RdsCloneDbInstanceArgs.builder()
.dbInstanceStorageType("string")
.sourceDbInstanceId("string")
.paymentType("string")
.parameters(RdsCloneDbInstanceParameterArgs.builder()
.name("string")
.value("string")
.build())
.clientCaCert("string")
.backupId("string")
.certificate("string")
.period("string")
.clientCaEnabled(0)
.clientCertRevocationList("string")
.clientCrlEnabled(0)
.connectionStringPrefix("string")
.dbInstanceClass("string")
.dbInstanceDescription("string")
.dbInstanceStorage(0)
.backupType("string")
.dbName("string")
.dbNames("string")
.dedicatedHostGroupId("string")
.deletionProtection(false)
.direction("string")
.effectiveTime("string")
.encryptionKey("string")
.engine("string")
.engineVersion("string")
.forceRestart(false)
.haMode("string")
.pgHbaConfs(RdsCloneDbInstancePgHbaConfArgs.builder()
.address("string")
.database("string")
.method("string")
.priorityId(0)
.type("string")
.user("string")
.mask("string")
.option("string")
.build())
.maintainTime("string")
.acl("string")
.password("string")
.category("string")
.caType("string")
.instanceNetworkType("string")
.port("string")
.privateIpAddress("string")
.privateKey("string")
.releasedKeepPolicy("string")
.replicationAcl("string")
.resourceGroupId("string")
.restoreTable("string")
.restoreTime("string")
.roleArn("string")
.securityIps("string")
.serverCert("string")
.serverKey("string")
.serverlessConfigs(RdsCloneDbInstanceServerlessConfigArgs.builder()
.maxCapacity(0)
.minCapacity(0)
.autoPause(false)
.switchForce(false)
.build())
.sourceBiz("string")
.autoUpgradeMinorVersion("string")
.sslEnabled(0)
.switchTime("string")
.syncMode("string")
.tableMeta("string")
.tcpConnectionType("string")
.tdeStatus("string")
.usedTime(0)
.vpcId("string")
.vswitchId("string")
.zoneId("string")
.zoneIdSlaveA("string")
.zoneIdSlaveB("string")
.build());
rds_clone_db_instance_resource = alicloud.rds.RdsCloneDbInstance("rdsCloneDbInstanceResource",
db_instance_storage_type="string",
source_db_instance_id="string",
payment_type="string",
parameters=[alicloud.rds.RdsCloneDbInstanceParameterArgs(
name="string",
value="string",
)],
client_ca_cert="string",
backup_id="string",
certificate="string",
period="string",
client_ca_enabled=0,
client_cert_revocation_list="string",
client_crl_enabled=0,
connection_string_prefix="string",
db_instance_class="string",
db_instance_description="string",
db_instance_storage=0,
backup_type="string",
db_name="string",
db_names="string",
dedicated_host_group_id="string",
deletion_protection=False,
direction="string",
effective_time="string",
encryption_key="string",
engine="string",
engine_version="string",
force_restart=False,
ha_mode="string",
pg_hba_confs=[alicloud.rds.RdsCloneDbInstancePgHbaConfArgs(
address="string",
database="string",
method="string",
priority_id=0,
type="string",
user="string",
mask="string",
option="string",
)],
maintain_time="string",
acl="string",
password="string",
category="string",
ca_type="string",
instance_network_type="string",
port="string",
private_ip_address="string",
private_key="string",
released_keep_policy="string",
replication_acl="string",
resource_group_id="string",
restore_table="string",
restore_time="string",
role_arn="string",
security_ips=["string"],
server_cert="string",
server_key="string",
serverless_configs=[alicloud.rds.RdsCloneDbInstanceServerlessConfigArgs(
max_capacity=0,
min_capacity=0,
auto_pause=False,
switch_force=False,
)],
source_biz="string",
auto_upgrade_minor_version="string",
ssl_enabled=0,
switch_time="string",
sync_mode="string",
table_meta="string",
tcp_connection_type="string",
tde_status="string",
used_time=0,
vpc_id="string",
vswitch_id="string",
zone_id="string",
zone_id_slave_a="string",
zone_id_slave_b="string")
const rdsCloneDbInstanceResource = new alicloud.rds.RdsCloneDbInstance("rdsCloneDbInstanceResource", {
dbInstanceStorageType: "string",
sourceDbInstanceId: "string",
paymentType: "string",
parameters: [{
name: "string",
value: "string",
}],
clientCaCert: "string",
backupId: "string",
certificate: "string",
period: "string",
clientCaEnabled: 0,
clientCertRevocationList: "string",
clientCrlEnabled: 0,
connectionStringPrefix: "string",
dbInstanceClass: "string",
dbInstanceDescription: "string",
dbInstanceStorage: 0,
backupType: "string",
dbName: "string",
dbNames: "string",
dedicatedHostGroupId: "string",
deletionProtection: false,
direction: "string",
effectiveTime: "string",
encryptionKey: "string",
engine: "string",
engineVersion: "string",
forceRestart: false,
haMode: "string",
pgHbaConfs: [{
address: "string",
database: "string",
method: "string",
priorityId: 0,
type: "string",
user: "string",
mask: "string",
option: "string",
}],
maintainTime: "string",
acl: "string",
password: "string",
category: "string",
caType: "string",
instanceNetworkType: "string",
port: "string",
privateIpAddress: "string",
privateKey: "string",
releasedKeepPolicy: "string",
replicationAcl: "string",
resourceGroupId: "string",
restoreTable: "string",
restoreTime: "string",
roleArn: "string",
securityIps: ["string"],
serverCert: "string",
serverKey: "string",
serverlessConfigs: [{
maxCapacity: 0,
minCapacity: 0,
autoPause: false,
switchForce: false,
}],
sourceBiz: "string",
autoUpgradeMinorVersion: "string",
sslEnabled: 0,
switchTime: "string",
syncMode: "string",
tableMeta: "string",
tcpConnectionType: "string",
tdeStatus: "string",
usedTime: 0,
vpcId: "string",
vswitchId: "string",
zoneId: "string",
zoneIdSlaveA: "string",
zoneIdSlaveB: "string",
});
type: alicloud:rds:RdsCloneDbInstance
properties:
acl: string
autoUpgradeMinorVersion: string
backupId: string
backupType: string
caType: string
category: string
certificate: string
clientCaCert: string
clientCaEnabled: 0
clientCertRevocationList: string
clientCrlEnabled: 0
connectionStringPrefix: string
dbInstanceClass: string
dbInstanceDescription: string
dbInstanceStorage: 0
dbInstanceStorageType: string
dbName: string
dbNames: string
dedicatedHostGroupId: string
deletionProtection: false
direction: string
effectiveTime: string
encryptionKey: string
engine: string
engineVersion: string
forceRestart: false
haMode: string
instanceNetworkType: string
maintainTime: string
parameters:
- name: string
value: string
password: string
paymentType: string
period: string
pgHbaConfs:
- address: string
database: string
mask: string
method: string
option: string
priorityId: 0
type: string
user: string
port: string
privateIpAddress: string
privateKey: string
releasedKeepPolicy: string
replicationAcl: string
resourceGroupId: string
restoreTable: string
restoreTime: string
roleArn: string
securityIps:
- string
serverCert: string
serverKey: string
serverlessConfigs:
- autoPause: false
maxCapacity: 0
minCapacity: 0
switchForce: false
sourceBiz: string
sourceDbInstanceId: string
sslEnabled: 0
switchTime: string
syncMode: string
tableMeta: string
tcpConnectionType: string
tdeStatus: string
usedTime: 0
vpcId: string
vswitchId: string
zoneId: string
zoneIdSlaveA: string
zoneIdSlaveB: string
RdsCloneDbInstance Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The RdsCloneDbInstance resource accepts the following input properties:
- Db
Instance stringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- Payment
Type string - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - Source
Db stringInstance Id - The source db instance id.
- Acl string
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - Auto
Upgrade stringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- Backup
Id string The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- Backup
Type string - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- Ca
Type string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- Category string
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- Certificate string
- The file that contains the certificate used for TDE.
- Client
Ca stringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- Client
Ca intEnabled - The client ca enabled.
- Client
Cert stringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- Client
Crl intEnabled - The client crl enabled.
- Connection
String stringPrefix - The connection string prefix.
- Db
Instance stringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- Db
Instance stringDescription - The db instance description.
- Db
Instance intStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- Db
Name string The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- Db
Names string - The names of the databases that you want to create on the new instance.
- Dedicated
Host stringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- Deletion
Protection bool The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- Direction string
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - Effective
Time string - The effective time.
- Encryption
Key string The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- Engine string
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- Engine
Version string - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- Force
Restart bool - Set it to true to make some parameter efficient when modifying them. Default to false.
- Ha
Mode string - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- Instance
Network stringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- Maintain
Time string - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- Parameters
List<Pulumi.
Ali Cloud. Rds. Inputs. Rds Clone Db Instance Parameter> - 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. - Password string
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- Period string
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- Pg
Hba List<Pulumi.Confs Ali Cloud. Rds. Inputs. Rds Clone Db Instance Pg Hba Conf> - The details of the AD domain.See
pg_hba_conf
below. - Port string
- The port.
- Private
Ip stringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- Private
Key string - The file that contains the private key used for TDE.
- Released
Keep stringPolicy - The released keep policy.
- Replication
Acl string - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - Resource
Group stringId - The resource group id.
- Restore
Table string - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- Restore
Time string - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- Role
Arn string 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.
NOTE: This parameter is available only when the instance runs MySQL.
- Security
Ips List<string> The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- Server
Cert string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- Server
Key string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- Serverless
Configs List<Pulumi.Ali Cloud. Rds. Inputs. Rds Clone Db Instance Serverless Config> - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - Source
Biz string - The source biz.
- Ssl
Enabled int - Enable or disable SSL. Valid values:
0
and1
. - Switch
Time string - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- Sync
Mode string The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- Table
Meta string - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- Tcp
Connection stringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- Tde
Status string - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- Used
Time int The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- Vpc
Id string The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- Vswitch
Id string The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- Zone
Id string - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- Zone
Id stringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- Zone
Id stringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- Db
Instance stringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- Payment
Type string - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - Source
Db stringInstance Id - The source db instance id.
- Acl string
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - Auto
Upgrade stringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- Backup
Id string The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- Backup
Type string - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- Ca
Type string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- Category string
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- Certificate string
- The file that contains the certificate used for TDE.
- Client
Ca stringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- Client
Ca intEnabled - The client ca enabled.
- Client
Cert stringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- Client
Crl intEnabled - The client crl enabled.
- Connection
String stringPrefix - The connection string prefix.
- Db
Instance stringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- Db
Instance stringDescription - The db instance description.
- Db
Instance intStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- Db
Name string The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- Db
Names string - The names of the databases that you want to create on the new instance.
- Dedicated
Host stringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- Deletion
Protection bool The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- Direction string
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - Effective
Time string - The effective time.
- Encryption
Key string The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- Engine string
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- Engine
Version string - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- Force
Restart bool - Set it to true to make some parameter efficient when modifying them. Default to false.
- Ha
Mode string - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- Instance
Network stringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- Maintain
Time string - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- Parameters
[]Rds
Clone Db Instance Parameter Args - 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. - Password string
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- Period string
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- Pg
Hba []RdsConfs Clone Db Instance Pg Hba Conf Args - The details of the AD domain.See
pg_hba_conf
below. - Port string
- The port.
- Private
Ip stringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- Private
Key string - The file that contains the private key used for TDE.
- Released
Keep stringPolicy - The released keep policy.
- Replication
Acl string - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - Resource
Group stringId - The resource group id.
- Restore
Table string - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- Restore
Time string - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- Role
Arn string 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.
NOTE: This parameter is available only when the instance runs MySQL.
- Security
Ips []string The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- Server
Cert string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- Server
Key string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- Serverless
Configs []RdsClone Db Instance Serverless Config Args - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - Source
Biz string - The source biz.
- Ssl
Enabled int - Enable or disable SSL. Valid values:
0
and1
. - Switch
Time string - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- Sync
Mode string The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- Table
Meta string - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- Tcp
Connection stringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- Tde
Status string - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- Used
Time int The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- Vpc
Id string The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- Vswitch
Id string The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- Zone
Id string - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- Zone
Id stringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- Zone
Id stringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- db
Instance StringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- payment
Type String - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - source
Db StringInstance Id - The source db instance id.
- acl String
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - auto
Upgrade StringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- backup
Id String The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- backup
Type String - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- ca
Type String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- category String
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- certificate String
- The file that contains the certificate used for TDE.
- client
Ca StringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- client
Ca IntegerEnabled - The client ca enabled.
- client
Cert StringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- client
Crl IntegerEnabled - The client crl enabled.
- connection
String StringPrefix - The connection string prefix.
- db
Instance StringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- db
Instance StringDescription - The db instance description.
- db
Instance IntegerStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- db
Name String The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- db
Names String - The names of the databases that you want to create on the new instance.
- dedicated
Host StringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- deletion
Protection Boolean The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- direction String
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - effective
Time String - The effective time.
- encryption
Key String The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- engine String
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- engine
Version String - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- force
Restart Boolean - Set it to true to make some parameter efficient when modifying them. Default to false.
- ha
Mode String - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- instance
Network StringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- maintain
Time String - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- parameters
List<Rds
Clone Db Instance Parameter> - 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. - password String
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- period String
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- pg
Hba List<RdsConfs Clone Db Instance Pg Hba Conf> - The details of the AD domain.See
pg_hba_conf
below. - port String
- The port.
- private
Ip StringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- private
Key String - The file that contains the private key used for TDE.
- released
Keep StringPolicy - The released keep policy.
- replication
Acl String - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - resource
Group StringId - The resource group id.
- restore
Table String - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- restore
Time String - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- role
Arn String 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.
NOTE: This parameter is available only when the instance runs MySQL.
- security
Ips List<String> The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- server
Cert String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- server
Key String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- serverless
Configs List<RdsClone Db Instance Serverless Config> - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - source
Biz String - The source biz.
- ssl
Enabled Integer - Enable or disable SSL. Valid values:
0
and1
. - switch
Time String - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- sync
Mode String The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- table
Meta String - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- tcp
Connection StringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- tde
Status String - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- used
Time Integer The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- vpc
Id String The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- vswitch
Id String The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- zone
Id String - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- zone
Id StringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- zone
Id StringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- db
Instance stringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- payment
Type string - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - source
Db stringInstance Id - The source db instance id.
- acl string
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - auto
Upgrade stringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- backup
Id string The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- backup
Type string - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- ca
Type string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- category string
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- certificate string
- The file that contains the certificate used for TDE.
- client
Ca stringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- client
Ca numberEnabled - The client ca enabled.
- client
Cert stringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- client
Crl numberEnabled - The client crl enabled.
- connection
String stringPrefix - The connection string prefix.
- db
Instance stringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- db
Instance stringDescription - The db instance description.
- db
Instance numberStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- db
Name string The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- db
Names string - The names of the databases that you want to create on the new instance.
- dedicated
Host stringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- deletion
Protection boolean The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- direction string
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - effective
Time string - The effective time.
- encryption
Key string The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- engine string
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- engine
Version string - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- force
Restart boolean - Set it to true to make some parameter efficient when modifying them. Default to false.
- ha
Mode string - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- instance
Network stringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- maintain
Time string - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- parameters
Rds
Clone Db Instance Parameter[] - 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. - password string
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- period string
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- pg
Hba RdsConfs Clone Db Instance Pg Hba Conf[] - The details of the AD domain.See
pg_hba_conf
below. - port string
- The port.
- private
Ip stringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- private
Key string - The file that contains the private key used for TDE.
- released
Keep stringPolicy - The released keep policy.
- replication
Acl string - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - resource
Group stringId - The resource group id.
- restore
Table string - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- restore
Time string - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- role
Arn string 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.
NOTE: This parameter is available only when the instance runs MySQL.
- security
Ips string[] The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- server
Cert string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- server
Key string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- serverless
Configs RdsClone Db Instance Serverless Config[] - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - source
Biz string - The source biz.
- ssl
Enabled number - Enable or disable SSL. Valid values:
0
and1
. - switch
Time string - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- sync
Mode string The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- table
Meta string - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- tcp
Connection stringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- tde
Status string - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- used
Time number The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- vpc
Id string The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- vswitch
Id string The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- zone
Id string - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- zone
Id stringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- zone
Id stringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- db_
instance_ strstorage_ type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- payment_
type str - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - source_
db_ strinstance_ id - The source db instance id.
- acl str
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - auto_
upgrade_ strminor_ version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- backup_
id str The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- backup_
type str - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- ca_
type str - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- category str
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- certificate str
- The file that contains the certificate used for TDE.
- client_
ca_ strcert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- client_
ca_ intenabled - The client ca enabled.
- client_
cert_ strrevocation_ list - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- client_
crl_ intenabled - The client crl enabled.
- connection_
string_ strprefix - The connection string prefix.
- db_
instance_ strclass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- db_
instance_ strdescription - The db instance description.
- db_
instance_ intstorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- db_
name str The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- db_
names str - The names of the databases that you want to create on the new instance.
- dedicated_
host_ strgroup_ id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- deletion_
protection bool The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- direction str
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - effective_
time str - The effective time.
- encryption_
key str The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- engine str
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- engine_
version str - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- force_
restart bool - Set it to true to make some parameter efficient when modifying them. Default to false.
- ha_
mode str - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- instance_
network_ strtype - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- maintain_
time str - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- parameters
Sequence[Rds
Clone Db Instance Parameter Args] - 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. - password str
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- period str
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- pg_
hba_ Sequence[Rdsconfs Clone Db Instance Pg Hba Conf Args] - The details of the AD domain.See
pg_hba_conf
below. - port str
- The port.
- private_
ip_ straddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- private_
key str - The file that contains the private key used for TDE.
- released_
keep_ strpolicy - The released keep policy.
- replication_
acl str - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - resource_
group_ strid - The resource group id.
- restore_
table str - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- restore_
time str - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- role_
arn str 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.
NOTE: This parameter is available only when the instance runs MySQL.
- security_
ips Sequence[str] The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- server_
cert str - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- server_
key str - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- serverless_
configs Sequence[RdsClone Db Instance Serverless Config Args] - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - source_
biz str - The source biz.
- ssl_
enabled int - Enable or disable SSL. Valid values:
0
and1
. - switch_
time str - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- sync_
mode str The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- table_
meta str - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- tcp_
connection_ strtype - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- tde_
status str - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- used_
time int The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- vpc_
id str The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- vswitch_
id str The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- zone_
id str - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- zone_
id_ strslave_ a - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- zone_
id_ strslave_ b The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- db
Instance StringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- payment
Type String - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - source
Db StringInstance Id - The source db instance id.
- acl String
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - auto
Upgrade StringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- backup
Id String The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- backup
Type String - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- ca
Type String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- category String
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- certificate String
- The file that contains the certificate used for TDE.
- client
Ca StringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- client
Ca NumberEnabled - The client ca enabled.
- client
Cert StringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- client
Crl NumberEnabled - The client crl enabled.
- connection
String StringPrefix - The connection string prefix.
- db
Instance StringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- db
Instance StringDescription - The db instance description.
- db
Instance NumberStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- db
Name String The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- db
Names String - The names of the databases that you want to create on the new instance.
- dedicated
Host StringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- deletion
Protection Boolean The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- direction String
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - effective
Time String - The effective time.
- encryption
Key String The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- engine String
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- engine
Version String - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- force
Restart Boolean - Set it to true to make some parameter efficient when modifying them. Default to false.
- ha
Mode String - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- instance
Network StringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- maintain
Time String - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- parameters List<Property Map>
- 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. - password String
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- period String
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- pg
Hba List<Property Map>Confs - The details of the AD domain.See
pg_hba_conf
below. - port String
- The port.
- private
Ip StringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- private
Key String - The file that contains the private key used for TDE.
- released
Keep StringPolicy - The released keep policy.
- replication
Acl String - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - resource
Group StringId - The resource group id.
- restore
Table String - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- restore
Time String - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- role
Arn String 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.
NOTE: This parameter is available only when the instance runs MySQL.
- security
Ips List<String> The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- server
Cert String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- server
Key String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- serverless
Configs List<Property Map> - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - source
Biz String - The source biz.
- ssl
Enabled Number - Enable or disable SSL. Valid values:
0
and1
. - switch
Time String - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- sync
Mode String The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- table
Meta String - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- tcp
Connection StringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- tde
Status String - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- used
Time Number The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- vpc
Id String The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- vswitch
Id String The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- zone
Id String - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- zone
Id StringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- zone
Id StringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
Outputs
All input properties are implicitly available as output properties. Additionally, the RdsCloneDbInstance resource produces the following output properties:
- Connection
String string - The database connection address.
- Id string
- The provider-assigned unique ID for this managed resource.
- Connection
String string - The database connection address.
- Id string
- The provider-assigned unique ID for this managed resource.
- connection
String String - The database connection address.
- id String
- The provider-assigned unique ID for this managed resource.
- connection
String string - The database connection address.
- id string
- The provider-assigned unique ID for this managed resource.
- connection_
string str - The database connection address.
- id str
- The provider-assigned unique ID for this managed resource.
- connection
String String - The database connection address.
- id String
- The provider-assigned unique ID for this managed resource.
Look up Existing RdsCloneDbInstance Resource
Get an existing RdsCloneDbInstance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: RdsCloneDbInstanceState, opts?: CustomResourceOptions): RdsCloneDbInstance
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
acl: Optional[str] = None,
auto_upgrade_minor_version: Optional[str] = None,
backup_id: Optional[str] = None,
backup_type: Optional[str] = None,
ca_type: Optional[str] = None,
category: Optional[str] = None,
certificate: Optional[str] = None,
client_ca_cert: Optional[str] = None,
client_ca_enabled: Optional[int] = None,
client_cert_revocation_list: Optional[str] = None,
client_crl_enabled: Optional[int] = None,
connection_string: Optional[str] = None,
connection_string_prefix: Optional[str] = None,
db_instance_class: Optional[str] = None,
db_instance_description: Optional[str] = None,
db_instance_storage: Optional[int] = None,
db_instance_storage_type: Optional[str] = None,
db_name: Optional[str] = None,
db_names: Optional[str] = None,
dedicated_host_group_id: Optional[str] = None,
deletion_protection: Optional[bool] = None,
direction: Optional[str] = None,
effective_time: Optional[str] = None,
encryption_key: Optional[str] = None,
engine: Optional[str] = None,
engine_version: Optional[str] = None,
force_restart: Optional[bool] = None,
ha_mode: Optional[str] = None,
instance_network_type: Optional[str] = None,
maintain_time: Optional[str] = None,
parameters: Optional[Sequence[RdsCloneDbInstanceParameterArgs]] = None,
password: Optional[str] = None,
payment_type: Optional[str] = None,
period: Optional[str] = None,
pg_hba_confs: Optional[Sequence[RdsCloneDbInstancePgHbaConfArgs]] = None,
port: Optional[str] = None,
private_ip_address: Optional[str] = None,
private_key: Optional[str] = None,
released_keep_policy: Optional[str] = None,
replication_acl: Optional[str] = None,
resource_group_id: Optional[str] = None,
restore_table: Optional[str] = None,
restore_time: Optional[str] = None,
role_arn: Optional[str] = None,
security_ips: Optional[Sequence[str]] = None,
server_cert: Optional[str] = None,
server_key: Optional[str] = None,
serverless_configs: Optional[Sequence[RdsCloneDbInstanceServerlessConfigArgs]] = None,
source_biz: Optional[str] = None,
source_db_instance_id: Optional[str] = None,
ssl_enabled: Optional[int] = None,
switch_time: Optional[str] = None,
sync_mode: Optional[str] = None,
table_meta: Optional[str] = None,
tcp_connection_type: Optional[str] = None,
tde_status: Optional[str] = None,
used_time: Optional[int] = None,
vpc_id: Optional[str] = None,
vswitch_id: Optional[str] = None,
zone_id: Optional[str] = None,
zone_id_slave_a: Optional[str] = None,
zone_id_slave_b: Optional[str] = None) -> RdsCloneDbInstance
func GetRdsCloneDbInstance(ctx *Context, name string, id IDInput, state *RdsCloneDbInstanceState, opts ...ResourceOption) (*RdsCloneDbInstance, error)
public static RdsCloneDbInstance Get(string name, Input<string> id, RdsCloneDbInstanceState? state, CustomResourceOptions? opts = null)
public static RdsCloneDbInstance get(String name, Output<String> id, RdsCloneDbInstanceState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Acl string
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - Auto
Upgrade stringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- Backup
Id string The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- Backup
Type string - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- Ca
Type string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- Category string
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- Certificate string
- The file that contains the certificate used for TDE.
- Client
Ca stringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- Client
Ca intEnabled - The client ca enabled.
- Client
Cert stringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- Client
Crl intEnabled - The client crl enabled.
- Connection
String string - The database connection address.
- Connection
String stringPrefix - The connection string prefix.
- Db
Instance stringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- Db
Instance stringDescription - The db instance description.
- Db
Instance intStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- Db
Instance stringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- Db
Name string The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- Db
Names string - The names of the databases that you want to create on the new instance.
- Dedicated
Host stringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- Deletion
Protection bool The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- Direction string
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - Effective
Time string - The effective time.
- Encryption
Key string The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- Engine string
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- Engine
Version string - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- Force
Restart bool - Set it to true to make some parameter efficient when modifying them. Default to false.
- Ha
Mode string - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- Instance
Network stringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- Maintain
Time string - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- Parameters
List<Pulumi.
Ali Cloud. Rds. Inputs. Rds Clone Db Instance Parameter> - 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. - Password string
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- Payment
Type string - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - Period string
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- Pg
Hba List<Pulumi.Confs Ali Cloud. Rds. Inputs. Rds Clone Db Instance Pg Hba Conf> - The details of the AD domain.See
pg_hba_conf
below. - Port string
- The port.
- Private
Ip stringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- Private
Key string - The file that contains the private key used for TDE.
- Released
Keep stringPolicy - The released keep policy.
- Replication
Acl string - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - Resource
Group stringId - The resource group id.
- Restore
Table string - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- Restore
Time string - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- Role
Arn string 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.
NOTE: This parameter is available only when the instance runs MySQL.
- Security
Ips List<string> The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- Server
Cert string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- Server
Key string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- Serverless
Configs List<Pulumi.Ali Cloud. Rds. Inputs. Rds Clone Db Instance Serverless Config> - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - Source
Biz string - The source biz.
- Source
Db stringInstance Id - The source db instance id.
- Ssl
Enabled int - Enable or disable SSL. Valid values:
0
and1
. - Switch
Time string - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- Sync
Mode string The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- Table
Meta string - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- Tcp
Connection stringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- Tde
Status string - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- Used
Time int The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- Vpc
Id string The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- Vswitch
Id string The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- Zone
Id string - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- Zone
Id stringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- Zone
Id stringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- Acl string
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - Auto
Upgrade stringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- Backup
Id string The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- Backup
Type string - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- Ca
Type string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- Category string
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- Certificate string
- The file that contains the certificate used for TDE.
- Client
Ca stringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- Client
Ca intEnabled - The client ca enabled.
- Client
Cert stringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- Client
Crl intEnabled - The client crl enabled.
- Connection
String string - The database connection address.
- Connection
String stringPrefix - The connection string prefix.
- Db
Instance stringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- Db
Instance stringDescription - The db instance description.
- Db
Instance intStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- Db
Instance stringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- Db
Name string The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- Db
Names string - The names of the databases that you want to create on the new instance.
- Dedicated
Host stringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- Deletion
Protection bool The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- Direction string
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - Effective
Time string - The effective time.
- Encryption
Key string The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- Engine string
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- Engine
Version string - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- Force
Restart bool - Set it to true to make some parameter efficient when modifying them. Default to false.
- Ha
Mode string - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- Instance
Network stringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- Maintain
Time string - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- Parameters
[]Rds
Clone Db Instance Parameter Args - 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. - Password string
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- Payment
Type string - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - Period string
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- Pg
Hba []RdsConfs Clone Db Instance Pg Hba Conf Args - The details of the AD domain.See
pg_hba_conf
below. - Port string
- The port.
- Private
Ip stringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- Private
Key string - The file that contains the private key used for TDE.
- Released
Keep stringPolicy - The released keep policy.
- Replication
Acl string - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - Resource
Group stringId - The resource group id.
- Restore
Table string - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- Restore
Time string - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- Role
Arn string 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.
NOTE: This parameter is available only when the instance runs MySQL.
- Security
Ips []string The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- Server
Cert string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- Server
Key string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- Serverless
Configs []RdsClone Db Instance Serverless Config Args - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - Source
Biz string - The source biz.
- Source
Db stringInstance Id - The source db instance id.
- Ssl
Enabled int - Enable or disable SSL. Valid values:
0
and1
. - Switch
Time string - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- Sync
Mode string The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- Table
Meta string - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- Tcp
Connection stringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- Tde
Status string - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- Used
Time int The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- Vpc
Id string The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- Vswitch
Id string The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- Zone
Id string - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- Zone
Id stringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- Zone
Id stringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- acl String
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - auto
Upgrade StringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- backup
Id String The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- backup
Type String - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- ca
Type String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- category String
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- certificate String
- The file that contains the certificate used for TDE.
- client
Ca StringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- client
Ca IntegerEnabled - The client ca enabled.
- client
Cert StringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- client
Crl IntegerEnabled - The client crl enabled.
- connection
String String - The database connection address.
- connection
String StringPrefix - The connection string prefix.
- db
Instance StringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- db
Instance StringDescription - The db instance description.
- db
Instance IntegerStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- db
Instance StringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- db
Name String The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- db
Names String - The names of the databases that you want to create on the new instance.
- dedicated
Host StringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- deletion
Protection Boolean The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- direction String
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - effective
Time String - The effective time.
- encryption
Key String The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- engine String
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- engine
Version String - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- force
Restart Boolean - Set it to true to make some parameter efficient when modifying them. Default to false.
- ha
Mode String - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- instance
Network StringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- maintain
Time String - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- parameters
List<Rds
Clone Db Instance Parameter> - 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. - password String
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- payment
Type String - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - period String
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- pg
Hba List<RdsConfs Clone Db Instance Pg Hba Conf> - The details of the AD domain.See
pg_hba_conf
below. - port String
- The port.
- private
Ip StringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- private
Key String - The file that contains the private key used for TDE.
- released
Keep StringPolicy - The released keep policy.
- replication
Acl String - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - resource
Group StringId - The resource group id.
- restore
Table String - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- restore
Time String - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- role
Arn String 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.
NOTE: This parameter is available only when the instance runs MySQL.
- security
Ips List<String> The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- server
Cert String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- server
Key String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- serverless
Configs List<RdsClone Db Instance Serverless Config> - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - source
Biz String - The source biz.
- source
Db StringInstance Id - The source db instance id.
- ssl
Enabled Integer - Enable or disable SSL. Valid values:
0
and1
. - switch
Time String - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- sync
Mode String The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- table
Meta String - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- tcp
Connection StringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- tde
Status String - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- used
Time Integer The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- vpc
Id String The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- vswitch
Id String The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- zone
Id String - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- zone
Id StringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- zone
Id StringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- acl string
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - auto
Upgrade stringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- backup
Id string The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- backup
Type string - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- ca
Type string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- category string
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- certificate string
- The file that contains the certificate used for TDE.
- client
Ca stringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- client
Ca numberEnabled - The client ca enabled.
- client
Cert stringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- client
Crl numberEnabled - The client crl enabled.
- connection
String string - The database connection address.
- connection
String stringPrefix - The connection string prefix.
- db
Instance stringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- db
Instance stringDescription - The db instance description.
- db
Instance numberStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- db
Instance stringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- db
Name string The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- db
Names string - The names of the databases that you want to create on the new instance.
- dedicated
Host stringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- deletion
Protection boolean The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- direction string
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - effective
Time string - The effective time.
- encryption
Key string The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- engine string
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- engine
Version string - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- force
Restart boolean - Set it to true to make some parameter efficient when modifying them. Default to false.
- ha
Mode string - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- instance
Network stringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- maintain
Time string - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- parameters
Rds
Clone Db Instance Parameter[] - 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. - password string
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- payment
Type string - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - period string
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- pg
Hba RdsConfs Clone Db Instance Pg Hba Conf[] - The details of the AD domain.See
pg_hba_conf
below. - port string
- The port.
- private
Ip stringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- private
Key string - The file that contains the private key used for TDE.
- released
Keep stringPolicy - The released keep policy.
- replication
Acl string - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - resource
Group stringId - The resource group id.
- restore
Table string - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- restore
Time string - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- role
Arn string 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.
NOTE: This parameter is available only when the instance runs MySQL.
- security
Ips string[] The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- server
Cert string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- server
Key string - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- serverless
Configs RdsClone Db Instance Serverless Config[] - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - source
Biz string - The source biz.
- source
Db stringInstance Id - The source db instance id.
- ssl
Enabled number - Enable or disable SSL. Valid values:
0
and1
. - switch
Time string - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- sync
Mode string The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- table
Meta string - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- tcp
Connection stringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- tde
Status string - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- used
Time number The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- vpc
Id string The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- vswitch
Id string The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- zone
Id string - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- zone
Id stringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- zone
Id stringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- acl str
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - auto_
upgrade_ strminor_ version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- backup_
id str The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- backup_
type str - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- ca_
type str - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- category str
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- certificate str
- The file that contains the certificate used for TDE.
- client_
ca_ strcert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- client_
ca_ intenabled - The client ca enabled.
- client_
cert_ strrevocation_ list - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- client_
crl_ intenabled - The client crl enabled.
- connection_
string str - The database connection address.
- connection_
string_ strprefix - The connection string prefix.
- db_
instance_ strclass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- db_
instance_ strdescription - The db instance description.
- db_
instance_ intstorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- db_
instance_ strstorage_ type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- db_
name str The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- db_
names str - The names of the databases that you want to create on the new instance.
- dedicated_
host_ strgroup_ id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- deletion_
protection bool The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- direction str
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - effective_
time str - The effective time.
- encryption_
key str The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- engine str
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- engine_
version str - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- force_
restart bool - Set it to true to make some parameter efficient when modifying them. Default to false.
- ha_
mode str - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- instance_
network_ strtype - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- maintain_
time str - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- parameters
Sequence[Rds
Clone Db Instance Parameter Args] - 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. - password str
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- payment_
type str - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - period str
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- pg_
hba_ Sequence[Rdsconfs Clone Db Instance Pg Hba Conf Args] - The details of the AD domain.See
pg_hba_conf
below. - port str
- The port.
- private_
ip_ straddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- private_
key str - The file that contains the private key used for TDE.
- released_
keep_ strpolicy - The released keep policy.
- replication_
acl str - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - resource_
group_ strid - The resource group id.
- restore_
table str - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- restore_
time str - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- role_
arn str 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.
NOTE: This parameter is available only when the instance runs MySQL.
- security_
ips Sequence[str] The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- server_
cert str - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- server_
key str - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- serverless_
configs Sequence[RdsClone Db Instance Serverless Config Args] - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - source_
biz str - The source biz.
- source_
db_ strinstance_ id - The source db instance id.
- ssl_
enabled int - Enable or disable SSL. Valid values:
0
and1
. - switch_
time str - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- sync_
mode str The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- table_
meta str - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- tcp_
connection_ strtype - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- tde_
status str - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- used_
time int The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- vpc_
id str The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- vswitch_
id str The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- zone_
id str - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- zone_
id_ strslave_ a - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- zone_
id_ strslave_ b The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
- acl String
- 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - auto
Upgrade StringMinor Version - How to upgrade the minor version of the instance. Valid values:
- Auto: automatically upgrade the minor version.
- Manual: It is not automatically upgraded. It is only mandatory when the current version is offline.
- backup
Id String The ID of the data backup file you want to use. You can call the DescribeBackups operation to query the most recent data backup file list.
NOTE: You must specify at least one of the BackupId and RestoreTime parameters. When
payment_type="Serverless"
and when modifying, do not performinstance_storage
check. Otherwise, check.- backup
Type String - The type of backup that is used to restore the data of the original instance. Valid values:
- FullBackup: full backup
- IncrementalBackup: incremental backup
- ca
Type String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the certificate type. When the value of ssl_action is Open, the default value of this parameter is aliyun. Value range:
- aliyun: using cloud certificates
- custom: use a custom certificate. Valid values:
aliyun
,custom
.
- category String
- Instance series. Valid values:
- Basic: Basic Edition
- HighAvailability: High availability
- AlwaysOn: Cluster Edition
- Finance: Three-node Enterprise Edition.
- serverless_basic: Serverless Basic Edition. (Available in 1.200.0+)
- serverless_standard: MySQL Serverless High Availability Edition. (Available in 1.207.0+)
- serverless_ha: SQLServer Serverless High Availability Edition. (Available in 1.207.0+)
- cluster: MySQL Cluster Edition. (Available in 1.207.0+)
- certificate String
- The file that contains the certificate used for TDE.
- client
Ca StringCert - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the public key of the client certification authority. If the value of client_ca_enabled is 1, this parameter must be configured.
- client
Ca NumberEnabled - The client ca enabled.
- client
Cert StringRevocation List - This parameter is only supported by the RDS PostgreSQL cloud disk version, which indicates that the client revokes the certificate file. If the value of client_crl_enabled is 1, this parameter must be configured.
- client
Crl NumberEnabled - The client crl enabled.
- connection
String String - The database connection address.
- connection
String StringPrefix - The connection string prefix.
- db
Instance StringClass - The instance type of the new instance. For information, see Primary ApsaraDB RDS instance types.
- db
Instance StringDescription - The db instance description.
- db
Instance NumberStorage 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.
NOTE: The default value of this parameter is the storage capacity of the original instance.
- db
Instance StringStorage Type - The type of storage media that is used for the new instance. Valid values:
- local_ssd: local SSDs
- cloud_ssd: standard SSDs
- cloud_essd: enhanced SSDs (ESSDs) of performance level 1 (PL1)
- cloud_essd2: ESSDs of PL2
- cloud_essd3: ESSDs of PL3
- db
Name String The name of the database for which you want to enable TDE. Up to 50 names can be entered in a single request. If you specify multiple names, separate these names with commas (,).
NOTE: This parameter is available and must be specified only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- db
Names String - The names of the databases that you want to create on the new instance.
- dedicated
Host StringGroup Id - The ID of the dedicated cluster to which the new instance belongs. This parameter takes effect only when you create the new instance in a dedicated cluster.
- deletion
Protection Boolean The switch of delete protection. Valid values:
- true: delete protect.
- false: no delete protect.
NOTE:
deletion_protection
is valid only when attributepayment_type
is set toPayAsYouGo
, supported engine type: MySQL, PostgreSQL, MariaDB, MSSQL.- direction String
- The direction. Valid values:
Auto
,Down
,TempUpgrade
,Up
. - effective
Time String - The effective time.
- encryption
Key String The ID of the private key.
NOTE: This parameter is available only when the instance runs MySQL.
- engine String
- Database type. Value options: MySQL, SQLServer, PostgreSQL, MariaDB.
- engine
Version String - Database version. Value:
- MySQL:5.5/5.6/5.7/8.0
- SQL Server:2008r2/08r2_ent_ha/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_std_ha/2017_ent/2019_std_ha/2019_ent
- PostgreSQL:9.4/10.0/11.0/12.0/13.0
- MariaDB:10.3.
- force
Restart Boolean - Set it to true to make some parameter efficient when modifying them. Default to false.
- ha
Mode String - The high availability mode. Valid values:
- RPO: Data persistence is preferred. The instance preferentially ensures data reliability to minimize data loss. Use this mode if you have higher requirements on data consistency.
- RTO: Instance availability is preferred. The instance restores services as soon as possible to ensure availability. Use this mode if you have higher requirements on service availability.
- instance
Network StringType - The network type of the instance. Valid values:
- Classic: Classic Network
- VPC: VPC.
- maintain
Time String - The maintainable time period of the instance. Format: HH:mm Z- HH:mm Z(UTC time).
- parameters List<Property Map>
- 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. - password String
The password of the certificate.
NOTE: This parameter is available only when the instance runs SQL Server 2019 SE or an Enterprise Edition of SQL Server.
- payment
Type String - The billing method of the new instance. Valid values:
PayAsYouGo
andSubscription
andServerless
. - period String
The period. Valid values:
Month
,Year
.NOTE: If you set the payment_type parameter to Subscription, you must specify the period parameter.
- pg
Hba List<Property Map>Confs - The details of the AD domain.See
pg_hba_conf
below. - port String
- The port.
- private
Ip StringAddress - The intranet IP address of the new instance must be within the specified vSwitch IP address range. By default, the system automatically allocates by using VPCId and VSwitchId.
- private
Key String - The file that contains the private key used for TDE.
- released
Keep StringPolicy - The released keep policy.
- replication
Acl String - 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
andperfer
andverify-ca
andverify-full (supported by RDS PostgreSQL above 12)
. - resource
Group StringId - The resource group id.
- restore
Table String - Specifies whether to restore only the databases and tables that you specify. The value 1 specifies to restore only the specified databases and tables. If you do not want to restore only the specified databases or tables, you can choose not to specify this parameter.
- restore
Time String - The point in time to which you want to restore the data of the original instance. The point in time must fall within the specified log backup retention period. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- role
Arn String 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.
NOTE: This parameter is available only when the instance runs MySQL.
- security
Ips List<String> The IP address whitelist of the instance. Separate multiple IP addresses with commas (,) and cannot be repeated. The following two formats are supported:
- IP address form, for example: 10.23.12.24.
- CIDR format, for example, 10.23.12.0/24 (no Inter-Domain Routing, 24 indicates the length of the prefix in the address, ranging from 1 to 32).
NOTE: each instance can add up to 1000 IP addresses or IP segments, that is, the total number of IP addresses or IP segments in all IP whitelist groups cannot exceed 1000. When there are more IP addresses, it is recommended to merge them into IP segments, for example, 10.23.12.0/24.
- server
Cert String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the content of the server certificate. If the CAType value is custom, this parameter must be configured.
- server
Key String - This parameter is only supported by the RDS PostgreSQL cloud disk version. It indicates the private key of the server certificate. If the value of CAType is custom, this parameter must be configured.
- serverless
Configs List<Property Map> - The settings of the serverless instance. This parameter is required when you create a serverless instance. This parameter takes effect only when you create an ApsaraDB RDS for MySQL instance.See
serverless_config
below. - source
Biz String - The source biz.
- source
Db StringInstance Id - The source db instance id.
- ssl
Enabled Number - Enable or disable SSL. Valid values:
0
and1
. - switch
Time String - The time at which you want to apply the specification changes. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
- sync
Mode String The data replication mode. Valid values:
- Sync: strong synchronization
- Semi-sync: Semi-synchronous
- Async: asynchronous
NOTE: SQL Server 2017 cluster version is currently not supported.
- table
Meta String - The information about the databases and tables that you want to restore. Format: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
- tcp
Connection StringType - The availability check method of the instance. Valid values:
- SHORT: Alibaba Cloud uses short-lived connections to check the availability of the instance.
- LONG: Alibaba Cloud uses persistent connections to check the availability of the instance.
- tde
Status String - Specifies whether to enable TDE. Valid values:
- Enabled
- Disabled
- used
Time Number The subscription period of the new instance. This parameter takes effect only when you select the subscription billing method for the new instance. Valid values:
- If you set the
Period
parameter to Year, the value of the UsedTime parameter ranges from 1 to 3. - If you set the
Period
parameter to Month, the value of the UsedTime parameter ranges from 1 to 9.
NOTE: If you set the payment_type parameter to Subscription, you must specify the used_time parameter.
- If you set the
- vpc
Id String The ID of the VPC to which the new instance belongs.
NOTE: Make sure that the VPC resides in the specified region.
- vswitch
Id String The ID of the vSwitch associated with the specified VPC. If there are multiple vswitches, separate them with commas. The first vswitch is a primary zone switch and the query only returns that vswitch. If there are multiple vswitches, do not perform
vswitch_id
check.NOTE: Make sure that the vSwitch belongs to the specified VPC and region.
- zone
Id String - The ID of the zone to which the new instance belongs. You can call the DescribeRegions operation to query the most recent region list.
- zone
Id StringSlave A - The region ID of the secondary instance if you create a secondary instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
- zone
Id StringSlave B The region ID of the log instance if you create a log instance. If you set this parameter to the same value as the ZoneId parameter, the instance is deployed in a single zone. Otherwise, the instance is deployed in multiple zones.
NOTE: The default value of this parameter is the ID of the zone to which the original instance belongs.
Supporting Types
RdsCloneDbInstanceParameter, RdsCloneDbInstanceParameterArgs
RdsCloneDbInstancePgHbaConf, RdsCloneDbInstancePgHbaConfArgs
- Address string
- The IP addresses from which the specified users can access the specified databases. If you set this parameter to 0.0.0.0/0, the specified users are allowed to access the specified databases from all IP addresses.
- Database string
- The name of the database that the specified users are allowed to access. If you set this parameter to all, the specified users are allowed to access all databases in the instance. If you specify multiple databases, separate the database names with commas (,).
- Method string
- The authentication method of Lightweight Directory Access Protocol (LDAP). Valid values:
trust
,reject
,scram-sha-256
,md5
,password
,gss
,sspi
,ldap
,radius
,cert
,pam
. - Priority
Id int - The priority of an AD domain. If you set this parameter to 0, the AD domain has the highest priority. Valid values: 0 to 10000. This parameter is used to identify each AD domain. When you add an AD domain, the value of the PriorityId parameter of the new AD domain cannot be the same as the value of the PriorityId parameter for any existing AD domain. When you modify or delete an AD domain, you must also modify or delete the value of the PriorityId parameter for this AD domain.
- Type string
The type of connection to the instance. Valid values:
- host: specifies to verify TCP/IP connections, including SSL connections and non-SSL connections.
- hostssl: specifies to verify only TCP/IP connections that are established over SSL connections.
- hostnossl: specifies to verify only TCP/IP connections that are established over non-SSL connections.
NOTE: You can set this parameter to hostssl only when SSL encryption is enabled for the instance. For more information, see Configure SSL encryption for an ApsaraDB RDS for PostgreSQL instance.
- User string
- The user that is allowed to access the instance. If you specify multiple users, separate the usernames with commas (,).
- Mask string
- The mask of the instance. If the value of the
Address
parameter is an IP address, you can use this parameter to specify the mask of the IP address. - Option string
- Optional. The value of this parameter is based on the value of the HbaItem.N.Method parameter. In this topic, LDAP is used as an example. You must configure this parameter. For more information, see Authentication Methods.
- Address string
- The IP addresses from which the specified users can access the specified databases. If you set this parameter to 0.0.0.0/0, the specified users are allowed to access the specified databases from all IP addresses.
- Database string
- The name of the database that the specified users are allowed to access. If you set this parameter to all, the specified users are allowed to access all databases in the instance. If you specify multiple databases, separate the database names with commas (,).
- Method string
- The authentication method of Lightweight Directory Access Protocol (LDAP). Valid values:
trust
,reject
,scram-sha-256
,md5
,password
,gss
,sspi
,ldap
,radius
,cert
,pam
. - Priority
Id int - The priority of an AD domain. If you set this parameter to 0, the AD domain has the highest priority. Valid values: 0 to 10000. This parameter is used to identify each AD domain. When you add an AD domain, the value of the PriorityId parameter of the new AD domain cannot be the same as the value of the PriorityId parameter for any existing AD domain. When you modify or delete an AD domain, you must also modify or delete the value of the PriorityId parameter for this AD domain.
- Type string
The type of connection to the instance. Valid values:
- host: specifies to verify TCP/IP connections, including SSL connections and non-SSL connections.
- hostssl: specifies to verify only TCP/IP connections that are established over SSL connections.
- hostnossl: specifies to verify only TCP/IP connections that are established over non-SSL connections.
NOTE: You can set this parameter to hostssl only when SSL encryption is enabled for the instance. For more information, see Configure SSL encryption for an ApsaraDB RDS for PostgreSQL instance.
- User string
- The user that is allowed to access the instance. If you specify multiple users, separate the usernames with commas (,).
- Mask string
- The mask of the instance. If the value of the
Address
parameter is an IP address, you can use this parameter to specify the mask of the IP address. - Option string
- Optional. The value of this parameter is based on the value of the HbaItem.N.Method parameter. In this topic, LDAP is used as an example. You must configure this parameter. For more information, see Authentication Methods.
- address String
- The IP addresses from which the specified users can access the specified databases. If you set this parameter to 0.0.0.0/0, the specified users are allowed to access the specified databases from all IP addresses.
- database String
- The name of the database that the specified users are allowed to access. If you set this parameter to all, the specified users are allowed to access all databases in the instance. If you specify multiple databases, separate the database names with commas (,).
- method String
- The authentication method of Lightweight Directory Access Protocol (LDAP). Valid values:
trust
,reject
,scram-sha-256
,md5
,password
,gss
,sspi
,ldap
,radius
,cert
,pam
. - priority
Id Integer - The priority of an AD domain. If you set this parameter to 0, the AD domain has the highest priority. Valid values: 0 to 10000. This parameter is used to identify each AD domain. When you add an AD domain, the value of the PriorityId parameter of the new AD domain cannot be the same as the value of the PriorityId parameter for any existing AD domain. When you modify or delete an AD domain, you must also modify or delete the value of the PriorityId parameter for this AD domain.
- type String
The type of connection to the instance. Valid values:
- host: specifies to verify TCP/IP connections, including SSL connections and non-SSL connections.
- hostssl: specifies to verify only TCP/IP connections that are established over SSL connections.
- hostnossl: specifies to verify only TCP/IP connections that are established over non-SSL connections.
NOTE: You can set this parameter to hostssl only when SSL encryption is enabled for the instance. For more information, see Configure SSL encryption for an ApsaraDB RDS for PostgreSQL instance.
- user String
- The user that is allowed to access the instance. If you specify multiple users, separate the usernames with commas (,).
- mask String
- The mask of the instance. If the value of the
Address
parameter is an IP address, you can use this parameter to specify the mask of the IP address. - option String
- Optional. The value of this parameter is based on the value of the HbaItem.N.Method parameter. In this topic, LDAP is used as an example. You must configure this parameter. For more information, see Authentication Methods.
- address string
- The IP addresses from which the specified users can access the specified databases. If you set this parameter to 0.0.0.0/0, the specified users are allowed to access the specified databases from all IP addresses.
- database string
- The name of the database that the specified users are allowed to access. If you set this parameter to all, the specified users are allowed to access all databases in the instance. If you specify multiple databases, separate the database names with commas (,).
- method string
- The authentication method of Lightweight Directory Access Protocol (LDAP). Valid values:
trust
,reject
,scram-sha-256
,md5
,password
,gss
,sspi
,ldap
,radius
,cert
,pam
. - priority
Id number - The priority of an AD domain. If you set this parameter to 0, the AD domain has the highest priority. Valid values: 0 to 10000. This parameter is used to identify each AD domain. When you add an AD domain, the value of the PriorityId parameter of the new AD domain cannot be the same as the value of the PriorityId parameter for any existing AD domain. When you modify or delete an AD domain, you must also modify or delete the value of the PriorityId parameter for this AD domain.
- type string
The type of connection to the instance. Valid values:
- host: specifies to verify TCP/IP connections, including SSL connections and non-SSL connections.
- hostssl: specifies to verify only TCP/IP connections that are established over SSL connections.
- hostnossl: specifies to verify only TCP/IP connections that are established over non-SSL connections.
NOTE: You can set this parameter to hostssl only when SSL encryption is enabled for the instance. For more information, see Configure SSL encryption for an ApsaraDB RDS for PostgreSQL instance.
- user string
- The user that is allowed to access the instance. If you specify multiple users, separate the usernames with commas (,).
- mask string
- The mask of the instance. If the value of the
Address
parameter is an IP address, you can use this parameter to specify the mask of the IP address. - option string
- Optional. The value of this parameter is based on the value of the HbaItem.N.Method parameter. In this topic, LDAP is used as an example. You must configure this parameter. For more information, see Authentication Methods.
- address str
- The IP addresses from which the specified users can access the specified databases. If you set this parameter to 0.0.0.0/0, the specified users are allowed to access the specified databases from all IP addresses.
- database str
- The name of the database that the specified users are allowed to access. If you set this parameter to all, the specified users are allowed to access all databases in the instance. If you specify multiple databases, separate the database names with commas (,).
- method str
- The authentication method of Lightweight Directory Access Protocol (LDAP). Valid values:
trust
,reject
,scram-sha-256
,md5
,password
,gss
,sspi
,ldap
,radius
,cert
,pam
. - priority_
id int - The priority of an AD domain. If you set this parameter to 0, the AD domain has the highest priority. Valid values: 0 to 10000. This parameter is used to identify each AD domain. When you add an AD domain, the value of the PriorityId parameter of the new AD domain cannot be the same as the value of the PriorityId parameter for any existing AD domain. When you modify or delete an AD domain, you must also modify or delete the value of the PriorityId parameter for this AD domain.
- type str
The type of connection to the instance. Valid values:
- host: specifies to verify TCP/IP connections, including SSL connections and non-SSL connections.
- hostssl: specifies to verify only TCP/IP connections that are established over SSL connections.
- hostnossl: specifies to verify only TCP/IP connections that are established over non-SSL connections.
NOTE: You can set this parameter to hostssl only when SSL encryption is enabled for the instance. For more information, see Configure SSL encryption for an ApsaraDB RDS for PostgreSQL instance.
- user str
- The user that is allowed to access the instance. If you specify multiple users, separate the usernames with commas (,).
- mask str
- The mask of the instance. If the value of the
Address
parameter is an IP address, you can use this parameter to specify the mask of the IP address. - option str
- Optional. The value of this parameter is based on the value of the HbaItem.N.Method parameter. In this topic, LDAP is used as an example. You must configure this parameter. For more information, see Authentication Methods.
- address String
- The IP addresses from which the specified users can access the specified databases. If you set this parameter to 0.0.0.0/0, the specified users are allowed to access the specified databases from all IP addresses.
- database String
- The name of the database that the specified users are allowed to access. If you set this parameter to all, the specified users are allowed to access all databases in the instance. If you specify multiple databases, separate the database names with commas (,).
- method String
- The authentication method of Lightweight Directory Access Protocol (LDAP). Valid values:
trust
,reject
,scram-sha-256
,md5
,password
,gss
,sspi
,ldap
,radius
,cert
,pam
. - priority
Id Number - The priority of an AD domain. If you set this parameter to 0, the AD domain has the highest priority. Valid values: 0 to 10000. This parameter is used to identify each AD domain. When you add an AD domain, the value of the PriorityId parameter of the new AD domain cannot be the same as the value of the PriorityId parameter for any existing AD domain. When you modify or delete an AD domain, you must also modify or delete the value of the PriorityId parameter for this AD domain.
- type String
The type of connection to the instance. Valid values:
- host: specifies to verify TCP/IP connections, including SSL connections and non-SSL connections.
- hostssl: specifies to verify only TCP/IP connections that are established over SSL connections.
- hostnossl: specifies to verify only TCP/IP connections that are established over non-SSL connections.
NOTE: You can set this parameter to hostssl only when SSL encryption is enabled for the instance. For more information, see Configure SSL encryption for an ApsaraDB RDS for PostgreSQL instance.
- user String
- The user that is allowed to access the instance. If you specify multiple users, separate the usernames with commas (,).
- mask String
- The mask of the instance. If the value of the
Address
parameter is an IP address, you can use this parameter to specify the mask of the IP address. - option String
- Optional. The value of this parameter is based on the value of the HbaItem.N.Method parameter. In this topic, LDAP is used as an example. You must configure this parameter. For more information, see Authentication Methods.
RdsCloneDbInstanceServerlessConfig, RdsCloneDbInstanceServerlessConfigArgs
- Max
Capacity double - The maximum number of RDS Capacity Units (RCUs). The value of this parameter must be greater than or equal to
min_capacity
and only supports passing integers. Valid values:- MySQL: 1~8
- SQLServer: 2~8
- PostgreSQL: 1~12
- Min
Capacity double - The minimum number of RCUs. The value of this parameter must be less than or equal to
max_capacity
. Valid values:- MySQL: 0.5~8
- SQLServer: 2~8 (Supports integers only).
- PostgreSQL: 0.5~12
- Auto
Pause bool - Specifies whether to enable the smart startup and stop feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. If there is no connection within 10 minutes, it will enter a paused state and automatically wake up when the connection enters.
- Switch
Force bool - Specifies whether to enable the forced scaling feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. After enabling this parameter, there will be a flash break within 1 minute when the instance is forced to expand or shrink. Please use it with caution according to the actual situation.
- The elastic scaling of an instance RCU usually takes effect immediately, but in some special circumstances (such as during large transaction execution), it is not possible to complete scaling immediately. In this case, this parameter can be enabled to force scaling.
- Max
Capacity float64 - The maximum number of RDS Capacity Units (RCUs). The value of this parameter must be greater than or equal to
min_capacity
and only supports passing integers. Valid values:- MySQL: 1~8
- SQLServer: 2~8
- PostgreSQL: 1~12
- Min
Capacity float64 - The minimum number of RCUs. The value of this parameter must be less than or equal to
max_capacity
. Valid values:- MySQL: 0.5~8
- SQLServer: 2~8 (Supports integers only).
- PostgreSQL: 0.5~12
- Auto
Pause bool - Specifies whether to enable the smart startup and stop feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. If there is no connection within 10 minutes, it will enter a paused state and automatically wake up when the connection enters.
- Switch
Force bool - Specifies whether to enable the forced scaling feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. After enabling this parameter, there will be a flash break within 1 minute when the instance is forced to expand or shrink. Please use it with caution according to the actual situation.
- The elastic scaling of an instance RCU usually takes effect immediately, but in some special circumstances (such as during large transaction execution), it is not possible to complete scaling immediately. In this case, this parameter can be enabled to force scaling.
- max
Capacity Double - The maximum number of RDS Capacity Units (RCUs). The value of this parameter must be greater than or equal to
min_capacity
and only supports passing integers. Valid values:- MySQL: 1~8
- SQLServer: 2~8
- PostgreSQL: 1~12
- min
Capacity Double - The minimum number of RCUs. The value of this parameter must be less than or equal to
max_capacity
. Valid values:- MySQL: 0.5~8
- SQLServer: 2~8 (Supports integers only).
- PostgreSQL: 0.5~12
- auto
Pause Boolean - Specifies whether to enable the smart startup and stop feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. If there is no connection within 10 minutes, it will enter a paused state and automatically wake up when the connection enters.
- switch
Force Boolean - Specifies whether to enable the forced scaling feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. After enabling this parameter, there will be a flash break within 1 minute when the instance is forced to expand or shrink. Please use it with caution according to the actual situation.
- The elastic scaling of an instance RCU usually takes effect immediately, but in some special circumstances (such as during large transaction execution), it is not possible to complete scaling immediately. In this case, this parameter can be enabled to force scaling.
- max
Capacity number - The maximum number of RDS Capacity Units (RCUs). The value of this parameter must be greater than or equal to
min_capacity
and only supports passing integers. Valid values:- MySQL: 1~8
- SQLServer: 2~8
- PostgreSQL: 1~12
- min
Capacity number - The minimum number of RCUs. The value of this parameter must be less than or equal to
max_capacity
. Valid values:- MySQL: 0.5~8
- SQLServer: 2~8 (Supports integers only).
- PostgreSQL: 0.5~12
- auto
Pause boolean - Specifies whether to enable the smart startup and stop feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. If there is no connection within 10 minutes, it will enter a paused state and automatically wake up when the connection enters.
- switch
Force boolean - Specifies whether to enable the forced scaling feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. After enabling this parameter, there will be a flash break within 1 minute when the instance is forced to expand or shrink. Please use it with caution according to the actual situation.
- The elastic scaling of an instance RCU usually takes effect immediately, but in some special circumstances (such as during large transaction execution), it is not possible to complete scaling immediately. In this case, this parameter can be enabled to force scaling.
- max_
capacity float - The maximum number of RDS Capacity Units (RCUs). The value of this parameter must be greater than or equal to
min_capacity
and only supports passing integers. Valid values:- MySQL: 1~8
- SQLServer: 2~8
- PostgreSQL: 1~12
- min_
capacity float - The minimum number of RCUs. The value of this parameter must be less than or equal to
max_capacity
. Valid values:- MySQL: 0.5~8
- SQLServer: 2~8 (Supports integers only).
- PostgreSQL: 0.5~12
- auto_
pause bool - Specifies whether to enable the smart startup and stop feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. If there is no connection within 10 minutes, it will enter a paused state and automatically wake up when the connection enters.
- switch_
force bool - Specifies whether to enable the forced scaling feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. After enabling this parameter, there will be a flash break within 1 minute when the instance is forced to expand or shrink. Please use it with caution according to the actual situation.
- The elastic scaling of an instance RCU usually takes effect immediately, but in some special circumstances (such as during large transaction execution), it is not possible to complete scaling immediately. In this case, this parameter can be enabled to force scaling.
- max
Capacity Number - The maximum number of RDS Capacity Units (RCUs). The value of this parameter must be greater than or equal to
min_capacity
and only supports passing integers. Valid values:- MySQL: 1~8
- SQLServer: 2~8
- PostgreSQL: 1~12
- min
Capacity Number - The minimum number of RCUs. The value of this parameter must be less than or equal to
max_capacity
. Valid values:- MySQL: 0.5~8
- SQLServer: 2~8 (Supports integers only).
- PostgreSQL: 0.5~12
- auto
Pause Boolean - Specifies whether to enable the smart startup and stop feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. If there is no connection within 10 minutes, it will enter a paused state and automatically wake up when the connection enters.
- switch
Force Boolean - Specifies whether to enable the forced scaling feature for the serverless instance. Valid values:
- true: enables the feature.
- false: disables the feature. This is the default value.
- Only MySQL Serverless instances need to set this parameter. After enabling this parameter, there will be a flash break within 1 minute when the instance is forced to expand or shrink. Please use it with caution according to the actual situation.
- The elastic scaling of an instance RCU usually takes effect immediately, but in some special circumstances (such as during large transaction execution), it is not possible to complete scaling immediately. In this case, this parameter can be enabled to force scaling.
Import
RDS Clone DB Instance can be imported using the id, e.g.
$ pulumi import alicloud:rds/rdsCloneDbInstance:RdsCloneDbInstance example <id>
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Alibaba Cloud pulumi/pulumi-alicloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
alicloud
Terraform Provider.