software.amazon.awscdk.services.appconfig

Class CfnDeploymentStrategy

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.CfnElement

software.amazon.awscdk.CfnRefElement

software.amazon.awscdk.CfnResource

software.amazon.awscdk.services.appconfig.CfnDeploymentStrategy

All Implemented Interfaces:

IInspectable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:36.299Z")
 @Stability(value=Stable)
public class CfnDeploymentStrategy
extends CfnResource
implements IInspectable

A CloudFormation `AWS::AppConfig::DeploymentStrategy`.

The AWS::AppConfig::DeploymentStrategy resource creates an AWS AppConfig deployment strategy. A deployment strategy defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes: the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.

AWS AppConfig requires that you create resources and deploy a configuration in the following order:

• Create an application
• Create an environment
• Create a configuration profile
• Create a deployment strategy
• Deploy the configuration

For more information, see AWS AppConfig in the AWS AppConfig 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.appconfig.*;
 CfnDeploymentStrategy cfnDeploymentStrategy = CfnDeploymentStrategy.Builder.create(this, "MyCfnDeploymentStrategy")
         .deploymentDurationInMinutes(123)
         .growthFactor(123)
         .name("name")
         .replicateTo("replicateTo")
         // the properties below are optional
         .description("description")
         .finalBakeTimeInMinutes(123)
         .growthType("growthType")
         .tags(List.of(TagsProperty.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CfnDeploymentStrategy.Builder A fluent builder for CfnDeploymentStrategy.
static interface	CfnDeploymentStrategy.TagsProperty Metadata to assign to the deployment strategy.

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

software.amazon.jsii.JsiiObject.InitializationMode

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

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Field Summary

Fields

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

Constructor Summary

Constructors

Modifier	Constructor and Description
	CfnDeploymentStrategy(software.constructs.Construct scope, String id, CfnDeploymentStrategyProps props) Create a new `AWS::AppConfig::DeploymentStrategy`.
protected	CfnDeploymentStrategy(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnDeploymentStrategy(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
protected Map<String,Object>	getCfnProperties()
Number	getDeploymentDurationInMinutes() Total amount of time for a deployment to last.
String	getDescription() A description of the deployment strategy.
Number	getFinalBakeTimeInMinutes() The amount of time AWS AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
Number	getGrowthFactor() The percentage of targets to receive a deployed configuration during each interval.
String	getGrowthType() The algorithm used to define how percentage grows over time.
String	getName() A name for the deployment strategy.
String	getReplicateTo() Save the deployment strategy to a Systems Manager (SSM) document.
List<CfnDeploymentStrategy.TagsProperty>	getTags() Assigns metadata to an AWS AppConfig resource.
void	inspect(TreeInspector inspector) Examines the CloudFormation resource and discloses attributes.
protected Map<String,Object>	renderProperties(Map<String,Object> props)
void	setDeploymentDurationInMinutes(Number value) Total amount of time for a deployment to last.
void	setDescription(String value) A description of the deployment strategy.
void	setFinalBakeTimeInMinutes(Number value) The amount of time AWS AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.
void	setGrowthFactor(Number value) The percentage of targets to receive a deployed configuration during each interval.
void	setGrowthType(String value) The algorithm used to define how percentage grows over time.
void	setName(String value) A name for the deployment strategy.
void	setReplicateTo(String value) Save the deployment strategy to a Systems Manager (SSM) document.
void	setTags(List<CfnDeploymentStrategy.TagsProperty> value) Assigns metadata to an AWS AppConfig resource.

Methods inherited from class software.amazon.awscdk.CfnResource

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

Methods inherited from class software.amazon.awscdk.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.constructs.Construct

getNode, isConstruct

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, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Detail

CFN_RESOURCE_TYPE_NAME

@Stability(value=Stable)
public static final String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Detail

CfnDeploymentStrategy

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

CfnDeploymentStrategy

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

CfnDeploymentStrategy

@Stability(value=Stable)
public CfnDeploymentStrategy(@NotNull
                                                      software.constructs.Construct scope,
                                                      @NotNull
                                                      String id,
                                                      @NotNull
                                                      CfnDeploymentStrategyProps props)

Create a new `AWS::AppConfig::DeploymentStrategy`.

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

@Stability(value=Stable)
public void inspect(@NotNull
                                             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

@Stability(value=Stable)
 @NotNull
protected Map<String,Object> renderProperties(@NotNull
                                                                                 Map<String,Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getCfnProperties

@Stability(value=Stable)
 @NotNull
protected Map<String,Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getDeploymentDurationInMinutes

@Stability(value=Stable)
 @NotNull
public Number getDeploymentDurationInMinutes()

Total amount of time for a deployment to last.

setDeploymentDurationInMinutes

@Stability(value=Stable)
public void setDeploymentDurationInMinutes(@NotNull
                                                                    Number value)

Total amount of time for a deployment to last.

getGrowthFactor

@Stability(value=Stable)
 @NotNull
public Number getGrowthFactor()

The percentage of targets to receive a deployed configuration during each interval.

setGrowthFactor

@Stability(value=Stable)
public void setGrowthFactor(@NotNull
                                                     Number value)

The percentage of targets to receive a deployed configuration during each interval.

getName

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

A name for the deployment strategy.

setName

@Stability(value=Stable)
public void setName(@NotNull
                                             String value)

A name for the deployment strategy.

getReplicateTo

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

Save the deployment strategy to a Systems Manager (SSM) document.

setReplicateTo

@Stability(value=Stable)
public void setReplicateTo(@NotNull
                                                    String value)

Save the deployment strategy to a Systems Manager (SSM) document.

getDescription

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

A description of the deployment strategy.

setDescription

@Stability(value=Stable)
public void setDescription(@Nullable
                                                    String value)

A description of the deployment strategy.

getFinalBakeTimeInMinutes

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

The amount of time AWS AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

setFinalBakeTimeInMinutes

@Stability(value=Stable)
public void setFinalBakeTimeInMinutes(@Nullable
                                                               Number value)

The amount of time AWS AppConfig monitors for alarms before considering the deployment to be complete and no longer eligible for automatic roll back.

getGrowthType

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

The algorithm used to define how percentage grows over time. AWS AppConfig supports the following growth types:.

Linear : For this type, AWS AppConfig processes the deployment by dividing the total number of targets by the value specified for Step percentage . For example, a linear deployment that uses a Step percentage of 10 deploys the configuration to 10 percent of the hosts. After those deployments are complete, the system deploys the configuration to the next 10 percent. This continues until 100% of the targets have successfully received the configuration.

Exponential : For this type, AWS AppConfig processes the deployment exponentially using the following formula: G*(2^N) . In this formula, G is the growth factor specified by the user and N is the number of steps until the configuration is deployed to all targets. For example, if you specify a growth factor of 2, then the system rolls out the configuration as follows:

2*(2^0)

2*(2^1)

2*(2^2)

Expressed numerically, the deployment rolls out as follows: 2% of the targets, 4% of the targets, 8% of the targets, and continues until the configuration has been deployed to all targets.

setGrowthType

@Stability(value=Stable)
public void setGrowthType(@Nullable
                                                   String value)

The algorithm used to define how percentage grows over time. AWS AppConfig supports the following growth types:.

Linear : For this type, AWS AppConfig processes the deployment by dividing the total number of targets by the value specified for Step percentage . For example, a linear deployment that uses a Step percentage of 10 deploys the configuration to 10 percent of the hosts. After those deployments are complete, the system deploys the configuration to the next 10 percent. This continues until 100% of the targets have successfully received the configuration.

Exponential : For this type, AWS AppConfig processes the deployment exponentially using the following formula: G*(2^N) . In this formula, G is the growth factor specified by the user and N is the number of steps until the configuration is deployed to all targets. For example, if you specify a growth factor of 2, then the system rolls out the configuration as follows:

2*(2^0)

2*(2^1)

2*(2^2)

Expressed numerically, the deployment rolls out as follows: 2% of the targets, 4% of the targets, 8% of the targets, and continues until the configuration has been deployed to all targets.

getTags

@Stability(value=Stable)
 @Nullable
public List<CfnDeploymentStrategy.TagsProperty> getTags()

Assigns metadata to an AWS AppConfig resource.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define. You can specify a maximum of 50 tags for a resource.

setTags

@Stability(value=Stable)
public void setTags(@Nullable
                                             List<CfnDeploymentStrategy.TagsProperty> value)

Assigns metadata to an AWS AppConfig resource.

Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define. You can specify a maximum of 50 tags for a resource.