tencent cloud

All product documents
TencentCloud API
DocumentationTencentCloud APIGetting StartedUsing CloudShell
Using CloudShell
Download PDF
Last updated: 2025-03-27 18:00:09
Using CloudShell
Last updated: 2025-03-27 18:00:09
Download PDF
CloudShell is a web-based command line tool that helps you manage Tencent Cloud resources via the command line. You can start CloudShell through the browser, and a Linux management machine will be automatically allocated for you to try for free. This instance comes pre-installed with TCCLI, Terraform, and various cloud management tools, as well as system tools like SSH and VIM.

Features

CloudShell has the following features:

Automatically creating a free virtual machine

When CloudShell starts, a Linux virtual machine will be automatically created for your exclusive use.
When the session is active, the CloudShell instance remains long-term valid. Each logged-in cloud account has administrative privileges equivalent to the operation permissions granted in Cloud Access Management (CAM). Additionally, CloudShell performs security authentication for all logged-in users and achieves user-based virtual machine isolation to ensure the security of the operating environment.

Persistent disk storage space

CloudShell provides 1GB of persistent storage for free (data will be terminated 120 days after the last session) as your /home/cloudshell/data/ directory on the CloudShell instance. All files stored in this directory remain unchanged between different sessions and instances.

Language and tool support

CloudShell instances support multiple languages and pre-installed tools as follows:
Language Support
Language
Version
Java
1.8.0
Go
1.13.8
Python2
2.7.17
Python3
3.6.9
Node.js
14.17.2
PHP
7.2.24
Ruby
2.5.1
C++
7.5.0
C#
5.0.205
Tool Support
Type
Tool Name
Version No.
Linux Utility
telnet
0.17
tmux
2.6
wget
1.19.4
ssh
7.6
curl
7.58.0
bash
4.4.20
ping
1.9.4
Tencent Cloud Tools
tccli
3.0.469.1
Online Editor
vim
8.0
nano
2.9.3
emacs
26.3
Source Code Management
git
2.17.1
Build and Packaging Tools
pip
9.0.1
nvm
0.38.0
gcc
7.5.0
dotnet
5.0.205
make
4.1
maven
3.6.0
cmake
3.10.2
npm
6.14.13
Orchestration tool
terraform
1.0.3
ansible
2.11.2
Container Tools
docker
20.10.7
kubectl
1.21.3
Database Tools
mysql client
14.14

Use Limits

Before using CloudShell, please understand the following usage restrictions:
Restriction Item
Description
Number of virtual machines
No matter how many session windows are opened, CloudShell will only create one virtual machine at a time, and all session windows will automatically connect to this virtual machine.
Session Window
Up to 5 session windows can be opened.
Cloud File Storage
CloudShell provides you with 1GB of free permanent storage space. You can store your files in the /home/cloudshell/data/ directory, and the data will be retained for 120 days (after the end of the last session).
Prohibited Use
Long-term use and compute or network intensive malicious processes will not be supported and may result in session termination or even disablement without any warning.
Machine Termination
If you have no command line session operations for 30 minutes, it will be considered stopped, and the machine will be terminated 30 minutes after stopping. When you use CloudShell again, a Linux machine will be reallocated.
Access Restrictions
CloudShell is a debugging tool for users, only supporting public domain access. Intranet access to other services except TencentCloud API is not supported.
COS Access Restrictions
Issues: The following similar errors may occur when accessing COS:



Reason: The domain name for accessing the COS service is resolved to the 169.254 segment, which has been disabled in CloudShell for security reasons.

Usage

Starting CloudShell

You can start CloudShell in the following two ways:
Run Through Console
Run Independently
Log in to the CVM Console, select Tool > CloudShell at the top of the page to start CloudShell. As shown below:

You can run CloudShell independently in the following ways:
Enter API Explorer, select the corresponding API, and click debug code in the code example. As shown below:

Note:
When you connect to CloudShell for the first time, a virtual machine will be created for you, which will take some time. When you open multiple CloudShell windows, all windows will connect to the same virtual machine. The number of virtual machines will not increase because you open new command line windows.
You can open multiple CloudShell windows as needed, but you can open up to 5 windows simultaneously.

Managing Cloud Resources Using TCCLI Command

You can refer to the following examples to manage cloud resources using Tencent Cloud TCCLI commands in CloudShell. For more information on using TCCLI, see Using TCCLI.
Execute the following command to view cloud product help information.
tccli <ProductCode> help
For example, execute the following command to view the APIs supported by Cloud Virtual Machine (CVM).
tccli cvm help
Execute the following command to view execute API help information.
tccli <ProductCode> <ApiName> help
For example, execute the following command to view the parameters supported by the DescribeInstances API of Cloud Virtual Machine (CVM). Detailed parameter descriptions and API information can be found in the corresponding API documentation on the Tencent Cloud Official Website.
tccli cvm DescribeInstances help

Related Documentation

Uploading and downloading file

CloudShell provides file upload and download features. You can transmit files through the CloudShell interface by following these steps:
1. Refer to Run Through Console to start CloudShell and open the CloudShell interface.
2. Select

at the top of the CloudShell interface. As shown below:

3. Select Upload or Download to transmit files as needed.
Upload file: In the pop-up window, select the file and click Open.
Download file: In the pop-up window, enter the absolute path of the file to be downloaded and click OK.
Note:
The upload file feature will default upload your files to the /home/cloudshell/data/ directory of the CloudShell instance. And you can only download files in the /home/cloudshell/data/ directory of the CloudShell instance.


Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon