Cluster

class Cluster : KotlinCustomResource

Import

PolarDB cluster can be imported using the id, e.g.

$ pulumi import alicloud:polardb/cluster:Cluster example pc-abc12345678

Properties

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

Specifies whether to enable the no-activity suspension feature. Default value: false. Valid values are true, false. This parameter is valid only for serverless clusters.

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

Auto-renewal period of an cluster, in the unit of the month. It is valid when pay_type is PrePaid. Valid value:1, 2, 3, 6, 12, 24, 36, Default to 1.

Link copied to clipboard

The retention policy for the backup sets when you delete the cluster. Valid values are ALL, LATEST, NONE. Value options can refer to the latest docs DeleteDBCluster

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

The time point of data to be cloned. Valid values are LATEST,BackupID,Timestamp.Value options can refer to the latest docs CreateDBCluster CloneDataPoint.

Link copied to clipboard
val collectorStatus: Output<String>

Specifies whether to enable or disable SQL data collector. Valid values are Enable, Disabled.

Link copied to clipboard
val compressStorage: Output<String>

Enable storage compression function. The value of this parameter is ON. Only MySQL supports.

Link copied to clipboard

(Available since 1.81.0) PolarDB cluster connection string.

Link copied to clipboard
val createTime: Output<String>

(Available since 1.204.1) PolarDB cluster creation time.

Link copied to clipboard

The edition of the PolarDB service. Valid values are Normal,Basic,ArchiveNormal,NormalMultimaster,SENormal.Value options can refer to the latest docs CreateDBCluster CreationCategory.

Link copied to clipboard
val creationOption: Output<String>

The method that is used to create a cluster. Valid values are Normal,CloneFromPolarDB,CloneFromRDS,MigrationFromRDS,CreateGdnStandby,RecoverFromRecyclebin. NOTE: From version 1.233.0, creation_option can be set to RecoverFromRecyclebin. Value options can refer to the latest docs CreateDBCluster CreationOption.

Link copied to clipboard

db_cluster_ip_array defines how users can send requests to your API. See db_cluster_ip_array below.

Link copied to clipboard
val dbMinorVersion: Output<String>

Database minor version. Value options can refer to the latest docs CreateDBCluster DBMinorVersion. This parameter takes effect only when db_type is MySQL and db_version is 8.0.

Link copied to clipboard
val dbNodeClass: Output<String>

The db_node_class of cluster node.

Link copied to clipboard
val dbNodeCount: Output<Int>

Number of the PolarDB cluster nodes, default is 2(Each cluster must contain at least a primary node and a read-only node). Add/remove nodes by modifying this parameter, valid values: 2~16.

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

The ID of the node or node subscript. Node subscript values: 1 to 15.

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

The number of Standard Edition nodes. Default value: 1. Valid values are 1, 2. From version 1.235.0, Valid values for PolarDB for MySQL Standard Edition: 1 to 8. Valid values for PolarDB for MySQL Enterprise Edition: 1 to 16.

Link copied to clipboard

(Available since v1.216.0) The db_revision_version_list supports the following:

Link copied to clipboard
val dbType: Output<String>

Database type. Value options: MySQL, Oracle, PostgreSQL.

Link copied to clipboard
val dbVersion: Output<String>

Database version. Value options can refer to the latest docs CreateDBCluster DBVersion.

Link copied to clipboard
val defaultTimeZone: Output<String>

The time zone of the cluster. You can set the parameter to a value that is on the hour from -12:00 to +13:00 based on UTC. Example: 00:00. Default value: SYSTEM. This value indicates that the time zone of the cluster is the same as the time zone of the region.

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

turn on table deletion_lock. Valid values are 0, 1. 1 means to open the cluster protection lock, 0 means to close the cluster protection lock

Link copied to clipboard
val description: Output<String>

The description of cluster.

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

The ID of the custom key. encryption_key cannot be modified after TDE is opened.

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

turn on table auto encryption. Valid values are ON, OFF. Only MySQL 8.0 supports.

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

Immediate or scheduled kernel version upgrade. Valid values are true, false. True means immediate execution, False means scheduled execution.

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

The ID of the global database network (GDN).

Link copied to clipboard
val hotReplicaMode: Output<String>

Indicates whether the hot standby feature is enabled. Valid values are ON, OFF. Only MySQL supports.

Link copied to clipboard

Whether to enable the hot standby cluster. Valid values are ON, OFF, EQUAL.

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

Specifies whether to enable the In-Memory Column Index (IMCI) feature. Valid values are ON, OFF.

Link copied to clipboard

Enable the Binlog function. Default value: OFF. Valid values are OFF, ON.

Link copied to clipboard
val looseXengine: Output<String>

Specifies whether to enable X-Engine. Valid values are ON, OFF.

Link copied to clipboard

Set the ratio to enable the X-Engine storage engine. Valid values: 10 to 90.

Link copied to clipboard

Specifies whether the table names are case-sensitive. Default value: 1. Valid values are 1, 0.

Link copied to clipboard
val maintainTime: Output<String>

Maintainable time period format of the instance: HH:MMZ-HH:MMZ (UTC time)

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

Use as db_node_class change class, define upgrade or downgrade. Valid values are Upgrade, Downgrade, Default to Upgrade.

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

The ID of the parameter template

Link copied to clipboard

Set of parameters needs to be set after DB cluster was launched. Available parameters can refer to the latest docs View database parameter templates .See parameters below.

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

Valid values are PrePaid, PostPaid, Default to PostPaid.

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

The duration that you will buy DB cluster (in month). It is valid when pay_type is PrePaid. Valid values: 1~9, 12, 24, 36.

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

The latest time to start executing the target scheduled task. The format is YYYY-MM-DDThh: mm: ssZ (UTC).

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

The earliest time to start executing a scheduled (i.e. within the target time period) kernel version upgrade task. The format is YYYY-MM-DDThh: mm: ssZ (UTC).

Link copied to clipboard
val port: Output<String>

(Available since 1.196.0) PolarDB cluster connection port.

Link copied to clipboard
val provisionedIops: Output<String>

The provisioned read/write IOPS of the ESSD AutoPL disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.

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

The specifications of the Standard Edition PolarProxy. Available parameters can refer to the latest docs CreateDBCluster

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

The type of PolarProxy. Valid values are EXCLUSIVE GENERAL.

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

Valid values are AutoRenewal, Normal, NotRenewal, Default to NotRenewal.

Link copied to clipboard
val resourceGroupId: Output<String>

The ID of resource group which the PolarDB cluster belongs. If not specified, then it belongs to the default resource group.

Link copied to clipboard
val roleArn: Output<String>

The Alibaba Cloud Resource Name (ARN) of the RAM role. A RAM role is a virtual identity that you can create within your Alibaba Cloud account. For more information see RAM role overview.

Link copied to clipboard
val scaleApRoNumMax: Output<Int>

Number of Read-only Columnar Nodes. Valid values: 0 to 7. This parameter is valid only for serverless clusters. This parameter is required when there are column nodes that support steady-state serverless.

Link copied to clipboard
val scaleApRoNumMin: Output<Int>

Number of Read-only Columnar Nodes. Valid values: 0 to 7. This parameter is valid only for serverless clusters. This parameter is required when there are column nodes that support steady-state serverless.

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

The maximum number of PCUs per node for scaling. Valid values: 1 PCU to 32 PCUs when serverless_type is AgileServerless and 0 PCU to 8 PCUs when serverless_type is SteadyServerless. This parameter is valid only for serverless clusters.

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

The minimum number of PCUs per node for scaling. Valid values: 1 PCU to 31 PCUs when serverless_type is AgileServerless and 0 PCU to 8 PCUs when serverless_type is SteadyServerless. This parameter is valid only for serverless clusters.

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

The maximum number of read-only nodes for scaling. Valid values: 0 to 15 when serverless_type is AgileServerless and 0 to 7 when serverless_type is SteadyServerless. This parameter is valid only for serverless clusters.

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

The minimum number of read-only nodes for scaling. Valid values: 0 to 15 when serverless_type is AgileServerless and 0 to 7 when serverless_type is SteadyServerless. This parameter is valid only for serverless clusters.

Link copied to clipboard

The detection period for No-activity Suspension. Valid values: 300 to 86,4005. Unit: seconds. The detection duration must be a multiple of 300 seconds. This parameter is valid only for serverless clusters.

Link copied to clipboard

The ID of the security group. Separate multiple security groups with commas (,). You can add a maximum of three security groups to a cluster.

Link copied to clipboard
val securityIps: Output<List<String>>

This attribute has been deprecated from v1.130.0 and using db_cluster_ip_array sub-element security_ips instead. Its value is same as db_cluster_ip_array sub-element security_ips value and its db_cluster_ip_array_name is "default".

Link copied to clipboard

CPU upscale threshold. Valid values: 40 to 100. This parameter is valid only for serverless clusters.

Link copied to clipboard

CPU downscale threshold. Valid values: 10 to 100. This parameter is valid only for serverless clusters.

Link copied to clipboard

Elasticity sensitivity. Valid values: normal for standard and flexible for sensitive. This parameter is valid only for serverless clusters.

Link copied to clipboard

Serverless steady-state switch. Valid values are ON, OFF. This parameter is valid only for serverless clusters.

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

The type of the serverless cluster. Valid values AgileServerless, SteadyServerless. This parameter is valid only for serverless clusters.

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

The ID of the source RDS instance or the ID of the source PolarDB cluster. This parameter is required only when CreationOption is set to MigrationFromRDS, CloneFromRDS, or CloneFromPolarDB.Value options can refer to the latest docs CreateDBCluster SourceResourceId.

Link copied to clipboard
val standbyAz: Output<String>

The availability zone where the hot standby cluster is stored, takes effect when hot_standby_cluster is ON or EQUAL.

Link copied to clipboard
val status: Output<String>

(Available since 1.204.1) PolarDB cluster status.

Link copied to clipboard
val storagePayType: Output<String>

The billing method of the storage. Valid values Postpaid, Prepaid.

Link copied to clipboard
val storageSpace: Output<Int>

Storage space charged by space (monthly package). Unit: GB.

Link copied to clipboard
val storageType: Output<String>

The storage type of the cluster. Enterprise storage type values are PSL5, PSL4. The standard version storage type values are ESSDPL1, ESSDPL2, ESSDPL3, ESSDPL0, ESSDAUTOPL. The standard version only supports MySQL and PostgreSQL.

Link copied to clipboard

Whether the cluster has enabled strong data consistency across multiple zones. Valid values are ON, OFF. Available parameters can refer to the latest docs CreateDBCluster

Link copied to clipboard
val subCategory: Output<String>

The category of the cluster. Valid values are Exclusive, General. Only MySQL supports.

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

A mapping of tags to assign to the resource.

Link copied to clipboard

The Version Code of the target version, whose parameter values can be obtained from the DescribeDBClusterVersion interface.

Link copied to clipboard
val tdeRegion: Output<String>

(Available since 1.200.0) The region where the TDE key resides.

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

turn on TDE encryption. Valid values are Enabled, Disabled. Default to Disabled. TDE cannot be closed after it is turned on.

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

Version upgrade type. Valid values are PROXY, DB, ALL. PROXY means upgrading the proxy version, DB means upgrading the db version, ALL means upgrading both db and proxy versions simultaneously.

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

The id of the VPC.

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

The virtual switch ID to launch DB instances in one VPC.

Link copied to clipboard
val zoneId: Output<String>

The Zone to launch the DB cluster. it supports multiple zone.