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