Elastic Compute Service：CLI參考

CLI使用方式

安裝和配置CLI

通過CLI調用ECS API

安裝配置好CLI後，您可以在終端按照以下命令結構，調用ECS API。

aliyun ecs <API Name> --<參數1 取值1> --<參數2 取值2> ...

CLI調用樣本

以下樣本為您展示如何使用阿里雲CLI調用Elastic Compute Service API。

建立ECS執行個體

以在杭州地區建立一個基於Alibaba Cloud Linux鏡像的訂用帳戶的ECS執行個體為例，指導您如何通過CLI建立ECS執行個體。

1. 準備工作。

   在建立ECS執行個體前，請確保您已經建立了Virtual Private Cloud、交換器、安全性群組，並擷取其ID。

   說明

   如果您已有上述資源且符合需求，可跳過該步驟。

   1. 調用CreateVpc建立VPC。

      假設在華東1（杭州）建立Virtual Private Cloud，VPC網段為192.168.0.0/16。

      • 請求樣本

        aliyun vpc CreateVpc \
        --RegionId cn-hangzhou \
        --CidrBlock 192.168.0.0/16 

      • 返回樣本

        {
          "RequestId": "EC94C73B-8103-4B86-B353-E65C7C9E****",
          "ResourceGroupId": "rg-acfmzw2jz2z****",
          "RouteTableId": "vtb-bp1jxpr9ji5wcn4yv****",
          "VRouterId": "vrt-bp1dyxemup2q4ouga****",
          "VpcId": "vpc-bp1d9v4763ym2hlzt****"
        }

   2. 調用CreateVSwitch在VPC中建立交換器。

      假設交換器網段為192.168.0.0/24，VPC ID為vpc-bp1d9v4763ym2hlzt****。

      • 請求樣本

        aliyun vpc CreateVSwitch \
        --CidrBlock 192.168.0.0/24 \
        --VpcId vpc-bp1d9v4763ym2hlzt**** \
        --ZoneId=cn-hangzhou-i

      • 返回樣本

        {
                "RequestId": "AF1787C4-0D81-44F0-A324-D5C54EA0****",
                "VSwitchId": "vsw-bp11hf5r945gewysp****"
        }

   3. 調用CreateSecurityGroup建立安全性群組。

      • 請求樣本

        aliyun ecs CreateSecurityGroup \
        --RegionId cn-hangzhou \
        --VpcId vpc-bp1d9v4763ym2hlzt****

      • 返回樣本

        {
                "RequestId": "B1C25C34-9B84-49E3-9E50-FB7D7970****",
                "SecurityGroupId": "sg-bp18z2q1jg4gq95t****"
        }

   4. 調用AuthorizeSecurityGroup添加安全性群組規則。

      假設在安全性群組（ID為sg-bp18z2q1jg4gq95t****）的入方向允許存取22連接埠，協議為TCP。

      • 請求樣本

        aliyun ecs AuthorizeSecurityGroup \
        --RegionId cn-hangzhou \
        --SecurityGroupId sg-bp18z2q1jg4gq95t**** \
        --IpProtocol tcp \
        --SourceCidrIp 0.0.0.0/0 \
        --PortRange 22/22

      • 返回樣本

        {
         "RequestId": "FA8B1E61-C9C9-4D91-9628-64B8E2F4****"
        }

2. 建立ECS執行個體。

   調用RunInstances建立一個訂用帳戶的ECS執行個體。

   1. 情境樣本

      參數	樣本取值
      RegionId	地區：cn-hangzhou
      ImageId	鏡像：推薦使用Alibaba Cloud Linux鏡像aliyun_3_x64_20G_alibase_20240528.vhd。
      InstanceType	執行個體規格： 個人應用：推薦選擇2 vCPU 2 GiB的執行個體規格ecs.e-c1m1.large。 中小公司專屬應用程式：推薦選擇2 vCPU 4 GiB的執行個體規格ecs.c7.large。
      SecurityGroupId	安全性群組ID：根據CreateSecurityGroup返回結果。 樣本：sg-bp18z2q1jg4gq95t****
      VSwitchId	交換器ID：根據建立交換器返回結果。 樣本：vsw-bp11hf5r945gewysp****
      InstanceName	執行個體名稱。 樣本：ecs_cli_demo
      InstanceChargeType	付費方式：執行個體按照訂用帳戶的付費方式PrePaid。 說明 您需要確保帳號餘額能夠完成支付。
      PeriodUnit	付費周期單位：Month
      Period	付費時間長度：1
      InternetMaxBandwidthOut	公網IP頻寬：1
      Password	執行個體登入密碼：<yourPassword> 說明 您需要自訂複雜密碼以保護ECS執行個體的安全。
      SystemDisk.Category	系統硬碟類型：cloud_essd
      SystemDisk.Size	系統硬碟大小：40

   2. 請求樣本

      aliyun ecs RunInstances \
      --RegionId cn-hangzhou \
      --ImageId aliyun_3_x64_20G_alibase_20240528.vhd \
      --InstanceType ecs.c7.large \
      --SecurityGroupId sg-bp18z2q1jg4gq95t**** \
      --VSwitchId vsw-bp11hf5r945gewys**** \
      --InstanceName ecs_cli_demo \
      --InstanceChargeType PrePaid \
      --PeriodUnit Month \
      --Period 1 \
      --InternetMaxBandwidthOut 1 \
      --Password <yourPassword>  \
      --SystemDisk.Category cloud_essd \
      --SystemDisk.Size 40

   3. 返回樣本

      { 
              "InstanceIdSets": {
                      "InstanceIdSet": [
                              "i-bp1de173dp87k5uv****"
                      ]
              },
              "OrderId": 23577729747****,
              "RequestId": "B0855F1A-279F-5153-BAA9-C245E073****",
              "TradePrice": ****
      }

串連執行個體

1. 擷取執行個體的公網IP資訊。

   調用DescribeInstances，通過執行個體ID（i-bp1ducce5hs1jm98****）擷取執行個體的公網IP資訊。

   • 請求樣本

     aliyun ecs DescribeInstances \
     --RegionId cn-hangzhou \
     --InstanceIds '["i-bp1ducce5hs1jm98****"]'

   • 返回樣本

     參數PublicIpAddresses為執行個體的公網IP資訊。

     

2. 串連ECS執行個體。

   ssh <使用者名稱>@<公網IP>

   

啟動執行個體

調用StartInstance介面啟動一台ECS執行個體。

• 情境樣本：執行個體ID為i-bp1aq39j2yul5y01****，地區為華東1（杭州）（cn-hangzhou），啟動執行個體時不進行故障處理，並且預檢查後直接啟動ECS執行個體。

• 請求樣本

  aliyun ecs StartInstance \
  --RegionId cn-hangzhou \
  --InstanceId i-bp1aq39j2yul5y01**** \
  --InitLocalDisk false \
  --DryRun false

• 返回樣本

  {
   "RequestId": "2DD09CBD-1F4D-4923-94C7-F3BD67137BBE"
  }

查詢執行個體的詳細資料

您可以調用DescribeInstances介面查詢一台或多台ECS執行個體的詳細資料。

建立快照

調用CreateSnapshot介面建立快照。

• 情境樣本：為ESSD雲端硬碟d-bp14bjlwo3t3owin****建立一個快照（快照名稱為demoname，描述為demo，保留時間：3天）。

• 請求樣本

  aliyun ecs CreateSnapshot \
  --DiskId d-bp14bjlwo3t3owin**** \
  --SnapshotName demoname \
  --Description demo \
  --RetentionDays 3

• 返回樣本

  {
   "RequestId": "DFB0B01F-420D-4932-911E-7328920C2012",
   "SnapshotId": "s-bp1eyr9nxxoo9icj****"
  }

通過執行個體建立自訂鏡像

調用CreateImage介面，基於ECS執行個體建立一個自訂鏡像。

• 情境樣本

  參數	樣本取值
  執行個體ID	i-bp1aq39j2yul5y01****
  作業系統	Alibaba Cloud Linux（即Platform為Aliyun）
  地區	cn-hangzhou

• 請求樣本

  aliyun ecs CreateImage \
  --RegionId cn-hangzhou \
  --InstanceId i-bp1aq39j2yul5y01**** \
  --ImageName demoimage \
  --Description demoimage \
  --Platform Aliyun

• 返回樣本

  {
   "ImageId": "m-bp1503ydxxrppctb****",
   "RequestId": "011AE447-20CE-4043-81AC-7AF2BBC4****"
  }

停止執行個體

調用StopInstance停止一台運行中（Running）的ECS執行個體，順利關機（ForceStop為 false）且停機模式為普通停機模式（StoppedMode為KeepCharging，即停止後仍舊保留執行個體並繼續收費），預檢查後正常停止ECS執行個體。

• 情境樣本：執行個體ID為i-bp1aq39j2yul5y01****，地區為華東1（杭州）（cn-hangzhou）。

• 請求樣本

  aliyun ecs StopInstance \
  --RegionId cn-hangzhou \
  --InstanceId i-bp1aq39j2yul5y01**** \
  --ForceStop false \
  --StoppedMode KeepCharging \
  --DryRun false

• 返回樣本

  {
      "RequestId": "121B5745-4983-57B1-BC97-C3A3536E****"
  }

相關文檔

本樣本僅使用部分API，更多ECS API資訊，請參見API概覽。

在阿里雲CLI中，您可根據需要使用命令列選項，用來修改命令的預設行為或為命令提供額外功能，請參見API命令可用選項。