

# RequestCancelExternalWorkflowExecutionFailedEventAttributes
<a name="API_RequestCancelExternalWorkflowExecutionFailedEventAttributes"></a>

Provides the details of the `RequestCancelExternalWorkflowExecutionFailed` event.

## Contents
<a name="API_RequestCancelExternalWorkflowExecutionFailedEventAttributes_Contents"></a>

 ** cause **   <a name="SWF-Type-RequestCancelExternalWorkflowExecutionFailedEventAttributes-cause"></a>
The cause of the failure. This information is generated by the system and can be useful for diagnostic purposes.  
If `cause` is set to `OPERATION_NOT_PERMITTED`, the decision failed because it lacked sufficient permissions. For details and example IAM policies, see [Using IAM to Manage Access to Amazon SWF Workflows](https://docs.aws.amazon.com/amazonswf/latest/developerguide/swf-dev-iam.html) in the *Amazon SWF Developer Guide*.
Type: String  
Valid Values: `UNKNOWN_EXTERNAL_WORKFLOW_EXECUTION | REQUEST_CANCEL_EXTERNAL_WORKFLOW_EXECUTION_RATE_EXCEEDED | OPERATION_NOT_PERMITTED`   
Required: Yes

 ** decisionTaskCompletedEventId **   <a name="SWF-Type-RequestCancelExternalWorkflowExecutionFailedEventAttributes-decisionTaskCompletedEventId"></a>
The ID of the `DecisionTaskCompleted` event corresponding to the decision task that resulted in the `RequestCancelExternalWorkflowExecution` decision for this cancellation request. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.  
Type: Long  
Required: Yes

 ** initiatedEventId **   <a name="SWF-Type-RequestCancelExternalWorkflowExecutionFailedEventAttributes-initiatedEventId"></a>
The ID of the `RequestCancelExternalWorkflowExecutionInitiated` event corresponding to the `RequestCancelExternalWorkflowExecution` decision to cancel this external workflow execution. This information can be useful for diagnosing problems by tracing back the chain of events leading up to this event.  
Type: Long  
Required: Yes

 ** workflowId **   <a name="SWF-Type-RequestCancelExternalWorkflowExecutionFailedEventAttributes-workflowId"></a>
The `workflowId` of the external workflow to which the cancel request was to be delivered.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Required: Yes

 ** control **   <a name="SWF-Type-RequestCancelExternalWorkflowExecutionFailedEventAttributes-control"></a>
The data attached to the event that the decider can use in subsequent workflow tasks. This data isn't sent to the workflow execution.  
Type: String  
Length Constraints: Maximum length of 32768.  
Required: No

 ** runId **   <a name="SWF-Type-RequestCancelExternalWorkflowExecutionFailedEventAttributes-runId"></a>
The `runId` of the external workflow execution.  
Type: String  
Length Constraints: Maximum length of 64.  
Required: No

## See Also
<a name="API_RequestCancelExternalWorkflowExecutionFailedEventAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/swf-2012-01-25/RequestCancelExternalWorkflowExecutionFailedEventAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/swf-2012-01-25/RequestCancelExternalWorkflowExecutionFailedEventAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/swf-2012-01-25/RequestCancelExternalWorkflowExecutionFailedEventAttributes) 