digital_ocean_tag – Создание и удаление тегов для ресурсов DigitalOcean
Новая версия с 2.2.
Описание
- Создание и удаление тегов для ресурсов DigitalOcean.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| name - / обязательно | Имя тега. Допустимые символы для имён включают буквенно-цифровые символы, дефисы и подчёркивания. | |
| oauth_token строка | Токен DigitalOcean OAuth. Можно использовать несколько переменных окружения для указания этого значения. Например, - 'DO_API_TOKEN', 'DO_API_KEY', 'DO_OAUTH_TOKEN' и 'OAUTH_TOKEN' псевдонимы: api_token | |
| resource_id - | Идентификатор ресурса, над которым нужно произвести операцию. Тип данных resource_id изменён со значения целого числа на строку, начиная с версии 2.5. псевдонимы: droplet_id | |
| resource_type - |
| Тип ресурса, над которым нужно произвести операцию. В настоящее время поддерживается только добавление тегов к виртуальным машинам. |
| state - |
| Требуется ли наличие тега на ресурсе. |
| timeout целое число | Значение по умолчанию: 30 | Таймаут в секундах, используемый для опроса API DigitalOcean. |
| validate_certs логическое значение |
| Если установлено в no, сертификаты SSL не будут проверены.Это значение должно быть установлено в no только на сайтах под личным контролем, использующих самозаверяемые сертификаты. |
Примечания
Примечание
- Можно использовать две переменные среды: DO_API_KEY и DO_API_TOKEN. Обе они ссылаются на токен v2.
- Начиная с Ansible 2.0, используется версия 2 API DigitalOcean.
Примеры
- name: create a tag
digital_ocean_tag:
name: production
state: present
- name: tag a resource; creating the tag if it does not exist
digital_ocean_tag:
name: "{{ item }}"
resource_id: "73333005"
state: present
loop:
- staging
- dbserver
- name: untag a resource
digital_ocean_tag:
name: staging
resource_id: "73333005"
state: absent
# Deleting a tag also untags all the resources that have previously been
# tagged with it
- name: remove a tag
digital_ocean_tag:
name: dbserver
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| data словарь | успех и отсутствие ограничений по ресурсам | ресурс DigitalOcean Tag Пример: {'tag': {'name': 'awesome', 'resources': {'droplets': {'count': 0, 'last_tagged': None}}}} |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [предварительная версия]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Victor Volle (@kontrafiktion)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 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/digital_ocean_tag_module.html
