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
}
}
属性
属性名称 | 类型 | 必须 | 允许更新 | 描述 | 约束 |
---|---|---|---|---|---|
Description | String | 否 | 否 | 自定义镜像的描述信息。 | 长度为2~256个字符,不能以http:// 和https:// 开头。 |
InstanceId | String | 否 | 否 | 实例ID。 | 指定该参数表示使用实例创建自定义镜像。更多信息,请参见使用实例创建自定义镜像。 |
ImageName | String | 否 | 否 | 自定义镜像名称。 | 长度为2~128个字符。必须以英文字母或汉字开头,不能以http:// 和https:// 开头。可包含英文字母、汉字、数字、下划线(_)和短划线(-)。 |
SnapshotId | String | 否 | 否 | 快照ID。 | 指定该参数表示使用快照创建自定义镜像。更多信息,请参见使用快照创建自定义镜像。 |
Tag | List | 否 | 否 | 标签。 | 更多信息,请参见Tag属性。 |
ResourceGroupId | String | 否 | 是 | 自定义镜像所在的企业资源组ID。 | 无 |
Platform | String | 否 | 否 | 指定数据盘快照作为自定义镜像的系统盘后,需要通过Platform确定系统盘的操作系统发行版。 | 取值:
|
DiskDeviceMapping | List | 否 | 否 | 自定义镜像和快照的关系。 | 更多信息,请参见DiskDeviceMapping属性。 |
Architecture | String | 否 | 否 | 指定数据盘快照作为自定义镜像的系统盘后,需要通过Architecture确定系统盘的系统架构。 | 取值:
|
ImageFamily | String | 否 | 否 | 自定义镜像族系名称。 | 长度为2~128个字符。必须以英文字母或汉字开头,不能以aliyun 和acs: 开头,不能包含http:// 和https:// 。可包含英文字母、汉字、数字、半角冒号(:)、下划线(_)或短划线(-)。 |
SourceRegionId | String | 否 | 否 | 实例或快照所在的地域ID。 | 默认为当前地域ID。 |
Tag语法
"Tag": [
{
"Key": String,
"Value": String
}
]
Tag属性
属性名称 | 类型 | 必须 | 允许更新 | 描述 | 约束 |
---|---|---|---|---|---|
Key | String | 否 | 否 | 标签键。 | 长度为1~128个字符,不能以aliyun 和acs: 开头,不能包含http:// 或https:// 。 |
Value | String | 否 | 否 | 标签值。 | 长度为0~128个字符,不能以aliyun 和acs: 开头,不能包含http:// 或https:// 。 |
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。
示例
JSON
格式{ "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" ] } } } }