Workspaces - Restore Workspace
還原已刪除的工作區。
Note
此 API 是預覽版的一部分，僅供評估和開發之用。 它可能會根據意見反應而變更，不建議用於生產環境。
Permissions
呼叫端必須具有網狀架構系統管理員許可權。
必要的委派範圍
Tenant.ReadWrite.All.
Limitations
每分鐘最多10個要求。
Microsoft Entra 支援的身分識別
此 API 支援本節中列出的Microsoft 身分識別。
| Identity | Support |
|---|---|
| User | Yes |
| 服務主體 和 受控識別 | Yes |
Interface
POST https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/restoreURI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
工作區標識碼。 |
要求本文
| 名稱 | 類型 | Description |
|---|---|---|
| newWorkspaceAdminPrincipal |
工作區的系統管理員。 |
|
| newWorkspaceName |
string |
工作區的名稱。 如果還原要求是 [ 我的工作區] ，則為必要專案。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
已成功還原工作區。 |
|
| Other Status Codes |
常見的錯誤碼：
|
範例
Restore workspace example
範例要求
POST https://api.fabric.microsoft.com/v1/admin/workspaces/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/restore
{
"newWorkspaceName": "Contoso Workspace",
"newWorkspaceAdminPrincipal": {
"id": "17dd1e38-a4c6-41ed-bc4f-1e383f8ddd01",
"type": "User"
}
}
範例回覆
定義
| 名稱 | Description |
|---|---|
|
Error |
錯誤相關的資源詳細資料物件。 |
|
Error |
錯誤回應。 |
|
Error |
錯誤回應詳細數據。 |
|
Group |
群組特定詳細數據。 當主體類型 |
|
Group |
群組的類型。 可能會隨著時間新增其他群組類型。 |
| Principal |
代表身分識別或Microsoft Entra 群組。 |
|
Principal |
主體的類型。 可能會隨著時間新增其他主體類型。 |
|
Restore |
還原已刪除工作區的要求。 |
|
Service |
服務主體特定詳細數據。 當主體類型 |
|
Service |
服務主體配置檔詳細數據。 當主體類型 |
|
User |
用戶主體特定詳細數據。 當主體類型 |
ErrorRelatedResource
錯誤相關的資源詳細資料物件。
| 名稱 | 類型 | Description |
|---|---|---|
| resourceId |
string |
發生錯誤的資源識別碼。 |
| resourceType |
string |
發生錯誤的資源類型。 |
ErrorResponse
錯誤回應。
| 名稱 | 類型 | Description |
|---|---|---|
| errorCode |
string |
提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。 |
| message |
string |
錯誤的人類可讀取表示法。 |
| moreDetails |
其他錯誤詳細數據的清單。 |
|
| relatedResource |
錯誤相關的資源詳細數據。 |
|
| requestId |
string |
與錯誤相關聯的要求標識碼。 |
ErrorResponseDetails
錯誤回應詳細數據。
| 名稱 | 類型 | Description |
|---|---|---|
| errorCode |
string |
提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。 |
| message |
string |
錯誤的人類可讀取表示法。 |
| relatedResource |
錯誤相關的資源詳細數據。 |
GroupDetails
群組特定詳細數據。 當主體類型 Group時適用。
| 名稱 | 類型 | Description |
|---|---|---|
| groupType |
群組的類型。 可能會隨著時間新增其他群組類型。 |
GroupType
群組的類型。 可能會隨著時間新增其他群組類型。
| 值 | Description |
|---|---|
| Unknown |
主體群組類型未知。 |
| SecurityGroup |
主體是安全組。 |
| DistributionList |
主體是通訊組清單。 |
Principal
代表身分識別或Microsoft Entra 群組。
| 名稱 | 類型 | Description |
|---|---|---|
| displayName |
string |
主體的顯示名稱。 |
| groupDetails |
群組特定詳細數據。 當主體類型 |
|
| id |
string (uuid) |
主體的標識碼。 |
| servicePrincipalDetails |
服務主體特定詳細數據。 當主體類型 |
|
| servicePrincipalProfileDetails |
服務主體配置檔詳細數據。 當主體類型 |
|
| type |
主體的類型。 可能會隨著時間新增其他主體類型。 |
|
| userDetails |
用戶主體特定詳細數據。 當主體類型 |
PrincipalType
主體的類型。 可能會隨著時間新增其他主體類型。
| 值 | Description |
|---|---|
| User |
主體是 entra 用戶主體Microsoft。 |
| ServicePrincipal |
主體是Microsoft Entra 服務主體。 |
| Group |
主體是安全組。 |
| ServicePrincipalProfile |
主體是服務主體配置檔。 |
| EntireTenant |
主體代表所有租用戶使用者。 |
RestoreWorkspaceRequest
還原已刪除工作區的要求。
| 名稱 | 類型 | Description |
|---|---|---|
| newWorkspaceAdminPrincipal |
工作區的系統管理員。 |
|
| newWorkspaceName |
string |
工作區的名稱。 如果還原要求是 [ 我的工作區] ，則為必要專案。 |
ServicePrincipalDetails
服務主體特定詳細數據。 當主體類型 ServicePrincipal時適用。
| 名稱 | 類型 | Description |
|---|---|---|
| aadAppId |
string (uuid) |
服務主體的 Microsoft Entra AppId。 |
ServicePrincipalProfileDetails
服務主體配置檔詳細數據。 當主體類型 ServicePrincipalProfile時適用。
| 名稱 | 類型 | Description |
|---|---|---|
| parentPrincipal |
服務主體配置檔的父主體。 |
UserDetails
用戶主體特定詳細數據。 當主體類型 User時適用。
| 名稱 | 類型 | Description |
|---|---|---|
| userPrincipalName |
string |
用戶主體名稱。 |