Workspaces - List Workspaces
Note
This API is in preview.
Returns a list of workspaces.
This API supports pagination. A maximum of 10,000 records can be returned per request. With the continuous token provided in the response, you can get the next 10,000 records.
Permissions
The caller must have administrator rights (such as Office 365 Global administrator or Fabric administrator) or authenticate using a service principal.
Required Delegated Scopes
Tenant.Read.All or Tenant.ReadWrite.All
Limitations
Maximum 200 requests per hour.
Interface
GET https://api.fabric.microsoft.com/v1/admin/workspaces
GET https://api.fabric.microsoft.com/v1/admin/workspaces?type={type}&capacityId={capacityId}&name={name}&state={state}&continuationToken={continuationToken}
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
capacity
|
query |
string uuid |
The capacity ID of the workspace. |
|
continuation
|
query |
string |
Continuation token. Used to get the next items in the list. |
|
name
|
query |
string |
The workspace name. |
|
state
|
query |
string |
The workspace state. Supported states are active and deleted. |
|
type
|
query |
string |
The workspace type. Supported types are personal, workspace, adminworkspace. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
The operation was successful. |
|
Other Status Codes |
Common error codes:
|
Examples
Get a list of workspaces example |
Get a list of workspaces using state query parameter example |
Get a list of workspaces example
Sample Request
GET https://api.fabric.microsoft.com/v1/admin/workspaces
Sample Response
{
"workspaces": [
{
"id": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
"name": "test report",
"type": "Workspace",
"state": "Active",
"capacityId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e84"
}
],
"continuationUri": "https://api.fabric.microsoft.com/v1/admin/workspaces?continuationToken='LDEsMTAwMDAwLDA%3D'",
"continuationToken": "LDEsMTAwMDAwLDA%3D"
}
Get a list of workspaces using state query parameter example
Sample Request
GET https://api.fabric.microsoft.com/v1/admin/workspaces?state=Active
Sample Response
{
"workspaces": [
{
"id": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
"name": "test report",
"type": "Workspace",
"state": "Active",
"capacityId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e84"
}
],
"continuationUri": null,
"continuationToken": null
}
Definitions
Name | Description |
---|---|
Error |
The error related resource details object. |
Error |
The error response. |
Error |
The error response details. |
Workspace |
Workspace. |
Workspaces |
A list of workspaces. |
Workspace |
The workspace state. Additional workspace states may be added over time. |
Workspace |
Workspace type. Additional workspace types may be added over time. |
ErrorRelatedResource
The error related resource details object.
Name | Type | Description |
---|---|---|
resourceId |
string |
The resource ID that's involved in the error. |
resourceType |
string |
The type of the resource that's involved in the error. |
ErrorResponse
The error response.
Name | Type | Description |
---|---|---|
errorCode |
string |
A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users. |
message |
string |
A human readable representation of the error. |
moreDetails |
List of additional error details. |
|
relatedResource |
The error related resource details. |
|
requestId |
string |
ID of the request associated with the error. |
ErrorResponseDetails
The error response details.
Name | Type | Description |
---|---|---|
errorCode |
string |
A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users. |
message |
string |
A human readable representation of the error. |
relatedResource |
The error related resource details. |
Workspace
Workspace.
Name | Type | Description |
---|---|---|
capacityId |
string |
The capacity ID of the workspace. |
id |
string |
The workspace ID. |
name |
string |
The workspace name. |
state |
The workspace state. |
|
type |
The workspace type. |
Workspaces
A list of workspaces.
Name | Type | Description |
---|---|---|
continuationToken |
string |
The token for the next result set batch. If there are no more records, it's removed from the response. |
continuationUri |
string |
The URI of the next result set batch. If there are no more records, it's removed from the response. |
workspaces |
The list of fabric workspaces. |
WorkspaceState
The workspace state. Additional workspace states may be added over time.
Name | Type | Description |
---|---|---|
Active |
string |
The workspace is active. Orphaned workspaces are displayed as active. |
Deleted |
string |
The workspace is deleted. |
WorkspaceType
Workspace type. Additional workspace types may be added over time.
Name | Type | Description |
---|---|---|
AdminWorkspace |
string |
Admin monitoring workspace. Contains admin reports such as the audit report and the usage and adoption report. |
Personal |
string |
My folder or My workspace used to manage user items. |
Workspace |
string |
Workspace used to manage the Fabric items. |