community.hrobot.server_info 模块 – 查询一个或多个服务器信息

注意

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

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

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

要在剧本中使用它，请指定： community.hrobot.server_info。

community.hrobot 1.2.0 中的新增功能

概要 

查询一个或多个服务器的信息。

参数 

参数	注释
full_info 布尔值	是否为每个服务器提供完整信息。将其设置为 `true` 每个服务器需要一个 REST 调用，这很慢并会降低您的速率限制。谨慎使用。当指定 `server_number` 时，此选项将设置为 `true`。选项 `false` ← (默认) `true`
hetzner_password 字符串 / 必需	Robot 网络服务用户的密码。
hetzner_user 字符串 / 必需	Robot 网络服务用户的用户名。
server_name 字符串	将结果列表限制为此名称的服务器。
server_number 整数	将结果列表限制为此编号的服务器。

属性 

属性	支持	描述
action_group	动作组： community.hrobot.robot community.hrobot 1.6.0 中添加	在 `module_defaults` 中使用 `group/community.hrobot.robot` 为此模块设置默认值。
check_mode	支持：完全支持此操作不会修改状态。	可以在 `check_mode` 中运行并返回更改状态预测，而无需修改目标。
diff_mode	支持： N/A 此操作不会修改状态。	在差异模式下，将返回有关更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

示例 

- name: Query a list of all servers
  community.hrobot.server_info:
    hetzner_user: foo
    hetzner_password: bar
  register: result

- name: Query a specific server
  community.hrobot.server_info:
    hetzner_user: foo
    hetzner_password: bar
    server_number: 23
  register: result

- name: Output data on specific server
  ansible.builtin.debug:
    msg: "Server name: {{ result.servers[0].server_name }}"

返回值 

常见的返回值已在此处记录，以下是此模块特有的字段

键	描述
servers 列表 / 元素=字典	匹配提供的选项的服务器列表。返回：成功
cancelled 布尔值	服务器是否已取消。返回：成功示例： `false`
cpanel 布尔值	cPanel 安装可用性的标志。返回：当 `full_info=true` 示例： `true`
dc 字符串	服务器所在的机房。返回：成功示例： `"NBG1-DC1"`
hot_swap 布尔值	热插拔可用性的标志。返回：当 `full_info=true` 示例： `true`
ip 列表 / 元素=字符串	分配的单个IP地址列表。返回：成功示例： `["123.123.123.123"]`
linked_storagebox 整数	链接的存储箱 ID。返回：当 `full_info=true` 示例： `12345`
paid_until 字符串	服务器已付费的日期。返回：成功示例： `"2018-08-04"`
plesk 布尔值	Plesk 安装可用性的标志。返回：当 `full_info=true` 示例： `true`
product 字符串	服务器产品名称。返回：成功示例： `"EQ 8"`
rescue 布尔值	救援系统是否可用。返回：当 `full_info=true` 示例： `false`
reset 布尔值	服务器是否可以自动重置。返回：当 `full_info=true` 示例： `true`
server_ip 字符串	服务器的主IP地址。返回：成功示例： `"123.123.123.123"`
server_ipv6_net 字符串	服务器的主IPv6网络地址。返回：成功示例： `"2a01:f48:111:4221::"`
server_name 字符串	用户自定义服务器名称。返回：成功示例： `"server1"`
server_number 整数	服务器的数字 ID。返回：成功示例： `321`
状态字符串	服务器状态。返回：成功只能返回 `"已准备"` `"处理中"` 示例： `"ready"`
子网列表 / 元素=字典	已分配子网的列表。返回：成功示例： `[{"ip": "2a01:4f8:111:4221::", "mask": 64}]`
ip 字符串	子网中的第一个 IP 地址。返回：成功示例： `"2a01:4f8:111:4221::"`
掩码字符串	掩码位长度。返回：成功示例： `"64"`
流量字符串	剩余流量配额。流量无限时显示 `unlimited`。返回：成功示例： `"5 TB"`
VNC 布尔值	VNC 安装可用性的标志。返回：当 `full_info=true` 示例： `true`
Windows 布尔值	Windows 安装可用性的标志。返回：当 `full_info=true` 示例： `true`
WOL 布尔值	Wake On Lan 可用性的标志。返回：当 `full_info=true` 示例： `true`

作者

Felix Fontein (@felixfontein)