(cli:create-workspace)=
# Create a SeqsLab workspace

The cloud backend resources, such as storage and computation on the SeqsLab platform are
managed using the concept of workspaces. For example, a SeqsLab workspace on Azure backend includes
an [Azure Data Lake Storage](https://azure.microsoft.com/en-us/services/storage/data-lake-storage/) and
an [Azure batch](https://azure.microsoft.com/en-us/services/batch/)

At least one workspace is required to enable data processing on the SeqsLab platform.

![workspace](../images/workspace.png)

```{important}
Only the SeqsLab account assigned to the **Global administrator** role can run the following commands.
```

The SeqsLab CLI provides a ***workspace*** command group for workspace management. To create a workspace, use the following command:
```
seqslab workspace create \
    --name ${WORKSPACE_NAME} \
    --location ${WORKSPACE_LOCATION}
```

This command triggers an asynchronous task to create a workspace and return a task ID. You can then use the task ID to track the workspace creation status.
```
seqslab workspace status --task-id ${TASK_ID}
```

After the workspace is created, you can use the following command to list existing workspaces:
```
seqslab workspace list
--
[
    {
        "id": "/subscriptions/xxxxxxxxx-aaaa-bbbb-cccc-zzzzzzzzzzzz/resourceGroups/seqslabwus2",
        "name": "seqslabwus2",
        "location": "westus2"
    }
]
```

## Next steps

The Global Administrator must complete the following to enable data processing on SeqsLab.  

1. [Request Azure backend quota](csp:request-quota)
1. [Manage SeqsLab users](cli:manage-users)
1. Recommend: [Manage Container Registry](tutorials:cli-container-registry)
1. Optional: [Configure storage log access](csp:azure-log-access)