Branch - AWS Amplify

Branch

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

Contents

activeJobId

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

Type: String

Length Constraints: Maximum length of 1000.

Required: Yes

associatedResources

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

Type: Array of strings

Length Constraints: Minimum length of 1. Maximum length of 2048.

Required: No

backendEnvironmentArn

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

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1000.

Required: No

basicAuthCredentials

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

Type: String

Length Constraints: Maximum length of 2000.

Required: No

branchArn

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

Type: String

Length Constraints: Maximum length of 1000.

Required: Yes

branchName

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

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: Yes

buildSpec

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

Type: String

Length Constraints: Minimum length of 1. Maximum length of 25000.

Required: No

createTime

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

Type: Timestamp

Required: Yes

customDomains

The custom domains for a branch of an Amplify app.

Type: Array of strings

Array Members: Maximum number of 255 items.

Length Constraints: Maximum length of 255.

Required: Yes

description

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

Type: String

Length Constraints: Maximum length of 1000.

Required: Yes

destinationBranch

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

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: No

displayName

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

Type: String

Length Constraints: Maximum length of 255.

Required: Yes

enableAutoBuild

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

Type: Boolean

Required: Yes

enableBasicAuth

Enables basic authorization for a branch of an Amplify app.

Type: Boolean

Required: Yes

enableNotification

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

Type: Boolean

Required: Yes

enablePerformanceMode

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.

Type: Boolean

Required: No

enablePullRequestPreview

Enables pull request previews for the branch.

Type: Boolean

Required: Yes

environmentVariables

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

Type: String to string map

Key Length Constraints: Maximum length of 255.

Value Length Constraints: Maximum length of 1000.

Required: Yes

framework

The framework for a branch of an Amplify app.

Type: String

Length Constraints: Maximum length of 255.

Required: Yes

pullRequestEnvironmentName

The Amplify environment name for the pull request.

Type: String

Length Constraints: Maximum length of 20.

Required: No

sourceBranch

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

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: No

stage

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

Type: String

Valid Values: PRODUCTION | BETA | DEVELOPMENT | EXPERIMENTAL | PULL_REQUEST

Required: Yes

tags

The tag for the branch of an Amplify app.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^(?!aws:)[a-zA-Z+-=._:/]+$

Value Length Constraints: Maximum length of 256.

Required: No

thumbnailUrl

The thumbnail URL for the branch of an Amplify app.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2000.

Required: No

totalNumberOfJobs

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

Type: String

Length Constraints: Maximum length of 1000.

Required: Yes

ttl

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

Type: String

Required: Yes

updateTime

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

Type: Timestamp

Required: Yes

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: