Workspaces - Restore Workspace

Tjeneste:

Admin

API-versjon:

v1

Gjenoppretter et slettet arbeidsområde.

Note

Denne API-en er en del av en forhåndsversjon, og er bare tilgjengelig for evaluerings- og utviklingsformål. Det kan endres basert på tilbakemelding og anbefales ikke for produksjonsbruk.

Permissions

Innringeren må ha administratorrettigheter for Fabric.

Nødvendige delegerte omfang

Tenant.ReadWrite.All.

Limitations

Maksimalt ti forespørsler per minutt.

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identity	Support
User	Yes
tjenestekontohaver og administrerte identiteter	Yes

Interface

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

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
workspaceId	path	True	string (uuid)	Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn	Type	Beskrivelse
newWorkspaceAdminPrincipal	Principal: UserPrincipal ServicePrincipalPrincipal GroupPrincipal ServicePrincipalProfilePrincipal EntireTenantPrincipal	Administratoren for arbeidsområdet.
newWorkspaceName	string	Navnet på arbeidsområdet. Obligatorisk hvis gjenopprettingsforespørselen er for Mitt arbeidsområde.

Svar

Navn	Type	Beskrivelse
200 OK		Gjenoppretting av arbeidsområde er fullført.
429 Too Many Requests	ErrorResponse	Grensen for tjenestesats ble overskredet. Serveren returnerer en Retry-After topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler. Overskrifter Retry-After: integer
Other Status Codes	ErrorResponse	Vanlige feilkoder: UnknownError - Det oppstod en feil.

Eksempler

Restore workspace example

Eksempelforespørsel

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

Eksempelsvar

Statuskode:

200

Definisjoner

Navn	Beskrivelse
EntireTenantPrincipal	Representerer en leierkontohaver
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.
GroupDetails	Grupper bestemte detaljer. Gjelder når hovedtypen er Group.
GroupPrincipal	Representerer en sikkerhetsgruppe.
GroupType	Typen gruppe. Flere gruppetyper kan legges til over tid.
PrincipalType	Typen hovedstol. Flere hovedstoltyper kan legges til over tid.
RestoreWorkspaceRequest	Forespørselen om å gjenopprette et slettet arbeidsområde.
ServicePrincipalDetails	Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er ServicePrincipal.
ServicePrincipalPrincipal	Representerer en Microsoft Entra-tjenestekontohaver.
ServicePrincipalProfileDetails	Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er ServicePrincipalProfile.
ServicePrincipalProfilePrincipal	Representerer en tjenestekontohaverprofil.
UserDetails	Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er User.
UserPrincipal	Representerer en Microsoft Entra-brukerkontohaver.

EntireTenantPrincipal

Objekt

Representerer en leierkontohaver

Navn	Type	Beskrivelse
displayName	string	Hovedkontohaverens visningsnavn.
id	string (uuid)	Hovedkontohaverens ID.
type	string: EntireTenant	Typen hovedstol. Flere hovedstoltyper kan legges til over tid.

ErrorRelatedResource

Objekt

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Objekt

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string (uuid)	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Objekt

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.

GroupDetails

Objekt

Grupper bestemte detaljer. Gjelder når hovedtypen er Group.

Navn	Type	Beskrivelse
groupType	GroupType	Typen gruppe. Flere gruppetyper kan legges til over tid.

GroupPrincipal

Objekt

Representerer en sikkerhetsgruppe.

Navn	Type	Beskrivelse
displayName	string	Hovedkontohaverens visningsnavn.
groupDetails	GroupDetails	Grupper bestemte detaljer. Gjelder når hovedtypen er Group.
id	string (uuid)	Hovedkontohaverens ID.
type	string: Group	Typen hovedstol. Flere hovedstoltyper kan legges til over tid.

GroupType

Opplisting

Typen gruppe. Flere gruppetyper kan legges til over tid.

Verdi	Beskrivelse
Unknown	Hovedgruppetypen er ukjent.
SecurityGroup	Hovedstol er en sikkerhetsgruppe.
DistributionList	Hovedstol er en distribusjonsliste.

PrincipalType

Opplisting

Typen hovedstol. Flere hovedstoltyper kan legges til over tid.

Verdi	Beskrivelse
User	Principal er en Microsoft Entra-brukerkontohaver.
ServicePrincipal	Principal er en Microsoft Entra-tjenestekontohaver.
Group	Hovedstol er en sikkerhetsgruppe.
ServicePrincipalProfile	Principal er en tjenestekontohaverprofil.
EntireTenant	Hovedstol representerer alle leierbrukere.

RestoreWorkspaceRequest

Objekt

Forespørselen om å gjenopprette et slettet arbeidsområde.

Navn	Type	Beskrivelse
newWorkspaceAdminPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Administratoren for arbeidsområdet.
newWorkspaceName	string	Navnet på arbeidsområdet. Obligatorisk hvis gjenopprettingsforespørselen er for Mitt arbeidsområde.

ServicePrincipalDetails

Objekt

Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er ServicePrincipal.

Navn	Type	Beskrivelse
aadAppId	string (uuid)	Tjenestekontohaverens Microsoft Entra AppId.

ServicePrincipalPrincipal

Objekt

Representerer en Microsoft Entra-tjenestekontohaver.

Navn	Type	Beskrivelse
displayName	string	Hovedkontohaverens visningsnavn.
id	string (uuid)	Hovedkontohaverens ID.
servicePrincipalDetails	ServicePrincipalDetails	Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er ServicePrincipal.
type	string: ServicePrincipal	Typen hovedstol. Flere hovedstoltyper kan legges til over tid.

ServicePrincipalProfileDetails

Objekt

Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er ServicePrincipalProfile.

Navn	Type	Beskrivelse
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Overordnet hovedkontohaver for tjenestekontohaverprofilen.

ServicePrincipalProfilePrincipal

Objekt

Representerer en tjenestekontohaverprofil.

Navn	Type	Beskrivelse
displayName	string	Hovedkontohaverens visningsnavn.
id	string (uuid)	Hovedkontohaverens ID.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er ServicePrincipalProfile.
type	string: ServicePrincipalProfile	Typen hovedstol. Flere hovedstoltyper kan legges til over tid.

UserDetails

Objekt

Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er User.

Navn	Type	Beskrivelse
userPrincipalName	string	Brukerhovednavn.

UserPrincipal

Objekt

Representerer en Microsoft Entra-brukerkontohaver.

Navn	Type	Beskrivelse
displayName	string	Hovedkontohaverens visningsnavn.
id	string (uuid)	Hovedkontohaverens ID.
type	string: User	Typen hovedstol. Flere hovedstoltyper kan legges til over tid.
userDetails	UserDetails	Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er User.