Create and manage instances - Cloud Phone - Alibaba Cloud Documentation Center

This topic describes how to create and manage Cloud Phone instances, including how to install applications and assign instances to end users.

Create an instance

Prerequisites

You have created a Cloud Phone instance group. For more information, see Create an instance group.

Procedure

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, click Create Instance.

In the Create Instance dialog box, set the following parameters and click Create Now.

Parameter	Description	Example
Creation Method	Options: Create in an existing instance group Create a new instance group If you select this option, click Create Now. You are then redirected to the page for creating an instance group.	Create in an existing instance group
Instance Group	This parameter is displayed when you create instances in an existing instance group. Select an existing instance group.	DemoGroup
Number Of Instances	This parameter is displayed when you create instances in an existing instance group. Enter the number of instances to create.	1

Perform one of the following operations:
- If you chose to create a new instance group, you are redirected to the instance group creation page. Create the instance group. For more information, see Create an instance group.
- If you chose to create instances in an existing instance group, you are redirected to the instance group scale-out page. Scale out the instance group. For more information, see Scale out an instance group.
You can view the latest status of the instances on the Instances page.

Manage instance views

The Instances page is where you manage your instances. It supports a list view and a card view. You can switch between and customize the views as needed.

List view
The list view is the default view. In this view, you can customize the visibility and order of columns.
1. Log on to the Cloud Phone console.
2. In the left-side navigation pane, choose Manage Resource > Instance.
3. Click the icon in the upper-right corner of the Instances page.
4. In the Customize List dialog box, drag and drop columns to adjust their visibility and order. Drag a column to the list on the right to hide it.
  Note
  The visibility settings apply to both the console and the exported instance information.
5. After you configure the settings, click OK.
Card view
Click Card View in the upper-right corner of the Instances page to switch to the card view. In this view, you can preview the real-time screen of Cloud Phone instances that are in the Active state.
In the card view, click Switch Between Landscape And Portrait in the upper-right corner of the page to change the orientation of the cards.

Find instances

If you have many instances, you can find specific instances using search, conditional filtering, or tag filtering.

Method 1: Search

The Instances page supports the following types of search:

Single-condition search: In the drop-down list to the left of the search box, select Auto-detect or a specific property, such as instance name. Then, enter a keyword in the search box.
Combined-condition search: After you perform a single-condition search, select another search condition and enter a new keyword to perform a search. This creates a combined-condition search. Only results that meet all the specified search conditions are displayed.

Method 2: Use conditional filtering

Some table headers in the list view support filtering. Click the icon to the right of a table header and select a value.

Method 3: Use tag filtering

Background information

As your number of Cloud Phone instances grows, you can use tags to identify and manage them. By attaching the same tag to instances with similar management requirements, you can filter these instances by tag to simplify batch operations. You can attach up to 20 tags to each instance. You can set tags as needed. The following table provides some examples.

Dimension	Tag Key	Tag Value
Organization	department	Department name, such as MD or FD.
Business architecture	project	Business project name, such as projectA or projectB.
Position role	position	Position name, such as designer or programmer.

Keep the following points in mind when you use tags:

Tags are key-value pairs. A tag key must be unique for a resource. For example, if you attach the tag department:MD to an instance and then attach the tag department:FD, the department:MD tag is automatically detached.
When a tag is detached from a resource, it is automatically deleted if it is not attached to any other resources.

Attach tags to Cloud Phone instances

You can attach tags when you create an instance group or attach them to existing instances. The following procedure describes how to attach tags to existing instances.

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, perform one of the following operations as needed:
- Single operation: Find the target instance and click Edit in the Tags column.
- Batch operation: Select multiple target instances and choose More > Attach Tag at the bottom of the page.
In the Edit Tag Attachment dialog box, select an existing tag or enter a new tag key and tag value, and then click OK.

Filter instances by tag

After you attach tags to instances, you can filter the instances by tag to quickly find the instances that meet your requirements and perform batch operations.

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, click Tag Filtering to the right of the search box.
In the panel that appears, select or enter the tag key and tag value, and then click OK.
Note
You can specify only a tag key without a tag value. In this case, all instances to which the tag key is attached are returned.

Install applications on an instance

You can install applications that you created in the console on specific instances.

Prerequisites

You have created an application. For more information, see Create an application.

Procedure

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, perform one of the following operations as needed:
- Single operation: Find the target instance and click Install Application in the Actions column.
- Batch operation: Select multiple target instances and choose More > Install Application at the bottom of the list.
  Note
  In a batch operation, you can select up to 1,000 instances for the Instance Edition.
In the Install Application panel, select one or more applications in the Select Applications To Install area, click OK, and then click OK again in the confirmation dialog box.
Note
If the same application is already installed on the Cloud Phone instance, installing a new version overwrites the existing version.
You can view the task progress on the Task Hub page.

What to do next

To uninstall an application from an instance, click the ⋮ icon in the Actions column, select Uninstall Application, choose one or more applications to uninstall, and then click OK.
To manage an application on an instance, click the ⋮ icon in the Actions column, and select Start Application, Restart Application, or Stop Application.

Assign an instance to an end user

After you assign an instance to an end user, the end user can connect to and use the Cloud Phone through the Cloud Phone client.

Prerequisites

Cloud Phone uses the convenience account system of WUYING Workspace Enterprise Edition. Therefore, you must create a convenience account in the WUYING Workspace Enterprise Edition console. For more information, see Create a convenience account.

Procedure

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, perform one of the following operations as needed:
- Single operation: Find the target instance, click the ⋮ icon in the Actions column, and select Assign User.
- Batch operation: Select multiple target instances and choose More > Assign User at the bottom of the list.
In the Assign User panel, select a user in the Selectable Users area and click OK.
Note
If no users are available, click Go Now to create a convenience account in the WUYING Workspace Enterprise Edition console.

What to do next

To unassign an instance from a user, perform the following steps:

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, find the target instance, click the ⋮ icon in the Actions column, select Unassign, and then click OK in the confirmation dialog box.

Manage the running status of an instance

You can manage the running state of a Cloud Phone, including starting, stopping, and restarting it, similar to how you would manage a physical mobile phone.

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, perform one of the following operations as needed:
- Single operation: Find the target instance, click the ⋮ icon in the Actions column, select Start, Restart, or Stop, and then click OK in the confirmation dialog box.
- Batch operation: Select multiple target instances and click Start, Restart, or Stop at the bottom of the list.
Important
If you select Restart or Stop, you can also select the Enable Force Restart or Enable Force Stop option. This option forces the Cloud Phone to restart or stop if a normal restart or stop operation fails due to system or network issues. Unsaved data may be lost.
You can view the task progress on the Task Hub page.

Run remote commands

You can run commands directly on specific Cloud Phone instances from the remote command panel.

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, perform one of the following operations as needed:
- Single operation: Find the target instance and click Remote Command in the Actions column.
- Batch operation: Select multiple target instances and choose More > Remote Command at the bottom of the list.
  Note
  In a batch operation, you can select up to 1,000 instances at a time.
In the Remote Command panel, set the command execution timeout period, enter the command to run in the Command Content text box, and click Run. The default timeout is 60 seconds, and the value can range from 10 to 3,600 seconds.
The command output is displayed in the Command Output text box.
(Optional) To run more commands, repeat the previous step.

Connect to an instance

To view the live environment of an instance, you can connect to the instance from the console. For information about how end users can connect to Cloud Phone instances, see End User Guide.

Normal connection

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, find the target instance and click Connect in the Actions column.
In the Cloud Phone instance preview panel that appears, you can view and interact with the Cloud Phone instance.
Note
When you interact with the Cloud Phone in the preview panel, you can right-click the screen to return to the previous interface.

SSH connection

Cloud Phone supports connecting to a Cloud Phone instance using the Secure Shell (SSH) protocol.

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, find the target instance and perform one of the following operations:
- Click the ⋮ icon in the Actions column, and select SSH.
  The SSH connection page opens in a new tab in your browser.
- Click Connect in the Actions column, and then click SSH on the right side of the Cloud Phone instance preview panel that appears.
  The SSH connection page opens within the preview panel. To open the page separately, click Open SSH In New Tab in the upper-right corner of the preview panel.

Reset an instance

You can use the instance reset feature to restore a Cloud Phone instance to its initial state.

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, perform one of the following operations as needed:
- Single operation: Find the target instance, click the ⋮ icon in the Actions column, and select Reset.
- Batch operation: Select multiple target instances and choose More > Reset at the bottom of the list.
In the confirmation dialog box, click I Have Confirmed. Start Reset..
Warning
Resetting an instance to its initial state clears all personal data, applications, and custom settings on the Cloud Phone instance. This operation cannot be undone. Back up important data in advance.

Export instance information

To export instance details to a local file for offline analysis, you can use the export feature on the Instances page. You can export all instances, only the filtered results, or only selected instances.

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, click the icon in the upper-right corner.
In the export dialog box, select one of the following options:
- All: Exports the details of all instances.
- Current Filter Conditions: Exports the details of instances that match the current filter conditions.
- Selected: Exports the details of the instances that you selected.

Release an instance

When you no longer need an instance, you can release it.

Release a pay-as-you-go instance

Log on to the Cloud Phone console.
In the left-side navigation pane, choose Manage Resource > Instance.
On the Instances page, find the target instance and copy the instance group ID in the Instance Group Name/ID column.
Important
Only instances in a pay-as-you-go instance group can be released. Instances in a subscription instance group cannot be released.
In the left-side navigation pane, choose Manage Resource > Instance Group.
On the Instance Groups page, search for the instance group ID that you copied and click the instance group ID from the search results.
On the instance group details page, find the instance that you want to release on the Instances tab, click the ⋮ icon in the Actions column, and select Release.
In the confirmation dialog box, click OK.

Release a subscription instance

Subscription instances cannot be released individually. To release them, you must unsubscribe from the entire instance group to which they belong. For more information, see Unsubscribe.