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

Примечание

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

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

Для использования в книге задач укажите: theforeman.foreman.location

Новое в версии 1.0.0: of theforeman.foreman

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

Обзор

Управление местоположениями

Требования

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

requests

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
name строка / обязательно			Имя местоположения
organizations список / элементы=строка			Список организаций, к которым должно быть назначено местоположение
parameters список / элементы=словарь			Параметры узла, специфичные для области сущности
	name строка / обязательно		Имя параметра
	parameter_type строка	Варианты: строка ← boolean integer real array hash yaml json	Тип параметра
	value сырой / обязательно		Значение параметра
parent строка			Заголовок родительского местоположения для вложенности
password строка / обязательно			Пароль пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды `FOREMAN_PASSWORD`.
server_url строка / обязательно			URL сервера Foreman. Если значение не указано в задаче, используется значение переменной среды `FOREMAN_SERVER_URL`.
state строка		Варианты: present ← absent	Состояние сущности
username строка / обязательно			Имя пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды `FOREMAN_USERNAME`.
validate_certs boolean		Варианты: no yes ←	Выполнять ли проверку сертификатов TLS сервера Foreman. Если значение не указано в задаче, используется значение переменной среды `FOREMAN_VALIDATE_CERTS`.

Примеры

# Create a simple location
- name: "Create CI Location"
  theforeman.foreman.location:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "My Cool New Location"
    organizations:
      - "Default Organization"
    state: present

# Create a nested location
- name: "Create Nested CI Location"
  theforeman.foreman.location:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "My Nested location"
    parent: "My Cool New Location"
    state: present

# Create a new nested location with parent included in name
- name: "Create New Nested Location"
  theforeman.foreman.location:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "My Cool New Location/New nested location"
    state: present

# Move a nested location to another parent
- name: "Create Nested CI Location"
  theforeman.foreman.location:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "My Cool New Location/New nested location"
    parent: "My Cool New Location/My Nested location"
    state: present

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

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

Ключ		Возвращаемое значение	Описание
entity словарь		успешно	Конечное состояние затронутых сущностей, сгруппированных по их типу.
	locations список / элементы=словарь	успешно	Список местоположений.

Авторы

Matthias M Dellweg (@mdellweg) ATIX AG

© 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/location_module.html