MainframeModernization / Client / create_application

create_application#

MainframeModernization.Client.create_application(**kwargs)#

Creates a new application with given parameters. Requires an existing runtime environment and application definition file.

See also: AWS API Documentation

Request Syntax

response = client.create_application(
    clientToken='string',
    definition={
        'content': 'string',
        's3Location': 'string'
    },
    description='string',
    engineType='microfocus'|'bluage',
    kmsKeyId='string',
    name='string',
    roleArn='string',
    tags={
        'string': 'string'
    }
)
Parameters:

  • clientToken (string) –

    Unique, case-sensitive identifier the service generates to ensure the idempotency of the request to create an application. The service generates the clientToken when the API call is triggered. The token expires after one hour, so if you retry the API within this timeframe with the same clientToken, you will get the same response. The service also handles deleting the clientToken after it expires.

    This field is autopopulated if not provided.

  • definition (dict) –

    [REQUIRED]

    The application definition for this application. You can specify either inline JSON or an S3 bucket location.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: content, s3Location.

    • content (string) –

      The content of the application definition. This is a JSON object that contains the resource configuration/definitions that identify an application.

    • s3Location (string) –

      The S3 bucket that contains the application definition.

  • description (string) – The description of the application.

  • engineType (string) –

    [REQUIRED]

    The type of the target platform for this application.

  • kmsKeyId (string) – The identifier of a customer managed key.

  • name (string) –

    [REQUIRED]

    The unique identifier of the application.

  • roleArn (string) – The Amazon Resource Name (ARN) that identifies a role that the application uses to access Amazon Web Services resources that are not part of the application or are in a different Amazon Web Services account.

  • tags (dict) –

    A list of tags to apply to the application.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'applicationArn': 'string',
    'applicationId': 'string',
    'applicationVersion': 123
}

Response Structure

  • (dict) –

    • applicationArn (string) –

      The Amazon Resource Name (ARN) of the application.

    • applicationId (string) –

      The unique application identifier.

    • applicationVersion (integer) –

      The version number of the application.

Exceptions

  • MainframeModernization.Client.exceptions.ServiceQuotaExceededException

  • MainframeModernization.Client.exceptions.ThrottlingException

  • MainframeModernization.Client.exceptions.AccessDeniedException

  • MainframeModernization.Client.exceptions.ConflictException

  • MainframeModernization.Client.exceptions.ValidationException

  • MainframeModernization.Client.exceptions.InternalServerException