Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

CreateApplication

Creates an account access manager instance and its AWS account access application in the associated IAM Identity Center instance. This operation is idempotent; calling it multiple times with the same parameters returns the existing application.

Request Syntax


POST /applications HTTP/1.1
Content-type: application/json

{
   "identitySource": { ... },
   "tags": { 
      "string" : "string" 
   }
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

identitySource

Specifies the identity source for the application. The identity source defines the IAM Identity Center instance that provides principals for entitlements.

Type: IdentitySource object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: Yes

tags

Specifies the tags to assign to the application.

Type: String to string map

Required: No

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "applicationArn": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

applicationArn

The Amazon Resource Name (ARN) of the created application.

Type: String

Length Constraints: Minimum length of 49. Maximum length of 2048.

Pattern: arn:[a-z0-9-]+:account-access:[a-z0-9]+(-[a-z0-9]+)*:[0-9]{12}:application/[a-zA-Z0-9-]+

Errors

For information about the errors that are common to all actions, see Common Error Types.

AccessDeniedException

You do not have sufficient access to perform this operation.

HTTP Status Code: 403

AlreadyCreatedException

The resource you are trying to create already exists. To retrieve the existing resource, use the corresponding Get operation.

HTTP Status Code: 400

ConflictException

The request conflicts with the current state of the resource.

HTTP Status Code: 409

InternalServerException

An internal service error occurred. Try your request again later.

HTTP Status Code: 500

ValidationException

The input does not satisfy the constraints specified by the service. Check your request parameters and retry the request.

HTTP Status Code: 400