Partager via


Répertorier les éléments supprimés (objets d’annuaire)

Espace de noms: microsoft.graph

Récupérez une liste d’objets d’annuaire récemment supprimés. Actuellement, les fonctionnalités d’éléments supprimés sont uniquement prises en charge pour l’application, servicePrincipal, le groupe, l’unité administrative et les ressources utilisateur .

Note: Les groupes de sécurité supprimés sont supprimés définitivement et ne peuvent pas être récupérés via cette API.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Le tableau suivant indique l’autorisation ou les autorisations les moins privilégiées requises pour appeler cette API sur chaque type de ressource pris en charge. Suivez les bonnes pratiques pour demander des autorisations minimales. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Ressource prise en charge Déléguée (compte professionnel ou scolaire) Déléguée (compte Microsoft personnel) Application
administrativeUnit AdministrativeUnit.Read.All Non prise en charge. AdministrativeUnit.Read.All
application Application.Read.All Non prise en charge. Application.Read.All
groupe Group.Read.All Non prise en charge. Group.Read.All
servicePrincipal Application.Read.All Non prise en charge. Application.Read.All
utilisateur User.Read.All Non prise en charge. User.Read.All

Importante

Lorsqu’une application interroge une relation qui retourne une collection de types directoryObject , si elle n’a pas l’autorisation de lire un certain type de ressource, les membres de ce type sont retournés, mais avec des informations limitées. Par exemple, seule la propriété @odata.type pour le type d’objet et l’ID est retournée, tandis que les autres propriétés sont indiquées comme null. Avec ce comportement, les applications peuvent demander les autorisations les moins privilégiées dont elles ont besoin, plutôt que de s’appuyer sur l’ensemble de Répertoire.*Autorisations. Pour plus d’informations, consultez Informations limitées retournées pour les objets membres inaccessibles.

Requête HTTP

GET /directory/deleteditems/microsoft.graph.application
GET /directory/deleteditems/microsoft.graph.servicePrincipal
GET /directory/deletedItems/microsoft.graph.group
GET /directory/deletedItems/microsoft.graph.user
GET /directory/deletedItems/microsoft.graph.administrativeUnit

Le type de cast OData est une partie obligatoire de l’URI et l’appel GET /directory/deleteditems sans type n’est pas pris en charge.

Paramètres facultatifs de la requête

Cette méthode prend en charge les paramètres de requête pris en charge par la ressource spécifiée par le cast OData. C’est-à-dire, $count, $expand$filter, $orderby, $search$select, et $top paramètres de requête. Cette API retourne 100 objets par défaut et prend en charge le retour de jusqu’à 999 objets par page à l’aide $topde .

Certaines requêtes sont prises en charge uniquement lorsque vous utilisez l’en-tête ConsistencyLevel défini sur eventual et $count. Par exemple :

GET https://graph.microsoft.com/beta/directory/deletedItems/microsoft.graph.group?&$count=true&$orderby=deletedDateTime desc&$select=id,displayName,deletedDateTime
ConsistencyLevel: eventual

Cet exemple nécessite l’en-tête ConsistencyLevel , car les paramètres de $orderby requête et $count sont utilisés dans la requête.

$orderby exemples de paramètres de requête OData

Le $orderby paramètre de requête OData est pris en charge sur les propriétés deletedDateTime, displayName et userPrincipalName des types d’objets supprimés. Sur la propriété deletedDateTime , la requête nécessite l’ajout des paramètres de requête avancés (l’en-tête ConsistencyLevel a la eventual valeur et $count=true la chaîne de requête).

Cast OData Propriétés prenant en charge les $orderby Exemple
microsoft.graph.user deletedDateTime, displayName, userPrincipalName /directory/deletedItems/microsoft.graph.user ?$orderby=userPrincipalName
microsoft.graph.group deletedDateTime, displayName /directory/deletedItems/microsoft.graph.group ?$orderby=deletedDateTime asc&$count=true
microsoft.graph.application deletedDateTime, displayName /directory/deletedItems/microsoft.graph.application ?$orderby=displayName
microsoft.graph.device deletedDateTime, displayName /directory/deletedItems/microsoft.graph.device ?$orderby=deletedDateTime&$count=true

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter application/json

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et la collection d’objets directoryObject dans le corps de la réponse.

Exemples

Exemple 1 : Récupérer des groupes supprimés

Demande

GET https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.group

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups",
  "value": [
    {
      "id":"46cc6179-19d0-473e-97ad-6ff84347bbbb",
      "displayName":"SampleGroup",
      "groupTypes":["Unified"],
      "mail":"example@contoso.com",
      "mailEnabled":true,
      "mailNickname":"Example",
      "securityEnabled":false,
      "visibility":"Public"
    }
  ]
}

Exemple 2 : Récupérer le nombre d’objets utilisateur supprimés et classer les résultats en fonction de la propriété deletedDateTime

Demande

GET https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.group?$count=true&$orderby=deletedDateTime asc&$select=id,DisplayName,deletedDateTime
ConsistencyLevel: eventual

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups(id,displayName,deletedDateTime)",
    "@odata.count": 2,
    "value": [
        {
            "id": "c31799b8-0683-4d70-9e91-e032c89d3035",
            "displayName": "Role assignable group",
            "deletedDateTime": "2021-10-26T16:56:36Z"
        },
        {
            "id": "74e45ce0-a52a-4766-976c-7201b0f99370",
            "displayName": "Role assignable group",
            "deletedDateTime": "2021-10-26T16:58:37Z"
        }
    ]
}