取得 PAM 要求

發行項
09/14/2023

由特殊權限帳戶用來傳回先前提出的 PAM 要求的歷程記錄。

注意

本文中的 URL 相對於 API 部署期間所選擇的主機名稱，例如 https://api.contoso.com 。

要求

方法	要求 URL
GET	/api/pamresources/pamrequests

查詢參數

參數	描述
$filter	選擇性。在篩選運算式中指定任何 PAM 要求屬性，以傳回已篩選的回應清單。如需支援操作員的詳細資訊，請參閱 PAM REST API 服務詳細資料中的篩選。
v	選擇性。 API 版本。如果未包含，則會使用目前發行 () 版 API。如需詳細資訊，請參閱 PAM REST API 服務中的版本設定詳細資料。

要求標頭

如需常見的要求標頭，請參閱PAM REST API 服務詳細資料中的HTTP 要求和回應標頭。

要求本文

無。

回應

本節說明回應。

回應碼

程式碼	描述
200	[確定]
401	未經授權
403	禁止
408	要求逾時
500	內部伺服器錯誤
503	服務無法使用

回應標頭

如需常見的要求標頭，請參閱PAM REST API 服務詳細資料中的HTTP 要求和回應標頭。

回應本文

成功的回應包含具有下列屬性的 PAM 要求物件清單：

屬性	描述
RequestID	PAM 要求唯一識別碼 (GUID)。
CreatorID	建立 PAM 要求的 Active Directory 帳戶的唯一識別碼 (GUID)。
理由	提高權限的理由。
DisplayName	PAM 要求在 MIM 中的顯示名稱。
CreationTime	要求的建立時間。
CreationMethod	用來建立要求的方法。
ExpirationTime	要求的到期時間。
RoleID	PAM 角色的唯一識別碼 (GUID)。
RequestedTTL	所要求的到期逾時 (秒)。
RequestedTime	提高權限所要求的時間。
RequestedStatus	要求的狀態。可能的值為「Active」、「Closed」、「Closing」、「Expired」、「PendingApproval」和「Rejected」。

範例

本節提供取得已張貼 PAM 要求的範例。

範例：要求

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

範例：回應

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

共用方式為