PAM 要求を取得する

以前にポストされた PAM 要求の履歴を返すために特権アカウントによって使用されます。

Note

この記事の URL は、API のデプロイ中に選択されたホスト名 (例: ) を基準にしています https://api.contoso.com

Request

Method 要求 URL
GET /api/pamresources/pamrequests

クエリ パラメーター

パラメーター 説明
$filter 任意。 フィルター式で PAM 要求プロパティを指定して、フィルター処理された応答の一覧を返します。 サポートされている演算子の詳細については、「PAM でのフィルター処理とサービスの詳細 」REST API参照してください
v 任意。 API のバージョン。 含まれていない場合は、現在の (最近リリースされた) バージョンの API が使用されます。 詳細については、「PAM でのバージョン 管理とサービスの詳細REST APIを参照してください

要求ヘッダー

一般的な要求ヘッダーについては、PAM の HTTP 要求ヘッダーと応答ヘッダーに関するページREST APIを参照してください

要求本文

[なし] :

Response

このセクションでは、応答について説明します。

応答コード

コード 説明
200 OK
401 権限がありません
403 Forbidden
408 要求タイムアウト
500 内部サーバー エラー
503 サービス利用不可

応答ヘッダー

一般的な要求ヘッダーについては、PAM の HTTP 要求ヘッダーと応答ヘッダーに関するページREST APIを参照してください

応答本文

成功した応答には、次のプロパティを持つ 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"
        }
    ]
}