保留中の PAM 要求を取得する

特権アカウントを使用して、承認が必要な保留中の要求の一覧が返されます。

Note

この記事の Url は、API の展開時に選択されたホスト名 (など) に関連してい https://api.contoso.com ます。

Request

Method 要求 URL
GET /api/pamresources/pamrequeststoapprove

クエリ パラメーター

パラメーター 説明
$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 要求承認オブジェクトの一覧が含まれています。

プロパティ 説明
RoleName 承認を必要とするロールの表示名。
要求元 承認の要求元のユーザー名。
妥当性 ユーザーによって提供される位置揃え。
RequestedTTL 要求の有効期限 (秒)。
RequestedTime 昇格の要求時間。
CreationTime 要求の作成時間。
FIMRequestID PAM 要求の一意識別子 (GUID) を持つ単一の要素 "Value" を格納します。
RequestorID PAM 要求を作成した Active Directory アカウントの一意の識別子 (GUID) を持つ単一の要素 "Value" を格納します。
ApprovalObjectID 承認オブジェクトの一意識別子 (GUID) を持つ単一の要素 "Value" を格納します。

このセクションでは、保留中の PAM 要求を取得する例を示します。

例: 要求

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

例: Response

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