software.amazon.awscdk.cxapi

Class AssetManifestArtifact

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.cxapi.CloudArtifact

software.amazon.awscdk.cxapi.AssetManifestArtifact

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-21T22:30:56.771Z")
public class AssetManifestArtifact
extends CloudArtifact

Asset manifest is a description of a set of assets which need to be built and published.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.cloudassembly.schema.*;
 import software.amazon.awscdk.cxapi.*;
 CloudAssembly cloudAssembly;
 AssetManifestArtifact assetManifestArtifact = AssetManifestArtifact.Builder.create(cloudAssembly, "name")
         .type(ArtifactType.NONE)
         // the properties below are optional
         .dependencies(List.of("dependencies"))
         .displayName("displayName")
         .environment("environment")
         .metadata(Map.of(
                 "metadataKey", List.of(MetadataEntry.builder()
                         .type("type")
                         // the properties below are optional
                         .data("data")
                         .trace(List.of("trace"))
                         .build())))
         .properties(AwsCloudFormationStackProperties.builder()
                 .templateFile("templateFile")
                 // the properties below are optional
                 .assumeRoleArn("assumeRoleArn")
                 .assumeRoleExternalId("assumeRoleExternalId")
                 .bootstrapStackVersionSsmParameter("bootstrapStackVersionSsmParameter")
                 .cloudFormationExecutionRoleArn("cloudFormationExecutionRoleArn")
                 .lookupRole(BootstrapRole.builder()
                         .arn("arn")
                         // the properties below are optional
                         .assumeRoleExternalId("assumeRoleExternalId")
                         .bootstrapStackVersionSsmParameter("bootstrapStackVersionSsmParameter")
                         .requiresBootstrapStackVersion(123)
                         .build())
                 .parameters(Map.of(
                         "parametersKey", "parameters"))
                 .requiresBootstrapStackVersion(123)
                 .stackName("stackName")
                 .stackTemplateAssetObjectUrl("stackTemplateAssetObjectUrl")
                 .tags(Map.of(
                         "tagsKey", "tags"))
                 .terminationProtection(false)
                 .validateOnSynth(false)
                 .build())
         .build();
 

Constructor Summary

Constructors

Modifier	Constructor and Description
	AssetManifestArtifact(CloudAssembly assembly, java.lang.String name, ArtifactManifest artifact)
protected	AssetManifestArtifact(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	AssetManifestArtifact(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getBootstrapStackVersionSsmParameter() Name of SSM parameter with bootstrap stack version.
java.lang.String	getFile() The file name of the asset manifest.
java.lang.Number	getRequiresBootstrapStackVersion() Version of bootstrap stack required to deploy this stack.
static java.lang.Boolean	isAssetManifestArtifact(java.lang.Object art) Checks if `art` is an instance of this class.

Methods inherited from class software.amazon.awscdk.cxapi.CloudArtifact

findMetadataByType, fromManifest, getAssembly, getDependencies, getHierarchicalId, getId, getManifest, getMessages

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AssetManifestArtifact

protected AssetManifestArtifact(software.amazon.jsii.JsiiObjectRef objRef)

AssetManifestArtifact

protected AssetManifestArtifact(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

AssetManifestArtifact

public AssetManifestArtifact(CloudAssembly assembly,
                             java.lang.String name,
                             ArtifactManifest artifact)

Parameters:

assembly - This parameter is required.

name - This parameter is required.

artifact - This parameter is required.

Method Detail

isAssetManifestArtifact

public static java.lang.Boolean isAssetManifestArtifact(java.lang.Object art)

Checks if `art` is an instance of this class.

Use this method instead of instanceof to properly detect AssetManifestArtifact instances, even when the construct library is symlinked.

Explanation: in JavaScript, multiple copies of the cx-api library on disk are seen as independent, completely different libraries. As a consequence, the class AssetManifestArtifact in each copy of the cx-api library is seen as a different class, and an instance of one class will not test as instanceof the other class. npm install will not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the cx-api library can be accidentally installed, and instanceof will behave unpredictably. It is safest to avoid using instanceof, and using this type-testing method instead.

Parameters:

art - This parameter is required.

getFile

public java.lang.String getFile()

The file name of the asset manifest.

getRequiresBootstrapStackVersion

public java.lang.Number getRequiresBootstrapStackVersion()

Version of bootstrap stack required to deploy this stack.

getBootstrapStackVersionSsmParameter

public java.lang.String getBootstrapStackVersionSsmParameter()

Name of SSM parameter with bootstrap stack version.

Default: - Discover SSM parameter by reading stack