vmware_category_facts – Сбор фактов о категориях тегов VMware
Новая в версии 2.7.
Краткое описание
- Этот модуль может использоваться для сбора фактов о категориях тегов VMware.
- Функция тегов была представлена в vSphere версии 6, поэтому этот модуль не поддерживается в более ранних версиях vSphere.
- Все переменные и имена объектов VMware чувствительны к регистру.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
- vSphere Automation SDK
- vCloud Suite SDK
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| hostname строка | Имя хоста или IP-адрес сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST. | |
| password строка | Пароль сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD.Псевдонимы: pass, pwd | |
| protocol строка |
| Протокол подключения. |
| username строка | Имя пользователя сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER.Псевдонимы: admin, user | |
| validate_certs логическое значение |
| Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в значение no, когда сертификаты не доверяются.Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS. |
Примечания
Примечание
- Тестировалось на vSphere 6.5
Примеры
- name: Gather facts about tag categories
vmware_category_facts:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
delegate_to: localhost
register: all_tag_category_facts
- name: Gather category id from given tag category
vmware_category_facts:
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
delegate_to: localhost
register: tag_category_results
- set_fact:
category_id: "{{ item.category_id }}"
loop: "{{ tag_category_results.tag_category_facts|json_query(query) }}"
vars:
query: "[?category_name==`Category0001`]"
- debug: var=category_id
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| tag_category_facts список | всегда | метаданные категорий тегов Пример: [{'category_associable_types': [], 'category_cardinality': 'MULTIPLE', 'category_description': 'отличное описание', 'category_id': 'urn:vmomi:InventoryServiceCategory:e785088d-6981-4b1c-9fb8-1100c3e1f742:GLOBAL', 'category_name': 'Category0001', 'category_used_by': []}, {'category_associable_types': ['VirtualMachine'], 'category_cardinality': 'SINGLE', 'category_description': 'еще одно отличное описание', 'category_id': 'urn:vmomi:InventoryServiceCategory:ae5b7c6c-e622-4671-9b96-76e93adb70f2:GLOBAL', 'category_name': 'template_tag', 'category_used_by': []}] |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Abhijeet Kasurde (@Akasurde)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/vmware_category_facts_module.html
