Модуль vultr.cloud.os_info — Получение информации об операционных системах Vultr

Примечание

Этот модуль входит в коллекцию vultr.cloud (версия 1.13.0).

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

Для установки используйте: ansible-galaxy collection install vultr.cloud.

Для использования в книге задач укажите: vultr.cloud.os_info.

Новая функция в vultr.cloud 1.0.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Получение информации об операционных системах, доступных для загрузки серверов.

Параметры

Параметр	Комментарии
api_endpoint строка	URL конечной точки API (без заключительного слеша). Используется переменная окружения `VULTR_API_ENDPOINT`. Значение по умолчанию: `"https://api.vultr.com/v2"`
api_key строка / обязательно	Ключ API для Vultr API. Используется переменная окружения `VULTR_API_KEY`.
api_retries целое число	Количество попыток при получении кода HTTP-ошибки от Vultr API, таких как - 429 Слишком много запросов - 500 Внутренняя ошибка сервера - 504 Истечение времени ожидания шлюза Используется переменная окружения `VULTR_API_RETRIES`. Значение по умолчанию: `5`
api_retry_max_delay целое число	Максимальная задержка повторной попытки в секундах, экспоненциально возрастает до этого значения. Используется переменная окружения `VULTR_API_RETRY_MAX_DELAY`. Значение по умолчанию: `12`
api_timeout целое число	Таймаут HTTP-запроса к Vultr API. Используется переменная окружения `VULTR_API_TIMEOUT`. Значение по умолчанию: `180`
validate_certs логическое значение	Проверять SSL-сертификаты Vultr API. Доступные значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

Также обратитесь к документации API по адресу https://www.vultr.com/api/.

Примеры

- name: Get Vultr OSes infos
  vultr.cloud.os_info:
  register: results

- name: Print the gathered infos
  ansible.builtin.debug:
    var: results.vultr_os_info

END_OF_DOCUMENT_MARKER

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

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

Ключ	Описание
vultr_api словарь	Ответ от API Vultr с несколькими добавленными/измененными элементами. Возвращено: успех
api_endpoint строка	Конечная точка, используемая для запросов API. Возвращено: успех Пример: `"https://api.vultr.com/v2"`
api_retries целое число	Максимальное количество попыток повторных запросов API. Возвращено: успех Пример: `5`
api_retry_max_delay целое число	Задержка экспоненциального отката в секундах между повторными попытками до этой максимальной задержки. Возвращено: успех Пример: `12`
api_timeout целое число	Таймаут, используемый для запросов API. Возвращено: успех Пример: `60`
vultr_os_info список / элементы=строка	Ответ от API Vultr в виде списка. Возвращено: доступно
arch строка	Архитектура ОС. Возвращено: успех Пример: `"x64"`
family строка	Семейство ОС. Возвращено: успех Пример: `"openbsd"`
name строка	Название ОС. Возвращено: успех Пример: `"OpenBSD 6 x64"`
windows булево	ОС — это MS Windows. Возвращено: успех

Авторы

Yanis Guenane (@Spredzy)
René Moser (@resmo)

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

© 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/vultr/cloud/os_info_module.html