Obtenir les demandes PAM en attente

Article
09/14/2023

Permet à un compte privilégié de retourner une liste de demandes en attente nécessitant une approbation.

Notes

Les URL de cet article sont relatives au nom d’hôte choisi pendant le déploiement de l’API, par exemple https://api.contoso.com.

Requête

Méthode	URL de demande
GET	/api/pamresources/pamrequeststoapprove

Paramètres de requête

Paramètre	Description
$filter	facultatif. Spécifiez l’une des propriétés de requête PAM en attente dans une expression de filtre pour renvoyer une liste filtrée de réponses. Pour plus d’informations sur les opérateurs pris en charge, consultez Filtrage dans les détails du service d’API REST PAM.
v	facultatif. Version de l'API. Si elle n’est pas incluse, la version actuelle (la plus récente) de l’API est utilisée. Pour plus d’informations, consultez Gestion de version dans les détails du service d’API REST PAM.

En-têtes de requête

Pour connaître les en-têtes de requête courants, consultez En-têtes de requête et de réponse HTTP dans les détails du service d’API REST PAM.

Corps de la demande

Aucun.

response

Cette section décrit la réponse.

Codes de réponse

Code	Description
200	OK
401	Non autorisé
403	Interdit
408	Délai d’expiration de la demande
500	Erreur interne du serveur
503	Service indisponible

En-têtes de réponse

Pour connaître les en-têtes de requête courants, consultez En-têtes de requête et de réponse HTTP dans les détails du service d’API REST PAM.

Response body

Une réponse réussie contient une liste d’objets d’approbation de demande PAM avec les propriétés suivantes :

Propriété	Description
RoleName	Nom complet du rôle pour lequel l'approbation est nécessaire.
Demandeur	Nom d'utilisateur du demandeur à approuver.
Justification	Justification fournie par l'utilisateur.
RequestedTTL	Durée d'expiration demandée, en secondes.
RequestedTime	Heure d'élévation demandée.
CreationTime	Heure de création de la demande.
FIMRequestID	Contient un élément unique, « Value », avec l’identificateur unique (GUID) de la requête PAM.
RequestorID	Contient un élément unique, « Value », avec l’identificateur unique (GUID) pour le compte Active Directory qui a créé la demande PAM.
ApprovalObjectID	Contient un élément unique, « Value », avec l’identificateur unique (GUID) de l’objet Approval.

Exemple

Cette section fournit un exemple pour obtenir les demandes PAM en attente.

Exemple : requête

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

Exemple : Réponse

HTTP/1.1 200 OK

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequeststoapprove",
    "value":[
        {
            "RoleName":"ApprovalRole",
            "Requestor":"PRIV.Jen",
            "Justification":"Justification Reason",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-07-11T22:25:00Z",
            "CreationTime":"2015-07-11T22:24:52.51Z",
            "FIMRequestID":{
                "Value":"9802d7b7-b4e9-4fe4-8f5c-649cda127e49"
            },
            "RequestorID":{
                "Value":"73257e5e-00b3-4309-a330-f1e607ff113a"
            },
            "ApprovalObjectID":{
                "Value":"5dbd9d0c-0a9d-4f75-8cbd-ff6ffdc00143"
            }
        }
    ]
}

Partager via