Obtenir des demandes PAM

Article
03/22/2025

Utilisé par un compte privilégié pour retourner un historique des demandes PAM précédemment publiées.

Remarque

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
OBTENIR	/api/pamresources/pamrequests

Paramètres de requête

Paramètre	Description
$filter	Optionnel. Spécifiez l’une des propriétés de requête PAM 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 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 API REST PAM.

En-têtes de requête

Pour obtenir des en-têtes de requête courants, consultez en-têtes de requête et de réponse HTTP dans détails du service d’API REST PAM.

Corps de la requête

Aucun.

Réponse

Cette section décrit la réponse.

Codes de réponse

Code	Description
200	D’ACCORD
401	Non autorisée
403	Interdit
408	Délai de demande
500	Erreur interne du serveur
503	Service indisponible

En-têtes de réponse

Pour obtenir des en-têtes de requête courants, consultez en-têtes de requête et de réponse HTTP dans détails du service d’API REST PAM.

Corps de la réponse

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

Propriété	Description
RequestID	Identificateur unique (GUID) de la requête PAM.
CreatorID	Identificateur unique (GUID) pour le compte Active Directory qui a créé la requête PAM.
Justification	Raison de l’élévation.
Nom d'affichage	Nom complet de la requête PAM dans MIM.
CreationTime	Heure de création de la requête.
CreationMethod	Méthode utilisée pour créer la requête.
ExpirationTime	Heure d’expiration de la demande.
RoleID	Identificateur unique (GUID) du rôle PAM.
RequestedTTL	Délai d’expiration demandé en secondes.
RequestedTime	Heure demandée pour l’élévation.
RequestedStatus	Statut de la demande. Les valeurs possibles sont « Active », « Closed », « Closing », « Expired », « PendingApproval » et « Rejected ».

Exemple :

Cette section fournit un exemple pour obtenir les demandes PAM publiées.

Exemple : requête

GET /api/pamresources/pamrequests?$filter=CreationTime%20gt%20datetime'2015-06-12T04:49:32.431Z'%20and%20CreationTime%20lt%20datetime'2015-07-13T04:49:32.432Z' HTTP/1.1

Exemple : réponse

HTTP/1.1 200 OK

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests",
    "value":[
        {
            "RequestId":"b22e1343-9a2b-4e33-a70a-1bb7b2d405b9",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":null,
            "CreationTime":"2015-06-23T11:34:38.58Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-06-23T12:34:38.847Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-06-23T11:34:36.417Z",
            "RequestStatus":"Expired"
        },
        {
            "RequestId":"3a98d1c7-524d-4b72-9da7-bd9f907eab55",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"Reason for Request",
            "CreationTime":"2015-07-12T04:35:14.433Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-07-12T04:43:51.95Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"12960000",
            "RequestedTime":"2015-07-12T04:35:00Z",
            "RequestStatus":"Closed"
        },
        {
            "RequestId":"f5e80be1-e9a3-42c4-81f8-4be5a4a429f4",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":null,
            "CreationTime":"2015-07-12T04:48:17.46Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-07-12T05:48:17.853Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-07-12T04:48:14.057Z",
            "RequestStatus":"Active"
        },
        {
            "RequestId":"b0f0ddc0-c809-4770-9d39-0d706f97a2de",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"",
            "CreationTime":"2015-06-30T07:01:13.147Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"0001-01-01T00:00:00",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-06-30T07:01:13.119Z",
            "RequestStatus":"Rejected"
        },
        {
            "RequestId":"5ec10e61-cdd1-404e-a18e-740467d87dbf",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"Example Reason",
            "CreationTime":"2015-07-12T04:49:09.963Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"0001-01-01T00:00:00",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"12960000",
            "RequestedTime":"2015-07-12T04:50:00Z",
            "RequestStatus":"PendingApproval"
        }
    ]
}

Partager via