Class CfnLifecyclePolicy.ScriptProperty.Builder
- All Implemented Interfaces:
software.amazon.jsii.Builder<CfnLifecyclePolicy.ScriptProperty>
- Enclosing interface:
CfnLifecyclePolicy.ScriptProperty
CfnLifecyclePolicy.ScriptProperty
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionbuild()
Builds the configured instance.executeOperationOnScriptFailure
(Boolean executeOperationOnScriptFailure) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecuteOperationOnScriptFailure()
executeOperationOnScriptFailure
(IResolvable executeOperationOnScriptFailure) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecuteOperationOnScriptFailure()
executionHandler
(String executionHandler) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecutionHandler()
executionHandlerService
(String executionHandlerService) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecutionHandlerService()
executionTimeout
(Number executionTimeout) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecutionTimeout()
maximumRetryCount
(Number maximumRetryCount) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getMaximumRetryCount()
Sets the value ofCfnLifecyclePolicy.ScriptProperty.getStages()
-
Constructor Details
-
Builder
public Builder()
-
-
Method Details
-
executeOperationOnScriptFailure
@Stability(Stable) public CfnLifecyclePolicy.ScriptProperty.Builder executeOperationOnScriptFailure(Boolean executeOperationOnScriptFailure) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecuteOperationOnScriptFailure()
- Parameters:
executeOperationOnScriptFailure
- Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.- To default to crash consistent snapshot if the pre script fails, specify
true
. - To skip the instance for snapshot creation if the pre script fails, specify
false
.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default: true
- To default to crash consistent snapshot if the pre script fails, specify
- Returns:
this
-
executeOperationOnScriptFailure
@Stability(Stable) public CfnLifecyclePolicy.ScriptProperty.Builder executeOperationOnScriptFailure(IResolvable executeOperationOnScriptFailure) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecuteOperationOnScriptFailure()
- Parameters:
executeOperationOnScriptFailure
- Indicates whether Amazon Data Lifecycle Manager should default to crash-consistent snapshots if the pre script fails.- To default to crash consistent snapshot if the pre script fails, specify
true
. - To skip the instance for snapshot creation if the pre script fails, specify
false
.
This parameter is supported only if you run a pre script. If you run a post script only, omit this parameter.
Default: true
- To default to crash consistent snapshot if the pre script fails, specify
- Returns:
this
-
executionHandler
@Stability(Stable) public CfnLifecyclePolicy.ScriptProperty.Builder executionHandler(String executionHandler) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecutionHandler()
- Parameters:
executionHandler
- The SSM document that includes the pre and/or post scripts to run.- If you are automating VSS backups, specify
AWS_VSS_BACKUP
. In this case, Amazon Data Lifecycle Manager automatically uses theAWSEC2-CreateVssSnapshot
SSM document. - If you are automating application-consistent snapshots for SAP HANA workloads, specify
AWSSystemsManagerSAP-CreateDLMSnapshotForSAPHANA
. - If you are using a custom SSM document that you own, specify either the name or ARN of the SSM document. If you are using a custom SSM document that is shared with you, specify the ARN of the SSM document.
- If you are automating VSS backups, specify
- Returns:
this
-
executionHandlerService
@Stability(Stable) public CfnLifecyclePolicy.ScriptProperty.Builder executionHandlerService(String executionHandlerService) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecutionHandlerService()
- Parameters:
executionHandlerService
- Indicates the service used to execute the pre and/or post scripts.- If you are using custom SSM documents or automating application-consistent snapshots of SAP HANA workloads, specify
AWS_SYSTEMS_MANAGER
. - If you are automating VSS Backups, omit this parameter.
Default: AWS_SYSTEMS_MANAGER
- If you are using custom SSM documents or automating application-consistent snapshots of SAP HANA workloads, specify
- Returns:
this
-
executionTimeout
@Stability(Stable) public CfnLifecyclePolicy.ScriptProperty.Builder executionTimeout(Number executionTimeout) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getExecutionTimeout()
- Parameters:
executionTimeout
- Specifies a timeout period, in seconds, after which Amazon Data Lifecycle Manager fails the script run attempt if it has not completed. If a script does not complete within its timeout period, Amazon Data Lifecycle Manager fails the attempt. The timeout period applies to the pre and post scripts individually.If you are automating VSS Backups, omit this parameter.
Default: 10
- Returns:
this
-
maximumRetryCount
@Stability(Stable) public CfnLifecyclePolicy.ScriptProperty.Builder maximumRetryCount(Number maximumRetryCount) Sets the value ofCfnLifecyclePolicy.ScriptProperty.getMaximumRetryCount()
- Parameters:
maximumRetryCount
- Specifies the number of times Amazon Data Lifecycle Manager should retry scripts that fail.- If the pre script fails, Amazon Data Lifecycle Manager retries the entire snapshot creation process, including running the pre and post scripts.
- If the post script fails, Amazon Data Lifecycle Manager retries the post script only; in this case, the pre script will have completed and the snapshot might have been created.
If you do not want Amazon Data Lifecycle Manager to retry failed scripts, specify
0
.Default: 0
- Returns:
this
-
stages
Sets the value ofCfnLifecyclePolicy.ScriptProperty.getStages()
- Parameters:
stages
- Indicate which scripts Amazon Data Lifecycle Manager should run on target instances. Pre scripts run before Amazon Data Lifecycle Manager initiates snapshot creation. Post scripts run after Amazon Data Lifecycle Manager initiates snapshot creation.- To run a pre script only, specify
PRE
. In this case, Amazon Data Lifecycle Manager calls the SSM document with thepre-script
parameter before initiating snapshot creation. - To run a post script only, specify
POST
. In this case, Amazon Data Lifecycle Manager calls the SSM document with thepost-script
parameter after initiating snapshot creation. - To run both pre and post scripts, specify both
PRE
andPOST
. In this case, Amazon Data Lifecycle Manager calls the SSM document with thepre-script
parameter before initiating snapshot creation, and then it calls the SSM document again with thepost-script
parameter after initiating snapshot creation.
If you are automating VSS Backups, omit this parameter.
Default: PRE and POST
- To run a pre script only, specify
- Returns:
this
-
build
Builds the configured instance.- Specified by:
build
in interfacesoftware.amazon.jsii.Builder<CfnLifecyclePolicy.ScriptProperty>
- Returns:
- a new instance of
CfnLifecyclePolicy.ScriptProperty
- Throws:
NullPointerException
- if any required attribute was not provided
-