Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Dans la gestion des droits d’utilisation de Microsoft Entra, renvoyez une collection d’approbations d’attribution de package d’accès. Les objets retournés sont ceux qui sont dans la portée de l’approbation de l’utilisateur appelant.
Dans PIM pour les groupes, renvoyer une collection d’approbations de devoirs. Les objets retournés sont ceux qui sont dans la portée de l’approbation de l’utilisateur appelant.
Cette API est disponible dans les déploiements cloud nationaux suivants.
| Service global | Gouvernement américain L4 | Gouvernement américain L5 (DOD) | Chine exploitée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
Pour la gestion des droits d’utilisation
| Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
|---|---|
| Déléguée (compte professionnel ou scolaire) | EntitlementManagement.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | Non prise en charge. |
Pour PIM pour les groupes
| Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
|---|---|
| Déléguée (compte professionnel ou scolaire) | PrivilegedAssignmentSchedule.Read.AzureADGroup, PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | Non prise en charge. |
Requête HTTP
Pour récupérer les ressources d’approbation dans la gestion des droits d’utilisation :
GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/filterByCurrentUser(on='approver')
Pour récupérer les ressources d’approbation dans PIM pour les groupes :
GET /identityGovernance/privilegedAccess/group/assignmentApprovals/filterByCurrentUser(on='approver')
Paramètres de fonction
Cette méthode prend en charge les paramètres de requête OData pour la pagination dans un jeu de résultats volumineux. Pour des informations générales, consultez paramètres de la requête OData.
| Paramètre | Type | Description |
|---|---|---|
| actif | approvalFilterByCurrentUserOptions | La valeur autorisée est approver. Obligatoire. |
En-têtes de demande
| Nom | Description |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
En cas de réussite, cette méthode renvoie un 200 OK code de réponse et une collection d’objets d’approbation dans le corps de la réponse.
Exemples
Exemple 1 : Récupérer les ressources d’approbation dans la gestion des droits d’utilisation
Demande
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/filterByCurrentUser(on='approver')
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.approval",
"id": "368f6786-6786-368f-8667-8f3686678f36"
}
]
}
Exemple 2 : récupérer les ressources d’approbation dans PIM pour les groupes
Demande
GET https://graph.microsoft.com/beta/identityGovernance/privilegedAccess/group/assignmentApprovals/filterByCurrentUser(on='approver')
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.approval",
"id": "46bc634a-0696-43c5-bc99-d568bc3c27f5",
"stages": [
{
"id": "46bc634a-0696-43c5-bc99-d568bc3c27f5",
"displayName": null,
"reviewedDateTime": null,
"reviewResult": "NotReviewed",
"status": "Completed",
"assignedToMe": true,
"justification": "",
"reviewedBy": null
}
]
}
]
}