infoblox.nios_modules.nios_restartservices 模块 – 重启网格服务。

注意

此模块是 infoblox.nios_modules 集合 (版本 1.7.1) 的一部分。

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

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

要在剧本中使用它，请指定： infoblox.nios_modules.nios_restartservices。

infoblox.nios_modules 1.1.0 中的新增功能

概要 

重启网格服务。
如果调用时没有任何选项，则会在需要时重启默认重启组上的所有服务。

要求 

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

infoblox-client

参数 

参数	注释
groups 列表 / 元素=字符串	要重启的服务重启组的列表。
members 列表 / 元素=字符串	要重启的网格成员列表。
mode 字符串	网格重启时的重启方法。选项 `"GROUPED"` `"SEQUENTIAL"` `"SIMULTANEOUS"`
provider 字典	包含连接详细信息的字典对象。
cert 字符串	指定客户端证书文件，其中包含 x509 配置摘要，用于为与 NIOS 的远程实例的安全连接增加额外的安全层。值也可以使用 `INFOBLOX_CERT` 环境变量指定。
host 字符串	指定用于通过 REST 连接到 NIOS WAPI 远程实例的 DNS 主机名或地址。值也可以使用 `INFOBLOX_HOST` 环境变量指定。
http_pool_connections 整数	在此处插入描述默认值： `10`
http_pool_maxsize 整数	在此处插入描述默认值： `10`
http_request_timeout 整数	在接收响应之前等待的时间量。值也可以使用 `INFOBLOX_HTTP_REQUEST_TIMEOUT` 环境变量指定。默认值： `10`
key 字符串	指定用于使用证书进行加密的私钥文件，以便与 NIOS 的远程实例连接。值也可以使用 `INFOBLOX_KEY` 环境变量指定。
max_results 整数	指定要返回的对象的最大数量，如果设置为负数，则当返回的对象数量超过设置值时，设备将返回错误。值也可以使用 `INFOBLOX_MAX_RESULTS` 环境变量指定。默认值： `1000`
max_retries 整数	配置在声明连接可用之前尝试重试的次数。值也可以使用 `INFOBLOX_MAX_RETRIES` 环境变量指定。默认值： `3`
password 字符串	指定用于验证与 NIOS 远程实例连接的密码。值也可以使用 `INFOBLOX_PASSWORD` 环境变量指定。
silent_ssl_warnings 布尔值	在此处插入描述选项 `false` `true` ← (默认)
username 字符串	配置用于验证与 NIOS 远程实例连接的用户名。值也可以使用 `INFOBLOX_USERNAME` 环境变量指定。
validate_certs 别名：ssl_verify 布尔值	启用或禁用验证 SSL 证书的布尔值。值也可以使用 `INFOBLOX_SSL_VERIFY` 环境变量指定。选项 `false` ← (默认) `true`
wapi_version 字符串	指定要使用的 WAPI 版本。值也可以使用 `INFOBLOX_WAPI_VERSION` 环境变量指定。在 Ansible 2.8 之前，默认的 WAPI 版本为 1.4。默认值： `"2.12.3"`
restart_option 字符串	控制服务是无条件重启还是按需重启。选项 `"RESTART_IF_NEEDED"` ← (默认) `"FORCE_RESTART"`
services 列表 / 元素=字符串	重启适用的服务列表。选项 `"ALL"` ← (默认) `"DNS"` `"DHCP"` `"DHCPV4"` `"DHCPV6"` 默认值： `["ALL"]`

注释 

注意

此模块支持 check_mode。
此模块必须在本地运行，可以通过指定 connection: local 来实现。
请阅读 :ref:`nios_guide` 以获取有关如何将 Infoblox 与 Ansible 一起使用的更多详细信息。

示例 

- name: Restart all grid services if needed.
  infoblox.nios_modules.nios_restartservices:
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Restart DNS service if needed.
  infoblox.nios_modules.nios_restartservices:
    services:
      - DNS
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

Mauricio Teixeira (@badnetmask)