ALIYUN::RDS::PrepayDBInstance类型用于创建预付费数据库实例。
语法
{
"Type": "ALIYUN::RDS::PrepayDBInstance",
"Properties": {
"DBMappings": List,
"CouponCode": String,
"MasterUsername": String,
"PeriodType": String,
"DBInstanceNetType": String,
"MasterUserType": String,
"AutoRenew": Boolean,
"PreferredBackupTime": String,
"PrivateIpAddress": String,
"Engine": String,
"MultiAZ": Boolean,
"VpcId": String,
"ConnectionMode": String,
"ResourceGroupId": String,
"VSwitchId": String,
"BackupRetentionPeriod": Number,
"Quantity": Number,
"CommodityCode": String,
"ZoneId": String,
"AutoPay": Boolean,
"Port": Integer,
"ConnectionStringPrefix": String,
"ConnectionStringType": String,
"EngineVersion": String,
"DBInstanceClass": String,
"PreferredBackupPeriod": List,
"DBInstanceStorage": Integer,
"DBInstanceDescription": String,
"Tags": Map,
"Period": Number,
"MasterUserPassword": String,
"AllocatePublicConnection": Boolean,
"SlaveZoneIds": List,
"TargetDedicatedHostIdForMaster": String,
"RoleARN": String,
"DBInstanceStorageType": String,
"Category": String,
"DBParamGroupId": String,
"EncryptionKey": String,
"DBIsIgnoreCase": Integer,
"SecurityGroupId": String,
"TargetDedicatedHostIdForLog": String,
"DBTimeZone": String,
"DedicatedHostGroupId": String,
"TargetDedicatedHostIdForSlave": String,
"MaintainTime": String,
"SQLCollectorStatus": String,
"SSLSetting": String,
"ArchiveBackupRetentionPeriod": Integer,
"LogBackupRetentionPeriod": Integer,
"EnableBackupLog": Boolean,
"LogBackupLocalRetentionNumber": Integer,
"ArchiveBackupKeepPolicy": String,
"LocalLogRetentionHours": Integer,
"HighSpaceUsageProtection": String,
"CompressType": Integer,
"LogBackupFrequency": String,
"BackupPolicyMode": String,
"ArchiveBackupKeepCount": Integer,
"LocalLogRetentionSpace": Integer,
"ReleasedKeepPolicy": String,
"BackUpCategory": String,
"ServerlessConfig": Map,
"InstanceNetworkType": String,
"StorageAutoScale": String,
"StorageUpperBound": Number,
"StorageThreshold": Number,
"IoAccelerationEnabled": String,
"ColdDataEnabled": Boolean,
"BurstingEnabled": Boolean
}
}
属性
属性名称 | 类型 | 必须 | 允许更新 | 描述 | 约束 |
ResourceGroupId | String | 否 | 是 | 资源组ID。 | 无 |
DBMappings | List | 否 | 否 | 实例下创建的数据库。 | 更多信息,请参见DBMappings属性。 |
CouponCode | String | 否 | 否 | 优惠码。 | 无 |
MasterUsername | String | 否 | 是 | 数据库实例的数据库账号名称。 | 名称需要全局唯一。 长度为2~16个字符,以英文字母开头,以英文字母或数字结尾。可包含英文字母、数字和下划线(_)。 |
PeriodType | String | 是 | 否 | 周期类型。 | 取值:
|
DBInstanceNetType | String | 否 | 否 | 数据库实例的网络类型。 | 取值:
|
MasterUserType | String | 否 | 否 | 数据库账号的权限类型。 | 取值:
|
Port | Integer | 否 | 是 | 实例端口。 | 无 |
ConnectionStringPrefix | String | 否 | 是 | 连接地址的前缀。 | 长度为8~64个字符,可包含英文字母、数字和短划线(-)。 |
ConnectionStringType | String | 否 | 是 | 连接地址的类型。 | 取值:
|
PreferredBackupTime | String | 否 | 否 | 备份时间。 | 格式:HH:mmZ-HH:mmZ。 取值:00:00Z-01:00Z、01:00Z-02:00Z、02:00Z-03:00Z、03:00Z-04:00至23:00Z-24:00Z。 |
PrivateIpAddress | String | 否 | 否 | 指定交换机下的私网IP地址。 | 如果不指定该参数,则系统自动分配私网IP地址。 |
Engine | String | 是 | 否 | 数据类型。 | 取值:
|
MultiAZ | Boolean | 否 | 否 | 数据库实例是否支持多可用区。 | 取值:
|
VpcId | String | 否 | 否 | 专有网络ID。 | 无 |
ConnectionMode | String | 否 | 否 | 数据库的连接模式。 | 取值:
如果未指定该参数,则默认由RDS系统分配。 |
AutoRenew | Boolean | 否 | 否 | 实例是否自动续费。 | 取值:
|
VSwitchId | String | 否 | 否 | 交换机ID。 | 无 |
BackupRetentionPeriod | Number | 否 | 否 | 备份保留天数。 | 无 |
Quantity | Number | 否 | 否 | 创建的实例数量。 | 取值范围:1~99。 默认值:1。 |
CommodityCode | String | 是 | 否 | 商品码。 | 取值:
|
ZoneId | String | 否 | 否 | 可用区ID。 | 无 |
EngineVersion | String | 是 | 否 | 数据库版本号。 | 取值:
|
DBInstanceClass | String | 是 | 是 | 实例规格。 | 例如:rds.mys2.large、rds.mss1.large、rds.pg.s1.small。 |
PreferredBackupPeriod | List | 否 | 否 | 备份周期。 | 取值:
|
DBInstanceStorage | Integer | 是 | 是 | 数据库存储空间。 | 取值:
单位:GB。 说明 每5 GB进行递增。 |
DBInstanceDescription | String | 否 | 否 | 实例的描述或备注信息。 | 长度为2~256个字符。以汉字或英文字母开头,不能以 |
Tags | Map | 否 | 是 | 标签。 | 无 |
Period | Number | 是 | 否 | 购买时长。 | 取值:
|
MasterUserPassword | String | 否 | 是 | 数据库实例的数据库账号密码。 | 长度为8~32个字符。由大写英文字母、小写英文字母、数字和特殊字符中的任意三种组成。支持特殊字符 |
AllocatePublicConnection | Boolean | 否 | 否 | 是否申请实例的外网连接地址。 | 取值:
|
AutoPay | Boolean | 否 | 否 | 是否自动付款。 | 取值:
|
SlaveZoneIds | List | 否 | 否 | 高可用版或三节点企业版的备可用区。 | 最多指定两个备可用区,例如: 为每个主可用区或者备可用区指定一个交换机,例如:ZoneId = 如果自动选择备可用区,取值为 |
TargetDedicatedHostIdForMaster | String | 否 | 否 | 在专属集群内创建实例时,指定主实例的主机ID。 | 无 |
RoleARN | String | 否 | 否 | 角色ARN。该角色允许RDS访问KMS。 | 无 |
DBInstanceStorageType | String | 否 | 是 | 实例存储类型。 | 取值:
|
Category | String | 否 | 是 | 实例系列。 | 取值:
|
DBParamGroupId | String | 否 | 否 | 参数模板ID。 | 无 |
EncryptionKey | String | 否 | 否 | 同地域内的云盘加密的密钥ID。 | 您可以在密钥管理服务控制台查看密钥ID,也可以创建新的密钥。 |
DBIsIgnoreCase | Integer | 否 | 否 | 表名是否区分大小写。 | 取值:
|
SecurityGroupId | String | 否 | 是 | 关联的安全组ID。 | 最多支持关联3个安全组,多个安全组用半角逗号(,)隔开。清空安全组请指定空字符串。 |
TargetDedicatedHostIdForLog | String | 否 | 否 | 在专属集群内创建实例时,指定日志实例的主机ID。 | 无 |
DBTimeZone | String | 否 | 否 | UTC时区。 | 取值范围:-12:59 ~ +13:00。 如果不指定该参数,默认时区为地域默认时区。 本地SSD盘实例可以命名时区。 |
DedicatedHostGroupId | String | 否 | 否 | 在专属集群内创建实例时,指定专属集群ID。 | 无 |
TargetDedicatedHostIdForSlave | String | 否 | 否 | 在专属集群内创建实例时,指定备实例的主机ID。 | 无 |
MaintainTime | String | 否 | 否 | 实例的可维护时间段。 | 格式:HH:mmZ-HH:mmZ。 |
SQLCollectorStatus | String | 否 | 是 | 是否开启SQL洞察(SQL审计)。 | 取值:
|
SSLSetting | String | 否 | 否 | 实例的安全套接层(SSL)链接设置。 | 取值:
|
ArchiveBackupRetentionPeriod | Integer | 否 | 否 | 归档备份的保留天数。 | 无 |
LogBackupRetentionPeriod | Integer | 否 | 否 | 日志备份保留天数。 | 无 |
EnableBackupLog | Boolean | 否 | 否 | 是否开启日志备份。 | 取值:
|
LogBackupLocalRetentionNumber | Integer | 否 | 否 | 本地Binlog保留个数。 | 无 |
ArchiveBackupKeepPolicy | String | 否 | 否 | 归档备份的保留周期。 | 取值:
归档备份的保留周期内能保存的备份个数由ArchiveBackupKeepCount决定,默认为0。 说明 当BackupPolicyMode参数取值为DataBackupPolicy时,该参数生效。 |
LocalLogRetentionHours | Integer | 否 | 否 | 本地日志备份保留小时数。 | 无 |
HighSpaceUsageProtection | String | 否 | 否 | 实例使用空间大于80%,或者剩余空间小于5 GB时,是否强制清理Binlog。 | 取值:
|
CompressType | Integer | 否 | 否 | 备份压缩方式。 | 取值:
|
LogBackupFrequency | String | 否 | 否 | 日志备份频率。 | 适用于SQL Server。 取值:LogInterval,表示每30分钟备份一次。 说明 默认与数据备份周期PreferredBackupPeriod一致。 |
BackupPolicyMode | String | 否 | 否 | 备份类型。 | 取值:
|
ArchiveBackupKeepCount | Integer | 否 | 否 | 归档备份的保留个数。 | 无 |
LocalLogRetentionSpace | Integer | 否 | 否 | 本地日志最大空间使用率。 | 无 |
ReleasedKeepPolicy | String | 否 | 否 | 已删除实例的归档备份保留策略。 | 取值:
|
BackUpCategory | String | 否 | 否 | 备份实例系列。 | 取值:
|
ServerlessConfig | Map | 否 | 否 | RDS Serverless实例的相关设置。 | 更多信息,请参见ServerlessConfig属性。 |
InstanceNetworkType | String | 否 | 否 | 实例的网络类型。 | 取值:
说明 MySQL云盘实例只支持专有网络,此参数必须配置为VPC。 PostgreSQL和MariaDB实例只支持专有网络,此参数必须配置为VPC。 SQL Server单机版和Web版实例支持经典网络和专有网络。其余实例只支持专有网络,此参数必须配置为VPC。 |
StorageAutoScale | String | 否 | 否 | 存储空间自动扩容开关。 | 仅MySQL和PostgreSQL支持,取值:
说明 您也可以在实例创建完成之后,调用ModifyDasInstanceConfig进行调整。更多信息,请参见设置存储空间自动扩容。 |
StorageUpperBound | Number | 否 | 否 | 存储空间自动扩容的总存储空间上限值。 | 自动扩容不会导致实例总存储空间超过该值。单位:GB。 说明 取值需大于等于0。 StorageAutoScale为Enable时必填。 |
StorageThreshold | Number | 否 | 否 | 存储空间自动扩容触发阈值(百分比)。 | 取值:
说明 StorageAutoScale为Enable时该参数必填。 |
IoAccelerationEnabled | String | 否 | 否 | 是否开启 IO 加速。 | 取值含义如下:
|
ColdDataEnabled | Boolean | 否 | 否 | 预留参数。 | 无 |
BurstingEnabled | Boolean | 否 | 否 | 是否已开启 IO 突发。 | 取值:
|
ServerlessConfig语法
"ServerlessConfig": {
"SwitchForce": Boolean,
"MaxCapacity": Number,
"MinCapacity": Number,
"AutoPause": Boolean
}
ServerlessConfig属性
属性名称 | 类型 | 必须 | 允许更新 | 描述 | 约束 |
SwitchForce | Boolean | 否 | 否 | 是否开启Serverless实例的强制弹性扩容和缩容。 | 取值:
说明
|
MaxCapacity | Number | 是 | 否 | 实例RCU(RDS Capacity Unit)自动扩容和缩容范围的最大值。 | 取值:0.5~8。 说明 该参数的值必须大于等于MinCapacity参数。 |
MinCapacity | Number | 是 | 否 | 实例RCU自动扩容和缩范围的最小值。 | 取值:0.5~8。 说明 该参数的值必须小于等于MaxCapacity参数。 |
AutoPause | Boolean | 否 | 否 | 是否开启Serverless实例的智能暂停和启动。 | 取值:
说明 如果10分钟无任何连接将进入暂停状态,当连接进入时会自动唤醒。 |
DBMappings语法
"DBMappings": [
{
"DBDescription": String,
"CharacterSetName": String,
"DBName": String
}
]
DBMappings属性
属性名称 | 类型 | 必须 | 允许更新 | 描述 | 约束 |
DBDescription | String | 否 | 否 | 数据库描述。 | 长度为2~256个字符。以汉字或英文字母开头,不能以 |
CharacterSetName | String | 是 | 否 | 字符集。 | 取值:
|
DBName | String | 是 | 否 | 数据库名称。 | 名称需要全局唯一。 长度不超过64个字符。以小写英文字母开头,可包含小写英文字母、数字和下划线(_)。 |
返回值
Fn::GetAtt
InnerPort:数据库实例的内网端口。
OrderId:订单ID。
PublicConnectionString:公网连接串。
InnerIPAddress:内网IP地址。
DBInstanceId:数据库实例ID。
PublicIPAddress:公网IP地址。
PublicPort:数据库实例公网端口。
InnerConnectionString:内网连接串。