All Products
Search
Document Center

Elastic Compute Service:Manage managed instances with Alibaba Cloud Client

Last Updated:Sep 07, 2026

View, connect to, register, and deregister managed instances with Alibaba Cloud Client.

Prerequisites

  • Accounts are added to Alibaba Cloud Client.

  • Session Manager connects to managed instances over SSH. Both Alibaba Cloud accounts and RAM users can use Session Manager, but only Alibaba Cloud accounts can enable it.

View managed instances

  1. On the homepage of Alibaba Cloud Client, click Managed Instance.

  2. On the Managed Instance page, use the following areas to view and manage managed instances:

    • Region selector: The top of the page shows the region that the current managed instances belong to. Click the region to switch to another region.

    • Managed instance list: Displays all managed instances in the current region.

    • Pagination toolbar: Click the pagination toolbar to switch between pages.

    • Search box: Enter an instance ID or instance name and press Enter to search for the target managed instance in the current region.

    • Actions menu: The Actions menu of the target instance provides the following operations:

      • Connect to an instance

      • Deregister an instance

      • View instance details

    • Register New Instances button: Click Register New Instances above the instance list to register a new managed instance.

Connect to a managed instance

Connect to a managed instance over SSH

  1. On the homepage of Alibaba Cloud Client, click Managed Instance.

  2. At the top of the managed instance list, select the target region.

  3. Find the target instance. In the Actions column, choose Actions > Start Session (via Cloud Assistant)...

  4. Specify Username. Default value: root. Specify Port Num. Default value: 22. Set Certifier.

    Valid values of Certifier:

    • Password: The instance password.

    • KeyPair: An SSH private key file from ~/.ssh/ or another local directory.

    • Temp KeyPair: A temporary key pair sent to the instance, valid for 1 minute. No password or key file management required.

  5. Click Connect.

Connect to a managed instance by using Session Manager

Use Session Manager provided by Cloud Assistant to connect to an ECS instance in these scenarios:

  • No password is configured for the instance.

  • No public IP address is assigned to the instance.

  • The SSH or RDP port cannot be opened for the instance.

  1. On the homepage of Alibaba Cloud Client, click Managed Instance.

  2. At the top of the managed instance list, select the target region.

  3. Find the target instance. In the Actions column, choose Actions > Start Session Manager...

    The default username is ecs-assist-user.

Deregister a managed instance

Important

Deregistering an instance removes it from both the Alibaba Cloud Client managed instance list and the Managed Instances tab in the ECS console.

  1. On the homepage of Alibaba Cloud Client, click Managed Instance.

  2. At the top of the managed instance list, select the target region.

  3. Find the target instance. In the Actions column, choose Actions > Deregister Instance.

  4. Click Deregister Instance.

View the properties of a managed instance

  1. On the homepage of Alibaba Cloud Client, click Managed Instance.

  2. At the top of the managed instance list, select the target region.

  3. Find the target instance. In the Actions column, choose Actions > Show Instance Properties.

    Properties include the instance name, hostname, operating system, and Cloud Assistant status.

Register a new managed instance

Create a registration code and generate a script to install Cloud Assistant Agent and register a new instance.

  1. On the homepage of Alibaba Cloud Client, click Managed Instance.

  2. At the top of the managed instance list, select the target region.

  3. On the top of the managed instance list, click Register New Instances.

  4. In the Register New Instances dialog box:

    1. Configure the following parameters to create a registration code:

      • Instance Name Prefix: A name prefix for managed instances.

      • Instances Quota: The number of managed instances. Valid values: 1 to 1000. Default value: 10.

      • Validity Period: The validity period of the registration code. Unit: hours. The code becomes invalid after expiration. Default value: 4.

      • Source IP Address: An IP address or CIDR block to restrict which servers can register.

        • If you specify a public IP address, only the server with that IP address can register. If you specify a CIDR block, only servers within that range can register.

        • If not specified, all servers can register.

    2. Click Next.

    3. Select the operating system tab, copy the generated script, and click Done.

      In the Register New Instances dialog box, the operating system type corresponds to three tabs: Linux(.rpm), Linux(.deb), and Windows(.exe). After you select a tab, the code area below automatically generates a script that contains the download, installation, and registration commands.

      Use this script to install Cloud Assistant Agent on the servers and register them as managed instances. See Alibaba Cloud managed instances.

References