Hämta PAM-förfrågningarGet PAM Requests

Används av ett konto med privilegier för att returnera en historik över tidigare bokförd PAM-förfrågningar.Used by a privileged account to return a history of previously posted PAM requests.

Obs: URL: er som visas i det här avsnittet är i förhållande till värdnamnet valt under distributionen av API, till exempel: http://api.contoso.com.Note: URLs shown in this topic are relative to the hostname chosen during API deployment; for example: http://api.contoso.com.

BegäranRequest

MetodMethod URL-begäranRequest URL
GETGET /API/pamresources/pamrequests/api/pamresources/pamrequests

FrågeparametrarQuery Parameters

ParameterParameter BeskrivningDescription
$filter$filter Valfritt.Optional. Ange de PAM-Request egenskaper i ett filteruttryck för att returnera en filtrerad lista över svar.Specify any of the PAM Request properties in a filter expression to return a filtered list of responses. Mer information om stöds operatorer finns filtrering i information om PAM REST API-tjänstenFor more information about supported operators, see Filtering in PAM REST API Service Details
vv Valfritt.Optional. API-versionen.The API version. Om inte ingår, används den aktuella (mest nyligen utgivna) versionen av API: et.If not included, the current (most recently released) version of the API will be used. Mer information finns i versionshantering i information om PAM REST API-tjänstenFor more information, see Versioning in PAM REST API Service Details

Huvuden för begäranRequest Headers

Vanliga begärandehuvuden finns HTTP-begäran och svarshuvuden i information om PAM REST API-tjänsten.For common request headers, see HTTP Request and Response Headers in PAM REST API Service Details.

BegärandetextenRequest Body

ingetnone

SvarResponse

SvarskoderResponse Codes

KodCode BeskrivningDescription
200200 OKOK
401401 ObehörigUnauthorized
403403 Tillåts inteForbidden
408408 Tidsgräns för förfråganRequest Timeout
500500 Internt serverfelInternal Server Error
503503 Tjänsten är inte tillgängligService Unavailable

SvarsrubrikerResponse Headers

Vanliga svarshuvuden finns HTTP-begäran och svarshuvuden i information om PAM REST API-tjänsten.For common response headers, see HTTP Request and Response Headers in PAM REST API Service Details.

SvarstextenResponse Body

Ett lyckat svar innehåller en lista över objekt för PAM-förfrågan med följande egenskaper.A successful response contains a list of PAM request objects with the following properties.

EgenskapProperty BeskrivningDescription
Begärande-IDRequestID Den unika identifieraren (GUID) för PAM-förfrågan.The unique identifier (GUID) for the PAM request.
CreatorIDCreatorID En unik identifierare (GUID) för Active Directory-konto som skapade PAM-förfrågan.A unique identifier (GUID) for the Active Directory account that created the PAM request.
MotiveringenJustification Orsak för höjning.The reason for elevation.
DisplayNameDisplayName Visningsnamn för PAM-förfrågan i MIM.The PAM request’s display name in MIM.
SkapadTidCreationTime Skapandetid för begäran.The creation time of the request.
CreationMethodCreationMethod Den metod som används för att skapa begäran.The method used to create the request.
ExpirationTimeExpirationTime Förfallotid för begäran.The expiration time of the request.
RoleIDRoleID Den unika identifieraren (GUID) för PAM-roll.The unique identifier (GUID) of the PAM role.
RequestedTTLRequestedTTL Den begärda giltighetstid tidsgränsen i sekunder.The requested expiration timeout in seconds.
RequestedTimeRequestedTime Den begärda tiden för höjning.The requested time for elevation.
RequestedStatusRequestedStatus Status för begäran.The status of the request. Möjliga värden är: ”aktiv”, ”stängd”, ”Closing”, ”upphört att gälla”, ”väntar på godkännande” och ”avvisad”.Possible values are: "Active", "Closed", "Closing", "Expired", "Pending Approval", and "Rejected".

ExempelExample

BegäranRequest

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

SvarResponse

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