software.amazon.awscdk.cxapi

Class CloudArtifact

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.cxapi.CloudArtifact

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

Direct Known Subclasses:

AssetManifestArtifact, CloudFormationStackArtifact, NestedCloudAssemblyArtifact, TreeCloudArtifact

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:42.896Z")
 @Stability(value=Stable)
public class CloudArtifact
extends software.amazon.jsii.JsiiObject

Represents an artifact within a cloud assembly.

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;
 CloudArtifact cloudArtifact = CloudArtifact.fromManifest(cloudAssembly, "MyCloudArtifact", ArtifactManifest.builder()
         .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
protected	CloudArtifact(CloudAssembly assembly, String id, ArtifactManifest manifest)
protected	CloudArtifact(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CloudArtifact(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
List<MetadataEntryResult>	findMetadataByType(String type)
static CloudArtifact	fromManifest(CloudAssembly assembly, String id, ArtifactManifest artifact) Returns a subclass of `CloudArtifact` based on the artifact type defined in the artifact manifest.
CloudAssembly	getAssembly()
List<CloudArtifact>	getDependencies() Returns all the artifacts that this artifact depends on.
String	getHierarchicalId() An identifier that shows where this artifact is located in the tree of nested assemblies, based on their manifests.
String	getId()
ArtifactManifest	getManifest() The artifact's manifest.
List<SynthesisMessage>	getMessages() The set of messages extracted from the artifact's metadata.

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

CloudArtifact

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

CloudArtifact

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

CloudArtifact

@Stability(value=Stable)
protected CloudArtifact(@NotNull
                                                 CloudAssembly assembly,
                                                 @NotNull
                                                 String id,
                                                 @NotNull
                                                 ArtifactManifest manifest)

Parameters:

assembly - This parameter is required.

id - This parameter is required.

manifest - This parameter is required.

Method Detail

fromManifest

@Stability(value=Stable)
 @Nullable
public static CloudArtifact fromManifest(@NotNull
                                                                             CloudAssembly assembly,
                                                                             @NotNull
                                                                             String id,
                                                                             @NotNull
                                                                             ArtifactManifest artifact)

Returns a subclass of `CloudArtifact` based on the artifact type defined in the artifact manifest.

Parameters:

assembly - The cloud assembly from which to load the artifact. This parameter is required.

id - The artifact ID. This parameter is required.

artifact - The artifact manifest. This parameter is required.

Returns:

the `CloudArtifact` that matches the artifact type or `undefined` if it's an artifact type that is unrecognized by this module.

findMetadataByType

@Stability(value=Stable)
 @NotNull
public List<MetadataEntryResult> findMetadataByType(@NotNull
                                                                                       String type)

Parameters:

type - This parameter is required.

Returns:

all the metadata entries of a specific type in this artifact.

getAssembly

@Stability(value=Stable)
 @NotNull
public CloudAssembly getAssembly()

getDependencies

@Stability(value=Stable)
 @NotNull
public List<CloudArtifact> getDependencies()

Returns all the artifacts that this artifact depends on.

getHierarchicalId

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

An identifier that shows where this artifact is located in the tree of nested assemblies, based on their manifests.

Defaults to the normal id. Should only be used in user interfaces.

getId

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

getManifest

@Stability(value=Stable)
 @NotNull
public ArtifactManifest getManifest()

The artifact's manifest.

getMessages

@Stability(value=Stable)
 @NotNull
public List<SynthesisMessage> getMessages()

The set of messages extracted from the artifact's metadata.