Модуль community.vmware.vmware_category — управление категориями VMware

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.vmware. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.vmware.vmware_category.

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

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

Этот модуль можно использовать для создания, удаления и обновления категорий VMware.
Функция тегов появилась в vSphere 6, поэтому этот модуль не поддерживается в более ранних версиях vSphere.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

vSphere Automation SDK

Параметры

Параметр	Комментарии
associable_object_types list / elements=string	Список типов объектов, которые можно связать с указанной категорией. Варианты: `"All objects"` `"Cluster"` `"Content Library"` `"Datacenter"` `"Datastore"` `"Datastore Cluster"` `"Distributed Port Group"` `"Distributed Switch"` `"Folder"` `"Host"` `"Library item"` `"Network"` `"Host Network"` `"Opaque Network"` `"Resource Pool"` `"vApp"` `"Virtual Machine"`
category_cardinality string	Мощность категории. Этот параметр игнорируется при обновлении существующей категории. `single` означает, что объекту можно назначить только один из тегов этой категории. Например, если `category_name=Operating System`, то тегами этой категории будут «Windows», «Linux» и так далее. В этом случае объекту VM можно назначить только один из этих тегов, поэтому мощность связанной категории здесь равна `single`. `multiple` означает, что объекту можно назначить несколько тегов этой категории. Например, если `category_name=Server`, то тегами этой категории будут «AppServer», «DatabaseServer» и так далее. В этом случае объекту VM можно назначить несколько из перечисленных тегов, поэтому мощность связанной категории здесь равна `multiple`. Варианты: `"multiple"` ← (по умолчанию) `"single"`
category_description string	Описание категории. Этот параметр обязателен, если `state=present`. Этот параметр игнорируется, если `state=absent`. По умолчанию: `""`
category_name string / обязательный	Имя категории, которой нужно управлять.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`.
new_category_name string	Новое имя существующей категории. Это значение используется при обновлении существующей категории.
password псевдонимы: pass, pwd string	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host string	Адрес прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Укажите имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port integer	Порт HTTP-прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
proxy_protocol псевдонимы: protocol string	Используемый протокол подключения к прокси-серверу. Этот параметр используется, если правильный протокол прокси-сервера невозможно определить автоматически. Варианты: `"http"` `"https"` ← (по умолчанию)
state string	Состояние категории. Если установлено значение `present` и категория не существует, она будет создана. Если установлено значение `present` и категория существует, она будет обновлена. Если установлено значение `absent` и категория существует, она будет удалена. Если установлено значение `absent` и категория не существует, никаких действий не выполняется. При обновлении категории можно изменить только имя и описание. Варианты: `"present"` ← (по умолчанию) `"absent"`
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
validate_certs boolean	Разрешает подключение, если SSL-сертификаты недействительны. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Для всех модулей требуется доступ на запись через API, поэтому они не поддерживаются при использовании бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не использует системное хранилище сертификатов. Указать хранилище сертификатов можно с помощью переменной среды REQUESTS_CA_BUNDLE. Обратите внимание, что в некоторых случаях при установленной переменной параметр ‘validate_certs’ со значением ‘false’ может быть проигнорирован. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- name: Create a category
  community.vmware.vmware_category:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    category_name: Sample_Cat_0001
    category_description: Sample Description
    category_cardinality: 'multiple'
    state: present

- name: Rename category
  community.vmware.vmware_category:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    category_name: Sample_Category_0001
    new_category_name: Sample_Category_0002
    state: present

- name: Update category description
  community.vmware.vmware_category:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    category_name: Sample_Category_0001
    category_description: Some fancy description
    state: present

- name: Delete category
  community.vmware.vmware_category:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    category_name: Sample_Category_0002
    state: absent

- name: Create category with 2 associable object types
  community.vmware.vmware_category:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    category_name: 'Sample_Category_0003'
    category_description: 'sample description'
    associable_object_types:
    - Datastore
    - Cluster
    state: present

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

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

Ключ	Описание
category_results dictionary	Словарь метаданных категории Возвращается: при успешном выполнении Пример: `{"category_id": "urn:vmomi:InventoryServiceCategory:d7120bda-9fa5-4f92-9d71-aa1acff2e5a8:GLOBAL", "msg": "Category NewCat_0001 updated."}`

Авторы

Abhijeet Kasurde (@Akasurde)

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

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