Amplify / Client / create_backend_environment

create_backend_environment

Amplify.Client.create_backend_environment(**kwargs)

Creates a new backend environment for an Amplify app.

This API is available only to Amplify Gen 1 applications where the backend is created using Amplify Studio or the Amplify command line interface (CLI). This API isn’t available to Amplify Gen 2 applications. When you deploy an application with Amplify Gen 2, you provision the app’s backend infrastructure using Typescript code.

See also: AWS API Documentation

Request Syntax

response = client.create_backend_environment(
    appId='string',
    environmentName='string',
    stackName='string',
    deploymentArtifacts='string'
)
Parameters:

  • appId (string) –

    [REQUIRED]

    The unique ID for an Amplify app.

  • environmentName (string) –

    [REQUIRED]

    The name for the backend environment.

  • stackName (string) – The AWS CloudFormation stack name of a backend environment.

  • deploymentArtifacts (string) – The name of deployment artifacts.

Return type:

dict

Returns:

Response Syntax

{
    'backendEnvironment': {
        'backendEnvironmentArn': 'string',
        'environmentName': 'string',
        'stackName': 'string',
        'deploymentArtifacts': 'string',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) –

    The result structure for the create backend environment request.

    • backendEnvironment (dict) –

      Describes the backend environment for an Amplify app.

      • backendEnvironmentArn (string) –

        The Amazon Resource Name (ARN) for a backend environment that is part of an Amplify app.

      • environmentName (string) –

        The name for a backend environment that is part of an Amplify app.

      • stackName (string) –

        The AWS CloudFormation stack name of a backend environment.

      • deploymentArtifacts (string) –

        The name of deployment artifacts.

      • createTime (datetime) –

        The creation date and time for a backend environment that is part of an Amplify app.

      • updateTime (datetime) –

        The last updated date and time for a backend environment that is part of an Amplify app.

Exceptions

  • Amplify.Client.exceptions.BadRequestException

  • Amplify.Client.exceptions.UnauthorizedException

  • Amplify.Client.exceptions.NotFoundException

  • Amplify.Client.exceptions.InternalFailureException

  • Amplify.Client.exceptions.LimitExceededException