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 boolean |
| Если установлено в 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
with_items:
- 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.7/modules/digital_ocean_tag_module.html
