Workspaces - Get Workspace
Note
This API is in preview.
Returns the specified workspace.
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/{workspaceId}
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
The workspace ID. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Common error codes:
|
Examples
Get workspace details by ID example
Sample request
GET https://api.fabric.microsoft.com/v1/admin/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48
Sample response
{
"id": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
"name": "test report",
"type": "Workspace",
"state": "Active",
"capacityId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e84"
}
Definitions
Name | Description |
---|---|
Error |
The error related resource details object. |
Error |
The error response. |
Error |
The error response details. |
Workspace |
Workspace. |
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. |
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. |