az Verified current stable Not installed? Cloud Infrastructure

Az / List Quantum Workspaces

List Quantum Workspaces

List all existing quantum workspaces within an Azure subscription.

$
Terminal
az quantum workspace list

When To Use

During resource management when auditing or assessing the availability of quantum environments.

Pro Tip

Utilize --query to filter output for specific workspace attributes for ease of management.

Terminal Output

Expected runtime feedback

Simulated preview
>
Output
| Name           | Location    | Resource Group      |
|----------------|-------------|---------------------|
| qworkspace1    | East US    | rg-quantum-resources|
| qworkspace2    | West Europe | rg-quantum-resources|
| qworkspace3    | Southeast Asia | rg-quantum-resources|

Anatomy of Output

Understanding the result

"Workspace Name": "myQuantumWorkspace","Location": "eastus","Provisioning State": "Succeeded" Workspace Listing

Provides naming and status details about existing quantum workspaces.

"Workspace Name": "anotherWorkspace","Location": "westus","Provisioning State": "Succeeded" Workspace Listing

Shows multiple workspaces organized by name and status.

"Workspace Name": "yetAnotherWorkspace","Location": "westeurope","Provisioning State": "Failed" Workspace Listing

Identifies any workspaces with issues in provisioning.

Power User Variants

Optimized versions

az quantum workspace list --query "[].{Name:workspaceName, Location:location}"

Filter output to show workspace names and their locations.

az quantum workspace list --output table

Display results in tabulated format for easy viewing.

Troubleshooting

Common pitfalls

AuthorizationFailed: The user does not have permission to perform action 'Microsoft.Quantum/locations/workspaces/read'

Solution: Ensure user has 'Reader' role assignment in the Azure subscription.

ResourceNotFound: No workspaces found in the specified subscription.

Solution: Confirm the subscription ID is correct or that no workspaces have been created.

RequestFailed: Unable to list workspaces due to service issues.

Solution: Check Azure service status for related disruptions.

Command Breakdown

What each part is doing

az
Base Command
The executable that performs this operation. Here it runs Az before the shell applies any redirect operators.

How To Run

Execution path

  1. Step 1

    Run the command: az quantum workspace list

  2. Step 2

    Check the output for the list of workspaces and their details.

Alternative Approaches

Comparable commands in other tools

Alternative cloud infrastructure tools for the same job.