リクエストの送信
post
/iam/governance/selfservice/api/v1/requests
新規リクエストを作成します。プロビジョニング・リクエストには、異なるエンティティ(アプリケーション・インスタンス、権限およびロール)を含めることができます。startDate属性とendDate属性を使用すると、オプションの日の出と日の入りの日時をリクエストに含めることができます。
リクエスト
サポートされているメディア・タイプ
- application/json
発生するリクエストの属性リスト。エンティティ・タイプにサポートされている値は、"AppInstance、EntitlementおよびRole"です。"parentAccountId"属性はエンティティ・タイプEntitlementのみに使用されます。指定されたアカウントIDは、指定されたアカウントに権限を関連付けるために使用されます。親アカウントIDがエンティティ・タイプEntitlementに指定されていない場合、プライマリ・アカウントがリクエストされた権限に関連付けられます。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ヘッダー
- ResponseTime: string
リクエストの処理にかかった時間(ミリ秒)を取得します。
401レスポンス
未認可
403レスポンス
禁止
500レスポンス
内部サーバー・エラー
デフォルト・レスポンス
予期しないエラー
例
この例では、バルク操作によるリクエスト作成の機能を示します。成功と失敗の両方を示しています。ここで表示された情報は疑似システムに対するものであり、プロトタイプとして使用します。
cURLの例
curl -H "Content-Type: application/json" -H "X-Requested-By: <anyvalue>" -X POST -u username:password -d @post.json https://pseudo.com/iam/governance/selfservice/api/v1/requests
POSTリクエスト本文の例
次に、JSON形式のリクエスト本文のコンテンツを示します。
{
"requests" :[
{
"requestId": "Req1001",
"reqJustification" : "Request role for sub-ordinate",
"reqBeneficiaryList":
[
{
"id": "24"
}
],
"reqTargetEntities":
[
{
"entityId": "12",
"entityType": "role",
"startDate" : "2019-03-19T01:30:00Z",
"endDate" : "2019-09-25T18:30:00Z"
},
{
"entityId": "13",
"entityType": "role",
"startDate" : "2019-03-19T01:30:00Z",
"endDate" : "2019-09-25T18:30:00Z"
}
]
}
]
}
POSTレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests"
}
],
"requests": [
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/3"
}
],
"id": "3",
"requestId": "Req1001",
"reqStatus": "Request Created",
"status": "SUCCESS"
}
]
}
権限を失効させるリクエストの例
次に、JSON形式のリクエスト本文のコンテンツを示します。
{
"requests": [
{
"id": "7001",
"reqJustification": "Request Entitlement",
"operation" : "revoke",
"reqBeneficiaryList": [
{
"id": "6"
}
],
"reqTargetEntities": [
{
"entityId": "246",
"entityType": "Entitlement"
}
]
}
]
}