Recevoir des demandes PAM
Permet à un compte privilégié de retourner un historique des demandes PAM précédemment publiées.
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/pamrequests |
Paramètres de requête
| Paramètre | Description |
|---|---|
| $filter | facultatif. Spécifiez l’une des propriétés de demande 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 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 de demande PAM avec les propriétés suivantes :
| Propriété | Description |
|---|---|
| RequestID | Identificateur unique (GUID) de la demande PAM. |
| CreatorID | Identificateur unique (GUID) du compte Active Directory ayant créé la demande PAM. |
| Justification | Motif de l'élévation. |
| DisplayName | Nom complet de la demande PAM dans MIM. |
| CreationTime | Heure de création de la demande. |
| CreationMethod | Méthode utilisée pour créer la demande. |
| ExpirationTime | Délai d'expiration de la demande. |
| RoleID | Identificateur unique (GUID) du rôle PAM. |
| RequestedTTL | Délai d'expiration demandé en secondes. |
| RequestedTime | Heure d'élévation demandée. |
| RequestedStatus | État de la demande. Les valeurs possibles sont « active », « Closed », « Closing », « Expired », « PendingApproval » et « rejected ». |
Exemple
Cette section fournit un exemple pour récupérer les demandes PAM publiées.
Exemple : demande
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":"8f5cec1a-ecba-42ec-b76d-e6e0e4bf4c62",
"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":"8f5cec1a-ecba-42ec-b76d-e6e0e4bf4c62",
"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":"8f5cec1a-ecba-42ec-b76d-e6e0e4bf4c62",
"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":"c28eab4a-95cf-4c08-a153-d5e8a9e660cd",
"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":"c28eab4a-95cf-4c08-a153-d5e8a9e660cd",
"RequestedTTL":"12960000",
"RequestedTime":"2015-07-12T04:50:00Z",
"RequestStatus":"PendingApproval"
}
]
}