community / community.vmware / 1.18.2 / module / vmware_vmotion Move a virtual machine using vMotion, and/or its vmdks using storage vMotion. Authors: Bede Carroll (@bedecarroll), Olivier Boukili (@oboukili)community.vmware.vmware_vmotion (1.18.2) — module
Install with ansible-galaxy collection install community.vmware:==1.18.2
collections: - name: community.vmware version: 1.18.2
Using VMware vCenter, move a virtual machine using vMotion to a different host, and/or its vmdks to another datastore using storage vMotion.
- 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
moid: description: - Managed Object ID of the instance to manage if known, this is a unique identifier only within a single vCenter instance. - This is required if C(vm_name) or C(vm_uuid) is not supplied. type: str port: default: 443 description: - The port number of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_PORT) will be used instead. - Environment variable support added in Ansible 2.6. type: int vm_name: aliases: - vm description: - Name of the VM to perform a vMotion on. - This is required parameter, if C(vm_uuid) is not set. - Version 2.6 onwards, this parameter is not a required parameter, unlike the previous versions. type: str vm_uuid: aliases: - uuid description: - UUID of the virtual machine to perform a vMotion operation on. - This is a required parameter, if C(vm_name) or C(moid) is not set. type: str hostname: description: - The hostname or IP address of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_HOST) will be used instead. - Environment variable support added in Ansible 2.6. type: str password: aliases: - pass - pwd description: - The password of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_PASSWORD) will be used instead. - Environment variable support added in Ansible 2.6. type: str username: aliases: - admin - user description: - The username of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_USER) will be used instead. - Environment variable support added in Ansible 2.6. type: str proxy_host: description: - Address of a proxy that will receive all HTTPS requests and relay them. - The format is a hostname or a IP. - If the value is not specified in the task, the value of environment variable C(VMWARE_PROXY_HOST) will be used instead. - This feature depends on a version of pyvmomi greater than v6.7.1.2018.12 required: false type: str proxy_port: description: - Port of the HTTP proxy that will receive all HTTPS requests and relay them. - If the value is not specified in the task, the value of environment variable C(VMWARE_PROXY_PORT) will be used instead. required: false type: int validate_certs: default: true description: - Allows connection when SSL certificates are not valid. Set to C(false) when certificates are not trusted. - If the value is not specified in the task, the value of environment variable C(VMWARE_VALIDATE_CERTS) will be used instead. - Environment variable support added in Ansible 2.6. - If set to C(true), please make sure Python >= 2.7.9 is installed on the given machine. type: bool destination_host: aliases: - destination description: - Name of the destination host the virtual machine should be running on. - Version 2.6 onwards, this parameter is not a required parameter, unlike the previous versions. type: str use_instance_uuid: default: false description: - Whether to use the VMware instance UUID rather than the BIOS UUID. type: bool destination_datastore: aliases: - datastore description: - Name of the destination datastore the virtual machine's vmdk should be moved on. type: str destination_datacenter: description: - Name of the destination datacenter the datastore is located on. - Optional, required only when datastores are shared across datacenters. type: str version_added: 1.11.0 version_added_collection: community.vmware destination_resourcepool: aliases: - resource_pool description: - Name of the destination resource pool where the virtual machine should be running. - Resource pool is required if vmotion is done between hosts which are part of different clusters or datacenters. - if not passed, resource_pool object will be retrived from host_obj parent. type: str
running_host: description: List the host the virtual machine is registered to returned: changed or success sample: host1.example.com type: str