保留中の PAM 要求を取得する
特権アカウントを使用して、承認が必要な保留中の要求の一覧が返されます。
注意
この記事の 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"
}
}
]
}