Модуль community.vmware.vmware_target_canonical_info – Возвращение канонического (NAA) с хост-системы ESXi

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.vmware.

Для использования в playbook, укажите: community.vmware.vmware_target_canonical_info.

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

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

Этот модуль может использоваться для сбора информации о каноническом (NAA) с хоста ESXi на основе идентификатора SCSI-цели.

Параметры

Параметр	Комментарии
cluster_name string	Имя кластера. Возвращается информация обо всех SCSI-устройствах для всех хост-систем в указанном кластере. Этот параметр обязателен, если не указан `esxi_hostname`.
esxi_hostname string	Имя хост-системы ESXi. Возвращается информация обо всех SCSI-устройствах для указанной хост-системы ESXi. Этот параметр обязателен, если не указан `cluster_name`.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_HOST`.
password aliases: pass, pwd string	Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PORT`. По умолчанию: `443`
proxy_host string	Адрес прокси-сервера, который будет получать все HTTPS-запросы и пересылать их. Формат – имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PROXY_HOST`.
proxy_port integer	Порт HTTP-прокси, который будет получать все HTTPS-запросы и пересылать их. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PROXY_PORT`.
target_id integer	Идентификатор цели на основе порядка SCSI-устройства. Начиная с версии 2.6, этот параметр является необязательным.
username aliases: admin, user string	Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_USER`.
validate_certs boolean	Разрешает подключение, когда SSL-сертификаты недействительны. Установите в `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Все модули требуют API-доступ на запись и поэтому не поддерживаются на бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.

Примеры

- name: Get Canonical name of particular target on particular ESXi host system
  community.vmware.vmware_target_canonical_info:
    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_info:
    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_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
  delegate_to: localhost

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

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

Ключ	Описание
canonical string	Метаданные об устройстве SCSI Target Возвращается: если указана хост-система и идентификатор цели Пример: `"mpx.vmhba0:C0:T0:L0"`
scsi_tgt_info dictionary	Метаданные обо всех устройствах SCSI Target Возвращается: если указана хост-система или кластер Пример: {"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"}}}

Ключ

Описание

canonical

string

Метаданные об устройстве SCSI Target

Возвращается: если указана хост-система и идентификатор цели

Пример: "mpx.vmhba0:C0:T0:L0"

scsi_tgt_info

dictionary

Метаданные обо всех устройствах SCSI Target

Возвращается: если указана хост-система или кластер

Пример: {"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"}}}

Авторы

Joseph Callen (@jcpowermac)
Abhijeet Kasurde (@Akasurde)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_target_canonical_info_module.html