Amplify

Client

class Amplify.Client

A low-level client representing AWS Amplify:

client = session.create_client('amplify')

These are the available methods:

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
create_app(**kwargs)

Creates a new Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.create_app(
    name='string',
    description='string',
    repository='string',
    platform='WEB',
    iamServiceRoleArn='string',
    oauthToken='string',
    accessToken='string',
    environmentVariables={
        'string': 'string'
    },
    enableBranchAutoBuild=True|False,
    enableBranchAutoDeletion=True|False,
    enableBasicAuth=True|False,
    basicAuthCredentials='string',
    customRules=[
        {
            'source': 'string',
            'target': 'string',
            'status': 'string',
            'condition': 'string'
        },
    ],
    tags={
        'string': 'string'
    },
    buildSpec='string',
    enableAutoBranchCreation=True|False,
    autoBranchCreationPatterns=[
        'string',
    ],
    autoBranchCreationConfig={
        'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
        'framework': 'string',
        'enableAutoBuild': True|False,
        'environmentVariables': {
            'string': 'string'
        },
        'basicAuthCredentials': 'string',
        'enableBasicAuth': True|False,
        'enablePerformanceMode': True|False,
        'buildSpec': 'string',
        'enablePullRequestPreview': True|False,
        'pullRequestEnvironmentName': 'string'
    }
)
Parameters
  • name (string) --

    [REQUIRED]

    The name for the Amplify app.

  • description (string) -- The description for an Amplify app.
  • repository (string) -- The repository for an Amplify app.
  • platform (string) -- The platform or framework for an Amplify app.
  • iamServiceRoleArn (string) -- The AWS Identity and Access Management (IAM) service role for an Amplify app.
  • oauthToken (string) -- The OAuth token for a third-party source control system for an Amplify app. The OAuth token is used to create a webhook and a read-only deploy key. The OAuth token is not stored.
  • accessToken (string) -- The personal access token for a third-party source control system for an Amplify app. The personal access token is used to create a webhook and a read-only deploy key. The token is not stored.
  • environmentVariables (dict) --

    The environment variables map for an Amplify app.

    • (string) --
      • (string) --
  • enableBranchAutoBuild (boolean) -- Enables the auto building of branches for an Amplify app.
  • enableBranchAutoDeletion (boolean) -- Automatically disconnects a branch in the Amplify Console when you delete a branch from your Git repository.
  • enableBasicAuth (boolean) -- Enables basic authorization for an Amplify app. This will apply to all branches that are part of this app.
  • basicAuthCredentials (string) -- The credentials for basic authorization for an Amplify app.
  • customRules (list) --

    The custom rewrite and redirect rules for an Amplify app.

    • (dict) --

      Describes a custom rewrite or redirect rule.

      • source (string) -- [REQUIRED]

        The source pattern for a URL rewrite or redirect rule.

      • target (string) -- [REQUIRED]

        The target pattern for a URL rewrite or redirect rule.

      • status (string) --

        The status code for a URL rewrite or redirect rule.

        200

        Represents a 200 rewrite rule.

        301

        Represents a 301 (moved pemanently) redirect rule. This and all future requests should be directed to the target URL.

        302

        Represents a 302 temporary redirect rule.

        404

        Represents a 404 redirect rule.

        404-200

        Represents a 404 rewrite rule.

      • condition (string) --

        The condition for a URL rewrite or redirect rule, such as a country code.

  • tags (dict) --

    The tag for an Amplify app.

    • (string) --
      • (string) --
  • buildSpec (string) -- The build specification (build spec) for an Amplify app.
  • enableAutoBranchCreation (boolean) -- Enables automated branch creation for the Amplify app.
  • autoBranchCreationPatterns (list) --

    The automated branch creation glob patterns for the Amplify app.

    • (string) --
  • autoBranchCreationConfig (dict) --

    The automated branch creation configuration for the Amplify app.

    • stage (string) --

      Describes the current stage for the autocreated branch.

    • framework (string) --

      The framework for the autocreated branch.

    • enableAutoBuild (boolean) --

      Enables auto building for the autocreated branch.

    • environmentVariables (dict) --

      The environment variables for the autocreated branch.

      • (string) --
        • (string) --
    • basicAuthCredentials (string) --

      The basic authorization credentials for the autocreated branch.

    • enableBasicAuth (boolean) --

      Enables basic authorization for the autocreated branch.

    • enablePerformanceMode (boolean) --

      Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

    • buildSpec (string) --

      The build specification (build spec) for the autocreated branch.

    • enablePullRequestPreview (boolean) --

      Enables pull request preview for the autocreated branch.

    • pullRequestEnvironmentName (string) --

      The Amplify environment name for the pull request.

Return type

dict

Returns

Response Syntax

{
    'app': {
        'appId': 'string',
        'appArn': 'string',
        'name': 'string',
        'tags': {
            'string': 'string'
        },
        'description': 'string',
        'repository': 'string',
        'platform': 'WEB',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'iamServiceRoleArn': 'string',
        'environmentVariables': {
            'string': 'string'
        },
        'defaultDomain': 'string',
        'enableBranchAutoBuild': True|False,
        'enableBranchAutoDeletion': True|False,
        'enableBasicAuth': True|False,
        'basicAuthCredentials': 'string',
        'customRules': [
            {
                'source': 'string',
                'target': 'string',
                'status': 'string',
                'condition': 'string'
            },
        ],
        'productionBranch': {
            'lastDeployTime': datetime(2015, 1, 1),
            'status': 'string',
            'thumbnailUrl': 'string',
            'branchName': 'string'
        },
        'buildSpec': 'string',
        'enableAutoBranchCreation': True|False,
        'autoBranchCreationPatterns': [
            'string',
        ],
        'autoBranchCreationConfig': {
            'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
            'framework': 'string',
            'enableAutoBuild': True|False,
            'environmentVariables': {
                'string': 'string'
            },
            'basicAuthCredentials': 'string',
            'enableBasicAuth': True|False,
            'enablePerformanceMode': True|False,
            'buildSpec': 'string',
            'enablePullRequestPreview': True|False,
            'pullRequestEnvironmentName': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • app (dict) --

      Represents the different branches of a repository for building, deploying, and hosting an Amplify app.

      • appId (string) --

        The unique ID of the Amplify app.

      • appArn (string) --

        The Amazon Resource Name (ARN) of the Amplify app.

      • name (string) --

        The name for the Amplify app.

      • tags (dict) --

        The tag for the Amplify app.

        • (string) --
          • (string) --
      • description (string) --

        The description for the Amplify app.

      • repository (string) --

        The repository for the Amplify app.

      • platform (string) --

        The platform for the Amplify app.

      • createTime (datetime) --

        Creates a date and time for the Amplify app.

      • updateTime (datetime) --

        Updates the date and time for the Amplify app.

      • iamServiceRoleArn (string) --

        The AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) of the Amplify app.

      • environmentVariables (dict) --

        The environment variables for the Amplify app.

        • (string) --
          • (string) --
      • defaultDomain (string) --

        The default domain for the Amplify app.

      • enableBranchAutoBuild (boolean) --

        Enables the auto-building of branches for the Amplify app.

      • enableBranchAutoDeletion (boolean) --

        Automatically disconnect a branch in the Amplify Console when you delete a branch from your Git repository.

      • enableBasicAuth (boolean) --

        Enables basic authorization for the Amplify app's branches.

      • basicAuthCredentials (string) --

        The basic authorization credentials for branches for the Amplify app.

      • customRules (list) --

        Describes the custom redirect and rewrite rules for the Amplify app.

        • (dict) --

          Describes a custom rewrite or redirect rule.

          • source (string) --

            The source pattern for a URL rewrite or redirect rule.

          • target (string) --

            The target pattern for a URL rewrite or redirect rule.

          • status (string) --

            The status code for a URL rewrite or redirect rule.

            200

            Represents a 200 rewrite rule.

            301

            Represents a 301 (moved pemanently) redirect rule. This and all future requests should be directed to the target URL.

            302

            Represents a 302 temporary redirect rule.

            404

            Represents a 404 redirect rule.

            404-200

            Represents a 404 rewrite rule.

          • condition (string) --

            The condition for a URL rewrite or redirect rule, such as a country code.

      • productionBranch (dict) --

        Describes the information about a production branch of the Amplify app.

        • lastDeployTime (datetime) --

          The last deploy time of the production branch.

        • status (string) --

          The status of the production branch.

        • thumbnailUrl (string) --

          The thumbnail URL for the production branch.

        • branchName (string) --

          The branch name for the production branch.

      • buildSpec (string) --

        Describes the content of the build specification (build spec) for the Amplify app.

      • enableAutoBranchCreation (boolean) --

        Enables automated branch creation for the Amplify app.

      • autoBranchCreationPatterns (list) --

        Describes the automated branch creation glob patterns for the Amplify app.

        • (string) --
      • autoBranchCreationConfig (dict) --

        Describes the automated branch creation configuration for the Amplify app.

        • stage (string) --

          Describes the current stage for the autocreated branch.

        • framework (string) --

          The framework for the autocreated branch.

        • enableAutoBuild (boolean) --

          Enables auto building for the autocreated branch.

        • environmentVariables (dict) --

          The environment variables for the autocreated branch.

          • (string) --
            • (string) --
        • basicAuthCredentials (string) --

          The basic authorization credentials for the autocreated branch.

        • enableBasicAuth (boolean) --

          Enables basic authorization for the autocreated branch.

        • enablePerformanceMode (boolean) --

          Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

        • buildSpec (string) --

          The build specification (build spec) for the autocreated branch.

        • enablePullRequestPreview (boolean) --

          Enables pull request preview for the autocreated branch.

        • pullRequestEnvironmentName (string) --

          The Amplify environment name for the pull request.

Exceptions

create_backend_environment(**kwargs)

Creates a new backend environment for an Amplify app.

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

create_branch(**kwargs)

Creates a new branch for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.create_branch(
    appId='string',
    branchName='string',
    description='string',
    stage='PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
    framework='string',
    enableNotification=True|False,
    enableAutoBuild=True|False,
    environmentVariables={
        'string': 'string'
    },
    basicAuthCredentials='string',
    enableBasicAuth=True|False,
    enablePerformanceMode=True|False,
    tags={
        'string': 'string'
    },
    buildSpec='string',
    ttl='string',
    displayName='string',
    enablePullRequestPreview=True|False,
    pullRequestEnvironmentName='string',
    backendEnvironmentArn='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for the branch.

  • description (string) -- The description for the branch.
  • stage (string) -- Describes the current stage for the branch.
  • framework (string) -- The framework for the branch.
  • enableNotification (boolean) -- Enables notifications for the branch.
  • enableAutoBuild (boolean) -- Enables auto building for the branch.
  • environmentVariables (dict) --

    The environment variables for the branch.

    • (string) --
      • (string) --
  • basicAuthCredentials (string) -- The basic authorization credentials for the branch.
  • enableBasicAuth (boolean) -- Enables basic authorization for the branch.
  • enablePerformanceMode (boolean) -- Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.
  • tags (dict) --

    The tag for the branch.

    • (string) --
      • (string) --
  • buildSpec (string) -- The build specification (build spec) for the branch.
  • ttl (string) -- The content Time To Live (TTL) for the website in seconds.
  • displayName (string) -- The display name for a branch. This is used as the default domain prefix.
  • enablePullRequestPreview (boolean) -- Enables pull request preview for this branch.
  • pullRequestEnvironmentName (string) -- The Amplify environment name for the pull request.
  • backendEnvironmentArn (string) -- The Amazon Resource Name (ARN) for a backend environment that is part of an Amplify app.
Return type

dict

Returns

Response Syntax

{
    'branch': {
        'branchArn': 'string',
        'branchName': 'string',
        'description': 'string',
        'tags': {
            'string': 'string'
        },
        'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
        'displayName': 'string',
        'enableNotification': True|False,
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'environmentVariables': {
            'string': 'string'
        },
        'enableAutoBuild': True|False,
        'customDomains': [
            'string',
        ],
        'framework': 'string',
        'activeJobId': 'string',
        'totalNumberOfJobs': 'string',
        'enableBasicAuth': True|False,
        'enablePerformanceMode': True|False,
        'thumbnailUrl': 'string',
        'basicAuthCredentials': 'string',
        'buildSpec': 'string',
        'ttl': 'string',
        'associatedResources': [
            'string',
        ],
        'enablePullRequestPreview': True|False,
        'pullRequestEnvironmentName': 'string',
        'destinationBranch': 'string',
        'sourceBranch': 'string',
        'backendEnvironmentArn': 'string'
    }
}

Response Structure

  • (dict) --

    The result structure for create branch request.

    • branch (dict) --

      Describes the branch for an Amplify app, which maps to a third-party repository branch.

      • branchArn (string) --

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

      • branchName (string) --

        The name for the branch that is part of an Amplify app.

      • description (string) --

        The description for the branch that is part of an Amplify app.

      • tags (dict) --

        The tag for the branch of an Amplify app.

        • (string) --
          • (string) --
      • stage (string) --

        The current stage for the branch that is part of an Amplify app.

      • displayName (string) --

        The display name for the branch. This is used as the default domain prefix.

      • enableNotification (boolean) --

        Enables notifications for a branch that is part of an Amplify app.

      • createTime (datetime) --

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

      • updateTime (datetime) --

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

      • environmentVariables (dict) --

        The environment variables specific to a branch of an Amplify app.

        • (string) --
          • (string) --
      • enableAutoBuild (boolean) --

        Enables auto-building on push for a branch of an Amplify app.

      • customDomains (list) --

        The custom domains for a branch of an Amplify app.

        • (string) --
      • framework (string) --

        The framework for a branch of an Amplify app.

      • activeJobId (string) --

        The ID of the active job for a branch of an Amplify app.

      • totalNumberOfJobs (string) --

        The total number of jobs that are part of an Amplify app.

      • enableBasicAuth (boolean) --

        Enables basic authorization for a branch of an Amplify app.

      • enablePerformanceMode (boolean) --

        Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

      • thumbnailUrl (string) --

        The thumbnail URL for the branch of an Amplify app.

      • basicAuthCredentials (string) --

        The basic authorization credentials for a branch of an Amplify app.

      • buildSpec (string) --

        The build specification (build spec) content for the branch of an Amplify app.

      • ttl (string) --

        The content Time to Live (TTL) for the website in seconds.

      • associatedResources (list) --

        A list of custom resources that are linked to this branch.

        • (string) --
      • enablePullRequestPreview (boolean) --

        Enables pull request preview for the branch.

      • pullRequestEnvironmentName (string) --

        The Amplify environment name for the pull request.

      • destinationBranch (string) --

        The destination branch if the branch is a pull request branch.

      • sourceBranch (string) --

        The source branch if the branch is a pull request branch.

      • backendEnvironmentArn (string) --

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

Exceptions

create_deployment(**kwargs)

Creates a deployment for a manually deployed Amplify app. Manually deployed apps are not connected to a repository.

See also: AWS API Documentation

Request Syntax

response = client.create_deployment(
    appId='string',
    branchName='string',
    fileMap={
        'string': 'string'
    }
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for the branch, for the job.

  • fileMap (dict) --

    An optional file map that contains the file name as the key and the file content md5 hash as the value. If this argument is provided, the service will generate a unique upload URL per file. Otherwise, the service will only generate a single upload URL for the zipped files.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'jobId': 'string',
    'fileUploadUrls': {
        'string': 'string'
    },
    'zipUploadUrl': 'string'
}

Response Structure

  • (dict) --

    The result structure for the create a new deployment request.

    • jobId (string) --

      The job ID for this deployment. will supply to start deployment api.

    • fileUploadUrls (dict) --

      When the fileMap argument is provided in the request, fileUploadUrls will contain a map of file names to upload URLs.

      • (string) --
        • (string) --
    • zipUploadUrl (string) --

      When the fileMap argument is not provided in the request, this zipUploadUrl is returned.

Exceptions

create_domain_association(**kwargs)

Creates a new domain association for an Amplify app. This action associates a custom domain with the Amplify app

See also: AWS API Documentation

Request Syntax

response = client.create_domain_association(
    appId='string',
    domainName='string',
    enableAutoSubDomain=True|False,
    subDomainSettings=[
        {
            'prefix': 'string',
            'branchName': 'string'
        },
    ],
    autoSubDomainCreationPatterns=[
        'string',
    ],
    autoSubDomainIAMRole='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • domainName (string) --

    [REQUIRED]

    The domain name for the domain association.

  • enableAutoSubDomain (boolean) -- Enables the automated creation of subdomains for branches.
  • subDomainSettings (list) --

    [REQUIRED]

    The setting for the subdomain.

    • (dict) --

      Describes the settings for the subdomain.

      • prefix (string) -- [REQUIRED]

        The prefix setting for the subdomain.

      • branchName (string) -- [REQUIRED]

        The branch name setting for the subdomain.

  • autoSubDomainCreationPatterns (list) --

    Sets the branch patterns for automatic subdomain creation.

    • (string) --
  • autoSubDomainIAMRole (string) -- The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.
Return type

dict

Returns

Response Syntax

{
    'domainAssociation': {
        'domainAssociationArn': 'string',
        'domainName': 'string',
        'enableAutoSubDomain': True|False,
        'autoSubDomainCreationPatterns': [
            'string',
        ],
        'autoSubDomainIAMRole': 'string',
        'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'PENDING_DEPLOYMENT'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
        'statusReason': 'string',
        'certificateVerificationDNSRecord': 'string',
        'subDomains': [
            {
                'subDomainSetting': {
                    'prefix': 'string',
                    'branchName': 'string'
                },
                'verified': True|False,
                'dnsRecord': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    The result structure for the create domain association request.

    • domainAssociation (dict) --

      Describes the structure of a domain association, which associates a custom domain with an Amplify app.

      • domainAssociationArn (string) --

        The Amazon Resource Name (ARN) for the domain association.

      • domainName (string) --

        The name of the domain.

      • enableAutoSubDomain (boolean) --

        Enables the automated creation of subdomains for branches.

      • autoSubDomainCreationPatterns (list) --

        Sets branch patterns for automatic subdomain creation.

        • (string) --
      • autoSubDomainIAMRole (string) --

        The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

      • domainStatus (string) --

        The current status of the domain association.

      • statusReason (string) --

        The reason for the current status of the domain association.

      • certificateVerificationDNSRecord (string) --

        The DNS record for certificate verification.

      • subDomains (list) --

        The subdomains for the domain association.

        • (dict) --

          The subdomain for the domain association.

          • subDomainSetting (dict) --

            Describes the settings for the subdomain.

            • prefix (string) --

              The prefix setting for the subdomain.

            • branchName (string) --

              The branch name setting for the subdomain.

          • verified (boolean) --

            The verified status of the subdomain

          • dnsRecord (string) --

            The DNS record for the subdomain.

Exceptions

create_webhook(**kwargs)

Creates a new webhook on an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.create_webhook(
    appId='string',
    branchName='string',
    description='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

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

  • description (string) -- The description for a webhook.
Return type

dict

Returns

Response Syntax

{
    'webhook': {
        'webhookArn': 'string',
        'webhookId': 'string',
        'webhookUrl': 'string',
        'branchName': 'string',
        'description': 'string',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    The result structure for the create webhook request.

    • webhook (dict) --

      Describes a webhook that connects repository events to an Amplify app.

      • webhookArn (string) --

        The Amazon Resource Name (ARN) for the webhook.

      • webhookId (string) --

        The ID of the webhook.

      • webhookUrl (string) --

        The URL of the webhook.

      • branchName (string) --

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

      • description (string) --

        The description for a webhook.

      • createTime (datetime) --

        The create date and time for a webhook.

      • updateTime (datetime) --

        Updates the date and time for a webhook.

Exceptions

delete_app(**kwargs)

Deletes an existing Amplify app specified by an app ID.

See also: AWS API Documentation

Request Syntax

response = client.delete_app(
    appId='string'
)
Parameters
appId (string) --

[REQUIRED]

The unique ID for an Amplify app.

Return type
dict
Returns
Response Syntax
{
    'app': {
        'appId': 'string',
        'appArn': 'string',
        'name': 'string',
        'tags': {
            'string': 'string'
        },
        'description': 'string',
        'repository': 'string',
        'platform': 'WEB',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'iamServiceRoleArn': 'string',
        'environmentVariables': {
            'string': 'string'
        },
        'defaultDomain': 'string',
        'enableBranchAutoBuild': True|False,
        'enableBranchAutoDeletion': True|False,
        'enableBasicAuth': True|False,
        'basicAuthCredentials': 'string',
        'customRules': [
            {
                'source': 'string',
                'target': 'string',
                'status': 'string',
                'condition': 'string'
            },
        ],
        'productionBranch': {
            'lastDeployTime': datetime(2015, 1, 1),
            'status': 'string',
            'thumbnailUrl': 'string',
            'branchName': 'string'
        },
        'buildSpec': 'string',
        'enableAutoBranchCreation': True|False,
        'autoBranchCreationPatterns': [
            'string',
        ],
        'autoBranchCreationConfig': {
            'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
            'framework': 'string',
            'enableAutoBuild': True|False,
            'environmentVariables': {
                'string': 'string'
            },
            'basicAuthCredentials': 'string',
            'enableBasicAuth': True|False,
            'enablePerformanceMode': True|False,
            'buildSpec': 'string',
            'enablePullRequestPreview': True|False,
            'pullRequestEnvironmentName': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The result structure for the delete app request.

    • app (dict) --

      Represents the different branches of a repository for building, deploying, and hosting an Amplify app.

      • appId (string) --

        The unique ID of the Amplify app.

      • appArn (string) --

        The Amazon Resource Name (ARN) of the Amplify app.

      • name (string) --

        The name for the Amplify app.

      • tags (dict) --

        The tag for the Amplify app.

        • (string) --
          • (string) --
      • description (string) --

        The description for the Amplify app.

      • repository (string) --

        The repository for the Amplify app.

      • platform (string) --

        The platform for the Amplify app.

      • createTime (datetime) --

        Creates a date and time for the Amplify app.

      • updateTime (datetime) --

        Updates the date and time for the Amplify app.

      • iamServiceRoleArn (string) --

        The AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) of the Amplify app.

      • environmentVariables (dict) --

        The environment variables for the Amplify app.

        • (string) --
          • (string) --
      • defaultDomain (string) --

        The default domain for the Amplify app.

      • enableBranchAutoBuild (boolean) --

        Enables the auto-building of branches for the Amplify app.

      • enableBranchAutoDeletion (boolean) --

        Automatically disconnect a branch in the Amplify Console when you delete a branch from your Git repository.

      • enableBasicAuth (boolean) --

        Enables basic authorization for the Amplify app's branches.

      • basicAuthCredentials (string) --

        The basic authorization credentials for branches for the Amplify app.

      • customRules (list) --

        Describes the custom redirect and rewrite rules for the Amplify app.

        • (dict) --

          Describes a custom rewrite or redirect rule.

          • source (string) --

            The source pattern for a URL rewrite or redirect rule.

          • target (string) --

            The target pattern for a URL rewrite or redirect rule.

          • status (string) --

            The status code for a URL rewrite or redirect rule.

            200

            Represents a 200 rewrite rule.

            301

            Represents a 301 (moved pemanently) redirect rule. This and all future requests should be directed to the target URL.

            302

            Represents a 302 temporary redirect rule.

            404

            Represents a 404 redirect rule.

            404-200

            Represents a 404 rewrite rule.

          • condition (string) --

            The condition for a URL rewrite or redirect rule, such as a country code.

      • productionBranch (dict) --

        Describes the information about a production branch of the Amplify app.

        • lastDeployTime (datetime) --

          The last deploy time of the production branch.

        • status (string) --

          The status of the production branch.

        • thumbnailUrl (string) --

          The thumbnail URL for the production branch.

        • branchName (string) --

          The branch name for the production branch.

      • buildSpec (string) --

        Describes the content of the build specification (build spec) for the Amplify app.

      • enableAutoBranchCreation (boolean) --

        Enables automated branch creation for the Amplify app.

      • autoBranchCreationPatterns (list) --

        Describes the automated branch creation glob patterns for the Amplify app.

        • (string) --
      • autoBranchCreationConfig (dict) --

        Describes the automated branch creation configuration for the Amplify app.

        • stage (string) --

          Describes the current stage for the autocreated branch.

        • framework (string) --

          The framework for the autocreated branch.

        • enableAutoBuild (boolean) --

          Enables auto building for the autocreated branch.

        • environmentVariables (dict) --

          The environment variables for the autocreated branch.

          • (string) --
            • (string) --
        • basicAuthCredentials (string) --

          The basic authorization credentials for the autocreated branch.

        • enableBasicAuth (boolean) --

          Enables basic authorization for the autocreated branch.

        • enablePerformanceMode (boolean) --

          Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

        • buildSpec (string) --

          The build specification (build spec) for the autocreated branch.

        • enablePullRequestPreview (boolean) --

          Enables pull request preview for the autocreated branch.

        • pullRequestEnvironmentName (string) --

          The Amplify environment name for the pull request.

Exceptions

delete_backend_environment(**kwargs)

Deletes a backend environment for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.delete_backend_environment(
    appId='string',
    environmentName='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID of an Amplify app.

  • environmentName (string) --

    [REQUIRED]

    The name of a backend environment of an Amplify app.

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 of the delete backend environment result.

    • 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

delete_branch(**kwargs)

Deletes a branch for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.delete_branch(
    appId='string',
    branchName='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for the branch.

Return type

dict

Returns

Response Syntax

{
    'branch': {
        'branchArn': 'string',
        'branchName': 'string',
        'description': 'string',
        'tags': {
            'string': 'string'
        },
        'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
        'displayName': 'string',
        'enableNotification': True|False,
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'environmentVariables': {
            'string': 'string'
        },
        'enableAutoBuild': True|False,
        'customDomains': [
            'string',
        ],
        'framework': 'string',
        'activeJobId': 'string',
        'totalNumberOfJobs': 'string',
        'enableBasicAuth': True|False,
        'enablePerformanceMode': True|False,
        'thumbnailUrl': 'string',
        'basicAuthCredentials': 'string',
        'buildSpec': 'string',
        'ttl': 'string',
        'associatedResources': [
            'string',
        ],
        'enablePullRequestPreview': True|False,
        'pullRequestEnvironmentName': 'string',
        'destinationBranch': 'string',
        'sourceBranch': 'string',
        'backendEnvironmentArn': 'string'
    }
}

Response Structure

  • (dict) --

    The result structure for the delete branch request.

    • branch (dict) --

      The branch for an Amplify app, which maps to a third-party repository branch.

      • branchArn (string) --

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

      • branchName (string) --

        The name for the branch that is part of an Amplify app.

      • description (string) --

        The description for the branch that is part of an Amplify app.

      • tags (dict) --

        The tag for the branch of an Amplify app.

        • (string) --
          • (string) --
      • stage (string) --

        The current stage for the branch that is part of an Amplify app.

      • displayName (string) --

        The display name for the branch. This is used as the default domain prefix.

      • enableNotification (boolean) --

        Enables notifications for a branch that is part of an Amplify app.

      • createTime (datetime) --

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

      • updateTime (datetime) --

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

      • environmentVariables (dict) --

        The environment variables specific to a branch of an Amplify app.

        • (string) --
          • (string) --
      • enableAutoBuild (boolean) --

        Enables auto-building on push for a branch of an Amplify app.

      • customDomains (list) --

        The custom domains for a branch of an Amplify app.

        • (string) --
      • framework (string) --

        The framework for a branch of an Amplify app.

      • activeJobId (string) --

        The ID of the active job for a branch of an Amplify app.

      • totalNumberOfJobs (string) --

        The total number of jobs that are part of an Amplify app.

      • enableBasicAuth (boolean) --

        Enables basic authorization for a branch of an Amplify app.

      • enablePerformanceMode (boolean) --

        Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

      • thumbnailUrl (string) --

        The thumbnail URL for the branch of an Amplify app.

      • basicAuthCredentials (string) --

        The basic authorization credentials for a branch of an Amplify app.

      • buildSpec (string) --

        The build specification (build spec) content for the branch of an Amplify app.

      • ttl (string) --

        The content Time to Live (TTL) for the website in seconds.

      • associatedResources (list) --

        A list of custom resources that are linked to this branch.

        • (string) --
      • enablePullRequestPreview (boolean) --

        Enables pull request preview for the branch.

      • pullRequestEnvironmentName (string) --

        The Amplify environment name for the pull request.

      • destinationBranch (string) --

        The destination branch if the branch is a pull request branch.

      • sourceBranch (string) --

        The source branch if the branch is a pull request branch.

      • backendEnvironmentArn (string) --

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

Exceptions

delete_domain_association(**kwargs)

Deletes a domain association for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.delete_domain_association(
    appId='string',
    domainName='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique id for an Amplify app.

  • domainName (string) --

    [REQUIRED]

    The name of the domain.

Return type

dict

Returns

Response Syntax

{
    'domainAssociation': {
        'domainAssociationArn': 'string',
        'domainName': 'string',
        'enableAutoSubDomain': True|False,
        'autoSubDomainCreationPatterns': [
            'string',
        ],
        'autoSubDomainIAMRole': 'string',
        'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'PENDING_DEPLOYMENT'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
        'statusReason': 'string',
        'certificateVerificationDNSRecord': 'string',
        'subDomains': [
            {
                'subDomainSetting': {
                    'prefix': 'string',
                    'branchName': 'string'
                },
                'verified': True|False,
                'dnsRecord': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • domainAssociation (dict) --

      Describes a domain association that associates a custom domain with an Amplify app.

      • domainAssociationArn (string) --

        The Amazon Resource Name (ARN) for the domain association.

      • domainName (string) --

        The name of the domain.

      • enableAutoSubDomain (boolean) --

        Enables the automated creation of subdomains for branches.

      • autoSubDomainCreationPatterns (list) --

        Sets branch patterns for automatic subdomain creation.

        • (string) --
      • autoSubDomainIAMRole (string) --

        The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

      • domainStatus (string) --

        The current status of the domain association.

      • statusReason (string) --

        The reason for the current status of the domain association.

      • certificateVerificationDNSRecord (string) --

        The DNS record for certificate verification.

      • subDomains (list) --

        The subdomains for the domain association.

        • (dict) --

          The subdomain for the domain association.

          • subDomainSetting (dict) --

            Describes the settings for the subdomain.

            • prefix (string) --

              The prefix setting for the subdomain.

            • branchName (string) --

              The branch name setting for the subdomain.

          • verified (boolean) --

            The verified status of the subdomain

          • dnsRecord (string) --

            The DNS record for the subdomain.

Exceptions

delete_job(**kwargs)

Deletes a job for a branch of an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.delete_job(
    appId='string',
    branchName='string',
    jobId='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for the branch, for the job.

  • jobId (string) --

    [REQUIRED]

    The unique ID for the job.

Return type

dict

Returns

Response Syntax

{
    'jobSummary': {
        'jobArn': 'string',
        'jobId': 'string',
        'commitId': 'string',
        'commitMessage': 'string',
        'commitTime': datetime(2015, 1, 1),
        'startTime': datetime(2015, 1, 1),
        'status': 'PENDING'|'PROVISIONING'|'RUNNING'|'FAILED'|'SUCCEED'|'CANCELLING'|'CANCELLED',
        'endTime': datetime(2015, 1, 1),
        'jobType': 'RELEASE'|'RETRY'|'MANUAL'|'WEB_HOOK'
    }
}

Response Structure

  • (dict) --

    The result structure for the delete job request.

    • jobSummary (dict) --

      Describes the summary for an execution job for an Amplify app.

      • jobArn (string) --

        The Amazon Resource Name (ARN) for the job.

      • jobId (string) --

        The unique ID for the job.

      • commitId (string) --

        The commit ID from a third-party repository provider for the job.

      • commitMessage (string) --

        The commit message from a third-party repository provider for the job.

      • commitTime (datetime) --

        The commit date and time for the job.

      • startTime (datetime) --

        The start date and time for the job.

      • status (string) --

        The current status for the job.

      • endTime (datetime) --

        The end date and time for the job.

      • jobType (string) --

        The type for the job. If the value is RELEASE , the job was manually released from its source by using the StartJob API. If the value is RETRY , the job was manually retried using the StartJob API. If the value is WEB_HOOK , the job was automatically triggered by webhooks.

Exceptions

delete_webhook(**kwargs)

Deletes a webhook.

See also: AWS API Documentation

Request Syntax

response = client.delete_webhook(
    webhookId='string'
)
Parameters
webhookId (string) --

[REQUIRED]

The unique ID for a webhook.

Return type
dict
Returns
Response Syntax
{
    'webhook': {
        'webhookArn': 'string',
        'webhookId': 'string',
        'webhookUrl': 'string',
        'branchName': 'string',
        'description': 'string',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    The result structure for the delete webhook request.

    • webhook (dict) --

      Describes a webhook that connects repository events to an Amplify app.

      • webhookArn (string) --

        The Amazon Resource Name (ARN) for the webhook.

      • webhookId (string) --

        The ID of the webhook.

      • webhookUrl (string) --

        The URL of the webhook.

      • branchName (string) --

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

      • description (string) --

        The description for a webhook.

      • createTime (datetime) --

        The create date and time for a webhook.

      • updateTime (datetime) --

        Updates the date and time for a webhook.

Exceptions

generate_access_logs(**kwargs)

Returns the website access logs for a specific time range using a presigned URL.

See also: AWS API Documentation

Request Syntax

response = client.generate_access_logs(
    startTime=datetime(2015, 1, 1),
    endTime=datetime(2015, 1, 1),
    domainName='string',
    appId='string'
)
Parameters
  • startTime (datetime) -- The time at which the logs should start. The time range specified is inclusive of the start time.
  • endTime (datetime) -- The time at which the logs should end. The time range specified is inclusive of the end time.
  • domainName (string) --

    [REQUIRED]

    The name of the domain.

  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

Return type

dict

Returns

Response Syntax

{
    'logUrl': 'string'
}

Response Structure

  • (dict) --

    The result structure for the generate access logs request.

    • logUrl (string) --

      The pre-signed URL for the requested access logs.

Exceptions

generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_app(**kwargs)

Returns an existing Amplify app by appID.

See also: AWS API Documentation

Request Syntax

response = client.get_app(
    appId='string'
)
Parameters
appId (string) --

[REQUIRED]

The unique ID for an Amplify app.

Return type
dict
Returns
Response Syntax
{
    'app': {
        'appId': 'string',
        'appArn': 'string',
        'name': 'string',
        'tags': {
            'string': 'string'
        },
        'description': 'string',
        'repository': 'string',
        'platform': 'WEB',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'iamServiceRoleArn': 'string',
        'environmentVariables': {
            'string': 'string'
        },
        'defaultDomain': 'string',
        'enableBranchAutoBuild': True|False,
        'enableBranchAutoDeletion': True|False,
        'enableBasicAuth': True|False,
        'basicAuthCredentials': 'string',
        'customRules': [
            {
                'source': 'string',
                'target': 'string',
                'status': 'string',
                'condition': 'string'
            },
        ],
        'productionBranch': {
            'lastDeployTime': datetime(2015, 1, 1),
            'status': 'string',
            'thumbnailUrl': 'string',
            'branchName': 'string'
        },
        'buildSpec': 'string',
        'enableAutoBranchCreation': True|False,
        'autoBranchCreationPatterns': [
            'string',
        ],
        'autoBranchCreationConfig': {
            'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
            'framework': 'string',
            'enableAutoBuild': True|False,
            'environmentVariables': {
                'string': 'string'
            },
            'basicAuthCredentials': 'string',
            'enableBasicAuth': True|False,
            'enablePerformanceMode': True|False,
            'buildSpec': 'string',
            'enablePullRequestPreview': True|False,
            'pullRequestEnvironmentName': 'string'
        }
    }
}

Response Structure

  • (dict) --
    • app (dict) --

      Represents the different branches of a repository for building, deploying, and hosting an Amplify app.

      • appId (string) --

        The unique ID of the Amplify app.

      • appArn (string) --

        The Amazon Resource Name (ARN) of the Amplify app.

      • name (string) --

        The name for the Amplify app.

      • tags (dict) --

        The tag for the Amplify app.

        • (string) --
          • (string) --
      • description (string) --

        The description for the Amplify app.

      • repository (string) --

        The repository for the Amplify app.

      • platform (string) --

        The platform for the Amplify app.

      • createTime (datetime) --

        Creates a date and time for the Amplify app.

      • updateTime (datetime) --

        Updates the date and time for the Amplify app.

      • iamServiceRoleArn (string) --

        The AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) of the Amplify app.

      • environmentVariables (dict) --

        The environment variables for the Amplify app.

        • (string) --
          • (string) --
      • defaultDomain (string) --

        The default domain for the Amplify app.

      • enableBranchAutoBuild (boolean) --

        Enables the auto-building of branches for the Amplify app.

      • enableBranchAutoDeletion (boolean) --

        Automatically disconnect a branch in the Amplify Console when you delete a branch from your Git repository.

      • enableBasicAuth (boolean) --

        Enables basic authorization for the Amplify app's branches.

      • basicAuthCredentials (string) --

        The basic authorization credentials for branches for the Amplify app.

      • customRules (list) --

        Describes the custom redirect and rewrite rules for the Amplify app.

        • (dict) --

          Describes a custom rewrite or redirect rule.

          • source (string) --

            The source pattern for a URL rewrite or redirect rule.

          • target (string) --

            The target pattern for a URL rewrite or redirect rule.

          • status (string) --

            The status code for a URL rewrite or redirect rule.

            200

            Represents a 200 rewrite rule.

            301

            Represents a 301 (moved pemanently) redirect rule. This and all future requests should be directed to the target URL.

            302

            Represents a 302 temporary redirect rule.

            404

            Represents a 404 redirect rule.

            404-200

            Represents a 404 rewrite rule.

          • condition (string) --

            The condition for a URL rewrite or redirect rule, such as a country code.

      • productionBranch (dict) --

        Describes the information about a production branch of the Amplify app.

        • lastDeployTime (datetime) --

          The last deploy time of the production branch.

        • status (string) --

          The status of the production branch.

        • thumbnailUrl (string) --

          The thumbnail URL for the production branch.

        • branchName (string) --

          The branch name for the production branch.

      • buildSpec (string) --

        Describes the content of the build specification (build spec) for the Amplify app.

      • enableAutoBranchCreation (boolean) --

        Enables automated branch creation for the Amplify app.

      • autoBranchCreationPatterns (list) --

        Describes the automated branch creation glob patterns for the Amplify app.

        • (string) --
      • autoBranchCreationConfig (dict) --

        Describes the automated branch creation configuration for the Amplify app.

        • stage (string) --

          Describes the current stage for the autocreated branch.

        • framework (string) --

          The framework for the autocreated branch.

        • enableAutoBuild (boolean) --

          Enables auto building for the autocreated branch.

        • environmentVariables (dict) --

          The environment variables for the autocreated branch.

          • (string) --
            • (string) --
        • basicAuthCredentials (string) --

          The basic authorization credentials for the autocreated branch.

        • enableBasicAuth (boolean) --

          Enables basic authorization for the autocreated branch.

        • enablePerformanceMode (boolean) --

          Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

        • buildSpec (string) --

          The build specification (build spec) for the autocreated branch.

        • enablePullRequestPreview (boolean) --

          Enables pull request preview for the autocreated branch.

        • pullRequestEnvironmentName (string) --

          The Amplify environment name for the pull request.

Exceptions

get_artifact_url(**kwargs)

Returns the artifact info that corresponds to an artifact id.

See also: AWS API Documentation

Request Syntax

response = client.get_artifact_url(
    artifactId='string'
)
Parameters
artifactId (string) --

[REQUIRED]

The unique ID for an artifact.

Return type
dict
Returns
Response Syntax
{
    'artifactId': 'string',
    'artifactUrl': 'string'
}

Response Structure

  • (dict) --

    Returns the result structure for the get artifact request.

    • artifactId (string) --

      The unique ID for an artifact.

    • artifactUrl (string) --

      The presigned URL for the artifact.

Exceptions

get_backend_environment(**kwargs)

Returns a backend environment for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.get_backend_environment(
    appId='string',
    environmentName='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique id for an Amplify app.

  • environmentName (string) --

    [REQUIRED]

    The name for the backend environment.

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 get backend environment result.

    • 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

get_branch(**kwargs)

Returns a branch for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.get_branch(
    appId='string',
    branchName='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for the branch.

Return type

dict

Returns

Response Syntax

{
    'branch': {
        'branchArn': 'string',
        'branchName': 'string',
        'description': 'string',
        'tags': {
            'string': 'string'
        },
        'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
        'displayName': 'string',
        'enableNotification': True|False,
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'environmentVariables': {
            'string': 'string'
        },
        'enableAutoBuild': True|False,
        'customDomains': [
            'string',
        ],
        'framework': 'string',
        'activeJobId': 'string',
        'totalNumberOfJobs': 'string',
        'enableBasicAuth': True|False,
        'enablePerformanceMode': True|False,
        'thumbnailUrl': 'string',
        'basicAuthCredentials': 'string',
        'buildSpec': 'string',
        'ttl': 'string',
        'associatedResources': [
            'string',
        ],
        'enablePullRequestPreview': True|False,
        'pullRequestEnvironmentName': 'string',
        'destinationBranch': 'string',
        'sourceBranch': 'string',
        'backendEnvironmentArn': 'string'
    }
}

Response Structure

  • (dict) --

    • branch (dict) --

      The branch for an Amplify app, which maps to a third-party repository branch.

      • branchArn (string) --

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

      • branchName (string) --

        The name for the branch that is part of an Amplify app.

      • description (string) --

        The description for the branch that is part of an Amplify app.

      • tags (dict) --

        The tag for the branch of an Amplify app.

        • (string) --
          • (string) --
      • stage (string) --

        The current stage for the branch that is part of an Amplify app.

      • displayName (string) --

        The display name for the branch. This is used as the default domain prefix.

      • enableNotification (boolean) --

        Enables notifications for a branch that is part of an Amplify app.

      • createTime (datetime) --

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

      • updateTime (datetime) --

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

      • environmentVariables (dict) --

        The environment variables specific to a branch of an Amplify app.

        • (string) --
          • (string) --
      • enableAutoBuild (boolean) --

        Enables auto-building on push for a branch of an Amplify app.

      • customDomains (list) --

        The custom domains for a branch of an Amplify app.

        • (string) --
      • framework (string) --

        The framework for a branch of an Amplify app.

      • activeJobId (string) --

        The ID of the active job for a branch of an Amplify app.

      • totalNumberOfJobs (string) --

        The total number of jobs that are part of an Amplify app.

      • enableBasicAuth (boolean) --

        Enables basic authorization for a branch of an Amplify app.

      • enablePerformanceMode (boolean) --

        Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

      • thumbnailUrl (string) --

        The thumbnail URL for the branch of an Amplify app.

      • basicAuthCredentials (string) --

        The basic authorization credentials for a branch of an Amplify app.

      • buildSpec (string) --

        The build specification (build spec) content for the branch of an Amplify app.

      • ttl (string) --

        The content Time to Live (TTL) for the website in seconds.

      • associatedResources (list) --

        A list of custom resources that are linked to this branch.

        • (string) --
      • enablePullRequestPreview (boolean) --

        Enables pull request preview for the branch.

      • pullRequestEnvironmentName (string) --

        The Amplify environment name for the pull request.

      • destinationBranch (string) --

        The destination branch if the branch is a pull request branch.

      • sourceBranch (string) --

        The source branch if the branch is a pull request branch.

      • backendEnvironmentArn (string) --

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

Exceptions

get_domain_association(**kwargs)

Returns the domain information for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.get_domain_association(
    appId='string',
    domainName='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique id for an Amplify app.

  • domainName (string) --

    [REQUIRED]

    The name of the domain.

Return type

dict

Returns

Response Syntax

{
    'domainAssociation': {
        'domainAssociationArn': 'string',
        'domainName': 'string',
        'enableAutoSubDomain': True|False,
        'autoSubDomainCreationPatterns': [
            'string',
        ],
        'autoSubDomainIAMRole': 'string',
        'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'PENDING_DEPLOYMENT'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
        'statusReason': 'string',
        'certificateVerificationDNSRecord': 'string',
        'subDomains': [
            {
                'subDomainSetting': {
                    'prefix': 'string',
                    'branchName': 'string'
                },
                'verified': True|False,
                'dnsRecord': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    The result structure for the get domain association request.

    • domainAssociation (dict) --

      Describes the structure of a domain association, which associates a custom domain with an Amplify app.

      • domainAssociationArn (string) --

        The Amazon Resource Name (ARN) for the domain association.

      • domainName (string) --

        The name of the domain.

      • enableAutoSubDomain (boolean) --

        Enables the automated creation of subdomains for branches.

      • autoSubDomainCreationPatterns (list) --

        Sets branch patterns for automatic subdomain creation.

        • (string) --
      • autoSubDomainIAMRole (string) --

        The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

      • domainStatus (string) --

        The current status of the domain association.

      • statusReason (string) --

        The reason for the current status of the domain association.

      • certificateVerificationDNSRecord (string) --

        The DNS record for certificate verification.

      • subDomains (list) --

        The subdomains for the domain association.

        • (dict) --

          The subdomain for the domain association.

          • subDomainSetting (dict) --

            Describes the settings for the subdomain.

            • prefix (string) --

              The prefix setting for the subdomain.

            • branchName (string) --

              The branch name setting for the subdomain.

          • verified (boolean) --

            The verified status of the subdomain

          • dnsRecord (string) --

            The DNS record for the subdomain.

Exceptions

get_job(**kwargs)

Returns a job for a branch of an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.get_job(
    appId='string',
    branchName='string',
    jobId='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The branch name for the job.

  • jobId (string) --

    [REQUIRED]

    The unique ID for the job.

Return type

dict

Returns

Response Syntax

{
    'job': {
        'summary': {
            'jobArn': 'string',
            'jobId': 'string',
            'commitId': 'string',
            'commitMessage': 'string',
            'commitTime': datetime(2015, 1, 1),
            'startTime': datetime(2015, 1, 1),
            'status': 'PENDING'|'PROVISIONING'|'RUNNING'|'FAILED'|'SUCCEED'|'CANCELLING'|'CANCELLED',
            'endTime': datetime(2015, 1, 1),
            'jobType': 'RELEASE'|'RETRY'|'MANUAL'|'WEB_HOOK'
        },
        'steps': [
            {
                'stepName': 'string',
                'startTime': datetime(2015, 1, 1),
                'status': 'PENDING'|'PROVISIONING'|'RUNNING'|'FAILED'|'SUCCEED'|'CANCELLING'|'CANCELLED',
                'endTime': datetime(2015, 1, 1),
                'logUrl': 'string',
                'artifactsUrl': 'string',
                'testArtifactsUrl': 'string',
                'testConfigUrl': 'string',
                'screenshots': {
                    'string': 'string'
                },
                'statusReason': 'string',
                'context': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • job (dict) --

      Describes an execution job for an Amplify app.

      • summary (dict) --

        Describes the summary for an execution job for an Amplify app.

        • jobArn (string) --

          The Amazon Resource Name (ARN) for the job.

        • jobId (string) --

          The unique ID for the job.

        • commitId (string) --

          The commit ID from a third-party repository provider for the job.

        • commitMessage (string) --

          The commit message from a third-party repository provider for the job.

        • commitTime (datetime) --

          The commit date and time for the job.

        • startTime (datetime) --

          The start date and time for the job.

        • status (string) --

          The current status for the job.

        • endTime (datetime) --

          The end date and time for the job.

        • jobType (string) --

          The type for the job. If the value is RELEASE , the job was manually released from its source by using the StartJob API. If the value is RETRY , the job was manually retried using the StartJob API. If the value is WEB_HOOK , the job was automatically triggered by webhooks.

      • steps (list) --

        The execution steps for an execution job, for an Amplify app.

        • (dict) --

          Describes an execution step, for an execution job, for an Amplify app.

          • stepName (string) --

            The name of the execution step.

          • startTime (datetime) --

            The start date and time of the execution step.

          • status (string) --

            The status of the execution step.

          • endTime (datetime) --

            The end date and time of the execution step.

          • logUrl (string) --

            The URL to the logs for the execution step.

          • artifactsUrl (string) --

            The URL to the artifact for the execution step.

          • testArtifactsUrl (string) --

            The URL to the test artifact for the execution step.

          • testConfigUrl (string) --

            The URL to the test configuration for the execution step.

          • screenshots (dict) --

            The list of screenshot URLs for the execution step, if relevant.

            • (string) --
              • (string) --
          • statusReason (string) --

            The reason for the current step status.

          • context (string) --

            The context for the current step. Includes a build image if the step is build.

Exceptions

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
get_webhook(**kwargs)

Returns the webhook information that corresponds to a specified webhook ID.

See also: AWS API Documentation

Request Syntax

response = client.get_webhook(
    webhookId='string'
)
Parameters
webhookId (string) --

[REQUIRED]

The unique ID for a webhook.

Return type
dict
Returns
Response Syntax
{
    'webhook': {
        'webhookArn': 'string',
        'webhookId': 'string',
        'webhookUrl': 'string',
        'branchName': 'string',
        'description': 'string',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    The result structure for the get webhook request.

    • webhook (dict) --

      Describes the structure of a webhook.

      • webhookArn (string) --

        The Amazon Resource Name (ARN) for the webhook.

      • webhookId (string) --

        The ID of the webhook.

      • webhookUrl (string) --

        The URL of the webhook.

      • branchName (string) --

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

      • description (string) --

        The description for a webhook.

      • createTime (datetime) --

        The create date and time for a webhook.

      • updateTime (datetime) --

        Updates the date and time for a webhook.

Exceptions

list_apps(**kwargs)

Returns a list of the existing Amplify apps.

See also: AWS API Documentation

Request Syntax

response = client.list_apps(
    nextToken='string',
    maxResults=123
)
Parameters
  • nextToken (string) -- A pagination token. If non-null, the pagination token is returned in a result. Pass its value in another request to retrieve more entries.
  • maxResults (integer) -- The maximum number of records to list in a single response.
Return type

dict

Returns

Response Syntax

{
    'apps': [
        {
            'appId': 'string',
            'appArn': 'string',
            'name': 'string',
            'tags': {
                'string': 'string'
            },
            'description': 'string',
            'repository': 'string',
            'platform': 'WEB',
            'createTime': datetime(2015, 1, 1),
            'updateTime': datetime(2015, 1, 1),
            'iamServiceRoleArn': 'string',
            'environmentVariables': {
                'string': 'string'
            },
            'defaultDomain': 'string',
            'enableBranchAutoBuild': True|False,
            'enableBranchAutoDeletion': True|False,
            'enableBasicAuth': True|False,
            'basicAuthCredentials': 'string',
            'customRules': [
                {
                    'source': 'string',
                    'target': 'string',
                    'status': 'string',
                    'condition': 'string'
                },
            ],
            'productionBranch': {
                'lastDeployTime': datetime(2015, 1, 1),
                'status': 'string',
                'thumbnailUrl': 'string',
                'branchName': 'string'
            },
            'buildSpec': 'string',
            'enableAutoBranchCreation': True|False,
            'autoBranchCreationPatterns': [
                'string',
            ],
            'autoBranchCreationConfig': {
                'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
                'framework': 'string',
                'enableAutoBuild': True|False,
                'environmentVariables': {
                    'string': 'string'
                },
                'basicAuthCredentials': 'string',
                'enableBasicAuth': True|False,
                'enablePerformanceMode': True|False,
                'buildSpec': 'string',
                'enablePullRequestPreview': True|False,
                'pullRequestEnvironmentName': 'string'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for an Amplify app list request.

    • apps (list) --

      A list of Amplify apps.

      • (dict) --

        Represents the different branches of a repository for building, deploying, and hosting an Amplify app.

        • appId (string) --

          The unique ID of the Amplify app.

        • appArn (string) --

          The Amazon Resource Name (ARN) of the Amplify app.

        • name (string) --

          The name for the Amplify app.

        • tags (dict) --

          The tag for the Amplify app.

          • (string) --
            • (string) --
        • description (string) --

          The description for the Amplify app.

        • repository (string) --

          The repository for the Amplify app.

        • platform (string) --

          The platform for the Amplify app.

        • createTime (datetime) --

          Creates a date and time for the Amplify app.

        • updateTime (datetime) --

          Updates the date and time for the Amplify app.

        • iamServiceRoleArn (string) --

          The AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) of the Amplify app.

        • environmentVariables (dict) --

          The environment variables for the Amplify app.

          • (string) --
            • (string) --
        • defaultDomain (string) --

          The default domain for the Amplify app.

        • enableBranchAutoBuild (boolean) --

          Enables the auto-building of branches for the Amplify app.

        • enableBranchAutoDeletion (boolean) --

          Automatically disconnect a branch in the Amplify Console when you delete a branch from your Git repository.

        • enableBasicAuth (boolean) --

          Enables basic authorization for the Amplify app's branches.

        • basicAuthCredentials (string) --

          The basic authorization credentials for branches for the Amplify app.

        • customRules (list) --

          Describes the custom redirect and rewrite rules for the Amplify app.

          • (dict) --

            Describes a custom rewrite or redirect rule.

            • source (string) --

              The source pattern for a URL rewrite or redirect rule.

            • target (string) --

              The target pattern for a URL rewrite or redirect rule.

            • status (string) --

              The status code for a URL rewrite or redirect rule.

              200

              Represents a 200 rewrite rule.

              301

              Represents a 301 (moved pemanently) redirect rule. This and all future requests should be directed to the target URL.

              302

              Represents a 302 temporary redirect rule.

              404

              Represents a 404 redirect rule.

              404-200

              Represents a 404 rewrite rule.

            • condition (string) --

              The condition for a URL rewrite or redirect rule, such as a country code.

        • productionBranch (dict) --

          Describes the information about a production branch of the Amplify app.

          • lastDeployTime (datetime) --

            The last deploy time of the production branch.

          • status (string) --

            The status of the production branch.

          • thumbnailUrl (string) --

            The thumbnail URL for the production branch.

          • branchName (string) --

            The branch name for the production branch.

        • buildSpec (string) --

          Describes the content of the build specification (build spec) for the Amplify app.

        • enableAutoBranchCreation (boolean) --

          Enables automated branch creation for the Amplify app.

        • autoBranchCreationPatterns (list) --

          Describes the automated branch creation glob patterns for the Amplify app.

          • (string) --
        • autoBranchCreationConfig (dict) --

          Describes the automated branch creation configuration for the Amplify app.

          • stage (string) --

            Describes the current stage for the autocreated branch.

          • framework (string) --

            The framework for the autocreated branch.

          • enableAutoBuild (boolean) --

            Enables auto building for the autocreated branch.

          • environmentVariables (dict) --

            The environment variables for the autocreated branch.

            • (string) --
              • (string) --
          • basicAuthCredentials (string) --

            The basic authorization credentials for the autocreated branch.

          • enableBasicAuth (boolean) --

            Enables basic authorization for the autocreated branch.

          • enablePerformanceMode (boolean) --

            Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

          • buildSpec (string) --

            The build specification (build spec) for the autocreated branch.

          • enablePullRequestPreview (boolean) --

            Enables pull request preview for the autocreated branch.

          • pullRequestEnvironmentName (string) --

            The Amplify environment name for the pull request.

    • nextToken (string) --

      A pagination token. Set to null to start listing apps from start. If non-null, the pagination token is returned in a result. Pass its value in here to list more projects.

Exceptions

list_artifacts(**kwargs)

Returns a list of artifacts for a specified app, branch, and job.

See also: AWS API Documentation

Request Syntax

response = client.list_artifacts(
    appId='string',
    branchName='string',
    jobId='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name of a branch that is part of an Amplify app.

  • jobId (string) --

    [REQUIRED]

    The unique ID for a job.

  • nextToken (string) -- A pagination token. Set to null to start listing artifacts from start. If a non-null pagination token is returned in a result, pass its value in here to list more artifacts.
  • maxResults (integer) -- The maximum number of records to list in a single response.
Return type

dict

Returns

Response Syntax

{
    'artifacts': [
        {
            'artifactFileName': 'string',
            'artifactId': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for the list artifacts request.

    • artifacts (list) --

      A list of artifacts.

      • (dict) --

        Describes an artifact.

        • artifactFileName (string) --

          The file name for the artifact.

        • artifactId (string) --

          The unique ID for the artifact.

    • nextToken (string) --

      A pagination token. If a non-null pagination token is returned in a result, pass its value in another request to retrieve more entries.

Exceptions

list_backend_environments(**kwargs)

Lists the backend environments for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.list_backend_environments(
    appId='string',
    environmentName='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • environmentName (string) -- The name of the backend environment
  • nextToken (string) -- A pagination token. Set to null to start listing backend environments from the start. If a non-null pagination token is returned in a result, pass its value in here to list more backend environments.
  • maxResults (integer) -- The maximum number of records to list in a single response.
Return type

dict

Returns

Response Syntax

{
    'backendEnvironments': [
        {
            'backendEnvironmentArn': 'string',
            'environmentName': 'string',
            'stackName': 'string',
            'deploymentArtifacts': 'string',
            'createTime': datetime(2015, 1, 1),
            'updateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for the list backend environments result.

    • backendEnvironments (list) --

      The list of backend environments for an Amplify app.

      • (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.

    • nextToken (string) --

      A pagination token. If a non-null pagination token is returned in a result, pass its value in another request to retrieve more entries.

Exceptions

list_branches(**kwargs)

Lists the branches of an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.list_branches(
    appId='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • nextToken (string) -- A pagination token. Set to null to start listing branches from the start. If a non-null pagination token is returned in a result, pass its value in here to list more branches.
  • maxResults (integer) -- The maximum number of records to list in a single response.
Return type

dict

Returns

Response Syntax

{
    'branches': [
        {
            'branchArn': 'string',
            'branchName': 'string',
            'description': 'string',
            'tags': {
                'string': 'string'
            },
            'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
            'displayName': 'string',
            'enableNotification': True|False,
            'createTime': datetime(2015, 1, 1),
            'updateTime': datetime(2015, 1, 1),
            'environmentVariables': {
                'string': 'string'
            },
            'enableAutoBuild': True|False,
            'customDomains': [
                'string',
            ],
            'framework': 'string',
            'activeJobId': 'string',
            'totalNumberOfJobs': 'string',
            'enableBasicAuth': True|False,
            'enablePerformanceMode': True|False,
            'thumbnailUrl': 'string',
            'basicAuthCredentials': 'string',
            'buildSpec': 'string',
            'ttl': 'string',
            'associatedResources': [
                'string',
            ],
            'enablePullRequestPreview': True|False,
            'pullRequestEnvironmentName': 'string',
            'destinationBranch': 'string',
            'sourceBranch': 'string',
            'backendEnvironmentArn': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for the list branches request.

    • branches (list) --

      A list of branches for an Amplify app.

      • (dict) --

        The branch for an Amplify app, which maps to a third-party repository branch.

        • branchArn (string) --

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

        • branchName (string) --

          The name for the branch that is part of an Amplify app.

        • description (string) --

          The description for the branch that is part of an Amplify app.

        • tags (dict) --

          The tag for the branch of an Amplify app.

          • (string) --
            • (string) --
        • stage (string) --

          The current stage for the branch that is part of an Amplify app.

        • displayName (string) --

          The display name for the branch. This is used as the default domain prefix.

        • enableNotification (boolean) --

          Enables notifications for a branch that is part of an Amplify app.

        • createTime (datetime) --

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

        • updateTime (datetime) --

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

        • environmentVariables (dict) --

          The environment variables specific to a branch of an Amplify app.

          • (string) --
            • (string) --
        • enableAutoBuild (boolean) --

          Enables auto-building on push for a branch of an Amplify app.

        • customDomains (list) --

          The custom domains for a branch of an Amplify app.

          • (string) --
        • framework (string) --

          The framework for a branch of an Amplify app.

        • activeJobId (string) --

          The ID of the active job for a branch of an Amplify app.

        • totalNumberOfJobs (string) --

          The total number of jobs that are part of an Amplify app.

        • enableBasicAuth (boolean) --

          Enables basic authorization for a branch of an Amplify app.

        • enablePerformanceMode (boolean) --

          Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

        • thumbnailUrl (string) --

          The thumbnail URL for the branch of an Amplify app.

        • basicAuthCredentials (string) --

          The basic authorization credentials for a branch of an Amplify app.

        • buildSpec (string) --

          The build specification (build spec) content for the branch of an Amplify app.

        • ttl (string) --

          The content Time to Live (TTL) for the website in seconds.

        • associatedResources (list) --

          A list of custom resources that are linked to this branch.

          • (string) --
        • enablePullRequestPreview (boolean) --

          Enables pull request preview for the branch.

        • pullRequestEnvironmentName (string) --

          The Amplify environment name for the pull request.

        • destinationBranch (string) --

          The destination branch if the branch is a pull request branch.

        • sourceBranch (string) --

          The source branch if the branch is a pull request branch.

        • backendEnvironmentArn (string) --

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

    • nextToken (string) --

      A pagination token. If a non-null pagination token is returned in a result, pass its value in another request to retrieve more entries.

Exceptions

list_domain_associations(**kwargs)

Returns the domain associations for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.list_domain_associations(
    appId='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • nextToken (string) -- A pagination token. Set to null to start listing apps from the start. If non-null, a pagination token is returned in a result. Pass its value in here to list more projects.
  • maxResults (integer) -- The maximum number of records to list in a single response.
Return type

dict

Returns

Response Syntax

{
    'domainAssociations': [
        {
            'domainAssociationArn': 'string',
            'domainName': 'string',
            'enableAutoSubDomain': True|False,
            'autoSubDomainCreationPatterns': [
                'string',
            ],
            'autoSubDomainIAMRole': 'string',
            'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'PENDING_DEPLOYMENT'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
            'statusReason': 'string',
            'certificateVerificationDNSRecord': 'string',
            'subDomains': [
                {
                    'subDomainSetting': {
                        'prefix': 'string',
                        'branchName': 'string'
                    },
                    'verified': True|False,
                    'dnsRecord': 'string'
                },
            ]
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for the list domain association request.

    • domainAssociations (list) --

      A list of domain associations.

      • (dict) --

        Describes a domain association that associates a custom domain with an Amplify app.

        • domainAssociationArn (string) --

          The Amazon Resource Name (ARN) for the domain association.

        • domainName (string) --

          The name of the domain.

        • enableAutoSubDomain (boolean) --

          Enables the automated creation of subdomains for branches.

        • autoSubDomainCreationPatterns (list) --

          Sets branch patterns for automatic subdomain creation.

          • (string) --
        • autoSubDomainIAMRole (string) --

          The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

        • domainStatus (string) --

          The current status of the domain association.

        • statusReason (string) --

          The reason for the current status of the domain association.

        • certificateVerificationDNSRecord (string) --

          The DNS record for certificate verification.

        • subDomains (list) --

          The subdomains for the domain association.

          • (dict) --

            The subdomain for the domain association.

            • subDomainSetting (dict) --

              Describes the settings for the subdomain.

              • prefix (string) --

                The prefix setting for the subdomain.

              • branchName (string) --

                The branch name setting for the subdomain.

            • verified (boolean) --

              The verified status of the subdomain

            • dnsRecord (string) --

              The DNS record for the subdomain.

    • nextToken (string) --

      A pagination token. If non-null, a pagination token is returned in a result. Pass its value in another request to retrieve more entries.

Exceptions

list_jobs(**kwargs)

Lists the jobs for a branch of an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.list_jobs(
    appId='string',
    branchName='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for a branch.

  • nextToken (string) -- A pagination token. Set to null to start listing steps from the start. If a non-null pagination token is returned in a result, pass its value in here to list more steps.
  • maxResults (integer) -- The maximum number of records to list in a single response.
Return type

dict

Returns

Response Syntax

{
    'jobSummaries': [
        {
            'jobArn': 'string',
            'jobId': 'string',
            'commitId': 'string',
            'commitMessage': 'string',
            'commitTime': datetime(2015, 1, 1),
            'startTime': datetime(2015, 1, 1),
            'status': 'PENDING'|'PROVISIONING'|'RUNNING'|'FAILED'|'SUCCEED'|'CANCELLING'|'CANCELLED',
            'endTime': datetime(2015, 1, 1),
            'jobType': 'RELEASE'|'RETRY'|'MANUAL'|'WEB_HOOK'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The maximum number of records to list in a single response.

    • jobSummaries (list) --

      The result structure for the list job result request.

      • (dict) --

        Describes the summary for an execution job for an Amplify app.

        • jobArn (string) --

          The Amazon Resource Name (ARN) for the job.

        • jobId (string) --

          The unique ID for the job.

        • commitId (string) --

          The commit ID from a third-party repository provider for the job.

        • commitMessage (string) --

          The commit message from a third-party repository provider for the job.

        • commitTime (datetime) --

          The commit date and time for the job.

        • startTime (datetime) --

          The start date and time for the job.

        • status (string) --

          The current status for the job.

        • endTime (datetime) --

          The end date and time for the job.

        • jobType (string) --

          The type for the job. If the value is RELEASE , the job was manually released from its source by using the StartJob API. If the value is RETRY , the job was manually retried using the StartJob API. If the value is WEB_HOOK , the job was automatically triggered by webhooks.

    • nextToken (string) --

      A pagination token. If non-null the pagination token is returned in a result. Pass its value in another request to retrieve more entries.

Exceptions

list_tags_for_resource(**kwargs)

Returns a list of tags for a specified Amazon Resource Name (ARN).

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    resourceArn='string'
)
Parameters
resourceArn (string) --

[REQUIRED]

The Amazon Resource Name (ARN) to use to list tags.

Return type
dict
Returns
Response Syntax
{
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    The response for the list tags for resource request.

    • tags (dict) --

      A list of tags for the specified The Amazon Resource Name (ARN).

      • (string) --
        • (string) --

Exceptions

list_webhooks(**kwargs)

Returns a list of webhooks for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.list_webhooks(
    appId='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • nextToken (string) -- A pagination token. Set to null to start listing webhooks from the start. If non-null,the pagination token is returned in a result. Pass its value in here to list more webhooks.
  • maxResults (integer) -- The maximum number of records to list in a single response.
Return type

dict

Returns

Response Syntax

{
    'webhooks': [
        {
            'webhookArn': 'string',
            'webhookId': 'string',
            'webhookUrl': 'string',
            'branchName': 'string',
            'description': 'string',
            'createTime': datetime(2015, 1, 1),
            'updateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for the list webhooks request.

    • webhooks (list) --

      A list of webhooks.

      • (dict) --

        Describes a webhook that connects repository events to an Amplify app.

        • webhookArn (string) --

          The Amazon Resource Name (ARN) for the webhook.

        • webhookId (string) --

          The ID of the webhook.

        • webhookUrl (string) --

          The URL of the webhook.

        • branchName (string) --

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

        • description (string) --

          The description for a webhook.

        • createTime (datetime) --

          The create date and time for a webhook.

        • updateTime (datetime) --

          Updates the date and time for a webhook.

    • nextToken (string) --

      A pagination token. If non-null, the pagination token is returned in a result. Pass its value in another request to retrieve more entries.

Exceptions

start_deployment(**kwargs)

Starts a deployment for a manually deployed app. Manually deployed apps are not connected to a repository.

See also: AWS API Documentation

Request Syntax

response = client.start_deployment(
    appId='string',
    branchName='string',
    jobId='string',
    sourceUrl='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for the branch, for the job.

  • jobId (string) -- The job ID for this deployment, generated by the create deployment request.
  • sourceUrl (string) -- The source URL for this deployment, used when calling start deployment without create deployment. The source URL can be any HTTP GET URL that is publicly accessible and downloads a single .zip file.
Return type

dict

Returns

Response Syntax

{
    'jobSummary': {
        'jobArn': 'string',
        'jobId': 'string',
        'commitId': 'string',
        'commitMessage': 'string',
        'commitTime': datetime(2015, 1, 1),
        'startTime': datetime(2015, 1, 1),
        'status': 'PENDING'|'PROVISIONING'|'RUNNING'|'FAILED'|'SUCCEED'|'CANCELLING'|'CANCELLED',
        'endTime': datetime(2015, 1, 1),
        'jobType': 'RELEASE'|'RETRY'|'MANUAL'|'WEB_HOOK'
    }
}

Response Structure

  • (dict) --

    The result structure for the start a deployment request.

    • jobSummary (dict) --

      The summary for the job.

      • jobArn (string) --

        The Amazon Resource Name (ARN) for the job.

      • jobId (string) --

        The unique ID for the job.

      • commitId (string) --

        The commit ID from a third-party repository provider for the job.

      • commitMessage (string) --

        The commit message from a third-party repository provider for the job.

      • commitTime (datetime) --

        The commit date and time for the job.

      • startTime (datetime) --

        The start date and time for the job.

      • status (string) --

        The current status for the job.

      • endTime (datetime) --

        The end date and time for the job.

      • jobType (string) --

        The type for the job. If the value is RELEASE , the job was manually released from its source by using the StartJob API. If the value is RETRY , the job was manually retried using the StartJob API. If the value is WEB_HOOK , the job was automatically triggered by webhooks.

Exceptions

start_job(**kwargs)

Starts a new job for a branch of an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.start_job(
    appId='string',
    branchName='string',
    jobId='string',
    jobType='RELEASE'|'RETRY'|'MANUAL'|'WEB_HOOK',
    jobReason='string',
    commitId='string',
    commitMessage='string',
    commitTime=datetime(2015, 1, 1)
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The branch name for the job.

  • jobId (string) -- The unique ID for an existing job. This is required if the value of jobType is RETRY .
  • jobType (string) --

    [REQUIRED]

    Describes the type for the job. The job type RELEASE starts a new job with the latest change from the specified branch. This value is available only for apps that are connected to a repository. The job type RETRY retries an existing job. If the job type value is RETRY , the jobId is also required.

  • jobReason (string) -- A descriptive reason for starting this job.
  • commitId (string) -- The commit ID from a third-party repository provider for the job.
  • commitMessage (string) -- The commit message from a third-party repository provider for the job.
  • commitTime (datetime) -- The commit date and time for the job.
Return type

dict

Returns

Response Syntax

{
    'jobSummary': {
        'jobArn': 'string',
        'jobId': 'string',
        'commitId': 'string',
        'commitMessage': 'string',
        'commitTime': datetime(2015, 1, 1),
        'startTime': datetime(2015, 1, 1),
        'status': 'PENDING'|'PROVISIONING'|'RUNNING'|'FAILED'|'SUCCEED'|'CANCELLING'|'CANCELLED',
        'endTime': datetime(2015, 1, 1),
        'jobType': 'RELEASE'|'RETRY'|'MANUAL'|'WEB_HOOK'
    }
}

Response Structure

  • (dict) --

    The result structure for the run job request.

    • jobSummary (dict) --

      The summary for the job.

      • jobArn (string) --

        The Amazon Resource Name (ARN) for the job.

      • jobId (string) --

        The unique ID for the job.

      • commitId (string) --

        The commit ID from a third-party repository provider for the job.

      • commitMessage (string) --

        The commit message from a third-party repository provider for the job.

      • commitTime (datetime) --

        The commit date and time for the job.

      • startTime (datetime) --

        The start date and time for the job.

      • status (string) --

        The current status for the job.

      • endTime (datetime) --

        The end date and time for the job.

      • jobType (string) --

        The type for the job. If the value is RELEASE , the job was manually released from its source by using the StartJob API. If the value is RETRY , the job was manually retried using the StartJob API. If the value is WEB_HOOK , the job was automatically triggered by webhooks.

Exceptions

stop_job(**kwargs)

Stops a job that is in progress for a branch of an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.stop_job(
    appId='string',
    branchName='string',
    jobId='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for the branch, for the job.

  • jobId (string) --

    [REQUIRED]

    The unique id for the job.

Return type

dict

Returns

Response Syntax

{
    'jobSummary': {
        'jobArn': 'string',
        'jobId': 'string',
        'commitId': 'string',
        'commitMessage': 'string',
        'commitTime': datetime(2015, 1, 1),
        'startTime': datetime(2015, 1, 1),
        'status': 'PENDING'|'PROVISIONING'|'RUNNING'|'FAILED'|'SUCCEED'|'CANCELLING'|'CANCELLED',
        'endTime': datetime(2015, 1, 1),
        'jobType': 'RELEASE'|'RETRY'|'MANUAL'|'WEB_HOOK'
    }
}

Response Structure

  • (dict) --

    The result structure for the stop job request.

    • jobSummary (dict) --

      The summary for the job.

      • jobArn (string) --

        The Amazon Resource Name (ARN) for the job.

      • jobId (string) --

        The unique ID for the job.

      • commitId (string) --

        The commit ID from a third-party repository provider for the job.

      • commitMessage (string) --

        The commit message from a third-party repository provider for the job.

      • commitTime (datetime) --

        The commit date and time for the job.

      • startTime (datetime) --

        The start date and time for the job.

      • status (string) --

        The current status for the job.

      • endTime (datetime) --

        The end date and time for the job.

      • jobType (string) --

        The type for the job. If the value is RELEASE , the job was manually released from its source by using the StartJob API. If the value is RETRY , the job was manually retried using the StartJob API. If the value is WEB_HOOK , the job was automatically triggered by webhooks.

Exceptions

tag_resource(**kwargs)

Tags the resource with a tag key and value.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    resourceArn='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) to use to tag a resource.

  • tags (dict) --

    [REQUIRED]

    The tags used to tag the resource.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The response for the tag resource request.

Exceptions

untag_resource(**kwargs)

Untags a resource with a specified Amazon Resource Name (ARN).

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    resourceArn='string',
    tagKeys=[
        'string',
    ]
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) to use to untag a resource.

  • tagKeys (list) --

    [REQUIRED]

    The tag keys to use to untag a resource.

    • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The response for the untag resource request.

Exceptions

update_app(**kwargs)

Updates an existing Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.update_app(
    appId='string',
    name='string',
    description='string',
    platform='WEB',
    iamServiceRoleArn='string',
    environmentVariables={
        'string': 'string'
    },
    enableBranchAutoBuild=True|False,
    enableBranchAutoDeletion=True|False,
    enableBasicAuth=True|False,
    basicAuthCredentials='string',
    customRules=[
        {
            'source': 'string',
            'target': 'string',
            'status': 'string',
            'condition': 'string'
        },
    ],
    buildSpec='string',
    enableAutoBranchCreation=True|False,
    autoBranchCreationPatterns=[
        'string',
    ],
    autoBranchCreationConfig={
        'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
        'framework': 'string',
        'enableAutoBuild': True|False,
        'environmentVariables': {
            'string': 'string'
        },
        'basicAuthCredentials': 'string',
        'enableBasicAuth': True|False,
        'enablePerformanceMode': True|False,
        'buildSpec': 'string',
        'enablePullRequestPreview': True|False,
        'pullRequestEnvironmentName': 'string'
    },
    repository='string',
    oauthToken='string',
    accessToken='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • name (string) -- The name for an Amplify app.
  • description (string) -- The description for an Amplify app.
  • platform (string) -- The platform for an Amplify app.
  • iamServiceRoleArn (string) -- The AWS Identity and Access Management (IAM) service role for an Amplify app.
  • environmentVariables (dict) --

    The environment variables for an Amplify app.

    • (string) --
      • (string) --
  • enableBranchAutoBuild (boolean) -- Enables branch auto-building for an Amplify app.
  • enableBranchAutoDeletion (boolean) -- Automatically disconnects a branch in the Amplify Console when you delete a branch from your Git repository.
  • enableBasicAuth (boolean) -- Enables basic authorization for an Amplify app.
  • basicAuthCredentials (string) -- The basic authorization credentials for an Amplify app.
  • customRules (list) --

    The custom redirect and rewrite rules for an Amplify app.

    • (dict) --

      Describes a custom rewrite or redirect rule.

      • source (string) -- [REQUIRED]

        The source pattern for a URL rewrite or redirect rule.

      • target (string) -- [REQUIRED]

        The target pattern for a URL rewrite or redirect rule.

      • status (string) --

        The status code for a URL rewrite or redirect rule.

        200

        Represents a 200 rewrite rule.

        301

        Represents a 301 (moved pemanently) redirect rule. This and all future requests should be directed to the target URL.

        302

        Represents a 302 temporary redirect rule.

        404

        Represents a 404 redirect rule.

        404-200

        Represents a 404 rewrite rule.

      • condition (string) --

        The condition for a URL rewrite or redirect rule, such as a country code.

  • buildSpec (string) -- The build specification (build spec) for an Amplify app.
  • enableAutoBranchCreation (boolean) -- Enables automated branch creation for the Amplify app.
  • autoBranchCreationPatterns (list) --

    Describes the automated branch creation glob patterns for the Amplify app.

    • (string) --
  • autoBranchCreationConfig (dict) --

    The automated branch creation configuration for the Amplify app.

    • stage (string) --

      Describes the current stage for the autocreated branch.

    • framework (string) --

      The framework for the autocreated branch.

    • enableAutoBuild (boolean) --

      Enables auto building for the autocreated branch.

    • environmentVariables (dict) --

      The environment variables for the autocreated branch.

      • (string) --
        • (string) --
    • basicAuthCredentials (string) --

      The basic authorization credentials for the autocreated branch.

    • enableBasicAuth (boolean) --

      Enables basic authorization for the autocreated branch.

    • enablePerformanceMode (boolean) --

      Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

    • buildSpec (string) --

      The build specification (build spec) for the autocreated branch.

    • enablePullRequestPreview (boolean) --

      Enables pull request preview for the autocreated branch.

    • pullRequestEnvironmentName (string) --

      The Amplify environment name for the pull request.

  • repository (string) -- The name of the repository for an Amplify app
  • oauthToken (string) -- The OAuth token for a third-party source control system for an Amplify app. The token is used to create a webhook and a read-only deploy key. The OAuth token is not stored.
  • accessToken (string) -- The personal access token for a third-party source control system for an Amplify app. The token is used to create webhook and a read-only deploy key. The token is not stored.
Return type

dict

Returns

Response Syntax

{
    'app': {
        'appId': 'string',
        'appArn': 'string',
        'name': 'string',
        'tags': {
            'string': 'string'
        },
        'description': 'string',
        'repository': 'string',
        'platform': 'WEB',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'iamServiceRoleArn': 'string',
        'environmentVariables': {
            'string': 'string'
        },
        'defaultDomain': 'string',
        'enableBranchAutoBuild': True|False,
        'enableBranchAutoDeletion': True|False,
        'enableBasicAuth': True|False,
        'basicAuthCredentials': 'string',
        'customRules': [
            {
                'source': 'string',
                'target': 'string',
                'status': 'string',
                'condition': 'string'
            },
        ],
        'productionBranch': {
            'lastDeployTime': datetime(2015, 1, 1),
            'status': 'string',
            'thumbnailUrl': 'string',
            'branchName': 'string'
        },
        'buildSpec': 'string',
        'enableAutoBranchCreation': True|False,
        'autoBranchCreationPatterns': [
            'string',
        ],
        'autoBranchCreationConfig': {
            'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
            'framework': 'string',
            'enableAutoBuild': True|False,
            'environmentVariables': {
                'string': 'string'
            },
            'basicAuthCredentials': 'string',
            'enableBasicAuth': True|False,
            'enablePerformanceMode': True|False,
            'buildSpec': 'string',
            'enablePullRequestPreview': True|False,
            'pullRequestEnvironmentName': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The result structure for an Amplify app update request.

    • app (dict) --

      Represents the updated Amplify app.

      • appId (string) --

        The unique ID of the Amplify app.

      • appArn (string) --

        The Amazon Resource Name (ARN) of the Amplify app.

      • name (string) --

        The name for the Amplify app.

      • tags (dict) --

        The tag for the Amplify app.

        • (string) --
          • (string) --
      • description (string) --

        The description for the Amplify app.

      • repository (string) --

        The repository for the Amplify app.

      • platform (string) --

        The platform for the Amplify app.

      • createTime (datetime) --

        Creates a date and time for the Amplify app.

      • updateTime (datetime) --

        Updates the date and time for the Amplify app.

      • iamServiceRoleArn (string) --

        The AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) of the Amplify app.

      • environmentVariables (dict) --

        The environment variables for the Amplify app.

        • (string) --
          • (string) --
      • defaultDomain (string) --

        The default domain for the Amplify app.

      • enableBranchAutoBuild (boolean) --

        Enables the auto-building of branches for the Amplify app.

      • enableBranchAutoDeletion (boolean) --

        Automatically disconnect a branch in the Amplify Console when you delete a branch from your Git repository.

      • enableBasicAuth (boolean) --

        Enables basic authorization for the Amplify app's branches.

      • basicAuthCredentials (string) --

        The basic authorization credentials for branches for the Amplify app.

      • customRules (list) --

        Describes the custom redirect and rewrite rules for the Amplify app.

        • (dict) --

          Describes a custom rewrite or redirect rule.

          • source (string) --

            The source pattern for a URL rewrite or redirect rule.

          • target (string) --

            The target pattern for a URL rewrite or redirect rule.

          • status (string) --

            The status code for a URL rewrite or redirect rule.

            200

            Represents a 200 rewrite rule.

            301

            Represents a 301 (moved pemanently) redirect rule. This and all future requests should be directed to the target URL.

            302

            Represents a 302 temporary redirect rule.

            404

            Represents a 404 redirect rule.

            404-200

            Represents a 404 rewrite rule.

          • condition (string) --

            The condition for a URL rewrite or redirect rule, such as a country code.

      • productionBranch (dict) --

        Describes the information about a production branch of the Amplify app.

        • lastDeployTime (datetime) --

          The last deploy time of the production branch.

        • status (string) --

          The status of the production branch.

        • thumbnailUrl (string) --

          The thumbnail URL for the production branch.

        • branchName (string) --

          The branch name for the production branch.

      • buildSpec (string) --

        Describes the content of the build specification (build spec) for the Amplify app.

      • enableAutoBranchCreation (boolean) --

        Enables automated branch creation for the Amplify app.

      • autoBranchCreationPatterns (list) --

        Describes the automated branch creation glob patterns for the Amplify app.

        • (string) --
      • autoBranchCreationConfig (dict) --

        Describes the automated branch creation configuration for the Amplify app.

        • stage (string) --

          Describes the current stage for the autocreated branch.

        • framework (string) --

          The framework for the autocreated branch.

        • enableAutoBuild (boolean) --

          Enables auto building for the autocreated branch.

        • environmentVariables (dict) --

          The environment variables for the autocreated branch.

          • (string) --
            • (string) --
        • basicAuthCredentials (string) --

          The basic authorization credentials for the autocreated branch.

        • enableBasicAuth (boolean) --

          Enables basic authorization for the autocreated branch.

        • enablePerformanceMode (boolean) --

          Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

        • buildSpec (string) --

          The build specification (build spec) for the autocreated branch.

        • enablePullRequestPreview (boolean) --

          Enables pull request preview for the autocreated branch.

        • pullRequestEnvironmentName (string) --

          The Amplify environment name for the pull request.

Exceptions

update_branch(**kwargs)

Updates a branch for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.update_branch(
    appId='string',
    branchName='string',
    description='string',
    framework='string',
    stage='PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
    enableNotification=True|False,
    enableAutoBuild=True|False,
    environmentVariables={
        'string': 'string'
    },
    basicAuthCredentials='string',
    enableBasicAuth=True|False,
    enablePerformanceMode=True|False,
    buildSpec='string',
    ttl='string',
    displayName='string',
    enablePullRequestPreview=True|False,
    pullRequestEnvironmentName='string',
    backendEnvironmentArn='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for the branch.

  • description (string) -- The description for the branch.
  • framework (string) -- The framework for the branch.
  • stage (string) -- Describes the current stage for the branch.
  • enableNotification (boolean) -- Enables notifications for the branch.
  • enableAutoBuild (boolean) -- Enables auto building for the branch.
  • environmentVariables (dict) --

    The environment variables for the branch.

    • (string) --
      • (string) --
  • basicAuthCredentials (string) -- The basic authorization credentials for the branch.
  • enableBasicAuth (boolean) -- Enables basic authorization for the branch.
  • enablePerformanceMode (boolean) -- Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.
  • buildSpec (string) -- The build specification (build spec) for the branch.
  • ttl (string) -- The content Time to Live (TTL) for the website in seconds.
  • displayName (string) -- The display name for a branch. This is used as the default domain prefix.
  • enablePullRequestPreview (boolean) -- Enables pull request preview for this branch.
  • pullRequestEnvironmentName (string) -- The Amplify environment name for the pull request.
  • backendEnvironmentArn (string) -- The Amazon Resource Name (ARN) for a backend environment that is part of an Amplify app.
Return type

dict

Returns

Response Syntax

{
    'branch': {
        'branchArn': 'string',
        'branchName': 'string',
        'description': 'string',
        'tags': {
            'string': 'string'
        },
        'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
        'displayName': 'string',
        'enableNotification': True|False,
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1),
        'environmentVariables': {
            'string': 'string'
        },
        'enableAutoBuild': True|False,
        'customDomains': [
            'string',
        ],
        'framework': 'string',
        'activeJobId': 'string',
        'totalNumberOfJobs': 'string',
        'enableBasicAuth': True|False,
        'enablePerformanceMode': True|False,
        'thumbnailUrl': 'string',
        'basicAuthCredentials': 'string',
        'buildSpec': 'string',
        'ttl': 'string',
        'associatedResources': [
            'string',
        ],
        'enablePullRequestPreview': True|False,
        'pullRequestEnvironmentName': 'string',
        'destinationBranch': 'string',
        'sourceBranch': 'string',
        'backendEnvironmentArn': 'string'
    }
}

Response Structure

  • (dict) --

    The result structure for the update branch request.

    • branch (dict) --

      The branch for an Amplify app, which maps to a third-party repository branch.

      • branchArn (string) --

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

      • branchName (string) --

        The name for the branch that is part of an Amplify app.

      • description (string) --

        The description for the branch that is part of an Amplify app.

      • tags (dict) --

        The tag for the branch of an Amplify app.

        • (string) --
          • (string) --
      • stage (string) --

        The current stage for the branch that is part of an Amplify app.

      • displayName (string) --

        The display name for the branch. This is used as the default domain prefix.

      • enableNotification (boolean) --

        Enables notifications for a branch that is part of an Amplify app.

      • createTime (datetime) --

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

      • updateTime (datetime) --

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

      • environmentVariables (dict) --

        The environment variables specific to a branch of an Amplify app.

        • (string) --
          • (string) --
      • enableAutoBuild (boolean) --

        Enables auto-building on push for a branch of an Amplify app.

      • customDomains (list) --

        The custom domains for a branch of an Amplify app.

        • (string) --
      • framework (string) --

        The framework for a branch of an Amplify app.

      • activeJobId (string) --

        The ID of the active job for a branch of an Amplify app.

      • totalNumberOfJobs (string) --

        The total number of jobs that are part of an Amplify app.

      • enableBasicAuth (boolean) --

        Enables basic authorization for a branch of an Amplify app.

      • enablePerformanceMode (boolean) --

        Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

      • thumbnailUrl (string) --

        The thumbnail URL for the branch of an Amplify app.

      • basicAuthCredentials (string) --

        The basic authorization credentials for a branch of an Amplify app.

      • buildSpec (string) --

        The build specification (build spec) content for the branch of an Amplify app.

      • ttl (string) --

        The content Time to Live (TTL) for the website in seconds.

      • associatedResources (list) --

        A list of custom resources that are linked to this branch.

        • (string) --
      • enablePullRequestPreview (boolean) --

        Enables pull request preview for the branch.

      • pullRequestEnvironmentName (string) --

        The Amplify environment name for the pull request.

      • destinationBranch (string) --

        The destination branch if the branch is a pull request branch.

      • sourceBranch (string) --

        The source branch if the branch is a pull request branch.

      • backendEnvironmentArn (string) --

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

Exceptions

update_domain_association(**kwargs)

Creates a new domain association for an Amplify app.

See also: AWS API Documentation

Request Syntax

response = client.update_domain_association(
    appId='string',
    domainName='string',
    enableAutoSubDomain=True|False,
    subDomainSettings=[
        {
            'prefix': 'string',
            'branchName': 'string'
        },
    ],
    autoSubDomainCreationPatterns=[
        'string',
    ],
    autoSubDomainIAMRole='string'
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • domainName (string) --

    [REQUIRED]

    The name of the domain.

  • enableAutoSubDomain (boolean) -- Enables the automated creation of subdomains for branches.
  • subDomainSettings (list) --

    [REQUIRED]

    Describes the settings for the subdomain.

    • (dict) --

      Describes the settings for the subdomain.

      • prefix (string) -- [REQUIRED]

        The prefix setting for the subdomain.

      • branchName (string) -- [REQUIRED]

        The branch name setting for the subdomain.

  • autoSubDomainCreationPatterns (list) --

    Sets the branch patterns for automatic subdomain creation.

    • (string) --
  • autoSubDomainIAMRole (string) -- The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.
Return type

dict

Returns

Response Syntax

{
    'domainAssociation': {
        'domainAssociationArn': 'string',
        'domainName': 'string',
        'enableAutoSubDomain': True|False,
        'autoSubDomainCreationPatterns': [
            'string',
        ],
        'autoSubDomainIAMRole': 'string',
        'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'PENDING_DEPLOYMENT'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
        'statusReason': 'string',
        'certificateVerificationDNSRecord': 'string',
        'subDomains': [
            {
                'subDomainSetting': {
                    'prefix': 'string',
                    'branchName': 'string'
                },
                'verified': True|False,
                'dnsRecord': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    The result structure for the update domain association request.

    • domainAssociation (dict) --

      Describes a domain association, which associates a custom domain with an Amplify app.

      • domainAssociationArn (string) --

        The Amazon Resource Name (ARN) for the domain association.

      • domainName (string) --

        The name of the domain.

      • enableAutoSubDomain (boolean) --

        Enables the automated creation of subdomains for branches.

      • autoSubDomainCreationPatterns (list) --

        Sets branch patterns for automatic subdomain creation.

        • (string) --
      • autoSubDomainIAMRole (string) --

        The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

      • domainStatus (string) --

        The current status of the domain association.

      • statusReason (string) --

        The reason for the current status of the domain association.

      • certificateVerificationDNSRecord (string) --

        The DNS record for certificate verification.

      • subDomains (list) --

        The subdomains for the domain association.

        • (dict) --

          The subdomain for the domain association.

          • subDomainSetting (dict) --

            Describes the settings for the subdomain.

            • prefix (string) --

              The prefix setting for the subdomain.

            • branchName (string) --

              The branch name setting for the subdomain.

          • verified (boolean) --

            The verified status of the subdomain

          • dnsRecord (string) --

            The DNS record for the subdomain.

Exceptions

update_webhook(**kwargs)

Updates a webhook.

See also: AWS API Documentation

Request Syntax

response = client.update_webhook(
    webhookId='string',
    branchName='string',
    description='string'
)
Parameters
  • webhookId (string) --

    [REQUIRED]

    The unique ID for a webhook.

  • branchName (string) -- The name for a branch that is part of an Amplify app.
  • description (string) -- The description for a webhook.
Return type

dict

Returns

Response Syntax

{
    'webhook': {
        'webhookArn': 'string',
        'webhookId': 'string',
        'webhookUrl': 'string',
        'branchName': 'string',
        'description': 'string',
        'createTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    The result structure for the update webhook request.

    • webhook (dict) --

      Describes a webhook that connects repository events to an Amplify app.

      • webhookArn (string) --

        The Amazon Resource Name (ARN) for the webhook.

      • webhookId (string) --

        The ID of the webhook.

      • webhookUrl (string) --

        The URL of the webhook.

      • branchName (string) --

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

      • description (string) --

        The description for a webhook.

      • createTime (datetime) --

        The create date and time for a webhook.

      • updateTime (datetime) --

        Updates the date and time for a webhook.

Exceptions

Client Exceptions

Client exceptions are available on a client instance via the exceptions property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.

The available client exceptions are:

class Amplify.Client.exceptions.BadRequestException

A request contains unexpected data.

Example

try:
  ...
except client.exceptions.BadRequestException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    A request contains unexpected data.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Amplify.Client.exceptions.DependentServiceFailureException

An operation failed because a dependent service threw an exception.

Example

try:
  ...
except client.exceptions.DependentServiceFailureException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    An operation failed because a dependent service threw an exception.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Amplify.Client.exceptions.InternalFailureException

The service failed to perform an operation due to an internal issue.

Example

try:
  ...
except client.exceptions.InternalFailureException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    The service failed to perform an operation due to an internal issue.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Amplify.Client.exceptions.LimitExceededException

A resource could not be created because service quotas were exceeded.

Example

try:
  ...
except client.exceptions.LimitExceededException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    A resource could not be created because service quotas were exceeded.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Amplify.Client.exceptions.NotFoundException

An entity was not found during an operation.

Example

try:
  ...
except client.exceptions.NotFoundException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    An entity was not found during an operation.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Amplify.Client.exceptions.ResourceNotFoundException

An operation failed due to a non-existent resource.

Example

try:
  ...
except client.exceptions.ResourceNotFoundException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'code': 'string',
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    An operation failed due to a non-existent resource.

    • code (string) --
    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Amplify.Client.exceptions.UnauthorizedException

An operation failed due to a lack of access.

Example

try:
  ...
except client.exceptions.UnauthorizedException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    An operation failed due to a lack of access.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.

Paginators

The available paginators are:

class Amplify.Paginator.ListApps
paginator = client.get_paginator('list_apps')
paginate(**kwargs)

Creates an iterator that will paginate through responses from Amplify.Client.list_apps().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
PaginationConfig (dict) --

A dictionary that provides parameters to control pagination.

  • MaxItems (integer) --

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) --

    The size of each page.

  • StartingToken (string) --

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type
dict
Returns
Response Syntax
{
    'apps': [
        {
            'appId': 'string',
            'appArn': 'string',
            'name': 'string',
            'tags': {
                'string': 'string'
            },
            'description': 'string',
            'repository': 'string',
            'platform': 'WEB',
            'createTime': datetime(2015, 1, 1),
            'updateTime': datetime(2015, 1, 1),
            'iamServiceRoleArn': 'string',
            'environmentVariables': {
                'string': 'string'
            },
            'defaultDomain': 'string',
            'enableBranchAutoBuild': True|False,
            'enableBranchAutoDeletion': True|False,
            'enableBasicAuth': True|False,
            'basicAuthCredentials': 'string',
            'customRules': [
                {
                    'source': 'string',
                    'target': 'string',
                    'status': 'string',
                    'condition': 'string'
                },
            ],
            'productionBranch': {
                'lastDeployTime': datetime(2015, 1, 1),
                'status': 'string',
                'thumbnailUrl': 'string',
                'branchName': 'string'
            },
            'buildSpec': 'string',
            'enableAutoBranchCreation': True|False,
            'autoBranchCreationPatterns': [
                'string',
            ],
            'autoBranchCreationConfig': {
                'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
                'framework': 'string',
                'enableAutoBuild': True|False,
                'environmentVariables': {
                    'string': 'string'
                },
                'basicAuthCredentials': 'string',
                'enableBasicAuth': True|False,
                'enablePerformanceMode': True|False,
                'buildSpec': 'string',
                'enablePullRequestPreview': True|False,
                'pullRequestEnvironmentName': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for an Amplify app list request.

    • apps (list) --

      A list of Amplify apps.

      • (dict) --

        Represents the different branches of a repository for building, deploying, and hosting an Amplify app.

        • appId (string) --

          The unique ID of the Amplify app.

        • appArn (string) --

          The Amazon Resource Name (ARN) of the Amplify app.

        • name (string) --

          The name for the Amplify app.

        • tags (dict) --

          The tag for the Amplify app.

          • (string) --
            • (string) --
        • description (string) --

          The description for the Amplify app.

        • repository (string) --

          The repository for the Amplify app.

        • platform (string) --

          The platform for the Amplify app.

        • createTime (datetime) --

          Creates a date and time for the Amplify app.

        • updateTime (datetime) --

          Updates the date and time for the Amplify app.

        • iamServiceRoleArn (string) --

          The AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) of the Amplify app.

        • environmentVariables (dict) --

          The environment variables for the Amplify app.

          • (string) --
            • (string) --
        • defaultDomain (string) --

          The default domain for the Amplify app.

        • enableBranchAutoBuild (boolean) --

          Enables the auto-building of branches for the Amplify app.

        • enableBranchAutoDeletion (boolean) --

          Automatically disconnect a branch in the Amplify Console when you delete a branch from your Git repository.

        • enableBasicAuth (boolean) --

          Enables basic authorization for the Amplify app's branches.

        • basicAuthCredentials (string) --

          The basic authorization credentials for branches for the Amplify app.

        • customRules (list) --

          Describes the custom redirect and rewrite rules for the Amplify app.

          • (dict) --

            Describes a custom rewrite or redirect rule.

            • source (string) --

              The source pattern for a URL rewrite or redirect rule.

            • target (string) --

              The target pattern for a URL rewrite or redirect rule.

            • status (string) --

              The status code for a URL rewrite or redirect rule.

              200

              Represents a 200 rewrite rule.

              301

              Represents a 301 (moved pemanently) redirect rule. This and all future requests should be directed to the target URL.

              302

              Represents a 302 temporary redirect rule.

              404

              Represents a 404 redirect rule.

              404-200

              Represents a 404 rewrite rule.

            • condition (string) --

              The condition for a URL rewrite or redirect rule, such as a country code.

        • productionBranch (dict) --

          Describes the information about a production branch of the Amplify app.

          • lastDeployTime (datetime) --

            The last deploy time of the production branch.

          • status (string) --

            The status of the production branch.

          • thumbnailUrl (string) --

            The thumbnail URL for the production branch.

          • branchName (string) --

            The branch name for the production branch.

        • buildSpec (string) --

          Describes the content of the build specification (build spec) for the Amplify app.

        • enableAutoBranchCreation (boolean) --

          Enables automated branch creation for the Amplify app.

        • autoBranchCreationPatterns (list) --

          Describes the automated branch creation glob patterns for the Amplify app.

          • (string) --
        • autoBranchCreationConfig (dict) --

          Describes the automated branch creation configuration for the Amplify app.

          • stage (string) --

            Describes the current stage for the autocreated branch.

          • framework (string) --

            The framework for the autocreated branch.

          • enableAutoBuild (boolean) --

            Enables auto building for the autocreated branch.

          • environmentVariables (dict) --

            The environment variables for the autocreated branch.

            • (string) --
              • (string) --
          • basicAuthCredentials (string) --

            The basic authorization credentials for the autocreated branch.

          • enableBasicAuth (boolean) --

            Enables basic authorization for the autocreated branch.

          • enablePerformanceMode (boolean) --

            Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

          • buildSpec (string) --

            The build specification (build spec) for the autocreated branch.

          • enablePullRequestPreview (boolean) --

            Enables pull request preview for the autocreated branch.

          • pullRequestEnvironmentName (string) --

            The Amplify environment name for the pull request.

    • NextToken (string) --

      A token to resume pagination.

class Amplify.Paginator.ListBranches
paginator = client.get_paginator('list_branches')
paginate(**kwargs)

Creates an iterator that will paginate through responses from Amplify.Client.list_branches().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    appId='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'branches': [
        {
            'branchArn': 'string',
            'branchName': 'string',
            'description': 'string',
            'tags': {
                'string': 'string'
            },
            'stage': 'PRODUCTION'|'BETA'|'DEVELOPMENT'|'EXPERIMENTAL'|'PULL_REQUEST',
            'displayName': 'string',
            'enableNotification': True|False,
            'createTime': datetime(2015, 1, 1),
            'updateTime': datetime(2015, 1, 1),
            'environmentVariables': {
                'string': 'string'
            },
            'enableAutoBuild': True|False,
            'customDomains': [
                'string',
            ],
            'framework': 'string',
            'activeJobId': 'string',
            'totalNumberOfJobs': 'string',
            'enableBasicAuth': True|False,
            'enablePerformanceMode': True|False,
            'thumbnailUrl': 'string',
            'basicAuthCredentials': 'string',
            'buildSpec': 'string',
            'ttl': 'string',
            'associatedResources': [
                'string',
            ],
            'enablePullRequestPreview': True|False,
            'pullRequestEnvironmentName': 'string',
            'destinationBranch': 'string',
            'sourceBranch': 'string',
            'backendEnvironmentArn': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for the list branches request.

    • branches (list) --

      A list of branches for an Amplify app.

      • (dict) --

        The branch for an Amplify app, which maps to a third-party repository branch.

        • branchArn (string) --

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

        • branchName (string) --

          The name for the branch that is part of an Amplify app.

        • description (string) --

          The description for the branch that is part of an Amplify app.

        • tags (dict) --

          The tag for the branch of an Amplify app.

          • (string) --
            • (string) --
        • stage (string) --

          The current stage for the branch that is part of an Amplify app.

        • displayName (string) --

          The display name for the branch. This is used as the default domain prefix.

        • enableNotification (boolean) --

          Enables notifications for a branch that is part of an Amplify app.

        • createTime (datetime) --

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

        • updateTime (datetime) --

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

        • environmentVariables (dict) --

          The environment variables specific to a branch of an Amplify app.

          • (string) --
            • (string) --
        • enableAutoBuild (boolean) --

          Enables auto-building on push for a branch of an Amplify app.

        • customDomains (list) --

          The custom domains for a branch of an Amplify app.

          • (string) --
        • framework (string) --

          The framework for a branch of an Amplify app.

        • activeJobId (string) --

          The ID of the active job for a branch of an Amplify app.

        • totalNumberOfJobs (string) --

          The total number of jobs that are part of an Amplify app.

        • enableBasicAuth (boolean) --

          Enables basic authorization for a branch of an Amplify app.

        • enablePerformanceMode (boolean) --

          Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. Enabling performance mode will mean that hosting configuration or code changes can take up to 10 minutes to roll out.

        • thumbnailUrl (string) --

          The thumbnail URL for the branch of an Amplify app.

        • basicAuthCredentials (string) --

          The basic authorization credentials for a branch of an Amplify app.

        • buildSpec (string) --

          The build specification (build spec) content for the branch of an Amplify app.

        • ttl (string) --

          The content Time to Live (TTL) for the website in seconds.

        • associatedResources (list) --

          A list of custom resources that are linked to this branch.

          • (string) --
        • enablePullRequestPreview (boolean) --

          Enables pull request preview for the branch.

        • pullRequestEnvironmentName (string) --

          The Amplify environment name for the pull request.

        • destinationBranch (string) --

          The destination branch if the branch is a pull request branch.

        • sourceBranch (string) --

          The source branch if the branch is a pull request branch.

        • backendEnvironmentArn (string) --

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

    • NextToken (string) --

      A token to resume pagination.

class Amplify.Paginator.ListDomainAssociations
paginator = client.get_paginator('list_domain_associations')
paginate(**kwargs)

Creates an iterator that will paginate through responses from Amplify.Client.list_domain_associations().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    appId='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'domainAssociations': [
        {
            'domainAssociationArn': 'string',
            'domainName': 'string',
            'enableAutoSubDomain': True|False,
            'autoSubDomainCreationPatterns': [
                'string',
            ],
            'autoSubDomainIAMRole': 'string',
            'domainStatus': 'PENDING_VERIFICATION'|'IN_PROGRESS'|'AVAILABLE'|'PENDING_DEPLOYMENT'|'FAILED'|'CREATING'|'REQUESTING_CERTIFICATE'|'UPDATING',
            'statusReason': 'string',
            'certificateVerificationDNSRecord': 'string',
            'subDomains': [
                {
                    'subDomainSetting': {
                        'prefix': 'string',
                        'branchName': 'string'
                    },
                    'verified': True|False,
                    'dnsRecord': 'string'
                },
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The result structure for the list domain association request.

    • domainAssociations (list) --

      A list of domain associations.

      • (dict) --

        Describes a domain association that associates a custom domain with an Amplify app.

        • domainAssociationArn (string) --

          The Amazon Resource Name (ARN) for the domain association.

        • domainName (string) --

          The name of the domain.

        • enableAutoSubDomain (boolean) --

          Enables the automated creation of subdomains for branches.

        • autoSubDomainCreationPatterns (list) --

          Sets branch patterns for automatic subdomain creation.

          • (string) --
        • autoSubDomainIAMRole (string) --

          The required AWS Identity and Access Management (IAM) service role for the Amazon Resource Name (ARN) for automatically creating subdomains.

        • domainStatus (string) --

          The current status of the domain association.

        • statusReason (string) --

          The reason for the current status of the domain association.

        • certificateVerificationDNSRecord (string) --

          The DNS record for certificate verification.

        • subDomains (list) --

          The subdomains for the domain association.

          • (dict) --

            The subdomain for the domain association.

            • subDomainSetting (dict) --

              Describes the settings for the subdomain.

              • prefix (string) --

                The prefix setting for the subdomain.

              • branchName (string) --

                The branch name setting for the subdomain.

            • verified (boolean) --

              The verified status of the subdomain

            • dnsRecord (string) --

              The DNS record for the subdomain.

    • NextToken (string) --

      A token to resume pagination.

class Amplify.Paginator.ListJobs
paginator = client.get_paginator('list_jobs')
paginate(**kwargs)

Creates an iterator that will paginate through responses from Amplify.Client.list_jobs().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    appId='string',
    branchName='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • appId (string) --

    [REQUIRED]

    The unique ID for an Amplify app.

  • branchName (string) --

    [REQUIRED]

    The name for a branch.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'jobSummaries': [
        {
            'jobArn': 'string',
            'jobId': 'string',
            'commitId': 'string',
            'commitMessage': 'string',
            'commitTime': datetime(2015, 1, 1),
            'startTime': datetime(2015, 1, 1),
            'status': 'PENDING'|'PROVISIONING'|'RUNNING'|'FAILED'|'SUCCEED'|'CANCELLING'|'CANCELLED',
            'endTime': datetime(2015, 1, 1),
            'jobType': 'RELEASE'|'RETRY'|'MANUAL'|'WEB_HOOK'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The maximum number of records to list in a single response.

    • jobSummaries (list) --

      The result structure for the list job result request.

      • (dict) --

        Describes the summary for an execution job for an Amplify app.

        • jobArn (string) --

          The Amazon Resource Name (ARN) for the job.

        • jobId (string) --

          The unique ID for the job.

        • commitId (string) --

          The commit ID from a third-party repository provider for the job.

        • commitMessage (string) --

          The commit message from a third-party repository provider for the job.

        • commitTime (datetime) --

          The commit date and time for the job.

        • startTime (datetime) --

          The start date and time for the job.

        • status (string) --

          The current status for the job.

        • endTime (datetime) --

          The end date and time for the job.

        • jobType (string) --

          The type for the job. If the value is RELEASE , the job was manually released from its source by using the StartJob API. If the value is RETRY , the job was manually retried using the StartJob API. If the value is WEB_HOOK , the job was automatically triggered by webhooks.

    • NextToken (string) --

      A token to resume pagination.