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

Elastic Compute Service:Alibaba Cloud CLIを使用したECSインスタンスの作成と管理

最終更新日:Aug 13, 2024

Alibaba Cloud CLIを定期的に使用してAlibaba Cloudリソースを管理する場合、Cloud Shellを使用して、Alibaba Cloud CLIを使用してElastic Compute Service (ECS) インスタンスを作成および管理できます。 このトピックでは、Alibaba Cloud CLIを使用してECSインスタンスを作成および管理する方法と例について説明します。

CLI使用量

  1. Cloud Shellクライアントにアクセスします。

    Alibaba Cloud管理コンソールからCloud Shellクライアントにアクセスする

    ECSコンソールにログインし、右上隅にあるCloud ShellアイコンをクリックしてCloud Shellコンソールに移動します。

    Cloud Shell

    オンプレミス端末からCloud Shellクライアントにアクセスする

    1. CLIのインストール

    2. Alibaba CloudアカウントにアクセスするためのCLI権限を付与します。

      この例では、AccessKeyペアベースの認証が使用されます。 その他の認証方法については、「資格情報の設定」をご参照ください。

      説明
      • リージョンについては、「リージョンとゾーン」をご参照ください。

      • AccessKey ペアは、AccessKey ID と AccessKey Secret で構成されます。 AccessKeyペアの取得方法については、「AccessKeyペアの作成」をご参照ください。

      aliyun configure
      aliyun Access Key ID [None]: xxxxx  # AccessKey ID
      aliyun Access Key Secret [None]: xxxxx  # AccessKey Secret
      Default Region Id [None]: cn-hangzhou # The region ID.
      Default Output Format [json]: json (Only supports JSON) # Only the JSON format is supported.
      Default Language [zh|en]: en # Select English as the default language.

      設定を完了すると、設定された資格情報が有効な場合、次の情報が表示されます。

      Configure Done!!!
      ..............888888888888888888888 ........=8888888888888888888D=..............
      ...........88888888888888888888888 ..........D8888888888888888888888I...........
      .........,8888888888888ZI: ...........................=Z88D8888888888D..........
      .........+88888888 ..........................................88888888D..........
      .........+88888888 .......Welcome to use Alibaba Cloud.......O8888888D..........
      .........+88888888 ............. ************* ..............O8888888D..........
      .........+88888888 .... Command Line Interface(Reloaded) ....O8888888D..........
      .........+88888888...........................................88888888D..........
      ..........D888888888888DO+. ..........................?ND888888888888D..........
      ...........O8888888888888888888888...........D8888888888888888888888=...........
      ............ .:D8888888888888888888.........78888888888888888888O ..............
  2. Alibaba Cloud CLIでは、API操作を呼び出して、次の形式要件に基づいてタスクを完了できます。

    重要
    • さまざまなデータ型のフィールドでサポートされている形式については、「パラメーター形式」をご参照ください。

    • API操作を呼び出す前に、API操作の手順を読むことをお勧めします。

    aliyun <product> <ApiName>
    -- parameter1 value1 \
    -- parameter2 value2 \
    ... 

サンプルCLI要求

重要
  • 次のサンプルリクエストは参考用です。 ビジネス要件に基づいてリクエストコマンドを変更します。

  • ECS APIの操作については、「APIリファレンス」をご参照ください。

ECSインスタンスの作成

次の例では、Alibaba Cloud CLIを使用して、中国 (杭州) リージョンのAlibaba Cloud LinuxイメージからサブスクリプションECSインスタンスを作成する方法を説明します。

  1. 準備をします。

    ECSインスタンスを作成する前に、仮想プライベートクラウド (VPC) 、vSwitch、およびセキュリティグループを作成し、上記のリソースのIDを取得します。

    説明

    上記のリソースを既に作成し、リソースが要件を満たしている場合は、この手順をスキップしてください。

    1. CreateVpc操作を呼び出してVPCを作成します。

      例: VPCの作成

      この例では、VPCは中国 (杭州) リージョンに作成され、CIDRブロック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にvSwitchを作成します。

      例: vSwitchの作成

      この例では、vSwitchのCIDRブロックは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操作を呼び出して、セキュリティグループルールを追加します。

      例: セキュリティグループルールの追加

      この例では、ポート22のTCPトラフィックを許可するインバウンドセキュリティグループルールが、IDがsg-bp18z2q1jg4gq95t **** のセキュリティグループに追加されます。

      • コマンド

        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. RunInstances操作を呼び出して、サブスクリプションECSインスタンスを作成します。

    • シナリオ例

      パラメーター

      説明と例

      RegionId

      ECSインスタンスを作成するリージョンのID。 例: cn-hangzhou

      ImageId

      イメージの ID です。 IDがaliyun_3_x64_20G_alibase_20240528.vhdのAlibaba Cloud Linuxイメージを選択することを推奨します。

      InstanceType

      インスタンスタイプです。 例:

      • パーソナルアプリケーションの場合、2 vCPUと2 GiBのメモリを持つecs.e-c1m1.largeインスタンスタイプを選択することを推奨します。

      • 中小企業のアプリケーションでは、2 vCPUと4 GiBのメモリを持つecs.c7.largeインスタンスタイプを選択することを推奨します。

      SecurityGroupId

      セキュリティグループ ID です。 CreateSecurityGroup操作の応答から値を取得します。

      例: sg-bp18z2q1jg4gq95t ****

      VSwitchId

      vSwitch ID。 CreateVSwitch操作の応答から値を取得します。

      例: vsw-bp11hf5r945gewysp ****

      InstanceName

      ECSインスタンスの名前。

      例: ecs_cli_demo

      InstanceChargeType

      ECSインスタンスの課金方法。 サブスクリプションECSインスタンスを作成するには、値をPrePaidに設定します。

      説明

      アカウントの残高が十分であることをご確認ください。

      PeriodUnit

      サブスクリプション期間の単位。 例:

      Period

      サブスクリプション期間です。 例: 1

      InternetMaxBandwidthOut

      最大アウトバウンドパブリック帯域幅です。 例: 1

      Password

      ECSインスタンスのログインパスワード。 例: <yourPassword>

      説明

      インスタンスのセキュリティを確保するには、複雑なパスワードを指定する必要があります。

      SystemDisk.Category

      システムディスクのカテゴリ。 例: cloud_essd。

      SystemDisk.Size

      システムディスクのサイズ。 例: 40。

    • コマンド

      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
    • コマンド出力

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

ECSインスタンスへの接続

  1. 操作を呼び出して、ECSインスタンスのパブリックIPアドレスを取得できます。

    この例では、DescribeInstances操作を呼び出して、IDがi-bp1ducce5hs1jm98 **** であるECSインスタンスのパブリックIPアドレスを取得します。

    • コマンド

      aliyun ecs DescribeInstances \
      --RegionId cn-hangzhou \
      --InstanceIds '["i-bp1ducce5hs1jm98****"]'
    • コマンド出力

      PublicIpAddressesパラメーターは、ECSインスタンスのパブリックIPアドレスを示します。

      公网IP

  2. Windows ECSインスタンスに接続します。

    ssh <Username>@<Public IP address>

    ssh登录

ECSインスタンスの起動

StartInstance操作を呼び出して、ECSインスタンスを起動します。

  • 例: ドライラン後に中国 (杭州) (cn-Hangzhou) リージョンでIDがi-bp1aq39j2yul5y01 **** であるECSインスタンスを起動し、インスタンスの起動中にトラブルシューティングを実行しないでください。

  • コマンド

  • aliyun ecs StartInstance \
    --RegionId cn-hangzhou \
    --InstanceId i-bp1aq39j2yul5y01**** \
    --InitLocalDisk false \
    --DryRun false
  • コマンド出力

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

ECSインスタンスの詳細の照会

DescribeInstancesを呼び出して、1つ以上のECSインスタンスの詳細を照会します。

例1: インスタンスIDによるECSインスタンスの照会

この例では、IDがi-bp14a7xie8erwsvo **** であるECSインスタンスに関する情報が照会されます。

  • コマンド

    aliyun ecs DescribeInstances \
    --RegionId cn-hangzhou \
    --InstanceIds '["i-bp14a7xie8erwsvo****"]' \
    --output cols=InstanceId,InstanceName,Description,ImageId,Status rows=Instances.Instance[]
  • コマンド出力

    InstanceId             | InstanceName | Description | ImageId                               | Status
    ----------             | ------------ | ----------- | -------                               | ------
    i-bp1de173dp87k5uv**** | ecs_cli_demo |             | aliyun_3_x64_20G_alibase_20240528.vhd | Running

例2: タグによるECSインスタンスの照会

この例では、owner:zhangsanタグが追加されたECSインスタンスに関する情報が照会されます。

  • コマンド

    aliyun ecs DescribeInstances \
    --RegionId cn-hangzhou \
    --Tag.1.Key owner \
    --Tag.1.Value zhangsan \
    --output cols=InstanceId,InstanceName,Description,ImageId,Status rows=Instances.Instance[]
  • コマンド出力

    InstanceId             | InstanceName | Description | ImageId                               | Status
    ----------             | ------------ | ----------- | -------                               | ------
    i-bp1de173dp87k5uv**** | ecs_cli_demo |             | aliyun_3_x64_20G_alibase_20240528.vhd | Running

例3: イメージIDによるECSインスタンスの照会

この例では、イメージがm-bp12qhgxbmp5eh02 **** タグを持つECSインスタンスに関する情報が照会されます。

  • コマンド

    aliyun ecs DescribeInstances \
    --RegionId cn-hangzhou \
    --ImageId m-bp12qhgxbmp5eh02**** \
    --output cols=InstanceId,InstanceName,Description,ImageId,Status rows=Instances.Instance[]
  • コマンド出力

    InstanceId             | InstanceName | Description | ImageId                | Status
    ----------             | ------------ | ----------- | -------                | ------
    i-bp14a7xie8erwsvo**** | demo01       | desc01      | m-bp12qhgxbmp5eh02**** | Running
    i-bp1aq39j2yul5y01**** | demo02       | desc02      | m-bp12qhgxbmp5eh02**** | Stopped

例4: 特定のVPC内のECSインスタンスの照会

この例では、IDがvpc-bp1vwnn14rqpyiczj **** であるVPCに存在し、IDがvsw-bp1ddbrxdlrcbim46 **** であるvSwitchに接続されているECSインスタンスに関する情報が照会されます。

  • コマンド

    aliyun ecs DescribeInstances \
    --RegionId cn-hangzhou \
    --VpcId vpc-bp1vwnn14rqpyiczj**** \
    --VSwitchId vsw-bp1ddbrxdlrcbim46**** \
    --output cols=InstanceId,InstanceName,ImageId,Status rows=Instances.Instance[]
  • コマンド出力

    InstanceId             | InstanceName | ImageId                               | Status
    ----------             | ------------ | -------                               | ------
    i-bp14a7xie8erwsvo**** | namedemo01   | m-bp12qhgxbmp5eh02****                | Running
    i-bp1c271nqm264lwj**** | namedemo02   | P2VSImageLnx125                       | Running
    i-bp18a6ub0vt1tvn1**** | namedemo03   | aliyun_3_x64_20G_alibase_20240528.vhd | Running
    i-bp1aq39j2yul5y01**** | namedemo04   | m-bp12qhgxbmp5eh02****                | Stopped

例5: ページによるECSインスタンスの照会

DescribeInstancesを呼び出して、中国 (杭州) リージョンのECSインスタンスをページごとに照会します。 各ページは5つのエントリを表示する。

  • コマンド

    aliyun ecs DescribeInstances \
    --RegionId cn-hangzhou \
    --PageNumber 2 \
    --PageSize 5 \
    --output cols=InstanceId,InstanceName,ImageId,Status rows=Instances.Instance[]
  • コマンド出力

    InstanceId             | InstanceName | ImageId                                 | Status
    ----------             | ------------ | -------                                 | ------
    i-bp1akazu9o0rm7q0**** | demoname01   | centos_8_0_x64_20G_alibase_20191225.vhd | Running
    i-bp134jm1g6kqyiqu**** | demoname02   | m-bp1bc3g3b032o0ja****                  | Running
    i-bp17qwke5y0v7hk2**** | demoname03   | centos_7_02_64_20G_alibase_20170818.vhd | Running
    i-bp18a6ub0vt1tvn1**** | demoname04   | centos_7_02_64_20G_alibase_20170818.vhd | Running
    i-bp1aq39j2yul5y01**** | demoname05   | m-bp12qhgxbmp5eh02****                  | Stopped

ディスクのスナップショットの作成

特定のディスクに基づいてスナップショットを作成するには、CreateSnapshot操作を呼び出します。

  • シナリオ例: IDがd-bp14bjlwo3t3owin **** であるエンタープライズSSD (ESSD) のスナップショットを作成します。 スナップショット名をdemonameに、説明をデモに、保持期間を3日に設定します。

  • コマンド

    aliyun ecs CreateSnapshot \
    --DiskId d-bp14bjlwo3t3owin**** \
    --SnapshotName demoname \
    --Description demo \
    --RetentionDays 3
  • コマンド出力

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

ECSインスタンスからのカスタムイメージの作成

CreateImage操作を呼び出して、ECSインスタンスからカスタムイメージを作成します。

  • シナリオ例: IDがi-bp1aq39j2yul5y01 **** で、Alibaba Cloud Linux (Aliyunに設定されたプラットフォーム) を実行し、中国 (杭州) (cn-Hangzhou) リージョンにデプロイされているECSインスタンスからカスタムイメージを作成します。

  • コマンド

    aliyun ecs CreateImage \
    --RegionId cn-hangzhou \
    --InstanceId i-bp1aq39j2yul5y01**** \
    --ImageName demoimage \
    --Description demoimage \
    --Platform Aliyun
  • コマンド出力

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

ECSインスタンスの停止

ForceStopパラメーターがfalseに設定され、StoppedModeパラメーターがKeepCharingに設定されているStopInstance操作を呼び出して、ドライラン後に実行中 (実行中) 状態のECSインスタンスを停止します。 ECSインスタンスが標準モードで停止し、ECSインスタンスの課金が継続されます。

  • シナリオ例: 中国 (杭州) (cn-Hangzhou) リージョンでIDがi-bp1aq39j2yul5y01 **** であるECSインスタンスを停止します。

  • コマンド

    aliyun ecs StopInstance \
    --RegionId cn-hangzhou \
    --InstanceId i-bp1aq39j2yul5y01**** \
    --ForceStop false \
    --StoppedMode KeepCharging \
    --DryRun false
  • コマンド出力

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