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) –

    A client token is a unique, case-sensitive string of up to 128 ASCII characters with ASCII values of 33-126 inclusive. It’s generated by the client to ensure idempotent operations, allowing for safe retries without unintended side effects.

    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