Skip to content

DBInstanceProps

Properties for defining a DBInstance.

See https://www.alibabacloud.com/help/ros/developer-reference/aliyun-gpdb-dbinstance

Initializer

import com.aliyun.ros.cdk.gpdb.DBInstanceProps;
DBInstanceProps.builder()
    .engineVersion(java.lang.String)
    .engineVersion(IResolvable)
    .vSwitchId(java.lang.String)
    .vSwitchId(IResolvable)
    .zoneId(java.lang.String)
    .zoneId(IResolvable)
//  .aiNodeSpecInfos(IResolvable)
//  .aiNodeSpecInfos(java.util.List<IResolvable)
//  .aiNodeSpecInfos(AINodeSpecInfosProperty>)
//  .backupId(java.lang.String)
//  .backupId(IResolvable)
//  .cacheStorageSize(java.lang.String)
//  .cacheStorageSize(IResolvable)
//  .createSampleData(java.lang.Boolean)
//  .createSampleData(IResolvable)
//  .dbInstanceCategory(java.lang.String)
//  .dbInstanceCategory(IResolvable)
//  .dbInstanceClass(java.lang.String)
//  .dbInstanceClass(IResolvable)
//  .dbInstanceDescription(java.lang.String)
//  .dbInstanceDescription(IResolvable)
//  .dbInstanceGroupCount(java.lang.Number)
//  .dbInstanceGroupCount(IResolvable)
//  .dbInstanceMode(java.lang.String)
//  .dbInstanceMode(IResolvable)
//  .deployMode(java.lang.String)
//  .deployMode(IResolvable)
//  .enableSsl(java.lang.Boolean)
//  .enableSsl(IResolvable)
//  .encryptionKey(java.lang.String)
//  .encryptionKey(IResolvable)
//  .encryptionType(java.lang.String)
//  .encryptionType(IResolvable)
//  .idleTime(java.lang.Number)
//  .idleTime(IResolvable)
//  .instanceSpec(java.lang.String)
//  .instanceSpec(IResolvable)
//  .masterAiSpec(java.lang.String)
//  .masterAiSpec(IResolvable)
//  .masterCu(java.lang.Number)
//  .masterCu(IResolvable)
//  .masterNodeNum(java.lang.Number)
//  .masterNodeNum(IResolvable)
//  .payType(java.lang.String)
//  .payType(IResolvable)
//  .period(java.lang.Number)
//  .period(IResolvable)
//  .periodUnit(java.lang.String)
//  .periodUnit(IResolvable)
//  .privateIpAddress(java.lang.String)
//  .privateIpAddress(IResolvable)
//  .prodType(java.lang.String)
//  .prodType(IResolvable)
//  .resourceGroupId(java.lang.String)
//  .resourceGroupId(IResolvable)
//  .securityIpList(java.lang.String)
//  .securityIpList(IResolvable)
//  .segDiskPerformanceLevel(java.lang.String)
//  .segDiskPerformanceLevel(IResolvable)
//  .segNodeNum(java.lang.Number)
//  .segNodeNum(IResolvable)
//  .segStorageType(java.lang.String)
//  .segStorageType(IResolvable)
//  .serverlessMode(java.lang.String)
//  .serverlessMode(IResolvable)
//  .serverlessResource(java.lang.Number)
//  .serverlessResource(IResolvable)
//  .srcDbInstanceName(java.lang.String)
//  .srcDbInstanceName(IResolvable)
//  .standbyVSwitchId(java.lang.String)
//  .standbyVSwitchId(IResolvable)
//  .standbyZoneId(java.lang.String)
//  .standbyZoneId(IResolvable)
//  .storageSize(java.lang.Number)
//  .storageSize(IResolvable)
//  .tags(java.util.List<TagsProperty>)
//  .vectorConfigurationStatus(java.lang.String)
//  .vectorConfigurationStatus(IResolvable)
//  .vpcId(java.lang.String)
//  .vpcId(IResolvable)
    .build();

Properties

Name Type Description
engineVersion java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property engineVersion: The version of the database engine.
vSwitchId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property vSwitchId: The vSwitch ID.
zoneId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property zoneId: The zone ID of the instance, such as cn-hangzhou-d.
aiNodeSpecInfos com.aliyun.ros.cdk.core.IResolvable OR java.util.ListAINodeSpecInfosProperty> Property aiNodeSpecInfos: AI node spec infos.
backupId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property backupId: Backup set ID.
cacheStorageSize java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property cacheStorageSize: The cache size for a serverless instance, in GB.
createSampleData java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable Property createSampleData: Whether to load the sample data set after the instance is created.
dbInstanceCategory java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property dbInstanceCategory: The instance edition.
dbInstanceClass java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property dbInstanceClass: The instance type.
dbInstanceDescription java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property dbInstanceDescription: The description of the instance.
dbInstanceGroupCount java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property dbInstanceGroupCount: The number of compute groups.
dbInstanceMode java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property dbInstanceMode: The db instance mode.
deployMode java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property deployMode: The deployment mode.
enableSsl java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable Property enableSsl: Whether to enable SSL encryption.
encryptionKey java.lang.String OR com.aliyun.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.
encryptionType java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property encryptionType: The type of the encryption.
idleTime java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property idleTime: The period of inactivity, in seconds, after which the instance is considered idle.
instanceSpec java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property instanceSpec: The instance type for the compute nodes.
masterAiSpec java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property masterAiSpec: If you need to change the Master node to MasterAI node, specify this parameter.
masterCu java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property masterCu: The resources for the coordinator node.
masterNodeNum java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property masterNodeNum: The number of master nodes.
payType java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property payType: The billing method of the instance.
period java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property period: The subscription period.
periodUnit java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property periodUnit: Unit of subscription period, it could be Month\/Year.
privateIpAddress java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property privateIpAddress: This parameter is deprecated.
prodType java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property prodType: Prod type.
resourceGroupId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property resourceGroupId: The ID of the resource group.
securityIpList java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property securityIpList: The IP address whitelist for the instance.
segDiskPerformanceLevel java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property segDiskPerformanceLevel: The performance level of the ESSDs.
segNodeNum java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property segNodeNum: Calculate the number of nodes.
segStorageType java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property segStorageType: The disk type of segment nodes.
serverlessMode java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property serverlessMode: Mode of the Serverless instance.
serverlessResource java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property serverlessResource: The threshold for computing resources, in AnalyticDB Compute Units (ACUs).
srcDbInstanceName java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property srcDbInstanceName: Clone source instance ID.
standbyVSwitchId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property standbyVSwitchId: The ID of the vSwitch in the standby zone.
standbyZoneId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property standbyZoneId: The ID of the standby zone.
storageSize java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable Property storageSize: The storage capacity for the instance, in GB.
tags java.util.List<TagsProperty> Property tags: The list of instance tags in the form of key\/value pairs.
vectorConfigurationStatus java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property vectorConfigurationStatus: the status of vector configuration.
vpcId java.lang.String OR com.aliyun.ros.cdk.core.IResolvable Property vpcId: The VPC ID of the instance.

engineVersionRequired

public java.lang.Object getEngineVersion();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property engineVersion: The version of the database engine.

For example: 6.0、7.0


vSwitchIdRequired

public java.lang.Object getVSwitchId();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property vSwitchId: The vSwitch ID.

  • This parameter is required.
  • The vSwitch must be in the zone specified by ZoneId.

zoneIdRequired

public java.lang.Object getZoneId();
  • Type: java.lang.String OR com.aliyun.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.


aiNodeSpecInfosOptional

public java.lang.Object getAiNodeSpecInfos();
  • Type: com.aliyun.ros.cdk.core.IResolvable OR java.util.ListAINodeSpecInfosProperty>

Property aiNodeSpecInfos: AI node spec infos.


backupIdOptional

public java.lang.Object getBackupId();
  • Type: java.lang.String OR com.aliyun.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.


cacheStorageSizeOptional

public java.lang.Object getCacheStorageSize();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property cacheStorageSize: The cache size for a serverless instance, in GB.


createSampleDataOptional

public java.lang.Object getCreateSampleData();
  • Type: java.lang.Boolean OR com.aliyun.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


dbInstanceCategoryOptional

public java.lang.Object getDbInstanceCategory();
  • Type: java.lang.String OR com.aliyun.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.


dbInstanceClassOptional

public java.lang.Object getDbInstanceClass();
  • Type: java.lang.String OR com.aliyun.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.


dbInstanceDescriptionOptional

public java.lang.Object getDbInstanceDescription();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property dbInstanceDescription: The description of the instance.

The description cannot exceed 256 characters in length.


dbInstanceGroupCountOptional

public java.lang.Object getDbInstanceGroupCount();
  • Type: java.lang.Number OR com.aliyun.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.


dbInstanceModeOptional

public java.lang.Object getDbInstanceMode();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property dbInstanceMode: The db instance mode.

Valid values: StorageElastic, Serverless, Classic.


deployModeOptional

public java.lang.Object getDeployMode();
  • Type: java.lang.String OR com.aliyun.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.

enableSslOptional

public java.lang.Object getEnableSsl();
  • Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property enableSsl: Whether to enable SSL encryption.

Valid values: true: Enable SSL encryption. false (default): Do not enable SSL encryption.


encryptionKeyOptional

public java.lang.Object getEncryptionKey();
  • Type: java.lang.String OR com.aliyun.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.


encryptionTypeOptional

public java.lang.Object getEncryptionType();
  • Type: java.lang.String OR com.aliyun.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.


idleTimeOptional

public java.lang.Object getIdleTime();
  • Type: java.lang.Number OR com.aliyun.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.


instanceSpecOptional

public java.lang.Object getInstanceSpec();
  • Type: java.lang.String OR com.aliyun.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.


masterAiSpecOptional

public java.lang.Object getMasterAiSpec();
  • Type: java.lang.String OR com.aliyun.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.


masterCuOptional

public java.lang.Object getMasterCu();
  • Type: java.lang.Number OR com.aliyun.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.


masterNodeNumOptional

public java.lang.Object getMasterNodeNum();
  • Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property masterNodeNum: The number of master nodes.

Minimum is 1, max is 2.


payTypeOptional

public java.lang.Object getPayType();
  • Type: java.lang.String OR com.aliyun.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

public java.lang.Object getPeriod();
  • Type: java.lang.Number OR com.aliyun.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.


periodUnitOptional

public java.lang.Object getPeriodUnit();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property periodUnit: Unit of subscription period, it could be Month\/Year.

Default value is Month.


privateIpAddressOptional

public java.lang.Object getPrivateIpAddress();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property privateIpAddress: This parameter is deprecated.


prodTypeOptional

public java.lang.Object getProdType();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property prodType: Prod type.

The value can be: standard, cost-effective. The default value is standard.


resourceGroupIdOptional

public java.lang.Object getResourceGroupId();
  • Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property resourceGroupId: The ID of the resource group.


securityIpListOptional

public java.lang.Object getSecurityIpList();
  • Type: java.lang.String OR com.aliyun.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.


segDiskPerformanceLevelOptional

public java.lang.Object getSegDiskPerformanceLevel();
  • Type: java.lang.String OR com.aliyun.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.

segNodeNumOptional

public java.lang.Object getSegNodeNum();
  • Type: java.lang.Number OR com.aliyun.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.

segStorageTypeOptional

public java.lang.Object getSegStorageType();
  • Type: java.lang.String OR com.aliyun.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.


serverlessModeOptional

public java.lang.Object getServerlessMode();
  • Type: java.lang.String OR com.aliyun.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.


serverlessResourceOptional

public java.lang.Object getServerlessResource();
  • Type: java.lang.Number OR com.aliyun.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.


srcDbInstanceNameOptional

public java.lang.Object getSrcDbInstanceName();
  • Type: java.lang.String OR com.aliyun.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.


standbyVSwitchIdOptional

public java.lang.Object getStandbyVSwitchId();
  • Type: java.lang.String OR com.aliyun.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.

standbyZoneIdOptional

public java.lang.Object getStandbyZoneId();
  • Type: java.lang.String OR com.aliyun.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.

storageSizeOptional

public java.lang.Object getStorageSize();
  • Type: java.lang.Number OR com.aliyun.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

public java.util.List<TagsProperty> getTags();

Property tags: The list of instance tags in the form of key\/value pairs.

You can define a maximum of 20 tags for instance.


vectorConfigurationStatusOptional

public java.lang.Object getVectorConfigurationStatus();
  • Type: java.lang.String OR com.aliyun.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).


vpcIdOptional

public java.lang.Object getVpcId();
  • Type: java.lang.String OR com.aliyun.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.