Package software.amazon.awscdk

Interface SynthesizeStackArtifactOptions

All Superinterfaces:
software.amazon.jsii.JsiiSerializable
All Known Implementing Classes:
SynthesizeStackArtifactOptions.Jsii$Proxy
@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)", date="2025-11-13T16:09:57.457Z") @Stability(Stable) public interface SynthesizeStackArtifactOptions extends software.amazon.jsii.JsiiSerializable
Stack artifact options.

A subset of cxschema.AwsCloudFormationStackProperties of optional settings that need to be configurable by synthesizers, plus additionalDependencies.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.*;
 Object assumeRoleAdditionalOptions;
 SynthesizeStackArtifactOptions synthesizeStackArtifactOptions = SynthesizeStackArtifactOptions.builder()
         .additionalDependencies(List.of("additionalDependencies"))
         .assumeRoleAdditionalOptions(Map.of(
                 "assumeRoleAdditionalOptionsKey", assumeRoleAdditionalOptions))
         .assumeRoleArn("assumeRoleArn")
         .assumeRoleExternalId("assumeRoleExternalId")
         .bootstrapStackVersionSsmParameter("bootstrapStackVersionSsmParameter")
         .cloudFormationExecutionRoleArn("cloudFormationExecutionRoleArn")
         .lookupRole(BootstrapRole.builder()
                 .arn("arn")
                 // the properties below are optional
                 .assumeRoleAdditionalOptions(Map.of(
                         "assumeRoleAdditionalOptionsKey", assumeRoleAdditionalOptions))
                 .assumeRoleExternalId("assumeRoleExternalId")
                 .bootstrapStackVersionSsmParameter("bootstrapStackVersionSsmParameter")
                 .requiresBootstrapStackVersion(123)
                 .build())
         .parameters(Map.of(
                 "parametersKey", "parameters"))
         .requiresBootstrapStackVersion(123)
         .stackTemplateAssetObjectUrl("stackTemplateAssetObjectUrl")
         .build();

  • Method Details

    • getAdditionalDependencies

      @Stability(Stable) @Nullable default List<String> getAdditionalDependencies()
      Identifiers of additional dependencies.

      Default: - No additional dependencies

    • getAssumeRoleAdditionalOptions

      @Stability(Stable) @Nullable default Map<String,Object> getAssumeRoleAdditionalOptions()
      Additional options to pass to STS when assuming the role for cloudformation deployments.

      • RoleArn should not be used. Use the dedicated assumeRoleArn property instead.
      • ExternalId should not be used. Use the dedicated assumeRoleExternalId instead.
      • TransitiveTagKeys defaults to use all keys (if any) specified in Tags. E.g, all tags are transitive by default.

      Default: - No additional options.

      See Also:

    • getAssumeRoleArn

      @Stability(Stable) @Nullable default String getAssumeRoleArn()
      The role that needs to be assumed to deploy the stack.

      Default: - No role is assumed (current credentials are used)

    • getAssumeRoleExternalId

      @Stability(Stable) @Nullable default String getAssumeRoleExternalId()
      The externalID to use with the assumeRoleArn.

      Default: - No externalID is used

    • getBootstrapStackVersionSsmParameter

      @Stability(Stable) @Nullable default String getBootstrapStackVersionSsmParameter()
      SSM parameter where the bootstrap stack version number can be found.

      Only used if requiresBootstrapStackVersion is set.

      • If this value is not set, the bootstrap stack name must be known at deployment time so the stack version can be looked up from the stack outputs.
      • If this value is set, the bootstrap stack can have any name because we won't need to look it up.

      Default: - Bootstrap stack version number looked up

    • getCloudFormationExecutionRoleArn

      @Stability(Stable) @Nullable default String getCloudFormationExecutionRoleArn()
      The role that is passed to CloudFormation to execute the change set.

      Default: - No role is passed (currently assumed role/credentials are used)

    • getLookupRole

      @Stability(Stable) @Nullable default BootstrapRole getLookupRole()
      The role to use to look up values from the target AWS account.

      Default: - None

    • getParameters

      @Stability(Stable) @Nullable default Map<String,String> getParameters()
      Values for CloudFormation stack parameters that should be passed when the stack is deployed.

      Default: - No parameters

    • getRequiresBootstrapStackVersion

      @Stability(Stable) @Nullable default Number getRequiresBootstrapStackVersion()
      Version of bootstrap stack required to deploy this stack.

      Default: - No bootstrap stack required

    • getStackTemplateAssetObjectUrl

      @Stability(Stable) @Nullable default String getStackTemplateAssetObjectUrl()
      If the stack template has already been included in the asset manifest, its asset URL.

      Default: - Not uploaded yet, upload just before deploying

    • builder

      @Stability(Stable) static SynthesizeStackArtifactOptions.Builder builder()
      Returns:
      a SynthesizeStackArtifactOptions.Builder of SynthesizeStackArtifactOptions