Répertorier les éléments supprimés (objets d’annuaire) appartenant à un utilisateur

Espace de noms: microsoft.graph

Récupérez la liste des objets d’application et de groupe récemment supprimés appartenant à l’utilisateur spécifié.

Cette API retourne jusqu’à 1 000 objets supprimés appartenant à l’utilisateur, triés par ID et ne prend pas en charge la pagination.

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

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. 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.

Type d’autorisation	Autorisations avec privilèges minimum	Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire)	Group.Read.All	Group.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.	Non prise en charge.
Application	Group.Read.All	Group.ReadWrite.All

Requête HTTP

POST /directory/deletedItems/getUserOwnedObjects

En-têtes de demande

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

Corps de la demande

Le corps de la demande requiert les paramètres suivants :

Paramètre	Type	Description
userId	String	ID du propriétaire.
type	Chaîne	Type d’objets détenus à retourner ; Group et Application sont actuellement les seules valeurs prises en charge.

Réponse

Les demandes réussies retournent 200 OK des codes de réponse ; l’objet response inclut des propriétés de répertoire (éléments supprimés).

Exemple

Demande

L’exemple suivant illustre une demande.

HTTP

POST https://graph.microsoft.com/beta/directory/deletedItems/getUserOwnedObjects
Content-type: application/json

{
  "userId":"55ac777c-109e-4022-b58c-470c8fcb6892",
  "type":"Group"
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const directoryObject = {
  userId: '55ac777c-109e-4022-b58c-470c8fcb6892',
  type: 'Group'
};

await client.api('/directory/deletedItems/getUserOwnedObjects')
	.version('beta')
	.post(directoryObject);

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Réponse

L’exemple suivant illustre la 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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.group",
      "id": "bfa7033a-7367-4644-85f5-95aaf385cbd7",
      "deletedDateTime": "2018-04-01T12:39:16Z",
      "classification": null,
      "createdDateTime": "2017-03-22T12:39:16Z",
      "description": null,
      "displayName": "Test",
      "groupTypes": [
        "Unified"
      ],
      "mail": "Test@contoso.com",
      "mailEnabled": true,
      "mailNickname": "Test",
      "membershipRule": null,
      "membershipRuleProcessingState": null,
      "preferredDataLocation": null,
      "preferredLanguage": null,
      "proxyAddresses": [
        "SMTP:Test@contoso.com"
      ],
      "renewedDateTime": "2017-09-22T22:30:39Z",
      "securityEnabled": false,
      "theme": null,
      "visibility": "Public"
    }
  ]
}