theforeman.foreman.host_power – Управление состоянием питания хостов

Примечание

Этот плагин входит в коллекцию theforeman.foreman (версия 1.5.1).

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

Чтобы использовать его в книге задач, укажите: theforeman.foreman.host_power.

Введено в версии 1.0.0: of theforeman.foreman

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

Описание

Управление состоянием питания хоста
Эта бета-версия может запускать и останавливать существующий хост foreman и запрашивать текущее состояние питания.

Требования

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

requests

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
name строка / обязательно		Имя (FQDN) хоста псевдонимы: имя хоста
password строка / обязательно		Пароль пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `FOREMAN_PASSWORD`.
server_url строка / обязательно		URL сервера Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `FOREMAN_SERVER_URL`.
state строка	Варианты: on start off stop soft reboot cycle reset state ← status	Желаемое состояние питания
username строка / обязательно		Имя пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `FOREMAN_USERNAME`.
validate_certs boolean	Варианты: no yes ←	Требовать проверку сертификатов TLS сервера Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `FOREMAN_VALIDATE_CERTS`.

Примеры

- name: "Switch a host on"
  theforeman.foreman.host_power:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    hostname: "test-host.domain.test"
    state: on

- name: "Switch a host off"
  theforeman.foreman.host_power:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    hostname: "test-host.domain.test"
    state: off

- name: "Query host power state"
  theforeman.foreman.host_power:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    hostname: "test-host.domain.test"
    state: state
    register: result
- debug:
    msg: "Host power state is {{ result.power_state }}"

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

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

Ключ	Возвращаемое значение	Описание
power_state строка	всегда	текущее состояние питания хоста Пример: off

Авторы

Bernhard Hopfenmueller (@Fobhep) ATIX AG
Baptiste Agasse (@bagasse)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/theforeman/foreman/host_power_module.html