リクエストの送信
post
/iam/governance/selfservice/api/v1/requests
新規リクエストを作成します。一度に1つのタイプのリクエストをサポートできます。たとえば、プロビジョニング・リクエストは、作成または変更ユーザー・リクエストと一緒に処理できません。プロビジョニング・リクエストには、異なるエンティティ(アプリケーション・インスタンス、権限およびロール)を含めることができます。
リクエスト
サポートされているメディア・タイプ
- 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" -X POST -u username:password -d @post.json https://pseudo.com/iam/governance/selfservice/api/v1/requests
POSTリクエスト本文の例
次に、JSON形式のリクエスト本文のコンテンツを示します。
{ "requests": [ { "requestId": "Req1001", "reqJustification": "Requesting for application", "reqBeneficiaryList": [ { "id": "2007" } ], "reqTargetEntities": [ { "entityId": "1", "entityType": "appInstance", "appFormData": [ { "name": "Account Login", "value": "test24" }, { "name": "Password", "value": "Test@3" }, { "name": "ID", "value": "test24@email.com" } ] } ] }, { "requestId": "Req1002", "reqJustification": "Requesting for application", "reqTargetEntities": [ { "entityId": "1", "entityType": "appInstance" } ] } ] }
POSTレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{ "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests" } ], "requests": [ { "requestId": "Req1001", "status": "FAIL", "reason": "Invalid appForm field provided." }, { "links": [ { "rel": "self", "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/5048" } ], "id": "5048", "requestId": "Req1002", "reqStatus": "PENDING", "status": "SUCCESS" } ] }