ALIYUN::ECS::InstanceClone類型用於複製一個ECS執行個體。
文法
{
"Type": "ALIYUN::ECS::InstanceClone",
"Properties": {
"DeletionProtection": Boolean,
"DiskMappings": List,
"LoadBalancerIdToAttach": String,
"Description": String,
"BackendServerWeight": Integer,
"Tags": List,
"SecurityGroupId": String,
"RamRoleName": String,
"ImageId": String,
"ResourceGroupId": String,
"SpotPriceLimit": String,
"InstanceChargeType": String,
"SourceInstanceId": String,
"Period": Number,
"SpotStrategy": String,
"Password": String,
"InstanceName": String,
"ZoneId": String,
"KeyPairName": String,
"InternetMaxBandwidthIn": Integer
}
}
屬性
屬性名稱 | 類型 | 必須 | 允許更新 | 描述 | 約束 |
ResourceGroupId | String | 否 | 否 | 執行個體所在的資源群組ID。 | 無 |
SourceInstanceId | String | 是 | 否 | 待複製的源ECS執行個體的ID。 | 複製執行個體規格、鏡像、頻寬收費方式、頻寬節流設定、網路類型等所有執行個體資料和設定。如果源ECS執行個體加入多個安全性群組,新執行個體會加入源執行個體的第一個安全性群組。 |
BackendServerWeight | Integer | 否 | 否 | ECS執行個體在負載平衡器執行個體中的權重。 | 取值範圍:0~100。 預設值:100。 |
LoadBalancerIdToAttach | String | 否 | 否 | ECS執行個體待加入的Server Load Balancer執行個體的ID。 | 無 |
Description | String | 否 | 否 | 描述資訊。 | 最長支援256個字元。 |
ImageId | String | 否 | 是 | 用於啟動ECS執行個體的鏡像ID,包括公用鏡像、自訂鏡像和雲市場鏡像。 | 支援通過模糊的方式指定公用鏡像ID,無需指定一個完整的公用鏡像ID。例如:
|
SecurityGroupId | String | 否 | 否 | 建立執行個體所屬安全性群組ID。 | 無 |
InstanceName | String | 否 | 是 | 執行個體名稱。 | 長度為2~128個字元。必須以英文字母或漢字開頭,不能以 |
Password | String | 否 | 否 | ECS執行個體登入密碼。 | 長度為8~30個字元。 必須同時包含大寫字母、小寫字母、數字和特殊字元中的三種。 支援的特殊字元為: 如果指定該參數,必須使用HTTPS協議調用API,以免密碼泄露。 |
DiskMappings | List | 否 | 是 | 需要掛載的磁碟。 | 最多支援16塊磁碟。 更多資訊,請參見DiskMappings屬性。 |
Tags | List | 否 | 是 | 使用者自訂標籤。 | 最多支援20個標籤,格式: 更多資訊,請參見Tags屬性。 |
ZoneId | String | 否 | 否 | 可用性區域ID。 | 無 |
InstanceChargeType | String | 否 | 否 | 執行個體的付費方式。 | 取值:
|
Period | Number | 否 | 否 | 付費周期。 | 取值:1、2、3、4、5、6、7、8、9、12、24、36。 單位:月。 若InstanceChargeType為PrePaid,此參數為必選;若InstanceChargeType為PostPaid,此參數為可選。 |
KeyPairName | String | 否 | 是 | ECS執行個體綁定的金鑰組名稱。 | Windows系統預設值為空白。 在Linux系統中,如果指定該參數,Password的內容仍舊會被設定到執行個體中,但是密碼登入方式會預設被禁止,採用金鑰組驗證登入。 |
RamRoleName | String | 否 | 否 | 執行個體RAM角色名稱。 | 更多資訊,請參見CreateRole - 建立角色和ListRoles - 擷取角色列表。 |
SpotPriceLimit | String | 否 | 否 | 設定執行個體的每小時最高價格。 | 支援最多3位小數,當SpotStrategy取值為SpotWithPriceLimit時該參數生效。 |
SpotStrategy | String | 否 | 否 | 隨用隨付執行個體的競價策略。 | 當InstanceChargeType取值為PostPaid時該參數生效。取值:
|
DeletionProtection | Boolean | 否 | 否 | 執行個體釋放保護屬性,指定是否支援通過控制台DeleteInstance介面釋放執行個體。 | 取值:
|
InternetMaxBandwidthIn | Integer | 否 | 否 | 最大公網輸出頻寬設定。 | 單位為Mbps(兆位元每秒)。 取值範圍為0~200。 預設值為200。 |
DiskMappings文法
"DiskMappings": [
{
"Category": String,
"DiskName": String,
"Description": String,
"Device": String,
"SnapshotId": String,
"PerformanceLevel": String,
"Size": String
}
]
DiskMappings屬性
屬性名稱 | 類型 | 必須 | 允許更新 | 描述 | 約束 |
Size | String | 是 | 否 | 資料盤大小。 | 取值範圍:20~500。 單位:GB。 |
Category | String | 否 | 否 | 資料盤類型。 | 取值:
I/O最佳化執行個體的預設值為cloud_efficiency,非I/O最佳化執行個體的預設值為cloud。 |
DiskName | String | 否 | 否 | 資料盤名稱。 | 長度為2~128個字元。必須以英文字母或漢字開頭,不能以 |
PerformanceLevel | String | 否 | 否 | 建立ESSD雲端硬碟作為系統硬碟使用時,設定雲端硬碟的效能等級。 | 取值:
關於如何選擇ESSD效能等級,請參見ESSD雲端硬碟。 |
Description | String | 否 | 否 | 描述資訊。 | 長度範圍:2~256個字元。 預設值為空白。 |
Device | String | 否 | 否 | 掛載點。 | 該參數即將停止使用,為提高代碼相容性,建議您盡量不要使用該參數。 |
SnapshotId | String | 否 | 否 | 建立資料盤使用的快照。 | 無 |
Tags文法
"Tags": [
{
"Value": String,
"Key": String
}
]
Tags屬性
屬性名稱 | 類型 | 必須 | 允許更新 | 描述 | 約束 |
Key | String | 是 | 否 | 標籤鍵。 | 長度為1~128個字元,不能以 |
Value | String | 否 | 否 | 標籤值。 | 長度為0~128個字元,不能以 |
傳回值
Fn::GetAtt
InstanceId:執行個體ID。由系統產生,執行個體的全域唯一標識。
PrivateIp:VPC類型執行個體的私網IP。當NetworkType為
vpc
時,該參數生效。InnerIp:Classic類型執行個體的私網IP。當 NetworkType為
classic
時,該參數生效。PublicIp:Classic類型執行個體的公網IP。當NetworkType為
classic
時,該參數生效。ZoneId:可用性區域ID。
HostName:執行個體的主機名稱。
PrimaryNetworkInterfaceId:主網卡ID。
SecurityGroupIds:已建立執行個體的安全性群組ID列表。
樣本
YAML
格式
ROSTemplateFormatVersion: '2015-09-01'
Description: Test ECS Instance Clone
Parameters:
RegionId:
Type: String
AssociationProperty: ALIYUN::ECS::RegionId
SourceInstanceId:
Type: String
AssociationProperty: ALIYUN::ECS::Instance::InstanceId
AssociationPropertyMetadata:
RegionId: ${RegionId}
Resources:
InstanceClone:
Type: ALIYUN::ECS::InstanceClone
Properties:
SourceInstanceId:
Ref: SourceInstanceId
JSON
格式
{
"ROSTemplateFormatVersion": "2015-09-01",
"Description": "Test ECS Instance Clone",
"Parameters": {
"RegionId": {
"Type": "String",
"AssociationProperty": "ALIYUN::ECS::RegionId"
},
"SourceInstanceId": {
"Type": "String",
"AssociationProperty": "ALIYUN::ECS::Instance::InstanceId",
"AssociationPropertyMetadata": {
"RegionId": "${RegionId}"
}
}
},
"Resources": {
"InstanceClone": {
"Type": "ALIYUN::ECS::InstanceClone",
"Properties": {
"SourceInstanceId": {
"Ref": "SourceInstanceId"
}
}
}
}
}