Модуль community.vmware.vmware_vmotion — перемещение виртуальной машины с помощью vMotion и/или её vmdk с помощью Storage vMotion.

Примечание

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

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

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

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

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

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

С помощью VMware vCenter переместите виртуальную машину на другой хост с помощью vMotion и/или её vmdk в другое хранилище данных с помощью Storage vMotion.

Параметры

Параметр	Комментарии
destination_cluster string	Имя целевого кластера, в котором должна работать виртуальная машина. Работает только в том случае, если для этого кластера включён DRS.
destination_datacenter string	Имя целого дата-центра, в котором находится хранилище данных. Необязательный параметр, необходимый только в том случае, если хранилища данных являются общими для нескольких дата-центров.
destination_datastore псевдонимы: datastore string	Имя целевого хранилища данных, в которое следует переместить vmdk виртуальной машины.
destination_datastore_cluster string	Имя целевого кластера хранилищ данных (пула хранилищ), в который следует переместить vmdk виртуальной машины. Работает только в том случае, если для кластера, в котором работает или должна работать виртуальная машина, включён DRS.
destination_host псевдонимы: destination string	Имя целевого хоста, на котором должна работать виртуальная машина. Начиная с версии 2.6 этот параметр не является обязательным, в отличие от предыдущих версий.
destination_resourcepool псевдонимы: resource_pool string	Имя целевого пула ресурсов, в котором должна работать виртуальная машина. Пул ресурсов необходимо указать, если vmotion выполняется между хостами, входящими в разные кластеры или дата-центры. Если параметр не указан, объект resource_pool будет получен из родительского объекта host_obj.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_HOST`.
moid string	Идентификатор управляемого объекта (Managed Object ID) экземпляра, которым нужно управлять, если он известен. Этот идентификатор уникален только в пределах одного экземпляра vCenter. Параметр обязателен, если не указано `vm_name` или `vm_uuid`.
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`.
timeout integer добавлено в community.vmware 3.4.0	Тайм-аут в секундах. По истечении тайм-аута работа модуля завершится с ошибкой. По умолчанию: `3600`
use_instance_uuid boolean	Использовать UUID экземпляра VMware вместо UUID BIOS. Варианты: `false` ← (по умолчанию) `true`
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_USER`.
validate_certs boolean	Разрешает подключение при недействительных SSL-сертификатах. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vm_name псевдонимы: vm string	Имя виртуальной машины, для которой нужно выполнить vMotion. Параметр обязателен, если не задан `vm_uuid`.
vm_uuid псевдонимы: uuid string	UUID виртуальной машины, для которой нужно выполнить операцию vMotion. Параметр обязателен, если не задан `vm_name` или `moid`.

Примечания

Примечание

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

Примеры

- name: Perform vMotion of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
    destination_host: 'destination_host_as_per_vcenter'
  delegate_to: localhost

- name: Perform vMotion of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    moid: vm-42
    destination_host: 'destination_host_as_per_vcenter'
  delegate_to: localhost

- name: Perform vMotion of virtual machine to resource_pool
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    moid: vm-42
    destination_host: 'destination_host_as_per_vcenter'
    destination_resourcepool: 'destination_resourcepool_as_per_vcenter'
  delegate_to: localhost

- name: Perform storage vMotion of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
    destination_datastore: 'destination_datastore_as_per_vcenter'
  delegate_to: localhost

- name: Perform storage vMotion and host vMotion of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
    destination_host: 'destination_host_as_per_vcenter'
    destination_datastore: 'destination_datastore_as_per_vcenter'
  delegate_to: localhost

- name: Perform storage vMotion to a Storage Cluster and vMotion to a Cluster of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
    destination_cluster: 'destination_cluster_as_per_vcenter'
    destination_datastore_cluster: 'destination_datastore_cluster_as_per_vcenter'
  delegate_to: localhost

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

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

Ключ	Описание
datastore string	Список хранилищ данных, в которых находится виртуальная машина. Возвращается только в том случае, если запрошена Storage vMotion (хранилище данных или кластер хранилищ данных). Возвращается: при изменении или успехе Пример: `"datastore1"`
running_host string	Список хостов, на которых зарегистрирована виртуальная машина. Возвращается только в том случае, если запрошена vMotion (кластер или хост). Возвращается: при изменении или успехе Пример: `"host1.example.com"`

Ключ

Описание

datastore

string

Список хранилищ данных, в которых находится виртуальная машина.

Возвращается только в том случае, если запрошена Storage vMotion (хранилище данных или кластер хранилищ данных).

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

Пример: "datastore1"

running_host

string

Список хостов, на которых зарегистрирована виртуальная машина.

Возвращается только в том случае, если запрошена vMotion (кластер или хост).

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

Пример: "host1.example.com"

Авторы

Bede Carroll (@bedecarroll)
Olivier Boukili (@oboukili)

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

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