ポリシーの取得
get
/iam/governance/selfservice/api/v1/policies
指定されたタイプのすべてのアクセス権、ユーザー名および承認ポリシーを返します。その他のフィルタを追加して、絞り込むことができます。たとえば、Aで始まる名前および従業員のロール(roleID=1234)を持つすべてのアクセス・ポリシーを取得するには、URIは/policies?policyType=accessPolicy&roleid=1234&q=name sw "A"となります
リクエスト
サポートされているメディア・タイプ
- application/json
問合せパラメータ
- fields(optional): string
結果に返される属性。ポリシーIDは、戻りリストの属性で必須です。カンマ区切り属性を受け入れます。
- policyType: string
policyType問合せパラメータで指定されるタイプのポリシーを取得できます。サポートされている値は、"usernamePolicy、accessPolicyおよびapprovalPolicy"です。
- q: string
フィルタにより、policyType問合せパラメータで指定されるタイプのポリシーのサブセットを取得できます。SCIMフィルタを受け入れます。属性値に空白は使用できません。属性値に空白を渡す場合、"::"に置き換えます。
- roleid(optional): string
指定されたロールに関連付けられたアクセス・ポリシーを返します。"policyType"が"accessPolicy"の場合、ロールID問合せパラメータは有効です。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ヘッダー
- ResponseTime: string
リクエストの処理にかかった時間(ミリ秒)を取得します。
401レスポンス
未認可
404レスポンス
リソースが見つからない
500レスポンス
内部サーバー・エラー
デフォルト・レスポンス
予期しないエラー
例
この例では、タイプがpasswordPolicyのすべてのポリシーを取得します。ここで表示された情報は疑似システムに対するものであり、プロトタイプとして使用します。
cURLの例
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/policies?policyType=passwordpolicy
GETレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/policies?policyType=passwordpolicy&offset=1&limit=10"
},
{
"rel": "first",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/policies?policyType=passwordpolicy&offset=1&limit=10"
}
],
"count": 1,
"hasMore": false,
"totalResult": -1,
"policy": [
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/policies/42?policyType=passwordPolicy"
}
],
"id": "42",
"pwr_name": "Polict_Test_3",
"pwr_desc": "Polict_Test_3",
"rules": [
"Password must be at least 8 character(s) long.",
"Password cannot be changed for 10 days after the last password change.",
"Password must not be one of 2 previous passwords."
]
}
]
}