Workspaces - Restore Workspace
削除されたワークスペースを復元します。
Note
この API はプレビュー リリースの一部であり、評価と開発のみを目的として提供されます。 フィードバックに基づいて変更される可能性があり、運用環境での使用はお勧めしません。
Permissions
呼び出し元には、ファブリック管理者権限が必要です。
必要な委任されたスコープ
Tenant.ReadWrite.All.
Limitations
1 分あたり最大 10 個の要求。
Microsoft Entra でサポートされている ID
この API では、このセクションに記載されている Microsoft ID がサポートされています。
| Identity | Support |
|---|---|
| User | Yes |
| サービス プリンシパルとマネージド ID | Yes |
Interface
POST https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/restoreURI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
ワークスペース ID。 |
要求本文
| 名前 | 型 | 説明 |
|---|---|---|
| newWorkspaceAdminPrincipal |
ワークスペースの管理者。 |
|
| newWorkspaceName |
string |
ワークスペースの名前。 復元要求が マイ ワークスペースの場合は必須です。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 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"
}
}
応答のサンプル
定義
| 名前 | 説明 |
|---|---|
|
Error |
エラー関連のリソース詳細オブジェクト。 |
|
Error |
エラー応答。 |
|
Error |
エラー応答の詳細。 |
|
Group |
グループ固有の詳細。 プリンシパルの種類が |
|
Group |
グループの種類。 グループの種類は、時間の経過と同時に追加される場合があります。 |
| Principal |
ID または Microsoft Entra グループを表します。 |
|
Principal |
プリンシパルの型。 プリンシパルの種類は、時間の経過と同時に追加される場合があります。 |
|
Restore |
削除されたワークスペースを復元する要求。 |
|
Service |
サービス プリンシパル固有の詳細。 プリンシパルの種類が |
|
Service |
サービス プリンシパル プロファイルの詳細。 プリンシパルの種類が |
|
User |
ユーザー プリンシパル固有の詳細。 プリンシパルの種類が |
ErrorRelatedResource
エラー関連のリソース詳細オブジェクト。
| 名前 | 型 | 説明 |
|---|---|---|
| resourceId |
string |
エラーに関係するリソース ID。 |
| resourceType |
string |
エラーに関係するリソースの種類。 |
ErrorResponse
エラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| moreDetails |
その他のエラーの詳細の一覧。 |
|
| relatedResource |
エラー関連のリソースの詳細。 |
|
| requestId |
string |
エラーに関連付けられている要求の ID。 |
ErrorResponseDetails
エラー応答の詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| relatedResource |
エラー関連のリソースの詳細。 |
GroupDetails
グループ固有の詳細。 プリンシパルの種類が Group場合に適用されます。
| 名前 | 型 | 説明 |
|---|---|---|
| groupType |
グループの種類。 グループの種類は、時間の経過と同時に追加される場合があります。 |
GroupType
グループの種類。 グループの種類は、時間の経過と同時に追加される場合があります。
| 値 | 説明 |
|---|---|
| Unknown |
プリンシパル グループの種類が不明です。 |
| SecurityGroup |
プリンシパルはセキュリティ グループです。 |
| DistributionList |
プリンシパルは配布リストです。 |
Principal
ID または Microsoft Entra グループを表します。
| 名前 | 型 | 説明 |
|---|---|---|
| displayName |
string |
プリンシパルの表示名。 |
| groupDetails |
グループ固有の詳細。 プリンシパルの種類が |
|
| id |
string (uuid) |
プリンシパルの ID。 |
| servicePrincipalDetails |
サービス プリンシパル固有の詳細。 プリンシパルの種類が |
|
| servicePrincipalProfileDetails |
サービス プリンシパル プロファイルの詳細。 プリンシパルの種類が |
|
| type |
プリンシパルの型。 プリンシパルの種類は、時間の経過と同時に追加される場合があります。 |
|
| userDetails |
ユーザー プリンシパル固有の詳細。 プリンシパルの種類が |
PrincipalType
プリンシパルの型。 プリンシパルの種類は、時間の経過と同時に追加される場合があります。
| 値 | 説明 |
|---|---|
| User |
プリンシパルは Microsoft Entra ユーザー プリンシパルです。 |
| ServicePrincipal |
プリンシパルは Microsoft Entra サービス プリンシパルです。 |
| Group |
プリンシパルはセキュリティ グループです。 |
| ServicePrincipalProfile |
プリンシパルはサービス プリンシパル プロファイルです。 |
| EntireTenant |
プリンシパルは、すべてのテナント ユーザーを表します。 |
RestoreWorkspaceRequest
削除されたワークスペースを復元する要求。
| 名前 | 型 | 説明 |
|---|---|---|
| newWorkspaceAdminPrincipal |
ワークスペースの管理者。 |
|
| newWorkspaceName |
string |
ワークスペースの名前。 復元要求が マイ ワークスペースの場合は必須です。 |
ServicePrincipalDetails
サービス プリンシパル固有の詳細。 プリンシパルの種類が ServicePrincipal場合に適用されます。
| 名前 | 型 | 説明 |
|---|---|---|
| aadAppId |
string (uuid) |
サービス プリンシパルの Microsoft Entra AppId。 |
ServicePrincipalProfileDetails
サービス プリンシパル プロファイルの詳細。 プリンシパルの種類が ServicePrincipalProfile場合に適用されます。
| 名前 | 型 | 説明 |
|---|---|---|
| parentPrincipal |
サービス プリンシパル プロファイルの親プリンシパル。 |
UserDetails
ユーザー プリンシパル固有の詳細。 プリンシパルの種類が User場合に適用されます。
| 名前 | 型 | 説明 |
|---|---|---|
| userPrincipalName |
string |
ユーザー プリンシパル名。 |