全部產品
Search
文件中心

:ALIYUN::ECS::CopyImage

更新時間:Jun 19, 2024

ALIYUN::ECS::CopyImage類型用於將一個地區下的自訂鏡像複製到其他地區。

文法

{
  "Type": "ALIYUN::ECS::CopyImage",
  "Properties": {
    "Encrypted": Boolean,
    "DestinationImageName": String,
    "ImageId": String,
    "DestinationRegionId": String,
    "SourceRegionId": String,
    "Tag": List,
    "DestinationDescription": String,
    "KMSKeyId": String,
    "ResourceGroupId": String,
    "AllowCopyInSameRegion": Boolean
  }
}

屬性

屬性名稱

類型

必須

允許更新

描述

約束

Encrypted

Boolean

是否加密複製後的自訂鏡像。

取值:

  • true:加密。

  • false(預設值):不加密。

DestinationImageName

String

複製後的自訂鏡像的名稱。

長度為2~128個字元。必須以英文字母或漢字開頭,不能以http://https://開頭。可包含英文字母、漢字、數字、半形冒號(:)、底線(_)或短劃線(-)。

ImageId

String

源自訂鏡像ID。

DestinationRegionId

String

複製後的自訂鏡像所在的地區ID。

SourceRegionId

String

源自訂鏡像所在的地區ID。

預設為當前地區ID。

Tag

List

標籤。

更多資訊,請參見Tag屬性

DestinationDescription

String

複製後的自訂鏡像的描述資訊。

長度為2~256個字元,不能以http://https://開頭。

KMSKeyId

String

加密自訂鏡像使用的密鑰ID。

ResourceGroupId

String

資源群組ID。

AllowCopyInSameRegion

Boolean

是否允許複製同一地區內的鏡像。

取值:

  • true:不會複製鏡像,將返回源鏡像ID,並且不會刪除原始鏡像。 

  • false:允許複製同一地區內的鏡像。

Tag文法

"Tag": [
  {
    "Key": String,
    "Value": String
  }
]

Tag屬性

屬性名稱

類型

必須

允許更新

描述

約束

Key

String

標籤鍵。

長度為1~128個字元,不能以aliyunacs:開頭,不能包含http://https://

Value

String

標籤值。

長度為0~128個字元,不能以aliyunacs:開頭,不能包含http://https://

傳回值

Fn::GetAtt

  • ImageId:複製後的自訂鏡像ID。

  • DestinationRegionId:目標自訂鏡像所在的地區ID。

  • SourceRegionId:源自訂鏡像所在的地區ID。

樣本

  • YAML格式

    ROSTemplateFormatVersion: '2015-09-01'
    Description:
      zh-cn: 將一個地區下的自訂鏡像複製到其他地區。
      en: Create ECS CopyImage
    Parameters:
      ImageId:
        Type: String
        AssociationProperty: ALIYUN::ECS::Image::ImageId
        AssociationPropertyMetadata:
          SupportedImageOwnerAlias:
            - self
    Resources:
      CopyImage:
        Type: ALIYUN::ECS::CopyImage
        Properties:
          Encrypted: false
          ImageId:
            Ref: ImageId
          DestinationRegionId: cn-shanghai
          SourceRegionId: cn-hangzhou
          DestinationDescription: Test CopyImage
    Outputs:
      CopyImageId:
        Value:
          Fn::GetAtt:
            - CopyImage
            - ImageId                    
  • JSON格式

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Description": {
        "zh-cn": "將一個地區下的自訂鏡像複製到其他地區。",
        "en": "Create ECS CopyImage"
      },
      "Parameters": {
        "ImageId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::Image::ImageId",
          "AssociationPropertyMetadata": {
            "SupportedImageOwnerAlias": [
              "self"
            ]
          }
        }
      },
      "Resources": {
        "CopyImage": {
          "Type": "ALIYUN::ECS::CopyImage",
          "Properties": {
            "Encrypted": false,
            "ImageId": {
              "Ref": "ImageId"
            },
            "DestinationRegionId": "cn-shanghai",
            "SourceRegionId": "cn-hangzhou",
            "DestinationDescription": "Test CopyImage"
          }
        }
      },
      "Outputs": {
        "CopyImageId": {
          "Value": {
            "Fn::GetAtt": [
              "CopyImage",
              "ImageId"
            ]
          }
        }
      }
    }            

更多樣本,請參見建立自訂鏡像和將一個地區下的自訂鏡像複製到其他地區的組合樣本:JSON樣本YAML樣本