Модуль hetzner.hcloud.datacenter_info – Сбор информации о дата-центрах Hetzner Cloud.

Примечание

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

У вас, возможно, уже установлена эта коллекция, если вы используете пакет 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 aliases: endpoint строка	API-конечная точка для Hetzner Cloud. Вы также можете установить этот параметр, используя переменную среды `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_token строка / обязательно	API-токен для Hetzner Cloud. Вы также можете установить этот параметр, используя переменную среды `HCLOUD_TOKEN`.
id целое число	Идентификатор дата-центра, который вы хотите получить. Модуль завершится ошибкой, если предоставленный идентификатор неверен.
name строка	Имя дата-центра, который вы хотите получить.

См. также

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

Примеры

- 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')

END_OF_DOCUMENT_MARKER

Значения возврата

Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:

Ключ	Описание
hcloud_datacenter_info сложный	Информация о дата-центре в виде списка Возвращается: всегда
city строка	Город расположения Возвращается: всегда Пример: `"fsn1"`
description строка	Подробное описание дата-центра Возвращается: всегда Пример: `"Falkenstein DC 8"`
id целое число	Числовой идентификатор дата-центра Возвращается: всегда Пример: `1937415`
location строка	Название местоположения, где расположен дата-центр Возвращается: всегда Пример: `"fsn1"`
name строка	Название дата-центра Возвращается: всегда Пример: `"fsn1-dc8"`
server_types словарь	Типы серверов, которые поддерживает дата-центр Возвращается: всегда
available список / элементы=целое число	Идентификаторы типов серверов, которые поддерживаются и для которых в дата-центре достаточно ресурсов Возвращается: всегда Пример: `[1, 2, 3]`
available_for_migration список / элементы=целое число	Идентификаторы типов серверов, которые поддерживаются и для которых в дата-центре достаточно ресурсов Возвращается: всегда Пример: `[1, 2, 3]`
supported список / элементы=целое число	Идентификаторы типов серверов, которые поддерживаются в дата-центре Возвращается: всегда Пример: `[1, 2, 3]`

Авторы

Lukas Kaemmerling (@LKaemmerling)

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

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