ancestor: null
releases:
  1.0.0:
    changes:
      bugfixes:
      - Added 'compose' and 'groups' feature in vmware_vm_inventory plugin.
      - Added keyed_groups feature in vmware_vm_inventory plugin.
      - Added support to vmware_tag_manager module for specifying tag and category
        as dict if any of the name contains colon (https://github.com/ansible/ansible/issues/65765).
      - Check for virtualNicManager in Esxi host system before accessing properties
        in vmware_vmkernel_info (https://github.com/ansible/ansible/issues/62772).
      - Fixed typo in vmware_guest_powerstate module (https://github.com/ansible/ansible/issues/65161).
      - Handle Base64 Binary while JSON serialization in vmware_vm_inventory.
      - Handle NoneType error when accessing service system info in vmware_host_service_info
        module (https://github.com/ansible/ansible/issues/67615).
      - Handle list items in vSphere schema while handling facts using to_json API
        (https://github.com/ansible-collections/vmware/issues/33).
      - Handle multiple tags name with different category id in vmware_tag module
        (https://github.com/ansible/ansible/issues/66340).
      - Handle slashes in VMware network name (https://github.com/ansible/ansible/issues/64399).
      - In inventory plugin, serialize properties user specifies which are objects
        as dicts (https://github.com/ansible-collections/vmware/pull/58).
      - In vmware_guest_network module use appropriate network while creating or reconfiguring
        (https://github.com/ansible/ansible/issues/65968).
      - Made vmnics attributes optional when creating DVS as they are optional on
        the API and GUI as well.
      - VMware Guest Inventory plugin enhancements and features.
      - VMware guest inventory plugin support for filters.
      - Vmware Fix for Create overwrites a VM of same name even when the folder is
        different(https://github.com/ansible/ansible/issues/43161)
      - '`vmware_content_deploy_template`''s `cluster` argument no longer fails with
        an error message about resource pools.'
      - return correct datastore cluster placement recommendations during when adding
        disk using the vmware_guest_disk module
      - vmware - Ensure we can use the modules with Python < 2.7.9 or RHEL/CentOS
        < 7.4, this as soon as ``validate_certs`` is disabled.
      - vmware_category - fix associable datatypes (https://github.com/ansible-collections/vmware/issues/197).
      - vmware_content_deploy_template - Added param content_library to the main function
      - vmware_deploy_ovf - Fixed ova deploy error occur if vm exists
      - vmware_dvs_portgroup - Implemented configuration changes on an existing Distributed
        vSwitch portgroup.
      - vmware_dvs_portgroup_find - Cast variable to integer for comparison.
      - vmware_guest - Add ability to upgrade the guest hardware version to latest
        fix issue (https://github.com/ansible/ansible/issues/56273).
      - vmware_guest - Allow '-' (Dash) special char in windows DNS name.
      - vmware_guest - Exclude dvswitch_name from triggering guest os customization.
      - vmware_guest - Updated reference link to vapp_properties property
      - vmware_host_capability_facts - Fixed vSphere API legacy version errors occur
        in pyvmomi 7.0 and later
      - vmware_host_capability_info - Fixed vSphere API legacy version errors occur
        in pyvmomi 7.0 and later
      - vmware_host_facts - handle facts when ESXi hostsystem is poweredoff (https://github.com/ansible-collections/vmware/issues/183).
      - vmware_host_firewall_manager - Ensure we can set rule with no ``allowed_hosts``
        key (https://github.com/ansible/ansible/issues/61332)
      - vmware_host_firewall_manager - Fixed creating IP specific firewall rules with
        Python 2 (https://github.com/ansible/ansible/issues/67303)
      - vmware_host_vmhba_info - fixed node_wwn and port_wwn for FC HBA to hexadecimal
        format(https://github.com/ansible/ansible/issues/63045).
      - vmware_vcenter_settings - Fixed when runtime_settings parameters not defined
        occur error(https://github.com/ansible/ansible/issues/66713)
      - vmware_vcenter_statistics - Fix some corner cases like increasing some interval
        and decreasing another at the same time.
      - vmware_vm_inventory inventory plugin, use the port value while connecting
        to vCenter (https://github.com/ansible/ansible/issues/64096).
      - vmware_vmkernel - Remove duplicate checks.
      - vmware_vspan_session - Extract repeated code and reduce complexity of function.
      deprecated_features:
      - vmware_dns_config - Deprecate in favour of new module vmware_host_dns.
      minor_changes:
      - A `vmware` module_defaults group has been added to simplify parameters for
        multiple VMware tasks. This group includes all VMware modules.
      - Add a flag 'force_upgrade' to force VMware tools upgrade installation (https://github.com/ansible-collections/vmware/issues/75).
      - Add powerstates to match vmware_guest_powerstate module with vmware_guest
        (https://github.com/ansible/ansible/issues/55653).
      - Added a timeout parameter `wait_for_ip_address_timeout` for `wait_for_ip_address`
        for longer-running tasks in vmware_guest.
      - Added missing backing_disk_mode information about disk which was removed by
        mistake in vmware_guest_disk_info.
      - Correct datatype for state in vmware_host_lockdown module.
      - Correct example from doc of `vmware_local_role_info.py` to match the change
        of returned structure.
      - Correct example from doc of `vmware_local_role_info.py` to match the change
        of returned structure.
      - Handle exceptions raised in connect_to_vsphere_client API.
      - Minor typo fixes in vmware_httpapi related modules and module_utils.
      - Removed ANSIBLE_METADATA from all the modules.
      - Return additional information about hosts inside the cluster using vmware_cluster_info.
      - Update Module examples with FQCN.
      - Update README.md for installing any third party required Python libraries
        using pip (https://github.com/ansible-collections/vmware/issues/154).
      - add storage_provisioning type into vmware_content_deploy_ovf_template.
      - add vmware_content_deploy_ovf_template module for creating VMs from OVF templates
      - new code module for new feature for operations of VCenter infra profile config.
      - vmware.py - Only add configured network interfaces to facts.
      - vmware_cluster_drs - Implemented DRS advanced settings (https://github.com/ansible/ansible/issues/66217)
      - vmware_cluster_ha - Implemented HA advanced settings (https://github.com/ansible/ansible/issues/61421)
      - vmware_cluster_ha - Remove a wrong parameter from an example in the documentation.
      - vmware_content_deploy_template - added new field "content_library" to search
        template inside the specified content library.
      - vmware_datastore_cluster - Added basic SDRS configuration (https://github.com/ansible/ansible/issues/65154).
      - vmware_datastore_info - added ``properties`` and ``schema`` options.
      - vmware_datastore_maintenancemode now returns datastore_status instead of Ansible
        internal key results (https://github.com/ansible/ansible/issues/62083).
      - vmware_dvs_portgroup_info - Include the value of the Portgroup ``key`` in
        the result
      - vmware_dvswitch now returns the UUID of the switch
      - vmware_dvswitch_info also returns the switch UUID
      - vmware_export_ovf - increase default timeout to 30s
      - vmware_export_ovf - timeout value is actually in seconds, not minutes
      - vmware_guest - Don't search for VMDK if filename is defined.
      - vmware_guest - Extracts repeated code from configure_vapp_properties() to
        set_vapp_properties() in vmware_guest.py.
      - vmware_guest - add support VM creation and reconfiguration with multiple types
        of disk controllers and disks
      - vmware_guest - add support for create and reconfigure CDROMs attaching to
        SATA (https://github.com/ansible/ansible/issues/42995)
      - vmware_guest - add support hardware version 17 for vSphere 7.0
      - vmware_guest_custom_attributes does not require VM name (https://github.com/ansible/ansible/issues/63222).
      - vmware_guest_disk - Add `destroy` option which allows to remove a disk without
        deleting the VMDK file.
      - vmware_guest_disk - Add `filename` option which allows to create a disk from
        an existing VMDK.
      - vmware_guest_disk - add support for setting the sharing/multi-writer mode
        of virtual disks (https://github.com/ansible-collections/vmware/issues/212)
      - vmware_guest_network - network adapters can be configured without lists
      - vmware_guest_network - network_info returns a list of dictionaries for ease
        of use
      - vmware_guest_network - put deprecation warning for the networks parameter
      - vmware_guest_tools_wait now exposes a ``timeout`` parameter that allow the
        user to adjust the timeout (second).
      - vmware_host_active_directory - Fail when there are unrecoverable problems
        with AD membership instead of reporting a change that doesn't take place (https://github.com/ansible-collections/vmware/issues/59).
      - vmware_host_dns - New module replacing vmware_dns_config with increased functionality.
      - vmware_host_dns can now set the following empty values, ``domain``, ``search_domains``
        and ``dns_servers``.
      - vmware_host_facts - added ``properties`` and ``schema`` options.
      - vmware_host_firewall_manager - ``allowed_hosts`` excpects a dict as parameter,
        list is deprecated
      - vmware_host_kernel_manager now returns host_kernel_status instead of Ansible
        internal key results (https://github.com/ansible/ansible/issues/62083).
      - vmware_host_logbundle - new code module for a new feature for ESXi support
        log bundle download operation
      - vmware_host_logbundle_info - new code module for a new feature for getting
        manifests  for ESXi support log bundle
      - vmware_host_ntp now returns host_ntp_status instead of Ansible internal key
        results (https://github.com/ansible/ansible/issues/62083).
      - vmware_host_service_manager now returns host_service_status instead of Ansible
        internal key results (https://github.com/ansible/ansible/issues/62083).
      - vmware_rest_client - Added a new definition get_library_item_from_content_library_name.
      - vmware_tag now returns tag_status instead of Ansible internal key results
        (https://github.com/ansible/ansible/issues/62083).
      - vmware_vm_inventory inventory plugin, raise more descriptive error when all
        template strings in ``hostnames`` fail.
      removed_features:
      - vmware_guest_find - Removed deprecated ``datacenter`` option
      - vmware_vmkernel - Removed deprecated ``ip_address`` option; use sub-option
        ip_address in the network option instead
      - vmware_vmkernel - Removed deprecated ``subnet_mask`` option; use sub-option
        subnet_mask in the network option instead
    fragments:
    - 109-vmware_host_logbundle.yml
    - 110-vmware_host_logbundle_info.yml
    - 113_vmware_content_deploy_ovf_template.yml
    - 121-vpsan_session-reduce-complexity.yaml
    - 129_vmware_vm_inventory.yml
    - 141_Correct_doc_of_vmware_local_role_info
    - 141_Correct_doc_of_vmware_local_role_info.yaml
    - 145-vmware_dvs_portgroup_find-integer-cast.yaml
    - 149-remove-duplicate-checks.yaml
    - 153-vmware_guest.yml
    - 154_update_doc.yml
    - 166-vmware_deploy_ovf.yml
    - 183_vmware_host_facts.yml
    - 185-make_vnics_optional_for_dvs.yml
    - 188-vmware_content_deploy_template-specify_content_library_name.yml
    - 197_vmware_category.yml
    - 214-add-disk-sharing.yaml
    - 219-vmware_content_deploy_template_added_param_content_library.yml
    - 225-vmware_vcenter_settings.yml
    - 253-inventory_hostnames_fail_message.yml
    - 33-vmware_guest_info_list_fix.yml
    - 44957-vmware_guest.yml
    - 46-Vcenter-infra-profile-config-operations.yml
    - 55653-vmware_guest_powerstate.yml
    - 56-vmware_rest.yml
    - 57185-fix_vmware_modules_py_pre2.79.yaml
    - 57535-vmware_vcenter_statistics_corner-cases.yml
    - 58-non-json-properties.yml
    - 58824-vmware_cluster_ha-advanced-settings.yml
    - 58824-vmware_dvs_portgroup-implement-portgroup-updates.yml
    - 59_vmware_host_active_directory.yml
    - 62083-vmware-internal_results.yml
    - 62188-VMware-Guest-Support-latest-version-while-upgrading-VM-hardware.yml
    - 62616-vmware_cluster_ha-fix-documentation.yml
    - 62772-vmware_vmkernel_info-fix.yml
    - 62810-Vmware-Guest-Allow-DashInWindowsServerDNSName.yml
    - 62916-add_properties_option_to_vmware_host_facts.yml
    - 629400-add_properties_option_to_vmware_datastore_info.yml
    - 63740-vmware_guest_disk_filename_destroy.yaml
    - 63741-do_not_search_for_vmdk_if_filename_defined.yaml
    - 64399_vmware_guest.yml
    - 64458-vmware_host_dns.yaml
    - 65-vmware_guest.yml
    - 65154-vmware_datastore_cluster-configure-dns.yml
    - 65715-vmware-content-deploy-template-fix-cluster.yml
    - 65733-fix-vmware-guest-properties-doc.yaml
    - 65765-vmware_tag_manager.yml
    - 65922-filter-VMs-of-Same-name-on-the-basis-of-folder.yml
    - 65968-vmware_guest_network.yml
    - 65997-vmware_guest-exclude-dvswitch-name-from-os-customization.yml
    - 66217-vmware_cluster_drs-advanced-settings.yml
    - 66340-vmware_tag.yml
    - 66692-vmware_host_vmhba_info_fix_63045.yml
    - 66877-vmware_host_dns.yaml
    - 66922-vmware_guest_network.yml
    - 67221-vmware-guest-disk-storage-drs-fix.yml
    - 67282-remove_options_from_some_vmware_modules_that_aren't_used_in_the_code.yml
    - 67303-vmware_host_firewall_manager-fix_ip_specific_firewall_rules_for_python2.yml
    - 67615-vmware_host_service_info_fix.yml
    - 69-vmware-extract-repeat-code.yaml
    - 7052_awx_handle_binary.yml
    - 75-vmware_guest_tool_upgrade.yml
    - fix-vim-legacy-version-error-vmware_host_capability_facts.yml
    - fix-vim-legacy-version-error-vmware_host_capability_info.yml
    - metadata_removal.yml
    - typo_fix_vmware_guest_powerstate.yml
    - update_examples.yml
    - vmware-module_fragments-group.yml
    - vmware-only-add-configured-interfaces.yml
    - vmware_cluster_info_hosts.yml
    - vmware_content_deploy_ovf_template_add_storage_provision_type.yml
    - vmware_dvs_portgroup_info_key.yaml
    - vmware_dvswitch_uuid.yaml
    - vmware_export_ovf.yaml
    - vmware_guest.yaml
    - vmware_guest_custom_attributes.yml
    - vmware_guest_disk_info_disk_mode.yml
    - vmware_guest_tools_wait_time.yaml
    - vmware_host_firewall_manager_fix_61332.yaml
    - vmware_host_lockdown_typo_fix.yml
    - vmware_httpapi_fix.yml
    - vmware_vm_inventory_compose.yml
    - vmware_vm_inventory_filter.yml
    - vmware_vm_inventory_keyed_groups.yml
    - vmware_vm_inventory_port.yml
    release_date: '2020-06-19'
  1.1.0:
    changes:
      breaking_changes:
      - vmware_datastore_maintenancemode - now returns ``datastore_status`` instead
        of Ansible internal key ``results``.
      - vmware_guest_custom_attributes - does not require VM name which was a required
        parameter for releases prior to Ansible 2.10.
      - vmware_guest_find - the ``datacenter`` option has been removed.
      - vmware_host_kernel_manager - now returns ``host_kernel_status`` instead of
        Ansible internal key ``results``.
      - vmware_host_ntp - now returns ``host_ntp_status`` instead of Ansible internal
        key ``results``.
      - vmware_host_service_manager - now returns ``host_service_status`` instead
        of Ansible internal key ``results``.
      - vmware_tag - now returns ``tag_status`` instead of Ansible internal key ``results``.
      - vmware_vmkernel - the options ``ip_address`` and ``subnet_mask`` have been
        removed; use the suboptions ``ip_address`` and ``subnet_mask`` of the ``network``
        option instead.
      bugfixes:
      - vmware_content_deploy_ovf_template - use datastore_id in deployment_spec (https://github.com/ansible-collections/vmware/pull/287).
      - vmware_dvs_portgroup_find - Fix comparison between str and int on method vlan_match
        (https://github.com/ansible-collections/vmware/pull/52).
      - vmware_guest - cdrom.controller_number, cdrom.unit_number are handled as integer.
        (https://github.com/ansible-collections/vmware/issues/274).
      - vmware_vm_inventory - CustomFieldManager is not present in ESXi, handle this
        condition (https://github.com/ansible-collections/vmware/issues/269).
      deprecated_features:
      - The vmware_dns_config module has been deprecated and will be removed in a
        later release; use vmware_host_dns instead.
      - vca - vca_fw, vca_nat, vca_app are deprecated since these modules rely on
        deprecated part of Pyvcloud library.
      - vmware_tag_info - in a later release, the module will not return ``tag_facts``
        since it does not return multiple tags with the same name and different category
        id. To maintain the existing behavior use ``tag_info`` which is a list of
        tag metadata.
      minor_changes:
      - Added module to be able to create, update, or delete VMware VM storage policies
        for virtual machines.
      - vmware_cluster_info - added ``properties`` and ``schema`` options and supported
        the getting of clusters resource summary information.
      - vmware_content_deploy_ovf_template - handle exception while deploying VM using
        OVF template.
      - vmware_content_deploy_template - handle exception while deploying VM (https://github.com/ansible-collections/vmware/issues/182).
      - vmware_dvs_portgroup - Added support for distributed port group with private
        VLAN.
      - vmware_guest_snapshot_info - Document that `folder` is required if the VM
        `name` is defined (https://github.com/ansible-collections/vmware/issues/243)
      - vmware_host_iscsi - a new module for the ESXi hosts that is dedicated to the
        management of the iSCSI configuration
      - vmware_migrate_vmk - allow migration from a VMware vSphere Distrubuted Switch
        to a ESXi Standard Switch
      - vmware_vcenter_settings_info - a new module for gather information about vCenter
        settings
      removed_features:
      - vmware_portgroup - removed 'inbound_policy', and 'rolling_order' deprecated
        options.
    fragments:
    - 124-vmware-migrate-vmk-to-std-switch.yaml
    - 182_content_library.yml
    - 224-vmware_host_iscsi.yml
    - 243_vmware_guest_snapshot_info.yml
    - 269_vmware_vm_inventory.yml
    - 274_vmware_guest.yml
    - 275_vmware_vcenter_settings_info.yml
    - 287_deploy_ovf_template.yml
    - 321-vmware_cluster_info.yml
    - 52-vmware_dvs_portgroup_find_fix.yml
    - porting-guide.yml
    - pvlan-config-vmware-dvs-portgroup.yml
    - vca_deprecate.yml
    - vmware_pg_options.yml
    - vmware_vm_storage_policy_module.yml
    release_date: '2020-08-01'
