ALIYUN::ECS::Instance 型は、ECS インスタンスを作成する場合に使用できます。

構文

  1. {  “Type”: “ALIYUN::ECS::Instance”,  “Properties”: {    “DiskMappings”: List,    “IoOptimized”: String,    “InternetChargeType”: String,    “PrivateIpAddress”: String,    “SystemDiskDiskName”: String,    “VpcId”: String,    “Description”: String,    “Tags”: List,    “HostName”: String,    “ImageId”: String,    “InstanceChargeType”: String,    “VSwitchId”: String,    “Password”: String,    “InstanceType”: String,    “SystemDiskCategory”: String,    “SystemDiskSize”: Integer,    “ZoneId”: String,    “InternetMaxBandwidthOut”: Integer,    “InstanceName”: String,    “InternetMaxBandwidthIn”: Integer,    “UserData”: String,    “SecurityGroupId”: String,    “Period”: Integer,    “AllocatePublicIP”: Boolean,    “SystemDiskDescription”: String,    “KeyPairName”: String,    “RamRoleName”: String,    “SpotPriceLimit”: String,    “SpotStrategy”: String  }}

属性

属性名 データ型 必須/省略可能 更新可/不可 説明 制約
ImageId String 必須 可 ECS インスタンスの起動時に使用されるイメージの ID です。 イメージは、パブリックイメージ、カスタムイメージ、またはマーケットプレイスイメージのいずれかです。 ECS パブリックイメージ一覧

完全なパブリックイメージ ID ではなく、あいまいな方法でパブリックイメージ ID を指定します。 通常、ECS インスタンスをデプロイするには、イメージのタイプとバージョンを選択します。 イメージタイプとバージョンを指定するか、テンプレートが必要なイメージタイプを指定できます。 ROS は適正なパブリックイメージ ID を自動的に選択します。 あいまい検索のイメージ ID では、イメージ ID の一部をワイルドカード文字のアスタリスク (*) で置き換えることができます。例として Alibaba Cloud が提供するすべての Ubuntu パブリックイメージを取り上げます。

ubuntu14_0405_32_40G_alibase_20170711.vhd

ubuntu_14_0405_32_40G_alibase_20170711.vhd

ubuntu_14_0405_64_20G_alibase_20170824.vhd

ubuntu_16_0402_32_40G_alibase_20170711.vhd

ubuntu_16_0402_64_20G_alibase_20170818.vhd

ECS のパブリックイメージ ID を指定するには、以下の方法を実行します。

指定 : ubuntu

一致するイメージ : ubuntu_16_0402_64_20G_alibase_20170818.vhd

指定 : ubuntu_14

一致するイメージ : ubuntu_14_0405_64_20G_alibase_20170824.vhd

指定 : ubuntu1432

一致するイメージ : ubuntu14_0405_32_40G_alibase_20170711.vhd

指定 : ubuntu_16_0402_32

一致するイメージ : ubuntu_16_0402_32_40G_alibase_20170711.vhd

InstanceType String 必須 不可 ECS インスタンスタイプ ECS インスタンスタイプの一覧
SecurityGroupId String 必須 不可 作成したインスタンスが属するセキュリティグループの ID なし
Description String 省略可能 不可 説明 説明は最大 256 文字です。
InstanceName String 省略可能 不可 インスタンス名 インスタンス名は、英字と漢字、数字、コンマ (,)、ピリオド (.)、およびハイフン (-) を含め最大 128 文字で指定できます。
Password String 省略可能 不可 ECS インスタンスログインパスワード インスタンスパスワードです。 パスワードは 8 - 30 文字の文字列で、大文字/小文字、数字、および特殊文字を含める必要があります。 使用できる特殊文字は以下のとおりです。 ( ) ` ~ ! @ # $ % ^ & - + = | { } [ ] : ; ‘ < > . ? / Password パラメーターが入力されている場合は、パスワード漏洩防止のため HTTPS を使用して API を呼び出します。
HostName String 省略可能 不可 ホスト名 このパラメーターは、ECS インスタンスのホスト名を示します。 2 文字以上の文字列です。 hostname の先頭または末尾の文字は . または - にすることはできません。 また、連続する . または - の記号は使用できません。 Windows の場合、ホスト名は大文字/小文字、数字、および - を含め最大 15 文字指定できます。 ピリオド . や数字だけを指定することはできません。 Linux などの他の OS では、ホスト名をピリオド (.) でセグメントに区切って最大 30 文字指定でき、各セグメントには大文字/小文字、数字、および を含めることができます。
AllocatePublicIP ブール値 省略可能 不可 パブリック IP アドレスを作成するかどうかを示します。 InternetMaxBandwidthOut が 0 に設定されている場合、パブリック IP アドレスは割り当てられません。 デフォルト値は true です。
PrivateIpAddress String 省略可能 不可 VPC のイントラネットIPアドレスです。 IP アドレスは VPC の他のインスタンスの IP アドレスと同じにすることはできません。 なし
InternetChargeType String 省略可能 不可 インターネット経由のアクセスに対する帯域幅課金方法です。デフォルト値 : PayByTraffic。 省略可能な値 : PayByBandwidth および PayByTraffic。
InternetMaxBandwidthIn Integer 省略可能 不可 Mbps 単位のインターネットの最大インバウンド帯域幅 値の範囲 : [1, 100]。デフォルト値 : 100。
InternetMaxBandwidthOut Integer 省略可能 不可 Mbps 単位の最大インターネットアウトバウンド帯域幅 PayByBandwidth モードの値の範囲 : [0, 200]。デフォルト値 : 0。 PayByTraffic モードでの値の範囲 : [1, 200]。 このパラメーターは PayByTraffic モードで指定する必要があります。
IoOptimized String 省略可能 不可 I/O 最適化インスタンスかどうかを示します。 省略可能な値 : なし (I/O 非最適化) および最適化 (I/O 最適化)。デフォルト値 : なし。
DiskMappings List 省略可能 不可 取り付けるディスク 最大 4 台のディスクを接続できます。
SystemDiskCategory String 省略可能 不可 システムディスクタイプ 省略可能な値 : cloud、cloud_efficiency、cloud_ssd、および ephemeral_ssd
SystemDiskDescription String 省略可能 不可 システムディスクの説明 なし
SystemDiskDiskName String 省略可能 不可 システムディスク名 なし
SystemDiskSize String 省略可能 不可 システムディスクサイズ 値の範囲 : [40, 500] GB。 カスタマイズイメージを使用してシステムディスクを作成する場合は、必ずシステムディスクのサイズがイメージのサイズより大きくなるようにします。
Tags List 省略可能 不可 カスタムタグ [{“Key”:”tagKey”,”Value”:”tagValue”}、“Key”:”tagKey2”、Value”:”tagValue2”}] の形式で最大 4 つのタグがサポートされます。
UserData String 省略可能 不可 ECSインスタンス作成中に入力されるユーザーデータ ユーザーデータサイズは 16 KB を超えることはできません。
ZoneId String 省略可能 不可 ゾーン ID なし
VpcId String 省略可能 不可 VPC ID なし
VSwitchId String 省略可能 不可 VSwitch ID なし
InstanceChargeType String 省略可能 不可 ECS インスタンスの課金方法です。従量課金、サブスクリプションのいずれかです。 値のオプション : Prepaid および Postpaid。 デフォルト値 : PostPaid。 このパラメーターが Prepaid に設定されている場合は、アカウントに十分な残高があることを確認してください。残高がない場合、インスタンス作成は失敗します。
Period Integer 省略可能 不可 支払いサイクル InstanceChargeType が Prepaid に設定されている場合は、このパラメーターを設定します。 InstanceChargeType が Postpaid に設定されている場合、このパラメーターは無視されます。 省略可能な値 : 1 - 9、12、24、および 36。単位 : 月
KeyPairName String 省略可能 不可 ECS インスタンスにバインドされているキーペアの名前 キーペアが Windows ECS インスタンスにバインドされている場合、このパラメーターは無視されます。 デフォルトは NULL です。 このパラメーターが設定されている場合、Password パラメーターの値はインスタンスに設定されます。 ただし、Linux のパスワードログインモードは初期化され無効になるります。
RamRoleName String 省略可能 不可 ECS インスタンスの RAM ロール名です。 ListRoles API を呼び出すことで、ロール名を照会できます。 詳細は、「CreateRole」および「ListRoles」をご参照ください。 なし
SpotPriceLimit String 省略可能 いいえ ECS インスタンスの 1 時間当たりの最高料金を設定します。 小数点以下は第 3 位までです。 このパラメーターは、SpotStrategy の値が SpotWithPriceLimit のときに有効になります。
SpotStrategy String 省略可能 不可 従量課金インスタンスの予期されるスポット料金を設定します。 このパラメーターは、InstanceChargeType の値が PostPaid のときに有効になります。 有効な値 :

NoSpot : 通常の従量課金インスタンス

SpotWithPriceLimit : スポットインスタンスの入札価格のしきい値を設定します。

SpotAsPriceGo : 入札システムにより従量課金の最高料金が自動的に設定されます。

デフォルト値 : NoSpot

DiskMappings の構文

  1. “DiskMappings”: [  {    “Category”: String,    “DiskName”: String,    “Description”: String,    “Device”: String,    “SnapshotId”: String,    “Size”: String  }]

DiskMappings のプロパティ

属性名 データ型 必須/省略可能 更新可/不可 説明 制約
Size String 必須 不可 GB 単位のデータディスクサイズ なし
Category String 省略可能 不可 データディスクタイプ

省略可能な値 : cloud、cloud_efficiency、cloud_ssd、および ephemeral_ssd

デフォルト値 : cloud
DiskName String 省略可能 不可 データディスク名 インスタンス名は、漢字と英字、数字、コンマ (,)、ピリオド (.)、およびハイフン (-) を含め最大 128 文字で指定できます。
Description String 省略可能 不可 説明 値の範囲 : [2, 256]。デフォルト値 : NULL。
Device String 省略可能 不可 ECS インスタンス内のデータディスクのデバイス名 例 : /dev/xvd[a-z]
SnapshotId String 省略可能 不可 データディスクの作成に使用されるスナップショットの ID なし

Tags の構文

  1. “Tags”: [  {    “Value”: String,    “Key”: String  }]

Tags の属性

属性名 データ型 必須/省略可能 更新可/不可 説明 制約
Key String 必須 不可 なし なし
Value String 省略可能 不可 なし なし

戻り値

Fn::GetAtt

  • InstanceId : システムによって生成され、グローバルに一意なインスタンスの ID です。 ECS インスタンスの一意の識別子です。
  • PrivateIp : VPC タイプのインスタンスのプライベート IP アドレスです。 このパラメーターは、NetworkType が VPC のときに有効です。
  • InnerIp : クラシックタイプのインスタンスのプライベート IP アドレスです。 このパラメーターは、NetworkType が Classic のときに有効です。
  • PublicIp : クラシックタイプのインスタンスのパブリック IP アドレスの一覧。 このパラメーターは、NetworkType が Classic のときに有効です。
  • ZoneId : ゾーン ID
  • HostName : インスタンスのホスト名

コーディング例

  1. {  “ROSTemplateFormatVersion”: “2015-09-01”,  “Resources”: {    “Webserver “:{      “Type”: “ALIYUN::ECS::Instance”,      “Properties”: {        Imagaid: m-25l0rcfjo “,        “InstanceType”: “ecs.t1.small”,        “SecurityGroupId”: “sg-25zwc3se0”,        “ZoneId”: “cn-beijing-b”,        “Tags”: [            “Key”: “tiantt “,            “Value”: “ros”        },{            “Key”: “tiantt1 “,            “Value”: “ros1”        }        ]      }    }  },  “Outputs “:{    “Instanceid “:{         “Value” : {“Fn::GetAtt”: [“WebServer”,”InstanceId”]}    },    “PublicIp”: {         “Value” : {“Fn::GetAtt”: [“WebServer”,”PublicIp”]}    }  }}            
  1.      </article>
  2.   </main>