Delen via

PAM-aanvragen ophalen

Wordt gebruikt door een bevoegd account om een geschiedenis van eerder geplaatste PAM-aanvragen te retourneren.

Notitie

De URL's in dit artikel zijn relatief ten opzichte van de hostnaam die tijdens de API-implementatie is gekozen, zoals https://api.contoso.com.

Aanvraag

Methode Aanvraag-URL
GET /api/pamresources/pamrequests

Query parameters

Maatstaf Beschrijving
$filter Facultatief. Geef een van de PAM-aanvraageigenschappen op in een filterexpressie om een gefilterde lijst met antwoorden te retourneren. Zie Filteren in de PAM REST API-servicedetailsvoor meer informatie over ondersteunde operators.
v Facultatief. De API-versie. Als deze niet is opgenomen, wordt de huidige (meest recent uitgebrachte) versie van de API gebruikt. Zie Versiebeheer in de PAM REST API-servicedetailsvoor meer informatie.

Headers aanvragen

Zie HTTP-aanvraag- en antwoordheaders in PAM REST API-servicedetailsvoor algemene aanvraagheaders.

Inhoud van het verzoek

Geen.

Reactie

In deze sectie wordt het antwoord beschreven.

Antwoordcodes

Code Beschrijving
200 OK
401 Niet geautoriseerd
403 Verboden
408 Time-out aanvraag
500 Interne serverfout
503 Service niet beschikbaar

Antwoordheaders

Zie HTTP-aanvraag- en antwoordheaders in PAM REST API-servicedetailsvoor algemene aanvraagheaders.

Antwoordlichaam

Een geslaagd antwoord bevat een lijst met PAM-aanvraagobjecten met de volgende eigenschappen:

Vastgoed Beschrijving
RequestID De unieke id (GUID) voor de PAM-aanvraag.
CreatorID Een unieke id (GUID) voor het Active Directory-account dat de PAM-aanvraag heeft gemaakt.
Rechtvaardiging De reden voor verhoging.
DisplayName De weergavenaam van de PAM-aanvraag in MIM.
CreationTime De aanmaaktijd van de aanvraag.
CreationMethod De methode die wordt gebruikt om de aanvraag te maken.
ExpirationTime De verlooptijd van de aanvraag.
RoleID De unieke id (GUID) van de PAM-rol.
RequestedTTL De aangevraagde time-out voor verlooptijd in seconden.
RequestedTime De aangevraagde tijd voor benodigde bevoegdheden.
RequestedStatus De status van de aanvraag. De mogelijke waarden zijn 'Actief', 'Gesloten', 'Sluiten', 'Verlopen', 'PendingApproval' en 'Geweigerd'.

Voorbeeld

Deze sectie bevat een voorbeeld voor het ophalen van de geplaatste PAM-aanvragen.

Voorbeeld: aanvraag

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

Voorbeeld: respons

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"
        }
    ]
}
  • Last updated on