UiPath Automation Cloud

The UiPath Automation Cloud Guide

Check the current status of the Automation Cloud here.

Managing Tenants

📘

Note:

You can perform changes on your tenants if you have the Organization Administrator role.

Adding Tenants

Based on your licensing plan, your organization can have one or more tenants. Here's how you can create new tenants, selecting the services they should contain and allocating licenses:

  1. In the Tenants page, click Add Tenant. The Add Tenant window is displayed.
  2. Enter a name for your tenant.
    You can enter up to 32 alphabetical or numeric characters, starting with a letter. The name cannot end with an _ underscore character. No spaces or special characters are allowed.
    You can change the tenant name later, but there are consequences.
  3. Select the services that are to be exposed within the new tenant.
    You can select any of the services displayed here. Note that for each of the selected services you must specify the license configuration in the Configure Service Licenses window.
    You can't deselect the Orchestrator service.
  1. Click Assign Licenses. The Configure Service Licenses window is displayed.
  2. Specify how many licenses of each type to be allocated to each service within the tenant.
    Only the licenses specific to the selected services are displayed in this window, grouped on service type.
    The entire number of unallocated licenses of each type is prefilled by default in the corresponding fields. You can modify the numbers using the and arrows next to each license type.
    If there are both named and concurrent (multiuser) licenses available for the same product, you may allocate only one type to a specific tenant. You cannot allocate both to the same tenant.
    You can't exceed the number of available licenses for each license type. You can either redistribute your licenses across your services, or you can contact us to purchase more. Read here more about the licensing considerations.
  1. In the Configure Service Licenses window, click Save. The tenant creation process starts and it is temporarily displayed in a Provisioning status.
    Refresh the Tenants page if its status doesn't change shortly to Enabled or Failed.

You can access the services within the new tenant if its status is Enabled.

Editing Tenants

You can edit the name, the contained services, and the number of licenses allocated to a tenant:

  1. Click Edit Services next to a tenant. The Edit Services for Tenant window is displayed.
  2. Edit the tenant name if needed.
    :warning: Changing a tenant's name results in disconnecting your Robots and Mobile Orchestrator users, and invalidating any pending user invites. Read more about the consequences and the actions you should perform after the change here.
  3. Modify the configuration of services within the tenant by adding or removing services.
    If you enable new services, you must specify the license configuration in the Configure Service Licenses window.
    If you disable existing services, their corresponding allocated licenses become available to other tenants. The service cannot be accessed anymore.
    You can't deselect the Orchestrator service.
  4. Click Edit Licenses. The Configure Service Licenses window is displayed.
  5. Modify the license count of each desired license type.
  6. Click Save. When saving the changes, the following scenarios can occur:
    If you entered more licenses than available, a text is displayed in red, informing you of the limitations. Modify the number of licenses according to the displayed instructions, then click Save. Read here more about the licensing considerations.
    If your modified license values are compliant, the service's status changes to Updating while the new service and license settings are being applied.
    If your modified values are compliant and you have changed the tenant name, the Change Tenant Name window is displayed. This window informs you of the consequences of changing the tenant name. Click Proceed to save your changes.
    Refresh the Tenants page if its status doesn't change shortly to Enabled or Failed.

License Overallocation

Across All Services

If you have more licenses allocated across all your services than allowed by your current licensing plan, the number of overallocated licenses is displayed. The license excess is visible in the Configure Service Licenses window from the Edit Services for Tenant window. This can happen if a change of plan occurred since the last time you've modified your license distribution across tenants.

Within Specific Services

If you have more licenses in use in a particular service than allowed by the current service license configuration, then the License page within that service shows a number of licenses in use exceeding the service's total count. This can happen if a user with the Organization Administrator role reduced the license configuration within the Cloud Portal below the number of licenses currently in use within the service.

❗️

Warning!

UiPath does not enforce automatic license removal or deny access to the services due to the license excess usage to not create any inconveniences by disrupting your operations. Nevertheless, you are required to adjust the license count within the limits dictated by your organization's license plan.

Continuing to use the excess licenses constitutes a breach in the license agreement and may result in disruption of services if no action is taken within 14 days.

Impact of Changing Tenant Names

Changing the name of any of your tenants greatly impacts your previous UiPath Automation Cloud service configurations:

  • Robots configured at Orchestrator services level are disconnected. Reconnect your Robots, entering the new URLs.
  • Service URLs previously bookmarked don't work anymore. Send your users the new URLs.
  • Mobile Orchestrator users are disconnected. Send them the new service URLs to connect again.
  • User invites sent before the change are not valid anymore. Send new invites for your colleagues who haven’t joined yet.

Deleting Tenants

  1. In the Tenants page, click next to a tenant and select the Delete option. The Delete Tenant window is displayed.
  2. Click Delete to confirm your action. The tenant, along with all its services and any data within them, is deleted. After deletion, it is no longer being displayed in the Tenants page.

🚧

Important!

A tenant can be deleted if none of the processes within its Orchestrator service are being executed.

After deleting a tenant, all its assigned licenses are freed up and available for you to use with other tenants.

Disabling Tenants

  1. In the Tenants page, click next to a tenant and select the Disable option. The Disable Tenant window is displayed.
  2. Click Disable to confirm your action. The tenant, along with all its services, is being disabled.

Disabled tenants remain displayed on the Tenants page, but their services are not accessible. All the services data is kept. Enable the tenant in order to access its services again.

🚧

Important!

After disabling a tenant, all its assigned licenses are freed up and become available for the other tenants.

Enabling Tenants

Disabled tenants can be enabled if you need to access their services.

  1. In the Tenants page, click next to a disabled tenant and select the Enable option.
    The tenant is being enabled and all its services become accessible again.

🚧

Important!

After enabling a tenant, for your convenience, all the licenses available in your organization are allocated by default to the tenant.
You can edit the licenses allocated to each service according to your needs subsequently.

If there are both named and concurrent (multiuser) licenses available for the same product, we allocate by default the named user licenses. You cannot allocate both to the same tenant.

Viewing License Usage

  1. In the Tenants page, click Usage next to a tenant. The Tenant License Usage page is displayed, containing comprehensive tenant information in a visual manner, concerning the number of licenses allocated to that tenant and insight regarding the license usage.

The donut charts for every license type illustrate the number of licenses currently allocated to your selected tenant versus the total number of licenses available for your organization.

Managing Users at Orchestrator Service Level

User management at Orchestrator service level is performed as described here.

  1. In the Tenats page, click next to a tenant to expand its services.
  2. Click Manage Users next to a service to navigate to that service and perform user management activities.

Updated 29 days ago


Managing Tenants


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.