Gelöschtes Element (Verzeichnisobjekt) wiederherstellen

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:

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