ポリシー違反履歴の取得
get
/iam/governance/selfservice/api/v1/policyviolations/{pvid}/history
指定されたポリシー違反IDのポリシー違反の履歴を返します。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
- pvid: string
ポリシー違反ID。
問合せパラメータ
- fields(optional): string
結果に返される属性。カンマ区切り属性を受け入れます。属性のサンプル値は、"action、comment、entityType、severity、status"です。ネストされたエンティティはフィルタできません。たとえば、"remediatorUser、remediatorRole"などは、返すことができる属性にすることはできません。
- q(optional): string
レコードのサブセットを取得する検索フィルタ。SCIMフィルタを受け入れます。属性値に空白は使用できません。属性値に空白を渡す場合、"::"に置き換えます。結果は、重大度またはポリシー違反の他の属性に基づいてフィルタできます。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ヘッダー
- ResponseTime: string
リクエストの処理にかかった時間(ミリ秒)を取得します。
401レスポンス
未認可
404レスポンス
リクエスト・エンティティが見つからない
500レスポンス
内部サーバー・エラー
デフォルト・レスポンス
予期しないエラー
例
この例では、指定されたポリシー違反の履歴を取得します。ここに示す情報は、擬似システムを使用した場合のものであり、プロトタイプとして提供しています。
cURLの例
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/policyviolations/9118FD33CDD4454B916DA94DC2A9A2B8/history
GETレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{ "policyviolationsHistory": { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/policyviolations/9118FD33CDD4454B916DA94DC2A9A2B8/history?offset=1&limit=10" }, { "rel": "first", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/policyviolations/9118FD33CDD4454B916DA94DC2A9A2B8/history?offset=1&limit=10" } ], "count": 3, "hasMore": false, "totalResult": -1, "violationHistory": [ { "actionDate": 1467699246892, "action": "policyviolation.action.create", "status": "policyviolation.status.open", "user": { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/users/4" } ] } }, { "cause": "Role Email = devrole@mydomain.com", "ruleName": "CheckGmailForRole", "actionDate": 1467699246947, "action": "policyviolationcause.action.activate", "status": "policyviolationcause.status.active", "user": { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/users/4" } ] } }, { "actionDate": 1467699286702, "action": "policyviolation.action.assign", "status": "policyviolation.status.assigned", "user": { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/users/4" } ] } } ] }, "assignedTo": { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/roles/215" } ] } }