         | Did this page help you? Yes No Tell us about it... |
SetTerminationProtection
Description
SetTerminationProtection locks a job flow so the Amazon EC2 instances in the cluster cannot be terminated by user intervention, an API call, or in the event of a job-flow error. The cluster still terminates upon successful completion of the job flow. Calling SetTerminationProtection on a job flow is analogous to calling the Amazon EC2 DisableAPITermination API on all of the EC2 instances in a cluster.
SetTerminationProtection is used to prevent accidental termination of a job flow and to ensure that in the event of an error, the instances will persist so you can recover any data stored in their ephemeral instance storage.
To terminate a job flow that has been locked by setting SetTerminationProtection to true,
you must first unlock the job flow by a subsequent call to SetTerminationProtection
in which you set the value to false.
For more information, go to Protecting a Job Flow from Termination in the Amazon Elastic MapReduce Developer's Guide.
Request Parameters
For information about the common parameters that all actions use, see Common Query Parameters.
| Name | Description | Required |
|---|---|---|
JobFlowIds.member.N
|
A list of strings that uniquely identify the job flows to protect. This identifier is returned by RunJobFlow and can also be obtained from DescribeJobFlows . Type: String list | Yes |
TerminationProtected
|
A Boolean that indicates whether to protect the job flow and prevent the Amazon EC2 instances in the cluster from shutting down due to API calls, user intervention, or job-flow error. Type: Boolean | Yes |
Errors
For information about the common errors that all actions use, see Common Errors.
| Error | Description | HTTP Status Code |
|---|---|---|
InternalServerError
|
Indicates that an error occurred while processing the request and that the request was not completed. | 500 |
Examples
Sample Request
https://elasticmapreduce.amazonaws.com?Action=SetTerminationProtection &JobFlowIds.member.1=j-3UN6WX5RRO2AG &TerminationProtected=true &AuthParams
Sample Response
<SetTerminationProtection xmlns="http://elasticmapreduce.amazonaws.com/doc/2009-03-31">
<ResponseMetadata>
<RequestId>
df6f4f4a-ed85-11dd-9877-6fad448a8419
</RequestId>
</ResponseMetadata>
</SetTerminationProtectionResponse>
