DBInstanceProps
Properties for defining a DBInstance.
See https://www.alibabacloud.com/help/ros/developer-reference/aliyun-gpdb-dbinstance
Initializer
import ros_cdk_gpdb
ros_cdk_gpdb.DBInstanceProps(
engine_version: typing.Union[str, IResolvable],
v_switch_id: typing.Union[str, IResolvable],
zone_id: typing.Union[str, IResolvable],
ai_node_spec_infos: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, AINodeSpecInfosProperty]]] = None,
backup_id: typing.Union[str, IResolvable] = None,
cache_storage_size: typing.Union[str, IResolvable] = None,
create_sample_data: typing.Union[bool, IResolvable] = None,
db_instance_category: typing.Union[str, IResolvable] = None,
db_instance_class: typing.Union[str, IResolvable] = None,
db_instance_description: typing.Union[str, IResolvable] = None,
db_instance_group_count: typing.Union[typing.Union[int, float], IResolvable] = None,
db_instance_mode: typing.Union[str, IResolvable] = None,
deploy_mode: typing.Union[str, IResolvable] = None,
enable_ssl: typing.Union[bool, IResolvable] = None,
encryption_key: typing.Union[str, IResolvable] = None,
encryption_type: typing.Union[str, IResolvable] = None,
idle_time: typing.Union[typing.Union[int, float], IResolvable] = None,
instance_spec: typing.Union[str, IResolvable] = None,
master_ai_spec: typing.Union[str, IResolvable] = None,
master_cu: typing.Union[typing.Union[int, float], IResolvable] = None,
master_node_num: typing.Union[typing.Union[int, float], IResolvable] = None,
pay_type: typing.Union[str, IResolvable] = None,
period: typing.Union[typing.Union[int, float], IResolvable] = None,
period_unit: typing.Union[str, IResolvable] = None,
private_ip_address: typing.Union[str, IResolvable] = None,
prod_type: typing.Union[str, IResolvable] = None,
resource_group_id: typing.Union[str, IResolvable] = None,
security_ip_list: typing.Union[str, IResolvable] = None,
seg_disk_performance_level: typing.Union[str, IResolvable] = None,
seg_node_num: typing.Union[typing.Union[int, float], IResolvable] = None,
seg_storage_type: typing.Union[str, IResolvable] = None,
serverless_mode: typing.Union[str, IResolvable] = None,
serverless_resource: typing.Union[typing.Union[int, float], IResolvable] = None,
src_db_instance_name: typing.Union[str, IResolvable] = None,
standby_v_switch_id: typing.Union[str, IResolvable] = None,
standby_zone_id: typing.Union[str, IResolvable] = None,
storage_size: typing.Union[typing.Union[int, float], IResolvable] = None,
tags: typing.List[TagsProperty] = None,
vector_configuration_status: typing.Union[str, IResolvable] = None,
vpc_id: typing.Union[str, IResolvable] = None
)
Properties
| Name | Type | Description |
|---|---|---|
engine_version | typing.Union[str, ros_cdk_core.IResolvable] | Property engineVersion: The version of the database engine. |
v_switch_id | typing.Union[str, ros_cdk_core.IResolvable] | Property vSwitchId: The vSwitch ID. |
zone_id | typing.Union[str, ros_cdk_core.IResolvable] | Property zoneId: The zone ID of the instance, such as cn-hangzhou-d. |
ai_node_spec_infos | typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, AINodeSpecInfosProperty]]] | Property aiNodeSpecInfos: AI node spec infos. |
backup_id | typing.Union[str, ros_cdk_core.IResolvable] | Property backupId: Backup set ID. |
cache_storage_size | typing.Union[str, ros_cdk_core.IResolvable] | Property cacheStorageSize: The cache size for a serverless instance, in GB. |
create_sample_data | typing.Union[bool, ros_cdk_core.IResolvable] | Property createSampleData: Whether to load the sample data set after the instance is created. |
db_instance_category | typing.Union[str, ros_cdk_core.IResolvable] | Property dbInstanceCategory: The instance edition. |
db_instance_class | typing.Union[str, ros_cdk_core.IResolvable] | Property dbInstanceClass: The instance type. |
db_instance_description | typing.Union[str, ros_cdk_core.IResolvable] | Property dbInstanceDescription: The description of the instance. |
db_instance_group_count | typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] | Property dbInstanceGroupCount: The number of compute groups. |
db_instance_mode | typing.Union[str, ros_cdk_core.IResolvable] | Property dbInstanceMode: The db instance mode. |
deploy_mode | typing.Union[str, ros_cdk_core.IResolvable] | Property deployMode: The deployment mode. |
enable_ssl | typing.Union[bool, ros_cdk_core.IResolvable] | Property enableSsl: Whether to enable SSL encryption. |
encryption_key | typing.Union[str, ros_cdk_core.IResolvable] | Property encryptionKey: If the EncryptionType parameter is set to CloudDisk, you must specify this parameter to the encryption key that is in the same region with the disks that is specified by the EncryptionType parameter. |
encryption_type | typing.Union[str, ros_cdk_core.IResolvable] | Property encryptionType: The type of the encryption. |
idle_time | typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] | Property idleTime: The period of inactivity, in seconds, after which the instance is considered idle. |
instance_spec | typing.Union[str, ros_cdk_core.IResolvable] | Property instanceSpec: The instance type for the compute nodes. |
master_ai_spec | typing.Union[str, ros_cdk_core.IResolvable] | Property masterAiSpec: If you need to change the Master node to MasterAI node, specify this parameter. |
master_cu | typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] | Property masterCu: The resources for the coordinator node. |
master_node_num | typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] | Property masterNodeNum: The number of master nodes. |
pay_type | typing.Union[str, ros_cdk_core.IResolvable] | Property payType: The billing method of the instance. |
period | typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] | Property period: The subscription period. |
period_unit | typing.Union[str, ros_cdk_core.IResolvable] | Property periodUnit: Unit of subscription period, it could be Month\/Year. |
private_ip_address | typing.Union[str, ros_cdk_core.IResolvable] | Property privateIpAddress: This parameter is deprecated. |
prod_type | typing.Union[str, ros_cdk_core.IResolvable] | Property prodType: Prod type. |
resource_group_id | typing.Union[str, ros_cdk_core.IResolvable] | Property resourceGroupId: The ID of the resource group. |
security_ip_list | typing.Union[str, ros_cdk_core.IResolvable] | Property securityIpList: The IP address whitelist for the instance. |
seg_disk_performance_level | typing.Union[str, ros_cdk_core.IResolvable] | Property segDiskPerformanceLevel: The performance level of the ESSDs. |
seg_node_num | typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] | Property segNodeNum: Calculate the number of nodes. |
seg_storage_type | typing.Union[str, ros_cdk_core.IResolvable] | Property segStorageType: The disk type of segment nodes. |
serverless_mode | typing.Union[str, ros_cdk_core.IResolvable] | Property serverlessMode: Mode of the Serverless instance. |
serverless_resource | typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] | Property serverlessResource: The threshold for computing resources, in AnalyticDB Compute Units (ACUs). |
src_db_instance_name | typing.Union[str, ros_cdk_core.IResolvable] | Property srcDbInstanceName: Clone source instance ID. |
standby_v_switch_id | typing.Union[str, ros_cdk_core.IResolvable] | Property standbyVSwitchId: The ID of the vSwitch in the standby zone. |
standby_zone_id | typing.Union[str, ros_cdk_core.IResolvable] | Property standbyZoneId: The ID of the standby zone. |
storage_size | typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] | Property storageSize: The storage capacity for the instance, in GB. |
tags | typing.List[TagsProperty] | Property tags: The list of instance tags in the form of key\/value pairs. |
vector_configuration_status | typing.Union[str, ros_cdk_core.IResolvable] | Property vectorConfigurationStatus: the status of vector configuration. |
vpc_id | typing.Union[str, ros_cdk_core.IResolvable] | Property vpcId: The VPC ID of the instance. |
engine_versionRequired
engine_version: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property engineVersion: The version of the database engine.
For example: 6.0、7.0
v_switch_idRequired
v_switch_id: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property vSwitchId: The vSwitch ID.
- This parameter is required.
- The vSwitch must be in the zone specified by
ZoneId.
zone_idRequired
zone_id: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property zoneId: The zone ID of the instance, such as cn-hangzhou-d.
You can call the DescribeRegions operation to query the most recent zone list.
ai_node_spec_infosOptional
ai_node_spec_infos: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, AINodeSpecInfosProperty]]]
- Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, AINodeSpecInfosProperty]]]
Property aiNodeSpecInfos: AI node spec infos.
backup_idOptional
backup_id: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property backupId: Backup set ID.
You can call DescribeDataBackups to view the backup set IDs of all backup sets under the target instance.
cache_storage_sizeOptional
cache_storage_size: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property cacheStorageSize: The cache size for a serverless instance, in GB.
create_sample_dataOptional
create_sample_data: typing.Union[bool, IResolvable]
- Type: typing.Union[bool, ros_cdk_core.IResolvable]
Property createSampleData: Whether to load the sample data set after the instance is created.
The value can be: true: load the sample dataset. false: not to load the sample dataset
db_instance_categoryOptional
db_instance_category: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property dbInstanceCategory: The instance edition.
Valid values:
- HighAvailability: High-availability Edition
- Basic: Basic Edition
This parameter is required for instances in elastic storage mode.
db_instance_classOptional
db_instance_class: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property dbInstanceClass: The instance type.
For more information, see the description of the DBInstanceClass parameter.
This parameter is required for instances in reserved storage mode.
db_instance_descriptionOptional
db_instance_description: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property dbInstanceDescription: The description of the instance.
The description cannot exceed 256 characters in length.
db_instance_group_countOptional
db_instance_group_count: typing.Union[typing.Union[int, float], IResolvable]
- Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]
Property dbInstanceGroupCount: The number of compute groups.
Valid values: 2, 4, 8, 12, 16, 24, 32, 64, 96, and 128.
This parameter is required for instances in reserved storage mode.
db_instance_modeOptional
db_instance_mode: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property dbInstanceMode: The db instance mode.
Valid values: StorageElastic, Serverless, Classic.
deploy_modeOptional
deploy_mode: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property deployMode: The deployment mode.
Valid values:
- multiple: multi-AZ deployment.
- single: single-AZ deployment.
- If this parameter is not specified, the default value is single.
- Defaults to
single(single-AZ deployment), which is the only mode currently supported.
enable_sslOptional
enable_ssl: typing.Union[bool, IResolvable]
- Type: typing.Union[bool, ros_cdk_core.IResolvable]
Property enableSsl: Whether to enable SSL encryption.
Valid values: true: Enable SSL encryption. false (default): Do not enable SSL encryption.
encryption_keyOptional
encryption_key: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property encryptionKey: If the EncryptionType parameter is set to CloudDisk, you must specify this parameter to the encryption key that is in the same region with the disks that is specified by the EncryptionType parameter.
Otherwise, leave this parameter empty.
encryption_typeOptional
encryption_type: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property encryptionType: The type of the encryption.
Default value: NULL. Valid values: NULL: Encryption is disabled. CloudDisk: Encryption is enabled on disks and the encryption key is specified by using the EncryptionKey parameter. Note: Disk encryption cannot be disabled after it is enabled.
idle_timeOptional
idle_time: typing.Union[typing.Union[int, float], IResolvable]
- Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]
Property idleTime: The period of inactivity, in seconds, after which the instance is considered idle.
Minimum value: 60. Default value: 600.
This parameter is required only for serverless instances that use auto-scheduling.
instance_specOptional
instance_spec: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property instanceSpec: The instance type for the compute nodes.
Valid values for a High-availability Edition instance in elastic storage mode:
- 2C16G
- 4C32G
- 16C128G Valid values for a Basic Edition instance in elastic storage mode:
- 2C8G
- 4C16G
- 8C32G
- 16C64G Valid values for a serverless instance:
- 4C16G
- 8C32G
This parameter is required for instances in elastic storage mode or serverless mode.
master_ai_specOptional
master_ai_spec: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property masterAiSpec: If you need to change the Master node to MasterAI node, specify this parameter.
This parameter cannot be specified at the same time as MasterCU. Only some regions and availability zones support changing the Master node to MasterAI node. Only Basic edition instances of AnalyticDB PostgreSQL 7.0 support MasterAI nodes. You can query all possible values of this parameter on the Master node reconfiguration sales page.
master_cuOptional
master_cu: typing.Union[typing.Union[int, float], IResolvable]
- Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]
Property masterCu: The resources for the coordinator node.
Valid values:
- 2 CU
- 4 CU
- 8 CU
- 16 CU
- 32 CU
You are charged for coordinator node resources of 8 CUs or more.
master_node_numOptional
master_node_num: typing.Union[typing.Union[int, float], IResolvable]
- Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]
Property masterNodeNum: The number of master nodes.
Minimum is 1, max is 2.
pay_typeOptional
pay_type: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property payType: The billing method of the instance.
Default value: Postpaid. Valid values: Postpaid: pay-as-you-go Prepaid: subscription
periodOptional
period: typing.Union[typing.Union[int, float], IResolvable]
- Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]
Property period: The subscription period.
While choose by pay by month, it could be from 1 to 11. While choose pay by year, it could be from 1 to 3.
period_unitOptional
period_unit: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property periodUnit: Unit of subscription period, it could be Month\/Year.
Default value is Month.
private_ip_addressOptional
private_ip_address: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property privateIpAddress: This parameter is deprecated.
prod_typeOptional
prod_type: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property prodType: Prod type.
The value can be: standard, cost-effective. The default value is standard.
resource_group_idOptional
resource_group_id: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property resourceGroupId: The ID of the resource group.
security_ip_listOptional
security_ip_list: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property securityIpList: The IP address whitelist for the instance.
A value of 127.0.0.1 blocks all external access. After you create the instance, you can call the ModifySecurityIps operation to modify the IP address whitelist.
seg_disk_performance_levelOptional
seg_disk_performance_level: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property segDiskPerformanceLevel: The performance level of the ESSDs.
Valid values:
- pl0: PL0
- pl1: PL1
- pl2: PL2
- This parameter applies only if the segment node storage type is ESSD.
- If this parameter is not specified, pl1 is used by default.
seg_node_numOptional
seg_node_num: typing.Union[typing.Union[int, float], IResolvable]
- Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]
Property segNodeNum: Calculate the number of nodes.
The value can be:
- When DBInstanceMode is StorageElastic and DBInstanceCategory is HighAvailability, the value ranges from 4 to 512. The value must be a multiple of 4.
- When DBInstanceMode is StorageElastic and DBInstanceCategory is Basic, the value ranges from 2 to 512. The value must be a multiple of 2.
- When DBInstanceMode is Serverless, The value ranges from 2 to 512. The value must be a multiple of 2.
seg_storage_typeOptional
seg_storage_type: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property segStorageType: The disk type of segment nodes.
For example: cloud_essd, cloud_efficiency. This parameter must be passed in to create a storage elastic mode instance. Storage Elastic Mode Basic Edition instances only support ESSD cloud disks.
serverless_modeOptional
serverless_mode: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property serverlessMode: Mode of the Serverless instance.
The value can be: Manual: manual scheduling is the default value. Auto: indicates automatic scheduling.
serverless_resourceOptional
serverless_resource: typing.Union[typing.Union[int, float], IResolvable]
- Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]
Property serverlessResource: The threshold for computing resources, in AnalyticDB Compute Units (ACUs).
The value must be a multiple of 8, ranging from 8 to 32. The default value is 32.
This parameter is required only for serverless instances that use auto-scheduling.
src_db_instance_nameOptional
src_db_instance_name: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property srcDbInstanceName: Clone source instance ID.
You can call the DescribeDBInstances interface to view the details of all AnalyticDB PostgreSQL instances in the target region, including the instance ID.
standby_v_switch_idOptional
standby_v_switch_id: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property standbyVSwitchId: The ID of the vSwitch in the standby zone.
- This parameter is required only for a multi-AZ deployment.
- The vSwitch must be in the standby zone specified in
StandbyZoneId.
standby_zone_idOptional
standby_zone_id: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property standbyZoneId: The ID of the standby zone.
- This parameter is required only for a multi-AZ deployment.
- You can call the DescribeRegions operation to query the IDs of available zones.
- The standby zone must be different from the primary zone.
storage_sizeOptional
storage_size: typing.Union[typing.Union[int, float], IResolvable]
- Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]
Property storageSize: The storage capacity for the instance, in GB.
Valid values: .
This parameter is required for instances in elastic storage mode.
tagsOptional
tags: typing.List[TagsProperty]
- Type: typing.List[TagsProperty]
Property tags: The list of instance tags in the form of key\/value pairs.
You can define a maximum of 20 tags for instance.
vector_configuration_statusOptional
vector_configuration_status: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property vectorConfigurationStatus: the status of vector configuration.
The value can be:Y: Turn on vector engine optimization.N: Turn off vector engine optimization (default value).
vpc_idOptional
vpc_id: typing.Union[str, IResolvable]
- Type: typing.Union[str, ros_cdk_core.IResolvable]
Property vpcId: The VPC ID of the instance.
If you set the InstanceNetworkType parameter to VPC, you must also specify the VPCId parameter. The specified region of the VPC must be the same as the RegionId value.