VhdZdZdZddlZ ddlmZddlmZddlm Z ddl m Z d Z ed k(re yy#e$rY$wxYw) a module: sns short_description: Send Amazon Simple Notification Service messages version_added: 1.0.0 description: - Sends a notification to a topic on your Amazon SNS account. author: - Michael J. Schultz (@mjschultz) - Paul Arthur (@flowerysong) options: msg: description: - Default message for subscriptions without a more specific message. required: true aliases: [ "default" ] type: str subject: description: - Message subject type: str topic: description: - The name or ARN of the topic to publish to. required: true type: str email: description: - Message to send to email subscriptions. type: str email_json: description: - Message to send to email-json subscriptions. type: str sqs: description: - Message to send to SQS subscriptions. type: str sms: description: - Message to send to SMS subscriptions. type: str http: description: - Message to send to HTTP subscriptions. type: str https: description: - Message to send to HTTPS subscriptions. type: str application: description: - Message to send to application subscriptions. type: str lambda: description: - Message to send to Lambda subscriptions. type: str message_attributes: description: - Dictionary of message attributes. These are optional structured data entries to be sent along to the endpoint. - This is in AWS's distinct Name/Type/Value format; see example below. type: dict message_structure: description: - The payload format to use for the message. - This must be C(json) to support protocol-specific messages (C(http), C(https), C(email), C(sms), C(sqs)). - It must be C(string) to support I(message_attributes). default: json choices: ['json', 'string'] type: str message_group_id: description: - A tag which is used to process messages that belong to the same group in a FIFO manner. - Has to be included when publishing a message to a fifo topic. - Can contain up to 128 alphanumeric characters and punctuation. type: str version_added: 5.4.0 message_deduplication_id: description: - Only in connection with the message_group_id. - Overwrites the auto generated MessageDeduplicationId. - Can contain up to 128 alphanumeric characters and punctuation. - Messages with the same deduplication id getting recognized as the same message. - Gets overwritten by an auto generated token, if the topic has ContentBasedDeduplication set. type: str version_added: 5.4.0 extends_documentation_fragment: - amazon.aws.region.modules - amazon.aws.common.modules - amazon.aws.boto3 a - name: Send default notification message via SNS community.aws.sns: msg: '{{ inventory_hostname }} has completed the play.' subject: Deploy complete! topic: deploy delegate_to: localhost - name: Send notification messages via SNS with short message for SMS community.aws.sns: msg: '{{ inventory_hostname }} has completed the play.' sms: deployed! subject: Deploy complete! topic: deploy delegate_to: localhost - name: Send message with message_attributes community.aws.sns: topic: "deploy" msg: "message with extra details!" message_attributes: channel: data_type: String string_value: "mychannel" color: data_type: String string_value: "green" delegate_to: localhost - name: Send message to a fifo topic community.aws.sns: topic: "deploy" msg: "Message with message group id" subject: Deploy complete! message_group_id: "deploy-1" delegate_to: localhost a msg: description: Human-readable diagnostic information returned: always type: str sample: OK message_id: description: The message ID of the submitted message returned: when success type: str sample: 2f681ef0-6d76-5c94-99b2-4ae3996ce57b sequence_number: description: A 128 bits long sequence number which gets assigned to the message in fifo topics returned: when success type: str N) BotoCoreError) ClientError)AnsibleCommunityAWSModule)topic_arn_lookupc gd}ttddgttdtdtdd gd tt }|D]}t||<t| }t|jd |jd|jd}|jdr6|jdd k7r|jd|jd|d<|jdr3|jd|d<|jdr|jd|d<d|di}|D]N}|j|s|ddk7r|jd|j|||j dd<P|j d}|jd}d |vr||d!<nt ||||d!<|d!s|jd"||ddk(rtj||d< |jd)i|}td$d%&} |jdr|d'| d(<|jd)i| y#ttf$r} |j| d#Yd} ~ ad} ~ wwxYw)*N)httphttpsemail email_jsonsmssqs applicationlambdaTdefault)requiredaliases)rdict)typejsonstring)choicesr)msgsubjecttopicmessage_attributesmessage_structuremessage_group_idmessage_deduplication_id) argument_specrrr)MessageSubjectMessageStructurerzLmessage_attributes is only supported when the message_structure is "string".)rMessageAttributesrMessageGroupIdrMessageDeduplicationIdr r"zOProtocol-specific messages are only supported when message_structure is "json"._-snsr:TopicArnzCould not find topic: zFailed to publish messageOK MessageId)r message_idSequenceNumbersequence_number)rAnsibleAWSModuleparams fail_jsonreplaceclientrrdumpspublishrr fail_json_aws exit_json) protocolsrpmodule sns_kwargsdict_msgr5rresulte sns_results e/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/aws/plugins/modules/sns.pymainrCs I $ 4D!V,'96J!%M"6 a"M :F e$ i(':;J }})* ==, - 9   !o  p*0--8L*M &' }}'('-}}5G'H #$ ==3 439==A[3\J/ 0:i01H = == ,-7  %v w,2MM!,$%/ $ 8 4 9A-*-$6++>?J }}'((./?(@ $%F"z" ; 'AQ$?@@AsII?"I::I?__main__) DOCUMENTATIONEXAMPLESRETURNrbotocore.exceptionsrr ImportError>ansible_collections.community.aws.plugins.module_utils.modulesrr1:ansible_collections.community.aws.plugins.module_utils.snsrrC__name__r0rBrNsf[ z$ L "  1/yWL#^ zFm  s 5==