community.general.twilio 模块 – 通过 Twilio 发送短信到手机

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.twilio。

概要 

通过 Twilio 消息 API 向电话号码发送短信。

参数 

参数	注释
account_sid 字符串 / 必填	用户在帐户页面上找到的 Twilio 帐户令牌。
auth_token 字符串 / 必填	用户的 Twilio 身份验证令牌。
from_number 字符串 / 必填	用于发送短信的 Twilio 号码，格式为 `+15551112222`。
media_url 字符串	一个包含图片、视频或声音片段的 URL，用于发送彩信（多媒体消息）而不是普通短信。
msg 字符串 / 必填	短信的正文。
to_numbers 别名: to_number 列表 / 元素=字符串 / 必填	一个或多个用于接收短信的电话号码，格式为 `+15551112222`。

属性 

属性	支持	描述
check_mode	支持：完全	可以在 `check_mode` 中运行并返回已更改状态的预测，而无需修改目标。
diff_mode	支持：无	在 diff 模式下，将返回有关已更改的内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

说明 

注意

此模块不是幂等的，因为它通过外部 API 发送电子邮件。只有在模块失败的情况下才是幂等的。
与其他通知模块一样，此模块需要外部依赖项才能工作。在这种情况下，您需要一个 Twilio 帐户，其中包含已购买或已验证的电话号码才能发送短信。

示例 

# send an SMS about the build status to (555) 303 5681
# note: replace account_sid and auth_token values with your credentials
# and you have to have the 'from_number' on your Twilio account
- name: Send a text message to a mobile phone through Twilio
  community.general.twilio:
    msg: All servers with webserver role are now configured.
    account_sid: ACXXXXXXXXXXXXXXXXX
    auth_token: ACXXXXXXXXXXXXXXXXX
    from_number: +15552014545
    to_number: +15553035681
  delegate_to: localhost

# send an SMS to multiple phone numbers about the deployment
# note: replace account_sid and auth_token values with your credentials
# and you have to have the 'from_number' on your Twilio account
- name: Send a text message to a mobile phone through Twilio
  community.general.twilio:
    msg: This server configuration is now complete.
    account_sid: ACXXXXXXXXXXXXXXXXX
    auth_token: ACXXXXXXXXXXXXXXXXX
    from_number: +15553258899
    to_numbers:
      - +15551113232
      - +12025551235
      - +19735559010
  delegate_to: localhost

# send an MMS to a single recipient with an update on the deployment
# and an image of the results
# note: replace account_sid and auth_token values with your credentials
# and you have to have the 'from_number' on your Twilio account
- name: Send a text message to a mobile phone through Twilio
  community.general.twilio:
    msg: Deployment complete!
    account_sid: ACXXXXXXXXXXXXXXXXX
    auth_token: ACXXXXXXXXXXXXXXXXX
    from_number: +15552014545
    to_number: +15553035681
    media_url: https://demo.twilio.com/logo.png
  delegate_to: localhost

作者

Matt Makai (@makaimc)