Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Wiederherstellen eines kürzlich gelöschten Verzeichnisobjekts aus gelöschten Elementen. Die folgenden Typen werden unterstützt:
- administrativeUnit
- application
- agentIdentityBlueprint
- agentIdentity
- agentIdentityBlueprintPrincipal
- agentUser
- certificateBasedAuthPki
- certificateAuthorityDetail
- externalUserProfile
- Gruppe
- pendingExternalUserProfile
- servicePrincipal
- user
Wenn ein Element versehentlich gelöscht wurde, können Sie das Element vollständig wiederherstellen. Darüber hinaus wird beim Wiederherstellen einer Anwendung der zugeordnete Dienstprinzipal nicht automatisch wiederhergestellt. Sie müssen diese API aufrufen, um den gelöschten Dienstprinzipal explizit wiederherzustellen.
Ein kürzlich gelöschtes Element bleibt bis zu 30 Tage lang verfügbar. Nach 30 Tagen wird das Element dauerhaft gelöscht.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Berechtigungen
In der folgenden Tabelle sind die Berechtigungen mit den geringsten Berechtigungen aufgeführt, die zum Aufrufen dieser API für jeden unterstützten Ressourcentyp erforderlich sind. Befolgen Sie die bewährten Methoden , um Berechtigungen mit den geringsten Berechtigungen anzufordern. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Unterstützte Ressource | Delegiert (Geschäfts-, Schul- oder Unikonto) | Delegiert (persönliches Microsoft-Konto) | Application |
|---|---|---|---|
| administrativeUnit | AdministrativeUnit.ReadWrite.All | Nicht unterstützt | AdministrativeUnit.ReadWrite.All |
| application | Application.ReadWrite.All | Nicht unterstützt | Application.ReadWrite.OwnedBy |
| agentIdentity | AgentIdentity.DeleteRestore.All | Nicht unterstützt | AgentIdentity.DeleteRestore.All |
| agentIdentityBlueprint | AgentIdentityBlueprint.DeleteRestore.All | Nicht unterstützt | AgentIdentityBlueprint.DeleteRestore.All |
| agentIdentityBlueprintPrincipal | AgentIdentityBlueprintPrincipal.DeleteRestore.All | Nicht unterstützt | AgentIdentityBlueprintPrincipal.DeleteRestore.All |
| agentUser | AgentIdUser.ReadWrite.IdentityParentedBy | Nicht unterstützt | AgentIdUser.ReadWrite.IdentityParentedBy |
| certificateBasedAuthPki | PublicKeyInfrastructure.Read.All | Nicht unterstützt | PublicKeyInfrastructure.Read.All |
| certificateAuthorityDetail | PublicKeyInfrastructure.Read.All | Nicht unterstützt | PublicKeyInfrastructure.Read.All |
| externalUserProfile | ExternalUserProfile.ReadWrite.All | Nicht unterstützt | ExternalUserProfile.ReadWrite.All |
| group | Group.ReadWrite.All | Nicht unterstützt | Group.ReadWrite.All |
| pendingExternalUserProfile | PendingExternalUserProfile.ReadWrite.All | Nicht unterstützt | PendingExternalUserProfile.ReadWrite.All |
| servicePrincipal | Application.ReadWrite.All | Nicht unterstützt | Application.ReadWrite.OwnedBy |
| user | User.DeleteRestore.All | Nicht unterstützt | User.DeleteRestore.All |
Wichtig
Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. Dieser Vorgang unterstützt die folgenden integrierten Rollen, die nur die geringstmöglichen Berechtigungen gewähren:
- Agentidentitäten, Agentidentitätsblaupausen und Agentidentitätsblaupausenprinzipale: Agent-ID-Administrator
- Verwaltungseinheiten: Verzeichnisleser (schreibgeschützt), globale Leser (schreibgeschützt), Administrator mit privilegierter Rolle
- Anwendungen: Administrator für Hybrididentitäten, Administrator für Cloudanwendungen, Anwendungsadministrator
- Externe Benutzerprofile: Globaler Leser (schreibgeschützt), Skype for Business-Administrator, Teams-Administrator
- Gruppen: Gruppenadministrator (außer bei rollenzuweisbaren Gruppen), Benutzeradministrator (außer bei rollenzuweisbaren Gruppen), Administrator für privilegierte Rollen (Rolle mit den geringsten Berechtigungen für rollenzuweisfähige Gruppen)
- Ausstehende externe Benutzerprofile: Globaler Leser (schreibgeschützt), Skype for Business-Administrator, Teams-Administrator
- Dienstprinzipale: Administrator für Hybrididentitäten, Administrator für Cloudanwendungen, Anwendungsadministrator
- Benutzer: Authentifizierungsadministrator, Administrator für privilegierte Authentifizierung, Benutzeradministrator. So stellen Sie jedoch Benutzer mit privilegierten Administratorrollen wieder her:
- In delegierten Szenarien muss der App die delegierte Berechtigung Directory.AccessAsUser.All zugewiesen werden, und dem aufrufenden Benutzer muss außerdem eine höhere privilegierte Administratorrolle zugewiesen werden, wie in "Wer kann sensible Aktionen ausführen?" angegeben.
- In Nur-App-Szenarien muss der App zusätzlich zur Erteilung der Anwendungsberechtigung User.ReadWrite.All eine höhere, privilegierte Administratorrolle zugewiesen werden, wie unter Wer kann sensible Aktionen ausführen?
HTTP-Anforderung
POST /directory/deletedItems/{id}/restore
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-type | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.
In der folgenden Tabelle sind die Parameter aufgeführt, die erforderlich sind, wenn Sie diese Aktion aufrufen.
| Parameter | Typ | Beschreibung |
|---|---|---|
| autoReconcileProxyConflict | Boolean | Optionaler Parameter. Gibt an, ob Microsoft Entra ID alle in Konflikt stehenden Proxyadressen entfernen soll, während ein vorläufig gelöschter Benutzer wiederhergestellt wird, dessen eine oder mehrere Proxyadressen derzeit für einen aktiven Benutzer verwendet werden. Wird nur zum Wiederherstellen eines vorläufig gelöschten Benutzers verwendet. Der Standardwert für diesen Parameter ist false. |
| newUserPrincipalName | Zeichenfolge | Der neue userPrincipalName , der dem wiederhergestellten Benutzer hinzugefügt werden soll. Optional. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das directoryObject-Objekt im Antworttext zurückgegeben.
Beispiele
Beispiel 1: Wiederherstellen eines gelöschten Verzeichnisobjekts
Anforderung
POST https://graph.microsoft.com/beta/directory/deletedItems/46cc6179-19d0-473e-97ad-6ff84347bbbb/restore
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context":"https://graph.microsoft.com/beta/$metadata#directoryObjects/$entity",
"@odata.type":"#microsoft.graph.group",
"id":"46cc6179-19d0-473e-97ad-6ff84347bbbb",
"displayName":"SampleGroup",
"groupTypes":["Unified"],
"mail":"example@contoso.com",
"mailEnabled":true,
"mailNickname":"Example",
"securityEnabled":false,
"visibility":"Public"
}
Beispiel 2: Wiederherstellen eines gelöschten Benutzers und Entfernen von in Konflikt stehenden Proxyadressen
Anforderung
POST https://graph.microsoft.com/beta/directory/deletedItems/78bf875b-9343-4edc-9130-0d3958113563/restore
Content-Type: application/json
{
"autoReconcileProxyConflict": true
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users/$entity",
"@odata.type": "#microsoft.graph.user",
"id": "78bf875b-9343-4edc-9130-0d3958113563",
"businessPhones": [],
"displayName": "SampleUser",
"givenName": "Sample",
"jobTitle": "Product Marketing Manager",
"mail": "sampleuser@contoso.com",
"mobilePhone": "+1 425 555 0109",
"officeLocation": "18/2111",
"preferredLanguage": "en-US",
"surname": "Vance",
"userPrincipalName": "sampleuser@contoso.com"
}
Beispiel 3: Wiederherstellen eines gelöschten Benutzers und Zuweisen eines neuen userPrincipalName
Anforderung
POST https://graph.microsoft.com/beta/directory/deletedItems/78bf875b-9343-4edc-9130-0d3958113563/restore
Content-Type: application/json
{
"newUserPrincipalName": "johndoe@contoso.com"
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects/$entity",
"@odata.type": "#microsoft.graph.user",
"id": "78bf875b-9343-4edc-9130-0d3958113563",
"businessPhones": [],
"displayName": "SampleUser",
"givenName": "Sample",
"mobilePhone": "+1 425 555 0109",
"officeLocation": "18/2111",
"preferredLanguage": "en-US",
"surname": "Vance",
"userPrincipalName": "johndoe@contoso.com"
}