Spec-Zone.ru › Ansible

Модуль community.hrobot.server — обновление информации о сервере

Примечание

Этот модуль входит в коллекцию community.hrobot (версия 2.7.2).

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

Чтобы установить её, используйте: ansible-galaxy collection install community.hrobot.

Чтобы использовать её в плейбуке, укажите: community.hrobot.server.

Добавлено в community.hrobot 1.2.0

  • Краткое описание
  • Параметры
  • Атрибуты
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Позволяет обновлять информацию о сервере.
  • В настоящее время API поддерживает только обновление имени сервера.

Параметры

Параметр

Комментарии

hetzner_password

строка / обязательный

Пароль пользователя веб-службы Robot.

hetzner_user

строка / обязательный

Имя пользователя веб-службы Robot.

rate_limit_retry_timeout

целое число

добавлено в community.hrobot 2.1.0

Время ожидания (в секундах) при получении ошибок превышения ограничения частоты запросов.

Укажите 0, чтобы не выполнять повторные попытки.

Укажите отрицательное значение, например -1, чтобы повторять попытки бесконечно.

По умолчанию: -1

server_name

строка

Имя сервера.

Если этот параметр не указан, имя не будет изменено.

server_number

целое число / обязательный

Номер обновляемого сервера.

Атрибуты

Атрибут

Поддержка

Описание

action_group

Группа действий: community.hrobot.robot

добавлено в community.hrobot 1.6.0

Используйте group/community.hrobot.robot в module_defaults, чтобы задать значения по умолчанию для этого модуля.

check_mode

Поддержка: полная

Может работать в режиме check_mode и возвращать прогноз изменения состояния, не изменяя целевой объект.

diff_mode

Поддержка: нет

В режиме сравнения изменений возвращает сведения об изменениях (или о том, что, возможно, необходимо изменить в check_mode).

idempotent

Поддержка: полная

При повторном запуске с теми же аргументами вне режима проверки второй запуск указывает на отсутствие изменений.

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

Примеры

---
- name: Set server's name to foo.example.com
  community.hrobot.server:
    hetzner_user: foo
    hetzner_password: bar
    server_number: 123
    server_name: foo.example.com

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

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

Ключ

Описание

server

словарь

Информация о сервере.

Возвращается: при успешном выполнении

cancelled

логическое значение

Отменено ли обслуживание сервера.

Возвращается: при успешном выполнении

Пример: false

cpanel

логическое значение

Признак доступности установки cPanel.

Возвращается: при успешном выполнении

Пример: true

dc

строка

Центр обработки данных, в котором находится сервер.

Возвращается: при успешном выполнении

Пример: "NBG1-DC1"

hot_swap

логическое значение

Признак доступности горячей замены.

Возвращается: при успешном выполнении

Пример: true

ip

список / элементы=строка

Список назначенных отдельных IP-адресов.

Возвращается: при успешном выполнении

Пример: ["123.123.123.123"]

linked_storagebox

целое число

Идентификатор связанного Storage Box.

Возвращается: при успешном выполнении

Пример: 12345

paid_until

строка

Дата, до которой оплачено обслуживание сервера.

Возвращается: при успешном выполнении

Пример: "2018-08-04"

plesk

логическое значение

Признак доступности установки Plesk.

Возвращается: при успешном выполнении

Пример: true

product

строка

Название модели сервера.

Возвращается: при успешном выполнении

Пример: "EQ 8"

rescue

логическое значение

Доступна ли система восстановления.

Возвращается: при успешном выполнении

Пример: false

reset

логическое значение

Можно ли автоматически перезагрузить сервер.

Возвращается: при успешном выполнении

Пример: true

server_ip

строка

Основной IP-адрес сервера.

Возвращается: при успешном выполнении

Пример: "123.123.123.123"

server_ipv6_net

строка

Основной сетевой IPv6-адрес сервера.

Возвращается: при успешном выполнении

Пример: "2a01:f48:111:4221::"

server_name

строка

Заданное пользователем имя сервера.

Возвращается: при успешном выполнении

Пример: "server1"

server_number

целое число

Числовой идентификатор сервера.

Возвращается: при успешном выполнении

Пример: 321

status

строка

Состояние сервера.

Возвращается: при успешном выполнении

Возможные значения:

  • "ready"
  • "in process"

Пример: "ready"

subnet

список / элементы=словарь

Список назначенных подсетей.

Возвращается: при успешном выполнении

Пример: [{"ip": "2a01:4f8:111:4221::", "mask": 64}]

ip

строка

Первый IP-адрес в подсети.

Возвращается: при успешном выполнении

Пример: "2a01:4f8:111:4221::"

mask

строка

Длина маски в битах.

Возвращается: при успешном выполнении

Пример: "64"

traffic

строка

Квота бесплатного трафика.

unlimited при неограниченном трафике.

Возвращается: при успешном выполнении

Пример: "5 TB"

vnc

логическое значение

Признак доступности установки VNC.

Возвращается: при успешном выполнении

Пример: true

windows

логическое значение

Признак доступности установки Windows.

Возвращается: при успешном выполнении

Пример: true

wol

логическое значение

Признак доступности Wake-on-LAN.

Возвращается: при успешном выполнении

Пример: true

Авторы

  • Felix Fontein (@felixfontein)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Запросить помощь (Hetzner Robot)
  • Сообщить об ошибке
  • Предложить функцию
  • Общение

© 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/community/hrobot/server_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API