# SignalExternalWorkflowExecutionFailedEventAttributes
<a name="API_SignalExternalWorkflowExecutionFailedEventAttributes"></a>

Provides the details of the `SignalExternalWorkflowExecutionFailed` event.

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

 ** cause **   <a name="SWF-Type-SignalExternalWorkflowExecutionFailedEventAttributes-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 | SIGNAL_EXTERNAL_WORKFLOW_EXECUTION_RATE_EXCEEDED | OPERATION_NOT_PERMITTED`   
Required: Yes

 ** decisionTaskCompletedEventId **   <a name="SWF-Type-SignalExternalWorkflowExecutionFailedEventAttributes-decisionTaskCompletedEventId"></a>
The ID of the `DecisionTaskCompleted` event corresponding to the decision task that resulted in the `SignalExternalWorkflowExecution` decision for this signal. 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-SignalExternalWorkflowExecutionFailedEventAttributes-initiatedEventId"></a>
The ID of the `SignalExternalWorkflowExecutionInitiated` event corresponding to the `SignalExternalWorkflowExecution` decision to request this signal. 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-SignalExternalWorkflowExecutionFailedEventAttributes-workflowId"></a>
The `workflowId` of the external workflow execution that the signal was being delivered to.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Required: Yes

 ** control **   <a name="SWF-Type-SignalExternalWorkflowExecutionFailedEventAttributes-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-SignalExternalWorkflowExecutionFailedEventAttributes-runId"></a>
The `runId` of the external workflow execution that the signal was being delivered to.  
Type: String  
Length Constraints: Maximum length of 64.  
Required: No

## See Also
<a name="API_SignalExternalWorkflowExecutionFailedEventAttributes_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/SignalExternalWorkflowExecutionFailedEventAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/swf-2012-01-25/SignalExternalWorkflowExecutionFailedEventAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/swf-2012-01-25/SignalExternalWorkflowExecutionFailedEventAttributes)