获取 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	MIM 中的 PAM 请求的显示名称。
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":"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"
        }
    ]
}