すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::ECS::InstanceClone

最終更新日:Jan 16, 2025

ALIYUN::ECS::InstanceClone は、Elastic Compute Service(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

いいえ

いいえ

新しい ECS インスタンスが属するリソースグループの ID。

なし。

SourceInstanceId

String

はい

いいえ

ソース ECS インスタンスの ID。

インスタンスタイプ、イメージ、帯域幅測定方法、帯域幅制限、ネットワークタイプなど、ソース ECS インスタンスのすべてのデータと設定を複製できます。ソース ECS インスタンスが複数のセキュリティグループに属している場合、新しいインスタンスは最初のセキュリティグループに追加されます。

BackendServerWeight

Integer

いいえ

いいえ

サーバーロードバランサー(SLB)インスタンスにアタッチする新しい ECS インスタンスの重み。

有効な値:0 ~ 100。

デフォルト値:100。

LoadBalancerIdToAttach

String

いいえ

いいえ

新しい ECS インスタンスをアタッチする SLB インスタンスの ID。

なし。

Description

String

いいえ

いいえ

説明。

説明は最大 256 文字まで入力できます。

ImageId

String

いいえ

はい

新しい ECS インスタンスの起動に使用するイメージの ID。パブリックイメージ、カスタムイメージ、または Alibaba Cloud Marketplace イメージを使用できます。

パブリックイメージを指定するには、完全なイメージ ID の代わりに部分的なイメージ ID を入力できます。パブリックイメージはあいまい検索をサポートしています。例:

  • ubuntu と入力すると、システムは ubuntu16_0402_64_20G_alibase_20170818.vhd というイメージ ID と一致します。

  • ubuntu_14 と入力すると、システムは ubuntu_14_0405_64_20G_alibase_20170824.vhd というイメージ ID と一致します。

  • ubuntu*14*32 と入力すると、システムは ubuntu_14_0405_32_40G_alibase_20170711.vhd というイメージ ID と一致します。

  • ubuntu_16_0402_32 と入力すると、システムは ubuntu_16_0402_32_40G_alibase_20170711.vhd というイメージ ID と一致します。

SecurityGroupId

String

いいえ

いいえ

新しい ECS インスタンスが属するセキュリティグループの ID。

なし。

InstanceName

String

いいえ

はい

新しい ECS インスタンスの名前。

名前は 2 ~ 128 文字の長さでなければなりません。英字で始まり、http:// または https:// で始めることはできません。英字、数字、コロン(:)、アンダースコア(_)、ハイフン(-)を含めることができます。

Password

String

いいえ

いいえ

新しい ECS インスタンスにログオンするために使用されるパスワード。

パスワードは 8 ~ 30 文字の長さでなければなりません。

大文字、小文字、数字、特殊文字のうち少なくとも 3 種類の文字を含める必要があります。

サポートされている特殊文字は次のとおりです。( ) ' ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /

このプロパティを指定する場合は、パスワードの漏洩を防ぐために、HTTPS を使用して特定のリソースオーケストレーションサービス(ROS)API オペレーションを呼び出す必要があります。

DiskMappings

List

いいえ

はい

新しい ECS インスタンスにアタッチするディスク。

最大 16 台のディスクをアタッチできます。

詳細については、DiskMappings プロパティをご参照ください。

Tags

List

いいえ

はい

カスタムタグ。

[{"Key":"tagKey","Value":"tagValue"},{"Key":"tagKey2","Value":"tagValue2"}] の形式で最大 20 個のタグを追加できます。

詳細については、Tags プロパティをご参照ください。

ZoneId

String

いいえ

いいえ

ゾーン ID。

なし。

InstanceChargeType

String

いいえ

いいえ

新しい ECS インスタンスの課金方式。

有効な値:

  • 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 インスタンスの場合、KeyPairName プロパティはデフォルトで空です。

Linux インスタンスの場合、KeyPairName プロパティを指定しても Password プロパティが有効になります。ただし、パスワードベースのログオンはデフォルトで無効になっており、KeyPairName プロパティの値がログオンの検証に使用されます。

RamRoleName

String

いいえ

いいえ

新しい ECS インスタンスのリソースアクセス管理(RAM)ロールの名前。

詳細については、CreateRole および ListRoles をご参照ください。

SpotPriceLimit

String

いいえ

いいえ

新しい ECS インスタンスの 1 時間あたりの最大価格。

このプロパティの値には、小数点以下 3 桁まで含めることができます。このプロパティは、SpotStrategy が SpotWithPriceLimit に設定されている場合に有効になります。

SpotStrategy

String

いいえ

いいえ

従量課金制インスタンスの入札ポリシー。

このプロパティは、InstanceChargeType が PostPaid に設定されている場合に有効になります。有効な値:

  • NoSpot(デフォルト):インスタンスは通常の従量課金制インスタンスとして作成されます。

  • SpotWithPriceLimit:インスタンスは、ユーザー定義の 1 時間あたりの最大価格を持つプリエンティブインスタンスとして作成されます。

  • SpotAsPriceGo:インスタンスは、購入時の市場価格に基づいて入札価格が決定されるプリエンティブインスタンスとして作成されます。市場価格は、従量課金制価格まで上がることがあります。

DeletionProtection

Boolean

いいえ

いいえ

新しい ECS インスタンスのリリース保護プロパティ。このプロパティを使用して、ECS コンソールで、または DeleteInstance オペレーションを呼び出すことによって、インスタンスをリリースできるかどうかを指定できます。

有効な値:

  • true

  • false(デフォルト)

InternetMaxBandwidthIn

Integer

いいえ

いいえ

最大アウトバウンドパブリック帯域幅。

単位:Mbit/s。

有効な値: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:エンタープライズ SSD(ESSD)

  • cloud_efficiency:ウルトラディスク

  • ephemeral_ssd:ローカル SSD

I/O 最適化インスタンスの場合、デフォルト値は cloud_efficiency です。I/O 最適化されていないインスタンスの場合、デフォルト値は cloud です。

DiskName

String

いいえ

いいえ

データディスクの名前。

名前は 2 ~ 128 文字の長さでなければなりません。英字で始まり、http:// または https:// で始めることはできません。英字、数字、アンダースコア(_)、コロン(:)、ハイフン(-)を含めることができます。

PerformanceLevel

String

いいえ

いいえ

システムディスクとして使用する ESSD のパフォーマンスレベル(PL)。

有効な値:

  • PL0:ESSD は最大 10,000 ランダム読み書き IOPS を提供できます。

  • PL1(デフォルト):ESSD は最大 50,000 ランダム読み書き IOPS を提供できます。

  • PL2:ESSD は最大 100,000 ランダム読み書き IOPS を提供できます。

  • PL3:ESSD は最大 1,000,000 ランダム読み書き IOPS を提供できます。

ESSD の PL の選択方法の詳細については、ESSD をご参照ください。

Description

String

いいえ

いいえ

説明。

説明は 2 ~ 256 文字の長さでなければなりません。

デフォルトでは、このプロパティは空です。

Device

String

いいえ

いいえ

マウントターゲット。

このプロパティは削除されます。コードの互換性を向上させるために、他のプロパティを使用することをお勧めします。

SnapshotId

String

いいえ

いいえ

データディスクの作成に使用するスナップショットの ID。

なし。

Tags 構文

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

Tags プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

Key

String

はい

いいえ

タグキー。

タグキーは 1 ~ 128 文字の長さでなければならず、http:// または https:// を含めることはできません。aliyun または acs: で始めることはできません。

Value

String

いいえ

いいえ

タグ値。

タグ値は最大 128 文字の長さで、http:// または https:// を含めることはできません。aliyun または acs: で始めることはできません。

戻り値

Fn::GetAtt

  • InstanceId:新しい ECS インスタンスの ID。インスタンス ID は、システムによってインスタンスに生成される GUID です。

  • PrivateIp:仮想プライベートクラウド(VPC)内の新しい ECS インスタンスのプライベート IP アドレス。このプロパティは、NetworkType が vpc に設定されている場合に有効になります。

  • InnerIp:クラシックネットワーク内の新しい ECS インスタンスのプライベート IP アドレス。このプロパティは、NetworkType が classic に設定されている場合に有効になります。

  • PublicIp:クラシックネットワーク内の新しい ECS インスタンスのパブリック IP アドレス。このプロパティは、NetworkType が classic に設定されている場合に有効になります。

  • ZoneId:新しい ECS インスタンスのゾーン ID。

  • HostName:新しい ECS インスタンスのホスト名。

  • PrimaryNetworkInterfaceId:新しい ECS インスタンスのプライマリ エラスティックネットワークインターフェース(ENI)ID。

  • SecurityGroupIds:新しい ECS インスタンスが属するセキュリティグループの ID。

YAML 形式

ROSTemplateFormatVersion: '2015-09-01'
Description: ECS インスタンス複製テスト
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": "ECS インスタンス複製テスト",
  "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"
        }
      }
    }
  }
}