Модуль vultr.cloud.plan_metal_info — сбор информации о планах Vultr с выделенными физическими серверами
Примечание
Этот модуль входит в коллекцию vultr.cloud (версия 1.14.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install vultr.cloud.
Чтобы использовать её в плейбуке, укажите: vultr.cloud.plan_metal_info.
Добавлено в vultr.cloud 1.0.0
Краткое описание
- Сбор информации о планах, доступных для запуска серверов.
Параметры
Параметр | Комментарии |
|---|---|
api_endpoint строка | URL конечной точки API (без завершающей косой черты). Резервная переменная окружения По умолчанию: |
api_key строка / обязательный | Ключ API для Vultr API. Резервная переменная окружения |
api_results_per_page целое число добавлено в vultr.cloud 1.14.0 | При получении большого числа ресурсов задаёт, сколько результатов должно возвращаться за один вызов API. Этот параметр не определяет количество возвращаемых результатов: возвращаются все ресурсы с учётом остальных фильтров. Максимальное значение для Vultr API — 500. Резервная переменная окружения По умолчанию: |
api_retries целое число | Количество повторных попыток в случае, если Vultr API возвращает код ошибки HTTP, например: 429 Too Many Requests, 500 Internal Server Error, 504 Gateway Time-out. Резервная переменная окружения По умолчанию: |
api_retry_max_delay целое число | Экспоненциальная задержка между повторными попытками (в секундах) увеличивается до этого максимального значения. Резервная переменная окружения По умолчанию: |
api_timeout целое число | Тайм-аут HTTP-запросов к Vultr API. Резервная переменная окружения По умолчанию: |
validate_certs логическое значение | Проверять SSL-сертификаты Vultr API. Варианты:
|
Примечания
Примечание
- См. также документацию API: https://www.vultr.com/api/.
Примеры
- name: Gather Vultr bare metal plans information
vultr.cloud.plan_metal_info:
register: result
- name: Print the gathered information
ansible.builtin.debug:
var: result.vultr_plan_metal_info
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
vultr_api словарь | Ответ Vultr API с некоторыми дополнениями и изменениями. Возвращается: при успешном выполнении |
|
api_endpoint строка |
Конечная точка, используемая для запросов API. Возвращается: при успешном выполнении Пример: |
|
api_results_per_page целое число |
Количество результатов, возвращаемых за один вызов API. Возвращается: при успешном выполнении Пример: |
|
api_retries целое число |
Максимальное количество повторных попыток запросов API. Возвращается: при успешном выполнении Пример: |
|
api_retry_max_delay целое число |
Максимальная экспоненциальная задержка между повторными попытками в секундах. Возвращается: при успешном выполнении Пример: |
|
api_timeout целое число |
Тайм-аут, используемый для запросов API. Возвращается: при успешном выполнении Пример: |
vultr_plan_info список / элементы=строка | Ответ Vultr API в виде списка. Возвращается: при успешном выполнении |
|
bandwidth целое число |
Пропускная способность в МБ. Возвращается: при успешном выполнении Пример: |
|
cpu_count целое число |
Количество процессоров. Возвращается: при успешном выполнении Пример: |
|
cpu_model строка |
Модель процессора. Возвращается: при успешном выполнении Пример: |
|
cpu_threads целое число |
Количество потоков процессора. Возвращается: при успешном выполнении Пример: |
|
disk целое число |
Размер диска в ГБ. Возвращается: при успешном выполнении Пример: |
|
disk_count целое число |
Количество дисков. Возвращается: при успешном выполнении Пример: |
|
id строка |
Идентификатор плана. Возвращается: при успешном выполнении Пример: |
|
locations список / элементы=строка |
Список местоположений, в которых доступен план. Возвращается: при успешном выполнении Пример: |
|
monthly_cost целое число |
Ежемесячная стоимость в долларах США. Возвращается: при успешном выполнении Пример: |
|
ram целое число |
Объём оперативной памяти в МБ. Возвращается: при успешном выполнении Пример: |
|
type строка |
Тип плана. Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 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/vultr/cloud/plan_metal_info_module.html