hetzner.hcloud.server_info 模块 – 收集关于您的 Hetzner 云服务器的信息。

注意

此模块是 hetzner.hcloud 集合（版本 4.2.2）的一部分。

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

要安装它，请使用： ansible-galaxy collection install hetzner.hcloud。您需要进一步的要求才能使用此模块，请参阅要求以获取详细信息。

要在 playbook 中使用它，请指定： hetzner.hcloud.server_info。

概要 

收集关于您的 Hetzner 云服务器的信息。

别名：hcloud_server_info

要求 

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

python-dateutil >= 2.7.5
requests >=2.20

参数 

参数	注释
api_endpoint 别名：endpoint 字符串	Hetzner Cloud 的 API 端点。您也可以使用 `HCLOUD_ENDPOINT` 环境变量设置此选项。默认值： `"https://api.hetzner.cloud/v1"`
api_token 字符串 / 必需	Hetzner Cloud 的 API 令牌。您也可以使用 `HCLOUD_TOKEN` 环境变量设置此选项。
id 整数	您要获取的服务器的 ID。如果提供的 ID 无效，则模块将失败。
label_selector 字符串	您要获取的服务器的标签选择器。
name 字符串	您要获取的服务器的名称。

另请参阅 

另请参阅

Hetzner Cloud API 文档: Hetzner Cloud API 的完整参考。

示例 

- name: Gather hcloud server infos
  hetzner.hcloud.server_info:
  register: output

- name: Print the gathered infos
  debug:
    var: output.hcloud_server_info

返回值 

通用返回值记录在此处，以下是此模块特有的字段

键	描述
hcloud_server_info 复杂	服务器信息列表返回：总是
backup_window 布尔值	备份将运行的时间窗口（UTC），如果未启用备份，则为 null 返回：总是示例： `"22-02"`
created 字符串	服务器创建的时间点（ISO-8601 格式）返回：总是示例： `"2023-11-06T13:36:56+00:00"`
datacenter 字符串	服务器的数据中心名称返回：总是示例： `"fsn1-dc14"`
delete_protection 布尔值在 hetzner.hcloud 0.1.0 中添加	如果服务器受保护，无法删除，则为 True 返回：总是示例： `false`
id 整数	服务器的数字标识符返回：总是示例： `1937415`
ipv4_address 字符串	服务器的公共 IPv4 地址返回：总是示例： `"116.203.104.109"`
ipv6 字符串	服务器的 IPv6 网络返回：总是示例： `"2a01:4f8:1c1c:c140::/64"`
labels 字典	用户定义的标签（键值对）返回：总是
location 字符串	服务器所在位置的名称返回：总是示例： `"fsn1"`
name 字符串	服务器的名称返回：总是示例： `"my-server"`
placement_group 字符串在 hetzner.hcloud 1.5.0 中添加	服务器的放置组返回：总是示例： `"4711"`
private_networks 列表 / 元素=字符串	服务器连接到的私有网络列表（名称）返回：总是示例： `["my-network", "another-network"]`
private_networks_info 列表 / 元素=字典	服务器连接到的私有网络列表（包含名称和 IP 的字典）返回：总是示例： `[{"ip": "192.168.1.1", "name": "my-network"}, {"ip": "10.185.50.40", "name": "another-network"}]`
rebuild_protection 布尔值在 hetzner.hcloud 0.1.0 中添加	如果服务器受保护，无法重建，则为 True 返回：总是示例： `false`
rescue_enabled 布尔值	如果启用救援模式，则为 True，服务器将在下次重启时启动进入救援系统返回：总是示例： `false`
server_type 字符串	服务器的服务器类型名称返回：总是示例： `"cx22"`
status 字符串	服务器的状态返回：总是示例： `"running"`

作者

Lukas Kaemmerling (@LKaemmerling)