hetzner.hcloud.datacenter_info 模块 – 收集关于 Hetzner Cloud 数据中心的信息。

注意

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

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

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

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

概要 

收集关于您的 Hetzner Cloud 数据中心的信息。

别名：hcloud_datacenter_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 无效，模块将失败。
name 字符串	您要获取的数据中心的名称。

参见 

另请参阅

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

示例 

- name: Gather hcloud datacenter info
  hetzner.hcloud.datacenter_info:
  register: output

- name: Print the gathered info
  debug:
    var: output

- name: List available server_types in a datacenter
  block:
    - name: Gather a hcloud datacenter
      hetzner.hcloud.datacenter_info:
        name: fsn1-dc14
      register: output

    - name: Gather a hcloud datacenter available server_types
      hetzner.hcloud.server_type_info:
        id: "{{ item }}"
      loop: "{{ output.hcloud_datacenter_info[0].server_types.available }}"
      register: available_server_types

    - name: Print a hcloud datacenter available server_types
      ansible.builtin.debug:
        var: available_server_types.results | map(attribute='hcloud_server_type_info')

返回值 

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

键	描述
hcloud_datacenter_info 复杂	数据中心信息作为列表返回：始终
city 字符串	位置的城市返回：始终示例： `"fsn1"`
description 字符串	数据中心的详细描述返回：始终示例： `"Falkenstein DC 8"`
id 整数	数据中心的数字标识符返回：始终示例： `1937415`
location 字符串	数据中心所在的位置名称返回：始终示例： `"fsn1"`
name 字符串	数据中心的名称返回：始终示例： `"fsn1-dc8"`
server_types 字典	数据中心可以处理的服务器类型返回：始终
available 列表 / 元素=整数	支持的服务器类型的 ID，并且数据中心有足够的剩余资源返回：始终示例： `[1, 2, 3]`
available_for_migration 列表 / 元素=整数	支持的服务器类型的 ID，并且数据中心有足够的剩余资源返回：始终示例： `[1, 2, 3]`
supported 列表 / 元素=整数	数据中心中支持的服务器类型的 ID 返回：始终示例： `[1, 2, 3]`

作者

Lukas Kaemmerling (@LKaemmerling)