Welcome to Cloud Virtual Machine (CVM).
Tencent Cloud CVM runs in Tencent IDC and provides scalable computing service. You can build and host software systems based on your business requirements.
CVM provides you with elastic computing, storage, and network resources. This document describes APIs for CVMs, and provides samples to create, terminate, and restart CVM instances and adjust bandwidth for them. For a full list of supported operations, see API Overview.
Please read CVM Overview before using these APIs.
Notes:
- All CVM APIs described here have been upgraded to API 3.0. All new CVM-related features will be added to these APIs.
Below is the list of common terms used in this document:
Term | Description |
---|---|
Instance | A cloud virtual machine, see Instance |
Region | A region where resources reside. Each region contains one or more availability zones. See Region |
Zone | Tencent Cloud physical IDCs in the same region with independent power and network resources. They are designed to ensure that the failures within an availability zone can be isolated without spreading to and affecting other zones, so as to ensure your business stability. See Availability Zone |
Image | A copy of the software environment on a CVM instance, generally including operating systems and installed software. It is used to create an instance. See Image |
Security Group | A type of virtual firewall with a state-based packet filtering feature. It is an important network security isolation method to control the network access of CVM instances. See Security Group |
EIP | A type of public IP. Unlike an ordinary public IP, an elastic IP belongs to a user account rather than an instance. The mapping relationship between an instance and a public IP address can be changed at any time. See EIP |
Monthly subscription | A billing method. For more information, see Billing Methods. |
Pay as you go | A billing method. For more information, see Billing Methods. |
Limit
and Offset
These parameters are used for paging control.
Limit
indicates the maximum number of entries returned at a time, andOffset
is the offset value. If the number of results exceeds theLimit
, the number of returned results equals to the value ofLimit
.For example, if Offset=0&Limit=20, the 0th to 19th entries are returned; if Offset=20&Limit=20, the 20th to 39th entries are returned; if Offset=40&Limit=20, the 40th to 59th entries are returned, and so on.
Ids.N
Format for entering multiple parameters at a time. Multiple parameters can be passed in at the same time in this form. For example:
GET request or POST x-www-form-urlencoded request: Ids.0=ins-r8hr2upy&Ids.1=ins-5d8a23rs&Ids.2=ins--dcs9x3gz
The others can be done in the same manner (starting with
0
).POST json request: {"Ids": ["ins-r8hr2upy", "ins-5d8a23rs", "ins-dcs9x3gz"]}
The following describes some typical use cases for CVM APIs:
Create a pay-as-you-go instance by using the RunInstances API and providing information like availability zone ID, image ID, model and other parameters.
Upgrade the configuration of an instance using the ResetInstancesType API. You can change CPU and memory by adjusting instance models.
Shut down an instance using the StopInstances API.
If you do not want to use an instance anymore, you can terminate it using the TerminateInstances API. No more fees will be incurred once the instance is terminated.
The CVM instances created via the API are subject to the number limit described in the Restrictions on CVM Instance Purchase, and share the quota with those created in the console.
For information on specific limits, see documents for corresponding APIs or products.
Was this page helpful?