Spec-Zone.ru › Ansible

Модуль community.vmware.vmware_vm_info – Возвращение основных сведений о гостевой машине VMware

Примечание

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

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

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

Для использования в плейбуке укажите: community.vmware.vmware_vm_info.

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

Описание

  • Возвращение основных сведений о гостевой машине виртуальной машины vSphere или ESXi.

Параметры

Параметр

Комментарии

folder

string

Укажите расположение папки с виртуальными машинами, информацию о которых необходимо собрать.

Примеры:

folder: /ha-datacenter/vm

folder: ha-datacenter/vm

folder: /datacenter1/vm

folder: datacenter1/vm

folder: /datacenter1/vm/folder1

folder: datacenter1/vm/folder1

folder: /folder1/datacenter1/vm

folder: folder1/datacenter1/vm

folder: /folder1/datacenter1/vm/folder2

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.

show_allocated

boolean

Выделенное хранилище в байтах и память в МБ отображаются, если установлено значение True.

Варианты:

  • false ← (по умолчанию)
  • true

show_attribute

boolean

Атрибуты, относящиеся к гостевой ОС виртуальной машины, отображаются в информации только тогда, когда это установлено true.

Варианты:

  • false ← (по умолчанию)
  • true

show_cluster

boolean

добавлено в community.vmware 3.5.0

Теги кластера виртуальной машины отображаются, если установлено значение true.

Варианты:

  • false
  • true ← (по умолчанию)

show_datacenter

boolean

добавлено в community.vmware 3.5.0

Теги центра обработки данных виртуальной машины отображаются, если установлено значение true.

Варианты:

  • false
  • true ← (по умолчанию)

show_datastore

boolean

добавлено в community.vmware 3.5.0

Теги хранилища данных виртуальной машины отображаются, если установлено значение true.

Варианты:

  • false
  • true ← (по умолчанию)

show_esxi_hostname

boolean

добавлено в community.vmware 3.5.0

Теги хоста ESXi виртуальной машины отображаются, если установлено значение true.

Варианты:

  • false
  • true ← (по умолчанию)

show_folder

boolean

добавлено в community.vmware 3.7.0

Показать папки

Варианты:

  • false
  • true ← (по умолчанию)

show_mac_address

boolean

добавлено в community.vmware 3.5.0

Теги MAC-адреса виртуальной машины отображаются, если установлено значение true.

Варианты:

  • false
  • true ← (по умолчанию)

show_net

boolean

добавлено в community.vmware 3.5.0

Теги сети виртуальной машины отображаются, если установлено значение true.

Варианты:

  • false
  • true ← (по умолчанию)

show_resource_pool

boolean

added in community.vmware 3.5.0

Если установлено в true, отображается пул ресурсов виртуальной машины.

Варианты:

  • false
  • true ← (по умолчанию)

show_tag

boolean

Если установлено в true, отображаются метки, относящиеся к виртуальной машине.

Варианты:

  • false ← (по умолчанию)
  • true

username

aliases: admin, user

string

Имя пользователя сервера vCenter vSphere или ESXi.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_USER.

validate_certs

boolean

Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты не доверяются.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

vm_name

string

Имя виртуальной машины, для которой требуется получить информацию о конфигурации.

vm_type

string

Если установлено в vm, то информация собирается только для виртуальных машин.

Если установлено в template, то информация собирается только для шаблонов виртуальных машин.

Если установлено в all, то информация собирается для всех виртуальных машин и шаблонов виртуальных машин.

Варианты:

  • "all" ← (по умолчанию)
  • "vm"
  • "template"

Примечания

Примечание

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

Примеры

- name: Gather all registered virtual machines
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
  delegate_to: localhost
  register: vm_info

- debug:
    var: vm_info.virtual_machines

- name: Gather one specific VM
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
  delegate_to: localhost
  register: vm_info

- debug:
    var: vminfo.virtual_machines

- name: Gather only registered virtual machine templates
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_type: template
  delegate_to: localhost
  register: template_info

- debug:
    var: template_info.virtual_machines

- name: Gather only registered virtual machines
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_type: vm
  delegate_to: localhost
  register: vm_info

- debug:
    var: vm_info.virtual_machines

- name: Get UUID from given VM Name
  block:
    - name: Get virtual machine info
      community.vmware.vmware_vm_info:
        hostname: '{{ vcenter_hostname }}'
        username: '{{ vcenter_username }}'
        password: '{{ vcenter_password }}'
        folder: "/datacenter/vm/folder"
      delegate_to: localhost
      register: vm_info

    - debug:
        msg: "{{ item.uuid }}"
      with_items:
        - "{{ vm_info.virtual_machines | community.general.json_query(query) }}"
      vars:
        query: "[?guest_name=='DC0_H0_VM0']"

- name: Get Tags from given VM Name
  block:
    - name: Get virtual machine info
      community.vmware.vmware_vm_info:
        hostname: '{{ vcenter_hostname }}'
        username: '{{ vcenter_username }}'
        password: '{{ vcenter_password }}'
        folder: "/datacenter/vm/folder"
      delegate_to: localhost
      register: vm_info

    - debug:
        msg: "{{ item.tags }}"
      with_items:
        - "{{ vm_info.virtual_machines | community.general.json_query(query) }}"
      vars:
        query: "[?guest_name=='DC0_H0_VM0']"

- name: Gather all VMs from a specific folder
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    folder: "/Asia-Datacenter1/vm/prod"
  delegate_to: localhost
  register: vm_info

- name: Get datastore_url from given VM name
  block:
    - name: Get virtual machine info
      community.vmware.vmware_vm_info:
        hostname: '{{ vcenter_hostname }}'
        username: '{{ vcenter_username }}'
        password: '{{ vcenter_password }}'
      delegate_to: localhost
      register: vm_info

    - debug:
        msg: "{{ item.datastore_url }}"
      with_items:
        - "{{ vm_info.virtual_machines | community.general.json_query(query) }}"
      vars:
        query: "[?guest_name=='DC0_H0_VM0']"

Значения возврата

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

Ключ

Описание

virtual_machines

list / elements=string

список словарей виртуальных машин и их информации

Возвращаемое значение: success

Пример: [{"allocated": {"cpu": 2, "memory": 16, "storage": 500000000}, "attributes": {"job": "backup-prepare"}, "cluster": null, "datacenter": "Datacenter-1", "datastore_url": [{"name": "t880-o2g", "url": "/vmfs/volumes/e074264a-e5c82a58"}], "esxi_hostname": "10.76.33.226", "folder": "/Datacenter-1/vm", "guest_fullname": "Ubuntu Linux (64-bit)", "guest_name": "ubuntu_t", "ip_address": "", "mac_address": ["00:50:56:87:a5:9a"], "moid": "vm-24", "power_state": "poweredOff", "tags": [{"category_id": "urn:vmomi:InventoryServiceCategory:b316cc45-f1a9-4277-811d-56c7e7975203:GLOBAL", "category_name": "cat_0001", "description": "", "id": "urn:vmomi:InventoryServiceTag:43737ec0-b832-4abf-abb1-fd2448ce3b26:GLOBAL", "name": "tag_0001"}], "uuid": "4207072c-edd8-3bd5-64dc-903fd3a0db04", "vm_network": {"00:50:56:87:a5:9a": {"ipv4": ["10.76.33.228/24"], "ipv6": []}}}]

Авторы

  • Joseph Callen (@jcpowermac)
  • Abhijeet Kasurde (@Akasurde)
  • Fedor Vompe (@sumkincpp)

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

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (источники)

© 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_vm_info_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API