software.amazon.awscdk.services.fis

Class CfnExperimentTemplate

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.CfnElement

software.amazon.awscdk.core.CfnRefElement

software.amazon.awscdk.core.CfnResource

software.amazon.awscdk.services.fis.CfnExperimentTemplate

All Implemented Interfaces:

IConstruct, IDependable, IInspectable

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:36.171Z")
public class CfnExperimentTemplate
extends CfnResource
implements IInspectable

A CloudFormation `AWS::FIS::ExperimentTemplate`.

Specifies an experiment template.

An experiment template includes the following components:

• Targets : A target can be a specific resource in your AWS environment, or one or more resources that match criteria that you specify, for example, resources that have specific tags.
• Actions : The actions to carry out on the target. You can specify multiple actions, the duration of each action, and when to start each action during an experiment.
• Stop conditions : If a stop condition is triggered while an experiment is running, the experiment is automatically stopped. You can define a stop condition as a CloudWatch alarm.

For more information, see Experiment templates in the AWS Fault Injection Simulator User Guide .

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.fis.*;
 Object cloudWatchLogsConfiguration;
 Object s3Configuration;
 CfnExperimentTemplate cfnExperimentTemplate = CfnExperimentTemplate.Builder.create(this, "MyCfnExperimentTemplate")
         .description("description")
         .roleArn("roleArn")
         .stopConditions(List.of(ExperimentTemplateStopConditionProperty.builder()
                 .source("source")
                 // the properties below are optional
                 .value("value")
                 .build()))
         .tags(Map.of(
                 "tagsKey", "tags"))
         .targets(Map.of(
                 "targetsKey", ExperimentTemplateTargetProperty.builder()
                         .resourceType("resourceType")
                         .selectionMode("selectionMode")
                         // the properties below are optional
                         .filters(List.of(ExperimentTemplateTargetFilterProperty.builder()
                                 .path("path")
                                 .values(List.of("values"))
                                 .build()))
                         .parameters(Map.of(
                                 "parametersKey", "parameters"))
                         .resourceArns(List.of("resourceArns"))
                         .resourceTags(Map.of(
                                 "resourceTagsKey", "resourceTags"))
                         .build()))
         // the properties below are optional
         .actions(Map.of(
                 "actionsKey", ExperimentTemplateActionProperty.builder()
                         .actionId("actionId")
                         // the properties below are optional
                         .description("description")
                         .parameters(Map.of(
                                 "parametersKey", "parameters"))
                         .startAfter(List.of("startAfter"))
                         .targets(Map.of(
                                 "targetsKey", "targets"))
                         .build()))
         .logConfiguration(ExperimentTemplateLogConfigurationProperty.builder()
                 .logSchemaVersion(123)
                 // the properties below are optional
                 .cloudWatchLogsConfiguration(cloudWatchLogsConfiguration)
                 .s3Configuration(s3Configuration)
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CfnExperimentTemplate.Builder A fluent builder for CfnExperimentTemplate.
static interface	CfnExperimentTemplate.CloudWatchLogsConfigurationProperty Example:
static interface	CfnExperimentTemplate.ExperimentTemplateActionProperty Specifies an action for an experiment template.
static interface	CfnExperimentTemplate.ExperimentTemplateLogConfigurationProperty Specifies the configuration for experiment logging.
static interface	CfnExperimentTemplate.ExperimentTemplateStopConditionProperty Specifies a stop condition for an experiment template.
static interface	CfnExperimentTemplate.ExperimentTemplateTargetFilterProperty Specifies a filter used for the target resource input in an experiment template.
static interface	CfnExperimentTemplate.ExperimentTemplateTargetProperty Specifies a target for an experiment.
static interface	CfnExperimentTemplate.S3ConfigurationProperty Example:

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IConstruct

IConstruct.Jsii$Default

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CFN_RESOURCE_TYPE_NAME The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors

Modifier	Constructor and Description
	CfnExperimentTemplate(Construct scope, java.lang.String id, CfnExperimentTemplateProps props) Create a new `AWS::FIS::ExperimentTemplate`.
protected	CfnExperimentTemplate(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnExperimentTemplate(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getActions() The actions for the experiment.
java.lang.String	getAttrId() The ID of the experiment template.
protected java.util.Map<java.lang.String,java.lang.Object>	getCfnProperties()
java.lang.String	getDescription() A description for the experiment template.
java.lang.Object	getLogConfiguration() The configuration for experiment logging.
java.lang.String	getRoleArn() The Amazon Resource Name (ARN) of an IAM role that grants the AWS FIS service permission to perform service actions on your behalf.
java.lang.Object	getStopConditions() The stop conditions.
TagManager	getTags() The tags to apply to the experiment template.
java.lang.Object	getTargets() The targets for the experiment.
void	inspect(TreeInspector inspector) Examines the CloudFormation resource and discloses attributes.
protected java.util.Map<java.lang.String,java.lang.Object>	renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)
void	setActions(IResolvable value) The actions for the experiment.
void	setActions(java.util.Map<java.lang.String,java.lang.Object> value) The actions for the experiment.
void	setDescription(java.lang.String value) A description for the experiment template.
void	setLogConfiguration(CfnExperimentTemplate.ExperimentTemplateLogConfigurationProperty value) The configuration for experiment logging.
void	setLogConfiguration(IResolvable value) The configuration for experiment logging.
void	setRoleArn(java.lang.String value) The Amazon Resource Name (ARN) of an IAM role that grants the AWS FIS service permission to perform service actions on your behalf.
void	setStopConditions(IResolvable value) The stop conditions.
void	setStopConditions(java.util.List<java.lang.Object> value) The stop conditions.
void	setTargets(IResolvable value) The targets for the experiment.
void	setTargets(java.util.Map<java.lang.String,java.lang.Object> value) The targets for the experiment.

Methods inherited from class software.amazon.awscdk.core.CfnResource

addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, isCfnResource, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.core.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.core.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

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

Field Detail

CFN_RESOURCE_TYPE_NAME

public static final java.lang.String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Detail

CfnExperimentTemplate

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

CfnExperimentTemplate

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

CfnExperimentTemplate

public CfnExperimentTemplate(Construct scope,
                             java.lang.String id,
                             CfnExperimentTemplateProps props)

Create a new `AWS::FIS::ExperimentTemplate`.

Parameters:

scope - - scope in which this resource is defined. This parameter is required.

id - - scoped id of the resource. This parameter is required.

props - - resource properties. This parameter is required.

Method Detail

inspect

public void inspect(TreeInspector inspector)

Examines the CloudFormation resource and discloses attributes.

Specified by:

inspect in interface IInspectable

Parameters:

inspector - - tree inspector to collect and process attributes. This parameter is required.

renderProperties

protected java.util.Map<java.lang.String,java.lang.Object> renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getAttrId

public java.lang.String getAttrId()

The ID of the experiment template.

getCfnProperties

protected java.util.Map<java.lang.String,java.lang.Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getTags

public TagManager getTags()

The tags to apply to the experiment template.

getDescription

public java.lang.String getDescription()

A description for the experiment template.

setDescription

public void setDescription(java.lang.String value)

A description for the experiment template.

getRoleArn

public java.lang.String getRoleArn()

The Amazon Resource Name (ARN) of an IAM role that grants the AWS FIS service permission to perform service actions on your behalf.

setRoleArn

public void setRoleArn(java.lang.String value)

The Amazon Resource Name (ARN) of an IAM role that grants the AWS FIS service permission to perform service actions on your behalf.

getStopConditions

public java.lang.Object getStopConditions()

The stop conditions.

setStopConditions

public void setStopConditions(IResolvable value)

The stop conditions.

setStopConditions

public void setStopConditions(java.util.List<java.lang.Object> value)

The stop conditions.

getTargets

public java.lang.Object getTargets()

The targets for the experiment.

setTargets

public void setTargets(IResolvable value)

The targets for the experiment.

setTargets

public void setTargets(java.util.Map<java.lang.String,java.lang.Object> value)

The targets for the experiment.

getActions

public java.lang.Object getActions()

The actions for the experiment.

setActions

public void setActions(IResolvable value)

The actions for the experiment.

setActions

public void setActions(java.util.Map<java.lang.String,java.lang.Object> value)

The actions for the experiment.

getLogConfiguration

public java.lang.Object getLogConfiguration()

The configuration for experiment logging.

setLogConfiguration

public void setLogConfiguration(IResolvable value)

The configuration for experiment logging.

setLogConfiguration

public void setLogConfiguration(CfnExperimentTemplate.ExperimentTemplateLogConfigurationProperty value)

The configuration for experiment logging.