Tenant Management
Overview
Tenant Management is the list page within the Platform Admin Console used to manage all business tenants. Here you can view every business tenant, search for a specific tenant, create new tenants, and click into a tenant's details page to perform start / stop / disable / delete operations.
Each "tenant" in the system is a completely isolated workspace with its own configuration item data, user system, and permission configuration. Tenants are isolated from one another. Every creation or status change you make here directly determines the birth or termination of an independent workspace.
Key Features
- Unified list view: See key information — status, enabled state, creator, and more — for all business tenants in a single table.
- Multi-criteria search: Fuzzy search by name/description; combine filters by status and enabled state.
- One-click creation: Fill in new tenant information through a dialog and automatically designate the first administrator.
- Quick access to details: Click a tenant name to jump directly to that tenant's details page.
Page Layout
The Tenant Management page uses a standard list layout, divided into three areas: the search/filter area, the table area, and the toolbar.
Search and Filter Area
The search bar above the table provides the following filtering options:
| Filter | Description |
|---|---|
| Search | Fuzzy search by tenant name or description; case-insensitive |
| Status | Multi-select; choose one or more of "Running / Stopped / Pending / Starting" |
| Enabled State | Select "Enabled" or "Disabled" |
After entering criteria, click Search to execute the query or Reset to clear all filters.
Tenant List
For common table operations such as column management, advanced filtering, pagination, and density, see Common Data Table Operations.
The tenant list displays the following columns by default:
| Column | Description |
|---|---|
| Name | The tenant's display name. Click to enter Tenant Details. |
| Tenant ID | The tenant's unique identifier (auto-generated, cannot be changed after creation) |
| Description | A description of the tenant's purpose. Optional. |
| Status | The tenant's current runtime status. See "Tenant Status Reference" below. |
| Enabled State | "Enabled" or "Disabled"; corresponds to a green / red label |
| Creator | The platform operations account that created this tenant |
| Created At | When the tenant was created |
| Updated By | The account that most recently modified this tenant |
| Updated At | When the most recent modification occurred |
Tenant Status Reference
The status column is displayed as a colored label for quick visual identification:
| Status | Label Color | Meaning |
|---|---|---|
| Running | Green | The tenant is fully started. All of its users can log in and use the system. |
| Starting | Blue (dynamic) | The tenant is in the startup process. It will automatically transition to "Running" shortly. |
| Pending | Blue | The tenant has been created but not yet started. Users cannot log in yet. |
| Stopped | Orange | Actively stopped by operations personnel. All tenant users are unable to log in. Can be started again. |
| Disabled | Red | In a disabled state. Cannot be started. (A tenant must be disabled before it can be deleted.) |
- Status: Describes whether the tenant is running at the process level (Running / Stopped, etc.). Can be toggled via the "Start / Stop" buttons on the details page.
- Enabled State: Describes whether the tenant is permitted to start (Enabled / Disabled). Once disabled, it cannot be started until it is re-enabled.
The two are independent: a tenant that is "Enabled" can still be "Stopped"; a "Disabled" tenant is never "Running".
Toolbar
The toolbar in the upper-right corner of the table provides the following actions:
| Button | Purpose | When to Use |
|---|---|---|
| Create | Opens the "Create Tenant" dialog | Provisioning a new tenant for a new customer or business line |
| Refresh | Reloads the tenant list | After data was changed elsewhere, or when tenant status is transitioning and you want to see the latest result |
Create a Tenant
Click the Create button in the toolbar to open the Create Tenant dialog.
Field Reference
| Field | Required | Description |
|---|---|---|
| Name | Yes | The tenant's display name, 1–100 characters. We recommend using the company name or business line name for easy identification. |
| Description | No | A note on the tenant's purpose or ownership. Up to 500 characters. |
| Administrator Account | Yes | The login account for the tenant's first administrator. 3–64 characters; must start with a letter; may only contain letters, numbers, underscores, and hyphens. |
| Administrator Email | No | The contact email for the tenant's first administrator. Used for future email notifications (if applicable). |
| Administrator Password | Yes | The initial password for the tenant's first administrator. At least 8 characters; must include uppercase letters, lowercase letters, numbers, and special characters. |
| Confirm Password | Yes | Re-enter the administrator password to confirm correctness. |
The "Administrator Account" here is the first administrator within the newly created business tenant — it is not a Platform Admin Console account. This administrator logs in to the new business tenant, not the Platform Admin Console itself.
Creation Steps
- Click the Create button in the toolbar to open the dialog.
- Fill in the Name (e.g., "East Region Key Account A") and an optional Description.
- Fill in the Administrator Account (e.g.,
admin). This account will become the first administrator of the new tenant. - Fill in the Administrator Email.
- Set the Administrator Password and re-enter it in Confirm Password.
- Click Create to submit.
After successful creation, a "Tenant created successfully" message appears and the new tenant shows up in the list immediately. You can then:
- Click the tenant name to enter the details page.
- Share the Access URL from the details page along with the initial password you set, through a secure channel, with the tenant's actual users.
What Happens After Creation
- The system allocates an independent data space for the new tenant in the background.
- The administrator account you designated is established as the tenant's "seed user" with full permissions within that tenant.
Deletion Restrictions and Protections
The ability to delete a tenant directly from the list page is not available here — the deletion entry point is on the Tenant Details page and is subject to strict protections:
- Only tenants with "Enabled State = Disabled" can be deleted.
- Deletion is irreversible and permanently erases all of the tenant's data.
The details page also provides two safer intermediate states — Stop (pauses the tenant, recoverable) and Disable (prevents startup, a prerequisite for deletion). We recommend using these first.