Class CfnDeploymentPropsMixin
- All Implemented Interfaces:
software.amazon.jsii.JsiiSerializable,software.constructs.IMixin
When you add a new core device to a group of core devices that has a deployment, AWS IoT Greengrass deploys that group's deployment to the new device.
You can define one deployment for each target. When you create a new deployment for a target that has an existing deployment, you replace the previous deployment. AWS IoT Greengrass applies the new deployment to the target devices.
You can only add, update, or delete up to 10 deployments at a time to a single target.
Every deployment has a revision number that indicates how many deployment revisions you define for a target. Use this operation to create a new revision of an existing deployment. This operation returns the revision number of the new deployment when you create it.
For more information, see the Create deployments in the AWS IoT Greengrass V2 Developer Guide .
Deployment resources are deleted when you delete stacks. To keep the deployments in a stack, you must specify
"DeletionPolicy": "Retain"on each deployment resource in the stack template that you want to keep. For more information, see DeletionPolicy .You can only delete up to 10 deployment resources at a time. If you delete more than 10 resources, you receive an error.
Example:
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.cfnpropertymixins.services.greengrassv2.*;
import software.amazon.awscdk.*;
IMergeStrategy mergeStrategy;
Object rateIncreaseCriteria;
CfnDeploymentPropsMixin cfnDeploymentPropsMixin = CfnDeploymentPropsMixin.Builder.create(CfnDeploymentMixinProps.builder()
.components(Map.of(
"componentsKey", ComponentDeploymentSpecificationProperty.builder()
.componentVersion("componentVersion")
.configurationUpdate(ComponentConfigurationUpdateProperty.builder()
.merge("merge")
.reset(List.of("reset"))
.build())
.runWith(ComponentRunWithProperty.builder()
.posixUser("posixUser")
.systemResourceLimits(SystemResourceLimitsProperty.builder()
.cpus(123)
.memory(123)
.build())
.windowsUser("windowsUser")
.build())
.build()))
.deploymentName("deploymentName")
.deploymentPolicies(DeploymentPoliciesProperty.builder()
.componentUpdatePolicy(DeploymentComponentUpdatePolicyProperty.builder()
.action("action")
.timeoutInSeconds(123)
.build())
.configurationValidationPolicy(DeploymentConfigurationValidationPolicyProperty.builder()
.timeoutInSeconds(123)
.build())
.failureHandlingPolicy("failureHandlingPolicy")
.build())
.iotJobConfiguration(DeploymentIoTJobConfigurationProperty.builder()
.abortConfig(IoTJobAbortConfigProperty.builder()
.criteriaList(List.of(IoTJobAbortCriteriaProperty.builder()
.action("action")
.failureType("failureType")
.minNumberOfExecutedThings(123)
.thresholdPercentage(123)
.build()))
.build())
.jobExecutionsRolloutConfig(IoTJobExecutionsRolloutConfigProperty.builder()
.exponentialRate(IoTJobExponentialRolloutRateProperty.builder()
.baseRatePerMinute(123)
.incrementFactor(123)
.rateIncreaseCriteria(rateIncreaseCriteria)
.build())
.maximumPerMinute(123)
.build())
.timeoutConfig(IoTJobTimeoutConfigProperty.builder()
.inProgressTimeoutInMinutes(123)
.build())
.build())
.parentTargetArn("parentTargetArn")
.tags(Map.of(
"tagsKey", "tags"))
.targetArn("targetArn")
.build())
.strategy(mergeStrategy)
.build();
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final classA fluent builder forCfnDeploymentPropsMixin.static interfaceContains information about a deployment's update to a component's configuration on AWS IoT Greengrass core devices.static interfaceContains information about a component to deploy.static interfaceContains information system user and group that the AWS IoT Greengrass Core software uses to run component processes on the core device.static interfaceContains information about a deployment's policy that defines when components are safe to update.static interfaceContains information about how long a component on a core device can validate its configuration updates before it times out.static interfaceContains information about an AWS IoT job configuration.static interfaceContains information about policies that define how a deployment updates components and handles failure.static interfaceContains a list of criteria that define when and how to cancel a configuration deployment.static interfaceContains criteria that define when and how to cancel a job.static interfaceContains information about the rollout configuration for a job.static interfaceContains information about an exponential rollout rate for a configuration deployment job.static interfaceContains information about the timeout configuration for a job.static interfaceContains information about system resource limits that the software applies to a component's processes.Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject
software.amazon.jsii.JsiiObject.InitializationModeNested classes/interfaces inherited from interface software.constructs.IMixin
software.constructs.IMixin.Jsii$Default, software.constructs.IMixin.Jsii$Proxy -
Field Summary
Fields -
Constructor Summary
ConstructorsModifierConstructorDescriptionCreate a mixin to apply properties toAWS::GreengrassV2::Deployment.CfnDeploymentPropsMixin(CfnDeploymentMixinProps props, CfnPropertyMixinOptions options) Create a mixin to apply properties toAWS::GreengrassV2::Deployment.protectedCfnDeploymentPropsMixin(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) protectedCfnDeploymentPropsMixin(software.amazon.jsii.JsiiObjectRef objRef) -
Method Summary
Modifier and TypeMethodDescriptionvoidapplyTo(software.constructs.IConstruct construct) Apply the mixin properties to the construct.protected CfnDeploymentMixinPropsgetProps()protected IMergeStrategysupports(software.constructs.IConstruct construct) Check if this mixin supports the given construct.Methods inherited from class software.amazon.jsii.JsiiObject
jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSetMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson
-
Field Details
-
CFN_PROPERTY_KEYS
-
-
Constructor Details
-
CfnDeploymentPropsMixin
protected CfnDeploymentPropsMixin(software.amazon.jsii.JsiiObjectRef objRef) -
CfnDeploymentPropsMixin
protected CfnDeploymentPropsMixin(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) -
CfnDeploymentPropsMixin
@Stability(Stable) public CfnDeploymentPropsMixin(@NotNull CfnDeploymentMixinProps props, @Nullable CfnPropertyMixinOptions options) Create a mixin to apply properties toAWS::GreengrassV2::Deployment.- Parameters:
props- L1 properties to apply. This parameter is required.options- Mixin options.
-
CfnDeploymentPropsMixin
Create a mixin to apply properties toAWS::GreengrassV2::Deployment.- Parameters:
props- L1 properties to apply. This parameter is required.
-
-
Method Details
-
applyTo
@Stability(Stable) public void applyTo(@NotNull software.constructs.IConstruct construct) Apply the mixin properties to the construct. -
supports
@Stability(Stable) @NotNull public Boolean supports(@NotNull software.constructs.IConstruct construct) Check if this mixin supports the given construct. -
getProps
-
getStrategy
-