All Products
Search
Document Center

Platform For AI:Create and manage workspaces

Last Updated:Aug 24, 2026

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.

    Note

    To 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

  1. Go to the PAI Workspaces page. In the upper-left corner of the console, select the target region and then click Create Workspace.

    Note

    After 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.

  2. Follow the on-screen instructions to configure the Workspace Name, Alibaba Cloud Resource Group, and other settings.

    Note

    You 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:

  • Administrator: Can manage workspace members, resource groups, and all assets within the workspace.

  • Algorithm Developer: Can develop and train models in the workspace.

  • Algorithm O&M Engineer: Can manage job priorities, publish models, and monitor online services.

  • Labeling Administrator: Has operational permissions for intelligent labeling.

  • Visitor: Has read-only access to all assets in the workspace.

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

  • How to add: On the Workspace Settings page, choose Configure Member and Role > Workspace Role and click the Create Custom Role button. A configuration panel appears on the right.

  • Permission levels:

    • No Permissions: No permissions in the specified product module.

    • Read-only: Can view resources that are owned by the user or publicly visible in the specified product module.

    • Modify/Execute: Can edit and run resources owned by the user in the specified product module.

    • Full Access: Has full management permissions on all resources in the specified product module.

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.

Note

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:

  1. Strictly control member roles. Do not assign the Workspace Administrator role to members from other companies.

  2. 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

Important

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

Important
  • 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:

  1. Log on to the RAM console. In the left-side navigation pane, choose Permissions > Grants, and then click Grant Permission.

  2. Set the principal to the RAM user or RAM role, and select AliyunLogFullAccess as the authorization policy.

  3. 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:

  1. Go to the recycle bin through one of the following entry points and restore the target workspace.

    Important

    After 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.

  2. After you restore the workspace, clean up the resources under it, such as DSW instances and EAS services.

  3. 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:

  • Use the ActionTrail console to verify the creation status of the resource.

  • Switch to the correct workspace and check the EAS instance list for running instances.