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

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

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

注意

この記事の 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) を持つ 1 つの要素 "Value" が含まれます。
RequestorID	PAM 要求を作成した Active Directory アカウントの一意識別子 (GUID) を持つ単一の要素 "Value" が含まれます。
ApprovalObjectID	承認オブジェクトの一意識別子 (GUID) を持つ単一の要素 "Value" が含まれます。

例

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

例: 要求

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

例: 応答

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