Workspaces - Restore Workspace

Layanan:

Admin

Versi API:

v1

Memulihkan ruang kerja yang dihapus.

Note

API ini adalah bagian dari rilis Pratinjau dan disediakan hanya untuk tujuan evaluasi dan pengembangan. Ini dapat berubah berdasarkan umpan balik dan tidak disarankan untuk penggunaan produksi.

Permissions

Pemanggil harus memiliki hak administrator Fabric.

Cakupan yang Didelegasikan yang Diperlukan

Tenant.ReadWrite.All.

Limitations

Maksimum sepuluh permintaan per menit.

Identitas yang didukung Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identity	Support
User	Yes
Prinsipal Layanan dan Identitas Terkelola	Yes

Interface

POST https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/restore

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
workspaceId	path	True	string (uuid)	ID ruang kerja.

Isi Permintaan

Nama	Jenis	Deskripsi
newWorkspaceAdminPrincipal	Principal: UserPrincipal ServicePrincipalPrincipal GroupPrincipal ServicePrincipalProfilePrincipal EntireTenantPrincipal	Admin ruang kerja.
newWorkspaceName	string	Nama ruang kerja. Wajib jika permintaan pemulihan adalah untuk Ruang kerja saya.

Respons

Nama	Jenis	Deskripsi
200 OK		Pulihkan ruang kerja dengan sukses.
429 Too Many Requests	ErrorResponse	Batas tarif layanan terlampaui. Server mengembalikan header yang Retry-After menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan. Header Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: UnknownError - Terjadi kesalahan.

Contoh

Restore workspace example

Permintaan sampel

HTTP

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"
  }
}

Respon sampel

Kode status:

200

Definisi

Nama	Deskripsi
EntireTenantPrincipal	Mewakili perwakilan penyewa
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
GroupDetails	Mengelompokkan detail spesifik. Berlaku ketika jenis utama Group.
GroupPrincipal	Mewakili grup keamanan.
GroupType	Jenis grup. Jenis grup tambahan dapat ditambahkan dari waktu ke waktu.
PrincipalType	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.
RestoreWorkspaceRequest	Permintaan untuk memulihkan ruang kerja yang dihapus.
ServicePrincipalDetails	Detail spesifik perwakilan layanan. Berlaku ketika jenis utama ServicePrincipal.
ServicePrincipalPrincipal	Mewakili perwakilan layanan Microsoft Entra.
ServicePrincipalProfileDetails	Detail profil perwakilan layanan. Berlaku ketika jenis utama ServicePrincipalProfile.
ServicePrincipalProfilePrincipal	Mewakili profil perwakilan layanan.
UserDetails	Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama User.
UserPrincipal	Mewakili prinsipal pengguna Microsoft Entra.

EntireTenantPrincipal

Objek

Mewakili perwakilan penyewa

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
id	string (uuid)	Id utama.
type	string: EntireTenant	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
isRetriable	boolean	Jika benar, permintaan dapat dicoba kembali. Retry-After Gunakan header respons untuk menentukan penundaan, jika tersedia.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string (uuid)	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.

GroupDetails

Objek

Mengelompokkan detail spesifik. Berlaku ketika jenis utama Group.

Nama	Jenis	Deskripsi
groupType	GroupType	Jenis grup. Jenis grup tambahan dapat ditambahkan dari waktu ke waktu.

GroupPrincipal

Objek

Mewakili grup keamanan.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
groupDetails	GroupDetails	Mengelompokkan detail spesifik. Berlaku ketika jenis utama Group.
id	string (uuid)	Id utama.
type	string: Group	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

GroupType

Enumerasi

Jenis grup. Jenis grup tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Unknown	Jenis grup utama tidak diketahui.
SecurityGroup	Prinsipal adalah kelompok keamanan.
DistributionList	Prinsipal adalah daftar distribusi.

PrincipalType

Enumerasi

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
User	Prinsipal adalah prinsipal pengguna Microsoft Entra.
ServicePrincipal	Prinsipal adalah perwakilan layanan Microsoft Entra.
Group	Prinsipal adalah kelompok keamanan.
ServicePrincipalProfile	Perwakilan adalah profil perwakilan layanan.
EntireTenant	Perwakilan mewakili semua pengguna penyewa.

RestoreWorkspaceRequest

Objek

Permintaan untuk memulihkan ruang kerja yang dihapus.

Nama	Jenis	Deskripsi
newWorkspaceAdminPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Admin ruang kerja.
newWorkspaceName	string	Nama ruang kerja. Wajib jika permintaan pemulihan adalah untuk Ruang kerja saya.

ServicePrincipalDetails

Objek

Detail spesifik perwakilan layanan. Berlaku ketika jenis utama ServicePrincipal.

Nama	Jenis	Deskripsi
aadAppId	string (uuid)	Microsoft Entra AppId perwakilan layanan.

ServicePrincipalPrincipal

Objek

Mewakili perwakilan layanan Microsoft Entra.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
id	string (uuid)	Id utama.
servicePrincipalDetails	ServicePrincipalDetails	Detail spesifik perwakilan layanan. Berlaku ketika jenis utama ServicePrincipal.
type	string: ServicePrincipal	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

ServicePrincipalProfileDetails

Objek

Detail profil perwakilan layanan. Berlaku ketika jenis utama ServicePrincipalProfile.

Nama	Jenis	Deskripsi
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Perwakilan induk profil perwakilan layanan.

ServicePrincipalProfilePrincipal

Objek

Mewakili profil perwakilan layanan.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
id	string (uuid)	Id utama.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Detail profil perwakilan layanan. Berlaku ketika jenis utama ServicePrincipalProfile.
type	string: ServicePrincipalProfile	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

UserDetails

Objek

Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama User.

Nama	Jenis	Deskripsi
userPrincipalName	string	Nama prinsipal pengguna.

UserPrincipal

Objek

Mewakili prinsipal pengguna Microsoft Entra.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
id	string (uuid)	Id utama.
type	string: User	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.
userDetails	UserDetails	Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama User.