Amplify / Paginator / ListBranches

ListBranches#

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',
            'backend': {
                'stackArn': '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) –

          Enables performance mode for the branch.

          Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. When performance mode is enabled, 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. You must base64-encode the authorization credentials and provide them in the format user:password.

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

          This property is available to Amplify Gen 1 apps only. When you deploy an application with Amplify Gen 2, you provision the app’s backend infrastructure using Typescript code.

        • backend (dict) –

          Describes the backend associated with an Amplify Branch.

          This property is available to Amplify Gen 2 apps only. When you deploy an application with Amplify Gen 2, you provision the app’s backend infrastructure using Typescript code.

          • stackArn (string) –

            The Amazon Resource Name (ARN) for the CloudFormation stack.

    • NextToken (string) –

      A token to resume pagination.