PAM 要求を取得する

[アーティクル]
09/14/2023

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

注意

この記事の URL は、などの https://api.contoso.comAPI デプロイ中に選択されたホスト名に対する相対 URL です。

Request

Method	要求 URL
GET	/api/pamresources/pamrequests

クエリパラメーター

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

要求ヘッダー

一般的な要求ヘッダーについては、「PAM REST API サービスの詳細」の「HTTP 要求ヘッダーと応答ヘッダー」を参照してください。

要求本文

なし。

Response

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

応答コード

コード	説明
200	OK
401	権限がありません
403	Forbidden
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"
        }
    ]
}