If you are familiar with network service protocols and one or more programming languages, we recommend that you use ECS API to manage your cloud resources and develop your applications.


Limits are applicable to your use of ECS resources such as instances, Block Storage devices, security groups, snapshots, and public bandwidth. These limits vary with your ECS usage. For more information, see Limits.


ECS API supports HTTP or HTTPS requests. You can use GET and POST methods to send and retrieve requests. You can use the following methods to call ECS API operations. For more examples, see Quick start.

Note When you call an API operation by using Alibaba Cloud CLI or SDKs, remove the periods (.) from request parameters. For example, use SystemDiskCategory instead of SystemDisk.Category as a request parameter.


Term Parameter Description
region RegionId An Alibaba Cloud data center. After a resource is created, you cannot change its region.
zone ZoneId A physical location with independent power grids and networks within a region. Each region includes multiple zones. Zones in the same region can communicate with each other over the internal network with faults isolated. The network latency for ECS instances within the same zone is reduced.
instance InstanceId A virtual machine virtualized from a physical server. It is the basic computing unit of ECS. For more information, see Instance families.
reserved instance ReservedInstanceId A discount coupon that can be applied to the use of pay-as-you-go instances except for preemptible instances and provides a resource reservation for pay-as-you-go instances.
launch template LaunchTemplateId A template that contains configurations that you can use to create instances. A template can include any configurations except for passwords. It can include key pairs, RAM roles, instance types, and network configurations.
auto provisioning group AutoProvisioningGroupId A group used by Auto Provisioning to schedule and maintain computing resources. Auto Provisioning is a service used to quickly deploy an instance cluster composed of preemptible and pay-as-you-go instances. Auto Provisioning facilitates the deployment of instance clusters with specified billing methods, zones, and instance families.
image ImageId A software configuration template that is pre-installed with an operating system. System disks of new instances are copies of images that are used to create the instances. You can use an image to create an instance or change the system disk of an instance.
Block Storage device DiskId A storage device for Alibaba Cloud ECS. Block Storage devices are classified into cloud disks and local disks, based on their performance and application scenarios.
security group SecurityGroupId A virtual firewall that implements access control for one or more ECS instances. An instance must belong to at least one security group.
SSH key pair KeyPairName A combination of a public key file and a private key file. SSH key pairs are used to connect to ECS instances through the SSH protocol and are applicable only to Linux instances.
elastic network interface NetworkInterfaceId A logical networking component in a VPC that represents a virtual network card. Elastic network interfaces (ENIs) can be attached to or detached from ECS instances. ENIs are applicable only to VPC-type ECS instances.
snapshot SnapshotId A stateful data file of a disk at a certain point in time. Snapshots are taken for disks to restore disk data to a specific point in time. Snapshots can be used to restore disk data and create images.
tag Tag.N.Key A key-value pair. You can bind tags to ECS resources for fast filtering and classification.
IP address NatIPAddress The public or private IP address of an ECS instance.
Cloud Assistant CommandId A built-in tool for ECS that provides O&M and deployment services. Cloud Assistant can automatically run batch, PowerShell, or shell scripts on multiple instances at a time, allowing you to perform multiple tasks without establishing individual connections to these instances.