通過鏡像族系建立ECS執行個體 - Elastic Compute Service

通過API建立ECS執行個體時，可基於鏡像族系（對應參數ImageFamily）建立，系統會自動選取鏡像族系內可用的最新鏡像。本文介紹如何通過鏡像族系建立ECS執行個體。

操作步驟

登入OpenAPI Explorer。
尋找並調用RunInstances介面建立一台ECS執行個體。
本樣本中，通過鏡像族系image-test建立ECS執行個體，API的請求參數說明如下：
- RegionId：選擇地區。例如，cn-hangzhou，即華東1（杭州）。
- InstanceType：執行個體規格。例如，ecs.g6.large。
- ImageFamily：鏡像族系。本樣本使用image-test。
- SecurityGroupId：安全性群組ID。例如，sg-bp1i4c0xgqxadew2****。
- VSwitchId：交換器ID。例如，vsw-bp1ddbrxdlrcbim46****。
調用結果樣本如下，得到建立的執行個體ID。
```
{
    "RequestId": "409D4604-84D0-4F16-B99E-809E2E72****",
    "InstanceIdSets": {
        "InstanceIdSet": [
            "i-bp1env7nl3mijm2t****"
        ]
    }
}
```
驗證ECS執行個體的鏡像資訊。
1. 尋找並調用DescribeImageFromFamily介面查詢指定鏡像族系內最新的鏡像。
  本樣本中，查詢鏡像族系image-test內最新的鏡像，API的請求參數說明如下：
  - RegionId：選擇鏡像族系同一地區。
  - ImageFamily：鏡像族系。本樣本中使用image-test。
  傳回值部分樣本如下，得到最新可用鏡像的ID。
  調用介面後，在返回的 JSON 中找到 ImageId 欄位，即鏡像族系內最新鏡像的 ID。返回樣本片段：
```
},
    "ImageVersion": "",
    "OSType": "linux",
    "ImageId": "m-bp1xxx",
    "CreationTime": "2020-03-17T06:19:19Z",
```
2. 調用DescribeInstances介面查詢執行個體的鏡像資訊。
  API的請求參數說明如下：
  - RegionId：選擇ECS執行個體所在的地區。
  - InstanceIds：執行個體ID。格式為["i-bp1env7nl3mijm2t****"]。
  傳回值的部分結果樣本如下，對比執行個體的鏡像ID與鏡像族系中最新可用鏡像的ID是否一致。
  返回結果中 ImageId 即為執行個體使用的鏡像 ID。
```
"OSName": "CentOS  8.0 64位",
        "InstanceNetworkType": "vpc",
        "InnerIpAddress": {
            "IpAddress": []
        },
        "ExpiredTime": "2099-12-31T15:59Z",
        "ImageId": "m-bp1cxxx",
        "EipAddress": {
            "AllocationId": "",
            "IpAddress": "",
            "InternetChargeType": ""
```