ジャンプ先

• リクエスト
• レスポンス
• 例

特定のアクセス・ポリシーを返す

get

/iam/governance/adminservice/api/v1/accesspolicies/{policyId}

アクセス・ポリシーIDに基づいて特定のアクセス・ポリシーを返します

リクエスト

パス・パラメータ

• policyId: integer
  アクセス・ポリシーID

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200レスポンス

アクセス・ポリシー

本文()

ルート・スキーマ : accessPolicy

型: object

アクセス・ポリシー詳細

ソースを表示

• deniedApplications(optional): array deniedApplications
  拒否されたアプリケーションの詳細
• description(optional): string
  アクセス・ポリシーの説明
• name(optional): string
  アクセス・ポリシーの名前
• owner(optional): object owner
  所有者
• priority(optional): string
  アクセス・ポリシーの優先度
• provisionedApplications(optional): array provisionedApplications
  プロビジョニングされたアプリケーションの詳細
• retrofit(optional): boolean

{
    "description":"Access Policy details",
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the Access Policy"
        },
        "description":{
            "type":"string",
            "description":"Description of the Access Policy"
        },
        "priority":{
            "type":"string",
            "description":"Priority of the Access Policy"
        },
        "retrofit":{
            "type":"boolean"
        },
        "owner":{
            "$ref":"#/definitions/owner"
        },
        "provisionedApplications":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/provisionedApplications"
            },
            "description":"Details of Provisioned Application"
        },
        "deniedApplications":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/deniedApplications"
            },
            "description":"Details of Denied Application"
        }
    }
}

ネストされたスキーマ : deniedApplications

型: array

拒否されたアプリケーションの詳細

ソースを表示

• 配列: オブジェクト deniedApplications

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/deniedApplications"
    },
    "description":"Details of Denied Application"
}

ネストされたスキーマ: owner

型: object

所有者

ソースを表示

• name(optional): string
  xelsysadmなどの所有者ログインID
• type(optional): string
  指定できる値: [ "USER", "ROLE" ]

  所有者のタイプ。有効な値はUSER/ROLEです

{
    "description":"Owner",
    "properties":{
        "name":{
            "type":"string",
            "description":"Owner login id for example xelsysadm"
        },
        "type":{
            "type":"string",
            "enum":[
                "USER",
                "ROLE"
            ],
            "description":"Type of Owner. Valid values are USER/ROLE"
        }
    }
}

ネストされたスキーマ : provisionedApplications

型: array

プロビジョニングされたアプリケーションの詳細

ソースを表示

• 配列: オブジェクト provisionedApplications

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/provisionedApplications"
    },
    "description":"Details of Provisioned Application"
}

ネストされたスキーマ : deniedApplications

型: object

ソースを表示

• name(optional): string
  拒否されたアプリケーションの名前

{
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the Denied Application"
        }
    }
}

ネストされたスキーマ : provisionedApplications

型: object

ソースを表示

• childobjects(optional): array childobjects
• constraint(optional): string
  指定できる値: [ "DISABLE", "REVOKE" ]

  制約。有効な値はDISABLE/REVOKEです
• general(optional): object general
  使用可能なその他のプロパティ: additionalProperties

  親フォームの詳細
• name(optional): string
  プロビジョニングされたアプリケーションの名前
• neor(optional): boolean
  デフォルト値: false

  ロールの外部に資格がある場合、アカウントをアクティブに維持

{
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the Provisioned Application"
        },
        "constraint":{
            "type":"string",
            "enum":[
                "DISABLE",
                "REVOKE"
            ],
            "description":"Constraint. Valid values are DISABLE/REVOKE"
        },
        "neor":{
            "type":"boolean",
            "description":"Keep Account Active if entitlement exists outside the role",
            "default":false
        },
        "general":{
            "type":"object",
            "description":"Parent form details",
            "additionalProperties":{
                "type":"string"
            }
        },
        "childobjects":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/childobject"
            }
        }
    }
}

ネストされたスキーマ : childObjects

型: array

ソースを表示

• 配列: オブジェクト childobject

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/childobject"
    }
}

ネストされたスキーマ: general

型: object

使用可能なその他のプロパティ

ソースを表示

• string

{
    "type":"object",
    "description":"Parent form details",
    "additionalProperties":{
        "type":"string"
    }
}

親フォームの詳細

ネストされたスキーマ: childobject

型: object

ソースを表示

• description(optional): string
  子フォームのラベル。
• records(optional): array records
  子フォームの詳細

{
    "properties":{
        "description":{
            "type":"string",
            "description":"Label of the child form."
        },
        "records":{
            "type":"array",
            "description":"Child form details",
            "items":{
                "type":"object",
                "additionalProperties":{
                    "type":"string"
                }
            }
        }
    }
}

ネストされたスキーマ: records

型: array

子フォームの詳細

ソースを表示

• 配列: オブジェクト items
  使用可能なその他のプロパティ: additionalProperties

{
    "type":"array",
    "description":"Child form details",
    "items":{
        "type":"object",
        "additionalProperties":{
            "type":"string"
        }
    }
}

ネストされたスキーマ: items

型: object

使用可能なその他のプロパティ

ソースを表示

• string

{
    "type":"object",
    "additionalProperties":{
        "type":"string"
    }
}

400レスポンス

不正なリクエスト

500レスポンス

内部サーバー・エラー

先頭に戻る

例

次の例は、cURLを使用してRESTリソースにGETリクエストを発行して、特定のアクセス・ポリシーを返す方法を示しています。ここに示す情報は、擬似システムを使用した場合のものであり、プロトタイプとして提供しています。

curl -u username:password -H "X-Requested-By:<anyvalue>"  -X GET "http://myhost.pseudo.com:14000/iam/governance/adminservice/api/v1/accesspolicies/5"

レスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。

{
    "links": [
        {
            "rel": "self",
            "href": "http://myhost.pseudo.com:14000/iam/governance/adminservice/api/v1/accesspolicies/1"
        }
    ],
    "id": "1",
    "name": "AP_1615537233845",
    "description": "AP_Desc_1615537233845",
    "priority": "1",
    "retrofit": true,
    "owner": {
        "type": "USER",
        "displayname": "System Administrator",
        "name": "XELSYSADM"
    },
    "provisionedApplications": [
        {
            "id": "2",
            "name": "VisionEmployeesDomain",
            "constraint": "REVOKE",
                          "neor":false,
            "general": {
                "Organization Name": "9~OU=employees,OU=Vision,DC=adlrg12c,DC=us,DC=pseudo,DC=com"
            },
            "childobjects": [
                {
                    "id": "10",
                    "description": "Assigned Groups Form",
                    "records": [
                        {
                            "Group Name": "9~CN=adentitlement1,OU=Vision,DC=adlrg12c,DC=us,DC=pseudo,DC=com"
                        }
                    ]
                }
            ]
        }
    ],
    "deniedApplications": []
}

先頭に戻る