全部產品
Search
文件中心

:ALIYUN::ECS::InstanceClone

更新時間:Oct 25, 2024

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。例如:

  • 指定ubuntu,最終會匹配ubuntu16_0402_64_20G_alibase_20170818.vhd。

  • 指定ubuntu_14,最終會匹配ubuntu_14_0405_64_20G_alibase_20170824.vhd。

  • 指定ubuntu*14*32,最終會匹配ubuntu_14_0405_32_40G_alibase_20170711.vhd。

  • 指定ubuntu_16_0402_32,最終會匹配ubuntu_16_0402_32_40G_alibase_20170711.vhd。

SecurityGroupId

String

建立執行個體所屬安全性群組ID。

InstanceName

String

執行個體名稱。

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

Password

String

ECS執行個體登入密碼。

長度為8~30個字元。

必須同時包含大寫字母、小寫字母、數字和特殊字元中的三種。

支援的特殊字元為:( ) ' ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /

如果指定該參數,必須使用HTTPS協議調用API,以免密碼泄露。

DiskMappings

List

需要掛載的磁碟。

最多支援16塊磁碟。

更多資訊,請參見DiskMappings屬性

Tags

List

使用者自訂標籤。

最多支援20個標籤,格式:[{"Key":"tagKey","Value":"tagValue"}、{"Key":"tagKey2","Value":"tagValue2"}]

更多資訊,請參見Tags屬性

ZoneId

String

可用性區域ID。

InstanceChargeType

String

執行個體的付費方式。

取值:

  • PrePaid:預付費(訂用帳戶)。

    說明

    如果指定PrePaid,必須確保餘額充足,否則將建立失敗。

  • PostPaid(預設值):隨用隨付。

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時該參數生效。取值:

  • NoSpot(預設值):正常隨用隨付執行個體。

  • SpotWithPriceLimit:設定上限價格的競價執行個體。

  • SpotAsPriceGo:系統自動出價,最高不超過隨用隨付價格。

DeletionProtection

Boolean

執行個體釋放保護屬性,指定是否支援通過控制台DeleteInstance介面釋放執行個體。

取值:

  • true:通過介面釋放執行個體。

  • false(預設值):不通過介面釋放執行個體。

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

資料盤類型。

取值:

  • cloud:普通雲端硬碟。

  • cloud_ssd:SSD雲端硬碟。

  • cloud_essd:ESSD雲端硬碟。

  • cloud_efficiency:高效雲端硬碟。

  • ephemeral_ssd:本地SSD盤。

I/O最佳化執行個體的預設值為cloud_efficiency,非I/O最佳化執行個體的預設值為cloud。

DiskName

String

資料盤名稱。

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

PerformanceLevel

String

建立ESSD雲端硬碟作為系統硬碟使用時,設定雲端硬碟的效能等級。

取值:

  • PL0:單盤最高隨機讀寫IOPS為1萬。

  • PL1(預設):單盤最高隨機讀寫IOPS為5萬。

  • PL2:單盤最高隨機讀寫IOPS為10萬。

  • PL3:單盤最高隨機讀寫IOPS為100萬。

關於如何選擇ESSD效能等級,請參見ESSD雲端硬碟

Description

String

描述資訊。

長度範圍:2~256個字元。

預設值為空白。

Device

String

掛載點。

該參數即將停止使用,為提高代碼相容性,建議您盡量不要使用該參數。

SnapshotId

String

建立資料盤使用的快照。

Tags文法

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

Tags屬性

屬性名稱

類型

必須

允許更新

描述

約束

Key

String

標籤鍵。

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

Value

String

標籤值。

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

傳回值

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"
        }
      }
    }
  }
}