community.hrobot.server 模块 – 更新服务器信息

注意

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

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

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

要在 playbook 中使用它，请指定：community.hrobot.server。

community.hrobot 1.2.0 中的新增功能

概要 

允许更新服务器信息。
目前 API 只支持更新服务器名称。

参数 

参数	注释
hetzner_password 字符串 / 必需	Robot Web 服务用户的密码。
hetzner_user 字符串 / 必需	Robot Web 服务用户的用户名。
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	支持：不支持	在差异模式下，将返回有关已更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

示例 

- name: Set server's name to foo.example.com
  community.hrobot.server:
    hetzner_user: foo
    hetzner_password: bar
    server_number: 123
    server_name: foo.example.com

返回值 

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

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

作者

Felix Fontein (@felixfontein)