community.general.ovh_ip_failover 模块 – 管理 OVH IP 故障转移地址

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.general。您需要其他要求才能使用此模块，有关详细信息，请参阅要求。

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

概要 

管理 OVH（法国欧洲托管提供商）IP 故障转移地址。目前，此模块只能用于在服务之间移动 IP 故障转移（或故障转移块）

要求 

执行此模块的主机需要满足以下要求。

ovh >= 0.4.8

参数 

参数	注释
application_key 字符串 / 必需	要使用的 applicationKey
application_secret 字符串 / 必需	要使用的应用程序密钥
consumer_key 字符串 / 必需	要使用的消费者密钥
endpoint 字符串 / 必需	要使用的端点（例如 ovh-eu）
name 字符串 / 必需	要管理的 IP 地址（可以是单个 IP，例如 1.1.1.1 或块，例如 1.1.1.1/28）
service 字符串 / 必需	此 IP 地址应路由到的 OVH 服务的名称
timeout 整数	等待任务完成的超时时间（以秒为单位）。默认值为 120 秒。默认值： `120`
wait_completion 布尔值	如果为 true，模块将等待 IP 地址被移动。如果为 false，则退出而不等待。taskId 将在模块输出中返回选项 `false` `true` ← (默认)
wait_task_completion 整数	如果不是 0，模块将等待此任务 ID 完成。如果您想等待先前执行的 wait_completion=false 的任务完成，请使用 wait_task_completion。您可以使用 wait_completion=false 重复执行此模块列表中的故障转移 IP（请参见示例）默认值： `0`

属性 

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

注意 

注意

使用 python OVH Api https://github.com/ovh/python-ovh。您必须按照 https://docs.ovh.com/gb/en/customer/first-steps-with-ovh-api/ 中的描述创建一个应用程序（密钥和密码）以及一个消费者密钥

示例 

# Route an IP address 1.1.1.1 to the service ns666.ovh.net
- community.general.ovh_ip_failover:
    name: 1.1.1.1
    service: ns666.ovh.net
    endpoint: ovh-eu
    application_key: yourkey
    application_secret: yoursecret
    consumer_key: yourconsumerkey
- community.general.ovh_ip_failover:
    name: 1.1.1.1
    service: ns666.ovh.net
    endpoint: ovh-eu
    wait_completion: false
    application_key: yourkey
    application_secret: yoursecret
    consumer_key: yourconsumerkey
  register: moved
- community.general.ovh_ip_failover:
    name: 1.1.1.1
    service: ns666.ovh.net
    endpoint: ovh-eu
    wait_task_completion: "{{moved.taskId}}"
    application_key: yourkey
    application_secret: yoursecret
    consumer_key: yourconsumerkey

作者

Pascal HERAUD (@pascalheraud)