Hämta väntande PAM-förfrågningarGet Pending PAM Requests

Används av ett konto med privilegier för att returnera en lista över väntande begäranden som måste godkännas.Used by a privileged account to return a list of pending requests that need approval.

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/pamrequeststoapprove/api/pamresources/pamrequeststoapprove

FrågeparametrarQuery Parameters

ParameterParameter BeskrivningDescription
$filter$filter Valfritt.Optional. Ange de Perding PAM Request egenskaper i ett filteruttryck för att returnera en filtrerad lista över svar.Specify any of the Perding 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 PAM begäran om godkännande objekt med följande egenskaper.A successful response contains a list of PAM request approval objects with the following properties.

EgenskapProperty BeskrivningDescription
RoleNameRoleName Visningsnamnet för rollen som krävs för godkännande.The display name of the role for which approval is needed.
BegärandeRequestor Användarnamn för den begärande godkänns.The user name of the requestor to be approved.
MotiveringenJustification Motiveringen som anges av användaren.The justification provided by the user.
RequestedTTLRequestedTTL Den begärda giltighetstid tiden i sekunder.The requested expiration time in seconds.
RequestedTimeRequestedTime Den begärda tiden för höjning.The requested time for elevation.
SkapadTidCreationTime Skapandetid för begäran.The creation time of the request.
FIMRequestIDFIMRequestID Innehåller ett element, ”värde” med den unika identifieraren (GUID) för PAM-förfrågan.Contains a single element, "Value", with the unique identifier (GUID) of the PAM request.
RequestorIDRequestorID Innehåller ett element, ”värde” med den unika identifieraren (GUID) för Active Directory-konto som skapade PAM-förfrågan.Contains a single element, "Value", with the unique identifier (GUID) for the Active Directory account that created the PAM request.
ApprovalObjectIDApprovalObjectID Innehåller ett element, ”värde” med den unika identifieraren (GUID) för godkännande-objektet.Contains a single element, "Value", with the unique identifier (GUID) for the Approval Object.

ExempelExample

BegäranRequest

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

SvarResponse

HTTP/1.1 200 OK

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequeststoapprove",
    "value":[
        {
            "RoleName":"ApprovalRole",
            "Requestor":"PRIV.Jen",
            "Justification":"Justification Reason",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-07-11T22:25:00Z",
            "CreationTime":"2015-07-11T22:24:52.51Z",
            "FIMRequestID":{
                "Value":"9802d7b7-b4e9-4fe4-8f5c-649cda127e49"
            },
            "RequestorID":{
                "Value":"73257e5e-00b3-4309-a330-f1e607ff113a"
            },
            "ApprovalObjectID":{
                "Value":"5dbd9d0c-0a9d-4f75-8cbd-ff6ffdc00143"
            }
        }
    ]
}