A workspace is the top-level resource in PAI. It provides unified capabilities for managing compute resources, user permissions, and AI assets. After you create a workspace, team members can develop, train, and deploy models within it.
Limits
Only workspace administrators or owners can modify workspace configurations.
The voice call, SMS, and email features in event notification settings are available only in the China (Hangzhou), China (Shanghai), and China (Ulanqab) regions.
A workspace is a regional resource. Workspaces, data, and instances in different regions are independent of each other. Cross-region access or migration is not supported. To use PAI in a different region, you must create a separate workspace in that region.
Account and permission requirements
Alibaba Cloud account: An Alibaba Cloud account has full access to all operations and requires no additional authorization.
-
RAM user: A RAM user requires the AliyunPAIFullAccess permission. AliyunPAIFullAccess grants all PAI permissions. Exercise caution when attaching this policy. We recommend that you use an Alibaba Cloud account instead.
NoteTo grant a RAM user read and write permissions on a specific PAI workspace only, add the RAM user as a member of that workspace. No additional RAM policy is required.
Create a workspace
-
Go to the PAI Workspaces page. In the upper-left corner of the console, select the target region and then click Create Workspace.
NoteAfter a workspace is created, it belongs to the selected region and cannot be migrated to another region. Select a region based on your business requirements and resource availability. To use PAI in multiple regions, create a separate workspace in each region.
-
Follow the on-screen instructions to configure the Workspace Name, Alibaba Cloud Resource Group, and other settings.
NoteYou can configure members and roles, default storage, and associated resources after the workspace is created by going to the workspace details page.
Configure a workspace
Compute resources
You can associate or disassociate the following types of compute resources:
|
Resource type |
Description |
|
LingJun intelligent computing resources |
Provides high-performance compute resource groups for model development and training, with advantages such as high efficiency and high resource utilization. |
|
General-purpose compute resources |
Dedicated general-purpose compute resources for AI development and training. For more information, see Create a resource group and purchase general computing resources. |
|
MaxCompute resources: |
|
|
Fully managed Flink resources |
Used for large-scale distributed model training in PAI. For more information, see Manage fully managed Flink resources. |
For more information about AI compute resources, see AI computing resources.
Members and roles
When multiple RAM users need to manage, develop, and perform O&M in the same workspace, you must add them as workspace members and assign appropriate roles.
PAI provides system default roles (basic roles and compute resource roles). You can view the mapping between roles and permissions. Assign roles to members as needed, or create custom roles.
Supported role types:
|
Role type |
Description |
|
Basic roles |
Basic roles include the following:
|
|
Compute resource roles |
The compute resource role refers to MaxCompute Developer, which corresponds to the Developer role in DataWorks and grants permissions related to MaxCompute data development. You can assign this role to RAM users who submit jobs from PAI to MaxCompute. |
|
Custom roles |
|
Member and role relationships:
Each member must have at least one role.
The Owner role cannot be removed. The Alibaba Cloud account or RAM user that creates a workspace automatically becomes the Owner of that workspace, with permissions to manage workspace members, reference and manage resource groups, and manage all assets within the workspace.
DataWorks and PAI workspaces are interconnected. The Workspace Administrator, Visitor, and MaxCompute Developer roles in PAI correspond to the Workspace Administrator, Visitor, and Developer roles in DataWorks, respectively. These three roles are shared between the two services. If a member is removed from one of these roles in PAI and that role is the member's last role in the DataWorks workspace, DataWorks automatically removes the member, which triggers Entity transfer.
Resource visibility settings:
DSW instances, DLC jobs, and EAS services in a PAI workspace all support visibility settings:
Visible to Creator Only: Only the resource creator and workspace administrators can view the resource.
Visible in Workspace: All members in the workspace can view the resource.
Regardless of the visibility setting, workspace administrators can view and manage all resources in the workspace.
Security recommendations for shared workspaces:
Workspace administrators can view all member resources in the workspace. Therefore, we recommend against sharing a single workspace across multiple companies or teams. If sharing is necessary, follow these guidelines:
Strictly control member roles. Do not assign the Workspace Administrator role to members from other companies.
Set sensitive resources to Visible to Creator Only to reduce the exposure scope.
Scheduling settings
Administrators can configure resource scheduling policies based on business requirements. For more information, see Scheduling configuration.
Event notification settings
Configure event notifications to track and monitor the status of DLC jobs, workflow jobs, and DSW instances, or to automatically trigger downstream operations when model version statuses change. For more information, see Event notification configuration.
Storage path settings
We recommend that you configure an OSS path as the default storage path for storing temporary data and models generated during jobs. This facilitates unified management.
If a Data Storage is also configured in Designer, the Data Storage path takes precedence when you run workflows.
SLS log forwarding settings
You can forward DLC job logs to Simple Log Service (SLS) for custom analysis. For more information, see Subscribe to job logs.
General settings
The workspace general settings provide the following feature toggles. Note that you must restart instances after you enable or disable a feature.
-
Public Resource Group:
Default Network Configuration: Administrators can configure default network settings such as VPC and security group in the workspace. Centralized configuration by administrators helps control permissions.
-
DLC Configurations:
Go to Node Container: Controls whether users can access the compute node container of a DLC job for debugging or troubleshooting. When enabled, authorized users can access the container through a terminal.
-
DSW settings:
SSH Logon to Instance from Internet: Specifies whether users can log on to instances over SSH through the public network.
Open Instance from Internet: Specifies whether users can access DSW instances from the public network.
Rate Limit for Internet Access: Specifies whether to limit the network bandwidth of DSW instances when a dedicated gateway is used for public network access. This prevents a single instance from consuming excessive bandwidth and ensures the stability of shared resources.
Delete a workspace
Before you delete a workspace, we recommend that you clean up resources such as DSW instances and EAS services to avoid continued billing from residual resources.
Deleting a workspace does not delete the resource quotas bound to it.
When you delete a workspace in PAI, the corresponding DataWorks workspace with the same name is also deleted.
After deletion, the workspace is moved to the recycle bin and retained for 14 days, during which you can restore it. After 14 days, the workspace and all its resources (DSW instances, DLC jobs, EAS services, PAIFlow jobs, LangStudio applications, etc.) are permanently deleted.
FAQ
Q: Why do I get a "Name already exists" error when creating a workspace?
If the name appears to be available but PAI reports that it already exists, a DataWorks workspace with the same name may already exist. Because PAI and DataWorks workspaces share the same underlying infrastructure, use a different name to ensure uniqueness.
Q: No data appears on the list page when configuring SLS log forwarding
Error message: Unauthorized error, with the message denied by sts or ram, action: log:ListProject, resource: acs:log......
Cause: The user does not have read permissions on the SLS Logstore.
Solution: Grant the user Logstore permissions by performing the following steps:
Log on to the RAM console. In the left-side navigation pane, choose Permissions > Grants, and then click Grant Permission.
Set the principal to the RAM user or RAM role, and select
AliyunLogFullAccessas the authorization policy.For finer-grained SLS permissions, go to the Log Service console, open the target project, click the More Applications icon, and then select Permission Assistant from the menu to generate a custom RAM policy.
Q: Request fails when configuring SLS log forwarding
Error message: Modify configuration failed [SLS] cannot init client for sis service: com.alibaba.pai.workspace.common.exception.ServiceExceptionV2: No Privilege error: {0}
Cause: The user does not have permissions to enable or disable SLS log forwarding.
Solution: Log on to the RAM console and configure a custom authorization policy to grant the user log forwarding permissions.
Configure the custom authorization policy as follows. For more information, see Create a custom policy:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"log:GetProductDataCollection",
"log:CloseProductDataCollection",
"log:OpenProductDataCollection"
],
"Resource": "*"
}
]
}
For more granular control, modify the Resource field to specify the target resources.
Q: How do I restore a deleted workspace or clean up residual resources?
After you delete a workspace, the data sources and compute resources in the workspace are moved to the recycle bin and retained for 14 days.
Uncleaned resources such as DSW instances, DLC jobs, and EAS services continue to incur charges until they are permanently deleted along with the workspace after 14 days. To stop billing immediately, restore the workspace first and then clean up the resources.
Procedure:
-
Go to the recycle bin through one of the following entry points and restore the target workspace.
The Go to Workspace Recycle Bin in the upper-right corner of the PAI Workspaces page.
ImportantAfter you go to the recycle bin, switch to the region where the deleted workspace was located in the upper-left corner to find the target workspace.
After you restore the workspace, clean up the resources under it, such as DSW instances and EAS services.
After you confirm that all billable resources are deleted, go to the Workspaces page in the PAI console and delete the target workspace.
Troubleshoot hidden resources: After you restore a workspace, if you cannot find certain resources in the EAS service list (for example, EAS services created through ModelScope authorization), use the following methods to troubleshoot: