Модуль hetzner.hcloud.datacenter_info — сбор информации о центрах обработки данных Hetzner Cloud.

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 6.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить ее, используйте: ansible-galaxy collection install hetzner.hcloud. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hetzner.hcloud.datacenter_info.

Краткое описание
Требования
Параметры
См. также
Примеры
Возвращаемые значения

Краткое описание

Сбор информации о центрах обработки данных Hetzner Cloud.

Псевдонимы: hcloud_datacenter_info

Требования

Для выполнения этого модуля на узле необходимы следующие компоненты.

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint string	Конечная точка API Hetzner Cloud. Это значение также можно задать с помощью переменной окружения `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner string	Конечная точка API Hetzner. Это значение также можно задать с помощью переменной окружения `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token string / обязательный	Токен для API Hetzner Cloud. Это значение также можно задать с помощью переменной окружения `HCLOUD_TOKEN`.
id integer	Идентификатор центра обработки данных, сведения о котором нужно получить. Модуль завершится с ошибкой, если указанный идентификатор недействителен.
name string	Название центра обработки данных, сведения о котором нужно получить.

См. также

Документация по API Hetzner: Полный справочник по API Hetzner.

Примеры

- 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 list / элементы=string	Сведения о центре обработки данных в виде списка Возвращается: всегда
city string	Город, в котором находится объект Возвращается: всегда Пример: `"fsn1"`
description string	Подробное описание центра обработки данных Возвращается: всегда Пример: `"Falkenstein DC 8"`
id integer	Числовой идентификатор центра обработки данных Возвращается: всегда Пример: `1937415`
location string	Название местоположения, где находится центр обработки данных Возвращается: всегда Пример: `"fsn1"`
name string	Название центра обработки данных Возвращается: всегда Пример: `"fsn1-dc8"`
server_types dictionary	Типы серверов, которые может обслуживать центр обработки данных. Устарело: значение `hcloud_datacenter_info[].server_types` устарело и будет удалено после 1 октября 2026 года. Вместо него используйте значение `hcloud_server_type_info[].locations`. См. https://docs.hetzner.cloud/changelog#2026-04-01-datacenter-deprecations. Возвращается: всегда
available list / элементы=integer	Идентификаторы поддерживаемых типов серверов, для которых в центре обработки данных осталось достаточно ресурсов Возвращается: всегда Пример: `[1, 2, 3]`
available_for_migration list / элементы=integer	Идентификаторы поддерживаемых типов серверов, для которых в центре обработки данных осталось достаточно ресурсов Возвращается: всегда Пример: `[1, 2, 3]`
supported list / элементы=integer	Идентификаторы типов серверов, поддерживаемых в центре обработки данных Возвращается: всегда Пример: `[1, 2, 3]`

Авторы

Lukas Kaemmerling (@LKaemmerling)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/hetzner/hcloud/datacenter_info_module.html