software.amazon.awscdk.cxapi

Class AssetManifestArtifact

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.cxapi.CloudArtifact

software.amazon.awscdk.cxapi.AssetManifestArtifact

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.78.1 (build 878761e)",
           date="2023-04-05T23:24:22.256Z")
 @Stability(value=Stable)
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();
 

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
	AssetManifestArtifact(CloudAssembly assembly, 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
String	getBootstrapStackVersionSsmParameter() Name of SSM parameter with bootstrap stack version.
AssetManifest	getContents() The Asset Manifest contents.
String	getFile() The file name of the asset manifest.
Number	getRequiresBootstrapStackVersion() Version of bootstrap stack required to deploy this stack.
static Boolean	isAssetManifestArtifact(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 software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

AssetManifestArtifact

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

AssetManifestArtifact

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

AssetManifestArtifact

@Stability(value=Stable)
public AssetManifestArtifact(@NotNull
                                                      CloudAssembly assembly,
                                                      @NotNull
                                                      String name,
                                                      @NotNull
                                                      ArtifactManifest artifact)

Parameters:

assembly - This parameter is required.

name - This parameter is required.

artifact - This parameter is required.

Method Detail

isAssetManifestArtifact

@Stability(value=Stable)
 @NotNull
public static Boolean isAssetManifestArtifact(@NotNull
                                                                                 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.

getContents

@Stability(value=Stable)
 @NotNull
public AssetManifest getContents()

The Asset Manifest contents.

getFile

@Stability(value=Stable)
 @NotNull
public String getFile()

The file name of the asset manifest.

getBootstrapStackVersionSsmParameter

@Stability(value=Stable)
 @Nullable
public String getBootstrapStackVersionSsmParameter()

Name of SSM parameter with bootstrap stack version.

Default: - Discover SSM parameter by reading stack

getRequiresBootstrapStackVersion

@Stability(value=Stable)
 @Nullable
public Number getRequiresBootstrapStackVersion()

Version of bootstrap stack required to deploy this stack.