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

注意

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

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

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

要在 playbook 中使用它，请指定：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`
status 字符串	服务器状态。返回：成功只能返回 `"ready"` `"in process"` 示例： `"ready"`
subnet 列表 / 元素=字典	分配的子网列表。返回：成功示例： `[{"ip": "2a01:4f8:111:4221::", "mask": 64}]`
ip 字符串	子网中的第一个 IP。返回：成功示例： `"2a01:4f8:111:4221::"`
mask 字符串	掩码位长。返回：成功示例： `"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)