# SnsAction
<a name="API_SnsAction"></a>

Describes an action to publish to an Amazon SNS topic.

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

 ** roleArn **   <a name="iot-Type-SnsAction-roleArn"></a>
The ARN of the IAM role that grants access.  
Type: String  
Required: Yes

 ** targetArn **   <a name="iot-Type-SnsAction-targetArn"></a>
The ARN of the SNS topic.  
Type: String  
Required: Yes

 ** messageFormat **   <a name="iot-Type-SnsAction-messageFormat"></a>
(Optional) The message format of the message to publish. Accepted values are "JSON" and "RAW". The default value of the attribute is "RAW". SNS uses this setting to determine if the payload should be parsed and relevant platform-specific bits of the payload should be extracted. To read more about SNS message formats, see [https://docs.amazonaws.cn/sns/latest/dg/json-formats.html](https://docs.amazonaws.cn/sns/latest/dg/json-formats.html) refer to their official documentation.  
Type: String  
Valid Values: `RAW | JSON`   
Required: No

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

For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+  [Amazon SDK for C\+\+](https://docs.amazonaws.cn/goto/SdkForCpp/iot-2015-05-28/SnsAction) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/iot-2015-05-28/SnsAction) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/iot-2015-05-28/SnsAction)