Package software.amazon.awscdk.services.amplify

Interface CfnBranchProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnBranchProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)",
           date="2025-10-24T13:34:30.073Z")
@Stability(Stable)
public interface CfnBranchProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnBranch.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.amplify.*;
 CfnBranchProps cfnBranchProps = CfnBranchProps.builder()
         .appId("appId")
         .branchName("branchName")
         // the properties below are optional
         .backend(BackendProperty.builder()
                 .stackArn("stackArn")
                 .build())
         .basicAuthConfig(BasicAuthConfigProperty.builder()
                 .password("password")
                 .username("username")
                 // the properties below are optional
                 .enableBasicAuth(false)
                 .build())
         .buildSpec("buildSpec")
         .computeRoleArn("computeRoleArn")
         .description("description")
         .enableAutoBuild(false)
         .enablePerformanceMode(false)
         .enablePullRequestPreview(false)
         .enableSkewProtection(false)
         .environmentVariables(List.of(EnvironmentVariableProperty.builder()
                 .name("name")
                 .value("value")
                 .build()))
         .framework("framework")
         .pullRequestEnvironmentName("pullRequestEnvironmentName")
         .stage("stage")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnBranchProps.Builder	A builder for CfnBranchProps
static final class	CfnBranchProps.Jsii$Proxy	An implementation for CfnBranchProps

Method Summary

Modifier and Type	Method	Description
static CfnBranchProps.Builder	builder()
String	getAppId()	The unique ID for an Amplify app.
default Object	getBackend()	The backend for a Branch of an Amplify app.
default Object	getBasicAuthConfig()	The basic authorization credentials for a branch of an Amplify app.
String	getBranchName()	The name for the branch.
default String	getBuildSpec()	The build specification (build spec) for the branch.
default String	getComputeRoleArn()	The Amazon Resource Name (ARN) of the IAM role to assign to a branch of an SSR app.
default String	getDescription()	The description for the branch that is part of an Amplify app.
default Object	getEnableAutoBuild()	Enables auto building for the branch.
default Object	getEnablePerformanceMode()	Enables performance mode for the branch.
default Object	getEnablePullRequestPreview()	Specifies whether Amplify Hosting creates a preview for each pull request that is made for this branch.
default Object	getEnableSkewProtection()	Specifies whether the skew protection feature is enabled for the branch.
default Object	getEnvironmentVariables()	The environment variables for the branch.
default String	getFramework()	The framework for the branch.
default String	getPullRequestEnvironmentName()	If pull request previews are enabled for this branch, you can use this property to specify a dedicated backend environment for your previews.
default String	getStage()	Describes the current stage for the branch.
default List<CfnTag>	getTags()	The tag for the branch.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getAppId

@Stability(Stable)
@NotNull
String getAppId()

The unique ID for an Amplify app.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-appid

getBranchName

@Stability(Stable)
@NotNull
String getBranchName()

The name for the branch.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-branchname

getBackend

@Stability(Stable)
@Nullable
default Object getBackend()

The backend for a Branch of an Amplify app. Use for a backend created from an AWS CloudFormation stack.

This field 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.

Returns union: either IResolvable or CfnBranch.BackendProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-backend

getBasicAuthConfig

@Stability(Stable)
@Nullable
default Object getBasicAuthConfig()

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 .

Returns union: either IResolvable or CfnBranch.BasicAuthConfigProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-basicauthconfig

getBuildSpec

@Stability(Stable)
@Nullable
default String getBuildSpec()

The build specification (build spec) for the branch.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-buildspec

getComputeRoleArn

@Stability(Stable)
@Nullable
default String getComputeRoleArn()

The Amazon Resource Name (ARN) of the IAM role to assign to a branch of an SSR app.

The SSR Compute role allows the Amplify Hosting compute service to securely access specific AWS resources based on the role's permissions. For more information about the SSR Compute role, see Adding an SSR Compute role in the Amplify User Guide .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-computerolearn

getDescription

@Stability(Stable)
@Nullable
default String getDescription()

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

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-description

getEnableAutoBuild

@Stability(Stable)
@Nullable
default Object getEnableAutoBuild()

Enables auto building for the branch.

Returns union: either Boolean or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-enableautobuild

getEnablePerformanceMode

@Stability(Stable)
@Nullable
default Object getEnablePerformanceMode()

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.

Returns union: either Boolean or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-enableperformancemode

getEnablePullRequestPreview

@Stability(Stable)
@Nullable
default Object getEnablePullRequestPreview()

Specifies whether Amplify Hosting creates a preview for each pull request that is made for this branch.

If this property is enabled, Amplify deploys your app to a unique preview URL after each pull request is opened. Development and QA teams can use this preview to test the pull request before it's merged into a production or integration branch.

To provide backend support for your preview, Amplify automatically provisions a temporary backend environment that it deletes when the pull request is closed. If you want to specify a dedicated backend environment for your previews, use the PullRequestEnvironmentName property.

For more information, see Web Previews in the AWS Amplify Hosting User Guide .

Returns union: either Boolean or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-enablepullrequestpreview

getEnableSkewProtection

@Stability(Stable)
@Nullable
default Object getEnableSkewProtection()

Specifies whether the skew protection feature is enabled for the branch.

Deployment skew protection is available to Amplify applications to eliminate version skew issues between client and servers in web applications. When you apply skew protection to a branch, you can ensure that your clients always interact with the correct version of server-side assets, regardless of when a deployment occurs. For more information about skew protection, see Skew protection for Amplify deployments in the Amplify User Guide .

Returns union: either Boolean or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-enableskewprotection

getEnvironmentVariables

@Stability(Stable)
@Nullable
default Object getEnvironmentVariables()

The environment variables for the branch.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnBranch.EnvironmentVariableProperty>

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-environmentvariables

getFramework

@Stability(Stable)
@Nullable
default String getFramework()

The framework for the branch.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-framework

getPullRequestEnvironmentName

@Stability(Stable)
@Nullable
default String getPullRequestEnvironmentName()

If pull request previews are enabled for this branch, you can use this property to specify a dedicated backend environment for your previews.

For example, you could specify an environment named prod , test , or dev that you initialized with the Amplify CLI and mapped to this branch.

To enable pull request previews, set the EnablePullRequestPreview property to true .

If you don't specify an environment, Amplify Hosting provides backend support for each preview by automatically provisioning a temporary backend environment. Amplify Hosting deletes this environment when the pull request is closed.

For more information about creating backend environments, see Feature Branch Deployments and Team Workflows in the AWS Amplify Hosting User Guide .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-pullrequestenvironmentname

getStage

@Stability(Stable)
@Nullable
default String getStage()

Describes the current stage for the branch.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-stage

getTags

@Stability(Stable)
@Nullable
default List<CfnTag> getTags()

The tag for the branch.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-branch.html#cfn-amplify-branch-tags

builder

@Stability(Stable)
static CfnBranchProps.Builder builder()

Returns:

a CfnBranchProps.Builder of CfnBranchProps