Tüm Ürünler
Search
Belge Merkezi

Elastic Compute Service:Create and use an ECS instance with the CLI

Son Güncelleme:Sep 30, 2026

Alibaba Cloud Command Line Interface (CLI), OpenAPI işlemlerini çağırarak terminalinizden Alibaba Cloud kaynaklarını yönetmenizi sağlayan bir araçtır. Bu konu, Alibaba Cloud CLI kullanarak bir ECS örneği oluşturmak ve yönetmek için örnekler sunar.

Not

Alibaba Cloud CLI hakkında daha fazla bilgi için bkz. Alibaba Cloud CLI nedir?.

Başlamadan önce

  1. Bir Alibaba Cloud hesabı tüm kaynaklar üzerinde tam yetkilere sahip olduğundan, hesap AccessKey bilgilerinin sızdırılması yüksek güvenlik riski oluşturur. Yalnızca gereken minimum izinlere sahip olan bir RAM kullanıcısının AccessKey bilgilerini kullanmanızı öneririz. Daha fazla bilgi için bkz. AccessKey oluşturma.

  2. RAM kullanıcısına ECS ve VPC kaynaklarını yönetmek için gerekli izinleri verin. Bu konudaki örnek kod; örnekler, VPC'ler ve vSwitch'ler gibi kaynaklar oluşturur. Aşağıdaki izinleri atamanızı öneririz:


    Cloud hizmeti


    İzin


    VPC


    Sistem ilkesini ekleyin: AliyunVPCFullAccess


    ECS


    Sistem ilkesini ekleyin: AliyunECSFullAccess

  3. CLI'yı yükleyin ve yapılandırın. Alibaba Cloud CLI Windows, Linux ve macOS için kullanılabilir. İşletim sisteminize uygun kurulum yöntemini seçin:

    1. CLI'yı yükleyin.

    2. CLI'yı yapılandırın.

      Alibaba Cloud kaynaklarını çağırmak için gereken kimlik bilgilerini ve hizmet isteği bölgesini yapılandırın. Daha fazla bilgi için bkz. Kimlik bilgilerini yapılandırma.

    Yalnızca geçici olarak hata ayıklama yapmanız gerekiyor ve Alibaba Cloud CLI'yı yüklemek istemiyorsanız Cloud Shell kullanabilirsiniz. Daha fazla bilgi için bkz. Cloud Shell nedir? Cloud Shell'i başlatmak için Alibaba Cloud konsolunda oturum açın ve üst gezinme çubuğundaki Tickets öğesinin sağ tarafındaki Cloud Shell simgesine (terminal simgesi) tıklayın.

Bir ECS örneği oluşturun

Bir ECS örneği oluşturmak için bir vSwitch ID, güvenlik grubu ID ve görüntü ID gibi parametreler gerekir. Mevcut kaynak ID'lerini kullanabilir veya aşağıdaki adımlardaki işlemleri çağırarak yeni olanları oluşturabilirsiniz.

  1. Bir VPC oluşturun.

    VPC, cloud kaynaklarınız için mantıksal olarak izole edilmiş özel bir ağdır.

    API

    Parametre

    Değer

    CreateVpc

    RegionId

    Bölge: cn-hangzhou

    CidrBlock

    VPC CIDR bloğu: 192.168.0.0/16

  2. Bir vSwitch oluşturun.

    vSwitch, bir VPC içindeki farklı cloud kaynaklarını bağlayan temel bir ağ cihazıdır.

    API

    Parametre

    Değer

    RegionId

    Bölge: cn-hangzhou

    CreateVSwitch

    ZoneId

    Alan: cn-hangzhou-i

    VpcId

    VPC ID: vpc-bp1aag0sb9s4i92i3****

    CidrBlock

    vSwitch CIDR bloğu: 192.168.0.0/24

  3. Bir güvenlik grubu oluşturun.

    Güvenlik grubu, ECS örneklerinize gelen ve giden trafiği kontrol eden sanal bir güvenlik duvarıdır.

    API

    Parametre

    Değer

    CreateSecurityGroup

    RegionId

    Bölge: cn-hangzhou

    VpcId

    VPC ID: vpc-bp1aag0sb9s4i92i3****

  4. Güvenlik grubuna gelen bir kural ekleyin.

    API

    Parametre

    Değer

    AuthorizeSecurityGroup

    RegionId

    Bölge: cn-hangzhou

    SecurityGroupId

    Güvenlik grubu ID: sg-bp1esyhwfbqeyudt****

    IpProtocol

    Protokol: tcp

    SourceCidrIp

    Kaynak CIDR bloğu: 0.0.0.0/0

    PortRange

    Bağlantı noktası aralığı:

    • Linux örnekleri için: 22/22

    • Windows örnekleri için: 3389/3389

  5. Bir ECS örneği oluşturun.

    API

    Parametre

    Değer

    RunInstances

    RegionId

    Bölge: cn-hangzhou

    ImageId

    Görüntü: Alibaba Cloud Linux görüntüsünü kullanın aliyun_3_x64_20G_alibase_20240819.vhd

    InstanceType

    Örnek türü: ecs.e-c1m1.large

    SecurityGroupId

    Güvenlik grubu ID: sg-bp1esyhwfbqeyudt****

    VSwitchId

    vSwitch ID: vsw-bp1nzprm8h7mmnl8t****

    InstanceName

    Örnek adı: ecs_cli_demo

    InstanceChargeType

    Kullandıkça öde bir örnek oluşturmak için PostPaid olarak ayarlayın.

    Not

    Hesabınızda yeterli bakiye bulunduğundan emin olun.

    Password

    Oturum açma parolası:

    InternetMaxBandwidthOut

    Bu değer 0'dan büyükse, örneğe otomatik olarak bir genel IP adresi atanır.

    SystemDisk.Category

    Sistem diski kategorisi: cloud_essd

    SystemDisk.Size

    Sistem diski boyutu: 40 GiB

Aşağıda tam örnek komut dosyası verilmiştir:

Önemli

Bu örnek komut dosyasını birden çok kez çalıştırmak yinelenen kaynaklar oluşturur ve gereksiz maliyetlere yol açabilir. Çalıştırmadan önce komut dosyasını gözden geçirin ve özel ihtiyaçlarınıza göre uyarlayın.

#!/bin/bash
# In a production environment, make sure that your AccessKey ID and AccessKey secret
# are securely set by using environment variables or a configuration file.
# 1. Set variables.
INSTANCE_NAME="ecs_cli_demo"
# 2. Install the jq tool.
echo "Installing the jq dependency tool..."
yum install -y jq
sleep 3
# 3. Create a VPC, vSwitch, and security group.
echo "Creating a VPC..."
VpcId=$(aliyun vpc CreateVpc --RegionId cn-hangzhou --CidrBlock 192.168.0.0/16 | jq -r .VpcId)
aliyun vpc DescribeVpcAttribute --RegionId cn-hangzhou --VpcId ${VpcId} --waiter expr='Status' to=Available > /dev/null 2>&1
echo "Creating a vSwitch..."
VSwitchId=$(aliyun vpc CreateVSwitch --CidrBlock 192.168.0.0/24 --VpcId ${VpcId} --ZoneId=cn-hangzhou-i | jq -r .VSwitchId)
echo "Creating a security group..."
SecurityGroupId=$(aliyun ecs CreateSecurityGroup --RegionId cn-hangzhou --VpcId ${VpcId} | jq -r .SecurityGroupId)
aliyun ecs AuthorizeSecurityGroup --RegionId cn-hangzhou --SecurityGroupId ${SecurityGroupId} --IpProtocol tcp --SourceCidrIp 0.0.0.0/0 --PortRange 22/22 > /dev/null 2>&1
read -s -p "Enter your password:" PASSWORD
echo
echo "PASSWORD OK."
# 4. Run the command to create an ECS instance.
echo "Creating the ECS instance..."
INSTANCE_ID_RAW=$(aliyun ecs RunInstances \
--RegionId cn-hangzhou \
--ImageId aliyun_3_x64_20G_alibase_20240819.vhd \
--InstanceType ecs.e-c1m1.large \
--SecurityGroupId ${SecurityGroupId} \
--VSwitchId ${VSwitchId} \
--InstanceName $INSTANCE_NAME \
--InstanceChargeType PostPaid \
--InternetMaxBandwidthOut 1 \
--Password $PASSWORD  \
--SystemDisk.Category cloud_essd \
--SystemDisk.Size 40)
# 5. Extract the instance ID for later use.
INSTANCE_ID=$(echo "$INSTANCE_ID_RAW" | jq -r '.InstanceIdSets.InstanceIdSet[]')
# 6. Wait for 20 seconds for the ECS instance to be created.
echo "Waiting for the ECS instance to be created..."
sleep 20
# 7. Query the ECS instance status.
echo "Querying the ECS instance status..."
INSTANCE_ID_QUOTED=$(printf '"%s"' "$INSTANCE_ID")
aliyun ecs DescribeInstances \
--RegionId cn-hangzhou \
--InstanceIds "[${INSTANCE_ID_QUOTED}]" \
--output cols=InstanceId,InstanceName,InstanceType,ImageId,Status rows=Instances.Instance[]

Shell komut dosyasını oluşturun ve çalıştırın. Beklenen çıktı aşağıdaki gibidir:

[root@i-xxxxx Z ~]# bash ecs-cli.sh
Installing the jq dependency tool...
Last metadata expiration check: 0:24:56 ago on Tue 22 Oct 2024 09:24:50 AM CST.
Package jq-1.6-15.al8.x86_64 is already installed.
Dependencies resolved.
Nothing to do.
Complete!
Creating a VPC...
Creating a vSwitch...
Creating a security group...
Enter your password:
PASSWORD OK.
Creating the ECS instance...
Waiting for the ECS instance to be created...
Querying the ECS instance status...
InstanceId          | InstanceName | InstanceType     | ImageId                               | Status
----------          | ------------ | ------------     | -------                               | -------
i-bpxxxxxxxxxxxz4   | ecs_cli_demo | ecs.e-c1m1.large | aliyun_3_x64_20G_alibase_20240819.vhd | Running

Örneğe bağlanın

SSH ile örneğe bağlandıktan sonra hizmetlerinizi ve uygulamalarınızı dağıtabilirsiniz.

  1. Örneğin genel IP adresini alın.

    Örneğin genel IP adresini elde etmek için <InstanceID> ile DescribeInstances işlemini çağırın.

    • Örnek istek

      aliyun ecs DescribeInstances \
      --RegionId cn-hangzhou \
      --InstanceIds '["<instance-id>"]'
    • Örnek yanıt

      PublicIpAddress parametresi örneğin genel IP adresini gösterir.

      "PublicIpAddress": {
          "IpAddress": [
                          "115.29.xxx.xxx"
          ]
      }
  2. ECS örneğine bağlanın.

    ssh <username>@<public_ip_address>
    [root@i-xxx bfZ ~ ]# ssh root@1xx.xx.xx.xx
    The authenticity of host '1xx.xx.xx.xx (1xx.xx.xx.xx)' can't be established.
    ECDSA key fingerprint is SHA256:PVyhCaxxx4mecykrU.
    Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
    Warning: Permanently added '1xx.xx.xx.xx' (ECDSA) to the list of known hosts.
    root@1xx.xx.xx.xx's password:
    Welcome to Alibaba Cloud Elastic Compute Service !
    Last login: Thu Oct 10 13:31:58 2024 from xxx.67
    [root@iZ xxx ugZ ~]#

Kaynakları temizleyin

Kaynaklara artık ihtiyacınız olmadığında ek ücretlerden kaçınmak için bunları serbest bırakın.

Not

Kaynakları serbest bırakmak için uygun OpenAPI işlemini seçin. Bu örnekte önceki adımlarda oluşturulan tüm kaynaklar serbest bırakılır.

  1. ECS örneğini silin.

    API

    Parametre

    Değer

    DeleteInstance

    RegionId

    Bölge: cn-hangzhou

    InstanceId

    Örnek ID: i-bp17f3kzgtzzj91r****

  2. Güvenlik grubunu silin.

    API

    Parametre

    Değer

    DeleteSecurityGroup

    RegionId

    Bölge: cn-hangzhou

    SecurityGroupId

    Güvenlik grubu ID: sg-bp1esyhwfbqeyudt****

  3. vSwitch'i silin.

    API

    Parametre

    Değer

    DeleteVSwitch

    RegionId

    Bölge: cn-hangzhou

    VSwitchId

    vSwitch ID: vsw-bp1nzprm8h7mmnl8t****

  4. VPC'yi silin.

    API

    Parametre

    Değer

    DeleteVpc

    RegionId

    Bölge: cn-hangzhou

    VpcId

    VPC ID: vpc-bp1aag0sb9s4i92i3****

Aşağıda örnek bir komut dosyası verilmiştir:

#!/bin/bash
# Replace the placeholder values with the actual IDs of the resources you want to release.
INSTANCE_ID='i-bpxxxxxxxxxxxz4'
SECURITY_GROUP_ID='sg-bp1esyhwfbqeyudt****'
VSWITCH_ID='vsw-bp1nzprm8h7mmnl8t****'
VPC_ID='vpc-bp1aag0sb9s4i92i3****'
REGION='cn-hangzhou'
echo "Releasing resources..."
# Delete the instance.
aliyun ecs DeleteInstance \
  --region ${REGION} \
  --InstanceId ${INSTANCE_ID}
# Wait for the instance to be deleted before deleting the security group.
# Add a wait logic here in a production script.
# Delete the security group.
aliyun ecs DeleteSecurityGroup \
  --region ${REGION} \
  --SecurityGroupId ${SECURITY_GROUP_ID}
# Delete the vSwitch.
aliyun vpc DeleteVSwitch \
  --region ${REGION} \
  --VSwitchId ${VSWITCH_ID}
# Delete the VPC.
aliyun vpc DeleteVpc \
  --region ${REGION} \
  --VpcId ${VPC_ID}
echo "Cleanup complete."
            

Başvurular

ECS için desteklenen CLI komutlarının listesini görüntülemek için aşağıdaki komutu çalıştırabilirsiniz.

aliyun ecs --help

ECS API işlemlerini çağırmak için aşağıdaki sözdizimini kullanın. Ayrıntılı parametreler için her işlemle ilgili belgelere bakın.

aliyun ecs <APIName> --<parameter1 value1> --<parameter2 value2> ...

CLI komutu oluşturun

Geliştiricilerin cloud hizmeti OpenAPI'lerini hızlı ve verimli bir şekilde öğrenmesine ve kullanmasına yardımcı olmak için Alibaba Cloud, OpenAPI web sitesini sağlar. Akıllı OpenAPI araması, belgeler, çevrimiçi hata ayıklama, SDK edinimi, kod örnekleri, çağrı hatası tanılama ve çağrı istatistiklerini entegre eden kapsamlı bir üründür. API'ler için CLI kodunu otomatik olarak oluşturmak üzere OpenAPI web sitesini kullanabilirsiniz. Daha fazla bilgi için bkz. OpenAPI nedir.

  1. ECS için OpenAPI Portalı adresinde oturum açın.

  2. Gerekli API işlemini seçin ve parametreleri doldurun.

  3. Belirtilen parametrelerle komutu oluşturmak için sağ taraftaki CLI Example sekmesini tıklayın.

    Örneğin, StartInstance API işlemini seçtikten ve parametreleri girdikten sonra CLI Example sekmesi ilgili komutu oluşturur: aliyun ecs StartInstance --region cn-hangzhou --InstanceId 'i-bp1i79spj7zmoqg****'.