vultr_server_facts – Сбор фактов о доступных серверах Vultr

Введено в версии 2.7.

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

Обзор

Сбор фактов о доступных серверах.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_account строка	Значение по умолчанию: "default"	Имя раздела ini в файле `vultr.ini`. Переменная среды `VULTR_API_ACCOUNT` используется в качестве значения по умолчанию, если определена.
api_endpoint строка		URL конечной точки API (без конечной косой черты). Переменная среды `VULTR_API_ENDPOINT` используется в качестве значения по умолчанию, если определена. Значение по умолчанию — https://api.vultr.com, если не указано.
api_key строка		Ключ API для Vultr API. Переменная среды `VULTR_API_KEY` используется в качестве значения по умолчанию, если определена.
api_retries целое число		Количество попыток повторного подключения в случае, если Vultr API возвращает код HTTP 503. Переменная среды `VULTR_API_RETRIES` используется в качестве значения по умолчанию, если определена. Значение по умолчанию — 5 попыток, если не указано.
api_timeout целое число		Таймаут HTTP-соединения с Vultr API. Переменная среды `VULTR_API_TIMEOUT` используется в качестве значения по умолчанию, если определена. Значение по умолчанию — 60 секунд, если не указано.
validate_certs логическое значение	Варианты: нет да ←	Проверять SSL-сертификаты Vultr API.

Примечания

Примечание

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

Примеры

- name: Gather Vultr servers facts
  local_action:
    module: vultr_server_facts

- name: Print the gathered facts
  debug:
    var: ansible_facts.vultr_server_facts

Возвращаемые значения

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

Ключ		Возвращаемое	Описание
vultr_api сложное		успех	Ответ от Vultr API с некоторыми дополнениями/изменениями
	api_account строка	успех	Аккаунт, используемый в файле ini для выбора ключа Пример: default
	api_endpoint строка	успех	Конечная точка, используемая для запросов API Пример: https://api.vultr.com
	api_retries целое число	успех	Максимальное количество попыток повторного подключения к API Пример: 5
	api_timeout целое число	успех	Таймаут, используемый для запросов API Пример: 60
vultr_server_facts сложное		успех	Ответ от Vultr API Пример: {'vultr_server_facts': [{'allowed_bandwidth_gb': 1000, 'auto_backup_enabled': False, 'application': None, 'cost_per_month': 5.0, 'current_bandwidth_gb': 0, 'date_created': '2018-07-19 08:23:03', 'default_password': 'p4ssw0rd!', 'disk': 'Virtual 25 GB', 'firewallgroup': None, 'id': 17241096, 'internal_ip': '', 'kvm_url': 'https://my.vultr.com/subs/vps/novnc/api.php?data=OFB...', 'name': 'ansibletest', 'os': 'CentOS 7 x64', 'pending_charges': 0.01, 'plan': '1024 MB RAM,25 GB SSD,1.00 TB BW', 'power_status': 'running', 'ram': '1024 MB', 'region': 'Амстердам', 'server_state': 'ok', 'status': 'active', 'tag': '', 'v4_gateway': '105.178.158.1', 'v4_main_ip': '105.178.158.181', 'v4_netmask': '255.255.254.0', 'v6_main_ip': '', 'v6_network': '', 'v6_network_size': '', 'v6_networks': [], 'vcpu_count': 1}]}

Статус

Гарантия обратной совместимости этого модуля не предоставляется. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Yanis Guenane (@Spredzy)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vultr_server_facts_module.html