ALIYUN::ECS::CustomImage類型用于創建自定義鏡像。
語法
{
"Type": "ALIYUN::ECS::CustomImage",
"Properties": {
"Description": String,
"InstanceId": String,
"ImageName": String,
"SnapshotId": String,
"Tag": List,
"ResourceGroupId": String,
"Platform": String,
"DiskDeviceMapping": List,
"Architecture": String,
"ImageFamily": String,
"SourceRegionId": String,
"DetectionStrategy": String,
"ImageVersion": String,
"BootMode": String
}
}
屬性
屬性名稱 | 類型 | 必須 | 允許更新 | 描述 | 約束 |
Description | String | 否 | 否 | 自定義鏡像的描述信息。 | 長度為2~256個字符,不能以 |
InstanceId | String | 否 | 否 | 實例ID。 | 指定該參數表示使用實例創建自定義鏡像。更多信息,請參見使用實例創建自定義鏡像。 |
ImageName | String | 否 | 否 | 自定義鏡像名稱。 | 長度為2~128個字符。必須以英文字母或漢字開頭,不能以 |
SnapshotId | String | 否 | 否 | 快照ID。 | 指定該參數表示使用快照創建自定義鏡像。更多信息,請參見使用快照創建自定義鏡像。 |
Tag | List | 否 | 否 | 標簽。 | 更多信息,請參見Tag屬性。 |
ResourceGroupId | String | 否 | 是 | 自定義鏡像所在的企業資源組ID。 | 無 |
Platform | String | 否 | 否 | 指定數據盤快照作為自定義鏡像的系統盤后,需要通過Platform確定系統盤的操作系統發行版。 | 取值:
|
DiskDeviceMapping | List | 否 | 否 | 自定義鏡像和快照的關系。 | 更多信息,請參見DiskDeviceMapping屬性。 |
Architecture | String | 否 | 否 | 指定數據盤快照作為自定義鏡像的系統盤后,需要通過Architecture確定系統盤的系統架構。 | 取值:
|
ImageFamily | String | 否 | 否 | 鏡像族系名稱。 | 長度為2~128個字符。必須以英文字母或漢字開頭,不能以 |
SourceRegionId | String | 否 | 否 | 實例或快照所在的地域ID。 | 默認為當前地域ID。 |
DetectionStrategy | String | 否 | 否 | 鏡像檢測策略。 | 不配置此參數時不觸發檢測。僅支持標準(Standard)檢測模式。 說明 目前已支持大部分的Linux、Windows版本,關于鏡像檢測項與操作系統限制說明,請參見鏡像檢測概述和鏡像檢測操作系統限制。 |
ImageVersion | String | 否 | 否 | 鏡像版本。 | 當您指定了實例ID,并且該實例的鏡像是云市場鏡像或者來自云市場鏡像創建的自定義鏡像時。該參數必須和當前實例的鏡像的ImageVersion相同或置為空。 |
BootMode | String | 否 | 否 | 修改鏡像的啟動模式。 | 取值:
說明 您需要了解指定的鏡像支持的啟動模式,當通過該參數修改啟動模式后,必須與鏡像本身支持的啟動模式匹配,實例才能正常啟動。 |
Tag語法
"Tag": [
{
"Key": String,
"Value": String
}
]
Tag屬性
屬性名稱 | 類型 | 必須 | 允許更新 | 描述 | 約束 |
Key | String | 否 | 否 | 標簽鍵。 | 長度為1~128個字符,不能以 |
Value | String | 否 | 否 | 標簽值。 | 長度為0~128個字符,不能以 |
DiskDeviceMapping語法
"DiskDeviceMapping": [
{
"Device": String,
"SnapshotId": String,
"Size": Integer,
"DiskType": String
}
]
DiskDeviceMapping屬性
屬性名稱 | 類型 | 必須 | 允許更新 | 描述 | 約束 |
Device | String | 否 | 否 | 自定義鏡像中的設備名稱。 | 取值:
|
SnapshotId | String | 否 | 否 | 快照ID。 | 無 |
Size | Integer | 否 | 否 | 云盤的大小。 | 取值:
單位:GiB。 |
DiskType | String | 否 | 否 | 自定義鏡像中的云盤類型。 | 您可以通過該參數使用數據盤快照作為自定義鏡像的系統盤。如果不指定該參數,默認為快照對應的云盤類型。 取值:
|
返回值
Fn::GetAtt
ImageId:自定義鏡像ID。
SourceRegionId:實例或快照所在的地域ID。
示例
ROSTemplateFormatVersion: '2015-09-01' Description: zh-cn: 創建自定義鏡像。 en: Create ECS Custom Image Parameters: InstanceId: Type: String AssociationProperty: ALIYUN::ECS::Instance::InstanceId Resources: CustomImage: Type: ALIYUN::ECS::CustomImage Properties: InstanceId: Ref: InstanceId ImageName: myImageName Outputs: ImageId: Value: Fn::GetAtt: - CustomImage - ImageId
{ "ROSTemplateFormatVersion": "2015-09-01", "Description": { "zh-cn": "創建自定義鏡像。", "en": "Create ECS Custom Image" }, "Parameters": { "InstanceId": { "Type": "String", "AssociationProperty": "ALIYUN::ECS::Instance::InstanceId" } }, "Resources": { "CustomImage": { "Type": "ALIYUN::ECS::CustomImage", "Properties": { "InstanceId": { "Ref": "InstanceId" }, "ImageName": "myImageName" } } }, "Outputs": { "ImageId": { "Value": { "Fn::GetAtt": [ "CustomImage", "ImageId" ] } } } }
更多示例,請參見創建自定義鏡像和將一個地域下的自定義鏡像復制到其他地域的組合示例:YAML示例。