community.vmware.vmware_target_canonical_facts – Возврат канонического (NAA) с системы ESXi хоста
Примечание
Этот плагин является частью коллекции community.vmware (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install community.vmware
Для использования в плейбуке укажите: community.vmware.vmware_target_canonical_facts
УСТЕРЕГШЕЕ
- Удалено в
-
главной версии после 2021-12-01
- Почему
-
Устарело в пользу модуля community.vmware.vmware_target_canonical_info.
- Альтернатива
-
Используйте community.vmware.vmware_target_canonical_info вместо этого.
Описание
- Этот модуль может использоваться для сбора фактов о каноническом (NAA) с хоста ESXi на основе идентификатора целевого SCSI.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- Проверено на vSphere 5.5 и 6.5
- Установлен PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster_name строка | Имя кластера. Возвращаются данные обо всех устройствах SCSI для всех систем хостов в заданном кластере. Этот параметр необходим, если esxi_hostname не указан. | |
| esxi_hostname строка | Имя системы хоста ESXi. Возвращаются данные обо всех устройствах SCSI для данной системы хоста ESXi. Этот параметр необходим, если cluster_name не указан. | |
| hostname строка | Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него используется значение переменной окружения VMWARE_HOSTПоддержка переменных окружения добавлена в Ansible 2.6. | |
| password строка | Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него используется значение переменной окружения VMWARE_PASSWORDПоддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число | По умолчанию: 443 | Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него используется значение переменной окружения VMWARE_PORTПоддержка переменных окружения добавлена в Ansible 2.6. |
| proxy_host строка | Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, вместо него используется значение переменной окружения VMWARE_PROXY_HOSTЭта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12 | |
| proxy_port целое число | Порт HTTP-прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, вместо него используется значение переменной окружения VMWARE_PROXY_PORT | |
| target_id целое число | Идентификатор целевого устройства на основе порядка устройства scsi. Начиная с версии 2.6, этот параметр является необязательным. | |
| username строка | Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него используется значение переменной окружения VMWARE_USERПоддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user | |
| validate_certs логическое значение |
| Позволяет подключиться, когда сертификаты SSL недействительны. Установите в false, когда сертификаты ненадёжны.Если значение не указано в задаче, вместо него используется значение переменной окружения VMWARE_VALIDATE_CERTSПоддержка переменных окружения добавлена в Ansible 2.6. Если установлено true, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примеры
- name: Get Canonical name of particular target on particular ESXi host system
community.vmware.vmware_target_canonical_facts:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
target_id: 7
esxi_hostname: esxi_hostname
delegate_to: localhost
- name: Get Canonical name of all target on particular ESXi host system
community.vmware.vmware_target_canonical_facts:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
delegate_to: localhost
- name: Get Canonical name of all ESXi hostname on particular Cluster
community.vmware.vmware_target_canonical_facts:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
cluster_name: '{{ cluster_name }}'
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| canonical строка | если система хоста и идентификатор целевого устройства указаны | метаданные о целевом устройстве SCSI Пример: mpx.vmhba0:C0:T0:L0 |
| scsi_tgt_facts словарь | если указана система хоста или кластер | метаданные обо всех целевых устройствах SCSI Пример: {'DC0_C0_H0': {'scsilun_canonical': {'key-vim.host.ScsiDisk-0000000000766d686261303a303a30': 'mpx.vmhba0:C0:T0:L0', 'key-vim.host.ScsiLun-0005000000766d686261313a303a30': 'mpx.vmhba1:C0:T0:L0'}, 'target_lun_uuid': {'0': 'key-vim.host.ScsiDisk-0000000000766d686261303a303a30'}}, 'DC0_C0_H1': {'scsilun_canonical': {'key-vim.host.ScsiDisk-0000000000766d686261303a303a30': 'mpx.vmhba0:C0:T0:L0', 'key-vim.host.ScsiLun-0005000000766d686261313a303a30': 'mpx.vmhba1:C0:T0:L0'}, 'target_lun_uuid': {'0': 'key-vim.host.ScsiDisk-0000000000766d686261303a303a30'}}} |
Статус
- Этот модуль будет удален в основной версии после 2021-12-01. [устаревший]
- Дополнительную информацию см. в разделе УСТЕРЕГШЕЕ.
Авторы
- Joseph Callen (@jcpowermac)
- 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.10/collections/community/vmware/vmware_target_canonical_facts_module.html