linode_v4 – Управление экземплярами на облаке Linode

Новое в версии 2.8.

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

Описание

Управление экземплярами на облаке Linode.

Требования

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

python >= 2.7
linode_api4 >= 2.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
access_token - / обязательно		Токен доступа к API v4 Linode. Также может быть указан через переменную среды `LINODE_ACCESS_TOKEN`. См. https://developers.linode.com/api/v4#section/Access-and-Authentication.
authorized_keys список		Список частей открытых ключей SSH для развертывания для пользователя root.
group строка		Группа, под которой должен быть помечен экземпляр. Обратите внимание, что маркировка групп устарела, но все еще поддерживается. Рекомендуемый способ маркировки экземпляров — использование тегов.
image строка		Изображение экземпляра. Этот параметр требуется только при создании экземпляров Linode. См. https://developers.linode.com/api/v4#tag/Images.
label строка / обязательно		Метка экземпляра. Эта метка используется в качестве основного определяющего фактора для идемпотентности модуля, поэтому она обязательна.
region строка		Регион экземпляра. Этот параметр требуется только при создании экземпляров Linode. См. https://developers.linode.com/api/v4#tag/Regions.
root_pass строка		Пароль для пользователя root. Если не указан, будет сгенерирован. Сгенерированный пароль будет доступен в JSON-ответе об успешном выполнении задачи.
state строка / обязательно	Варианты: present absent	Желаемое состояние экземпляра.
tags список		Теги, под которыми должен быть помечен экземпляр. См. https://developers.linode.com/api/v4#tag/Tags.
type строка		Тип экземпляра. Этот параметр требуется только при создании экземпляров Linode. См. https://developers.linode.com/api/v4#tag/Linode-Types.

Примечания

Примечание

В настоящее время изменение размера Linode не реализовано. Этот модуль со временем заменит текущий модуль Linode, который использует устаревшие API-связки на стороне Linode.

Примеры

- name: Create a new Linode.
  linode_v4:
    label: new-linode
    type: g6-nanode-1
    region: eu-west
    image: linode/debian9
    root_pass: passw0rd
    authorized_keys:
      - "ssh-rsa ..."
    state: present

- name: Delete that new Linode.
  linode_v4:
    label: new-linode
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
instance словарь	Всегда.	Описание экземпляра в формате JSON. Пример: {'root_pass': 'foobar', 'alerts': {'cpu': 90, 'io': 10000, 'network_in': 10, 'network_out': 10, 'transfer_quota': 80}, 'backups': {'enabled': False, 'schedule': {'day': None, 'window': None}}, 'created': '2018-09-26T08:12:33', 'group': 'Группа Foobar', 'hypervisor': 'kvm', 'id': 10480444, 'image': 'linode/centos7', 'ipv4': ['130.132.285.233'], 'ipv6': '2a82:7e00::h03c:46ff:fe04:5cd2/64', 'label': 'lin-foo', 'region': 'eu-west', 'specs': {'disk': 25600, 'memory': 1024, 'transfer': 1000, 'vcpus': 1}, 'status': 'запущен', 'tags': [], 'type': 'g6-nanode-1', 'updated': '2018-09-26T10:10:14', 'watchdog_enabled': True}

Статус

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

Авторы

Luke Murphy (@lwm)

Подсказка

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

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