Récupérer les demandes PAM en attente

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 qui est 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 Optionnel. Spécifiez l’une des propriétés de demande PAM en attente dans une expression de filtre pour retourner 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 de l’API REST PAM.
v Optionnel. Version de l'API. S’il n’est pas inclus, la version actuelle (la plus récente) de l’API est utilisée. Pour plus d’informations, consultez contrôle de version dans les détails du service de l’API REST PAM.

En-têtes de requête

Pour les en-têtes de requête courants, consultez en -têtes de requête et de réponse http dans Détails du service de l' 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 les en-têtes de requête courants, consultez en -têtes de requête et de réponse http dans Détails du service de l' API REST PAM.

Response body

Une réponse correcte 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 demande PAM.
RequestorID Contient un élément unique, « value », avec l’identificateur unique (GUID) du compte Active Directory qui a créé la demande PAM.
ApprovalObjectID Contient un élément unique, « value », avec l’identificateur unique (GUID) de l’objet d’approbation.

Exemple

Cette section fournit un exemple pour récupérer les demandes PAM en attente.

Exemple : demande

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