community / community.vmware / 4.2.0 / module / vsphere_file Manage files on a vCenter datastore Authors: Dag Wieers (@dagwieers)community.vmware.vsphere_file (4.2.0) — module
Install with ansible-galaxy collection install community.vmware:==4.2.0
collections: - name: community.vmware version: 4.2.0
Manage files on a vCenter datastore.
- name: Create an empty file on a datastore community.vmware.vsphere_file: host: '{{ vhost }}' username: '{{ vuser }}' password: '{{ vpass }}' datacenter: DC1 Someplace datastore: datastore1 path: some/remote/file state: touch delegate_to: localhost
- name: Create a directory on a datastore community.vmware.vsphere_file: host: '{{ vhost }}' username: '{{ vuser }}' password: '{{ vpass }}' datacenter: DC2 Someplace datastore: datastore2 path: other/remote/file state: directory delegate_to: localhost
- name: Query a file on a datastore community.vmware.vsphere_file: host: '{{ vhost }}' username: '{{ vuser }}' password: '{{ vpass }}' datacenter: DC1 Someplace datastore: datastore1 path: some/remote/file state: file delegate_to: localhost ignore_errors: true
- name: Delete a file on a datastore community.vmware.vsphere_file: host: '{{ vhost }}' username: '{{ vuser }}' password: '{{ vpass }}' datacenter: DC2 Someplace datastore: datastore2 path: other/remote/file state: absent delegate_to: localhost
path: aliases: - dest description: - The file or directory on the datastore on the vCenter server. required: true 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 E(VMWARE_PORT) will be used instead. type: int state: choices: - absent - directory - file - touch default: file description: - The state of or the action on the provided path. - If V(absent), the file will be removed. - If V(directory), the directory will be created. - If V(file), more information of the (existing) file will be returned. - If V(touch), an empty file will be created if the path does not exist. type: str timeout: default: 10 description: - The timeout in seconds for the upload to the datastore. type: int 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 E(VMWARE_HOST) will be used instead. 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 E(VMWARE_PASSWORD) will be used instead. 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 E(VMWARE_USER) will be used instead. type: str datastore: description: - The datastore on the vCenter server to push files to. required: true type: str datacenter: description: - The datacenter on the vCenter server that holds the datastore. required: true 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 E(VMWARE_PROXY_HOST) will be used instead. 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 E(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 V(false) when certificates are not trusted. - If the value is not specified in the task, the value of environment variable E(VMWARE_VALIDATE_CERTS) will be used instead. type: bool