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。 | 您可以在Key Management Service控制台查看密鑰ID,也可以建立新的密鑰。 |
DBIsIgnoreCase | Integer | 否 | 否 | 表名是否區分大小寫。 | 取值:
|
SecurityGroupId | String | 否 | 是 | 關聯的安全性群組ID。 | 最多支援關聯3個安全性群組,多個安全性群組用半形逗號(,)隔開。清空安全性群組請指定Null 字元串。 |
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:內網串連串。