cisco / cisco.nd / 0.5.0 / module / nd_backup_restore Manages restore of backup on Nexus Dashboard. | "added in version" 0.5.0 of cisco.nd" Authors: Shreyas Srish (@shrsr) preview | supported by communitycisco.nd.nd_backup_restore (0.5.0) — module
Install with ansible-galaxy collection install cisco.nd:==0.5.0
collections: - name: cisco.nd version: 0.5.0
Manages importing the cluster configuration using a backup.
- name: Import a Backup cisco.nd.nd_backup_restore: name: nexus encryption_key: testtest file_location: ./nexus.tgz state: restore
- name: Query a restore job cisco.nd.nd_backup_restore: name: nexus state: query register: query_result
- name: Query all restore jobs cisco.nd.nd_backup_restore: state: query register: query_results
- name: Delete a restore job cisco.nd.nd_backup_restore: name: nexus state: absent
host: aliases: - hostname description: - IP Address or hostname of the Nexus Dashboard (ND) host. - If the value is not specified in the task, the value of environment variable C(ND_HOST) will be used instead. type: str name: aliases: - restore_name description: - The name given for a backup to be restored. - This can be different from the backup file. - This is assigned to the job once the restore is complete. type: str port: description: - Port number to be used for the REST connection. - The default value depends on parameter `use_ssl`. - If the value is not specified in the task, the value of environment variable C(ND_PORT) will be used instead. type: int state: choices: - restore - query - absent default: restore description: - Use C(restore) for importing a backup of the cluster config. - Use C(query) for listing all the restored jobs. - Use C(absent) for deleting a restored job. type: str timeout: default: 30 description: - The socket level timeout in seconds. - If the value is not specified in the task, the value of environment variable C(ND_TIMEOUT) will be used instead. type: int use_ssl: description: - If C(no), an HTTP connection will be used instead of the default HTTPS connection. - If the value is not specified in the task, the value of environment variable C(ND_USE_SSL) will be used instead. type: bool password: description: - The password to use for authentication. - If the value is not specified in the task, the value of environment variables C(ND_PASSWORD) or C(ANSIBLE_NET_PASSWORD) will be used instead. type: str username: description: - The username to use for authentication. - If the value is not specified in the task, the value of environment variables C(ND_USERNAME) or C(ANSIBLE_NET_USERNAME) will be used instead. type: str use_proxy: description: - If C(no), it will not use a proxy, even if one is defined in an environment variable on the target hosts. - If the value is not specified in the task, the value of environment variable C(ND_USE_PROXY) will be used instead. type: bool restore_key: description: - The key generated for a restored job by ND during import of a backup. - This key is required when querying or deleting a restored job among multiple restored jobs that have the same name. - This key can be obtained by querying a restored job. type: str login_domain: description: - The login domain name to use for authentication. - The default value is DefaultAuth. - If the value is not specified in the task, the value of environment variable C(ND_LOGIN_DOMAIN) will be used instead. type: str output_level: choices: - debug - info - normal default: normal description: - Influence the output of this ND module. - C(normal) means the standard output, incl. C(current) dict - C(info) adds informational output, incl. C(previous), C(proposed) and C(sent) dicts - C(debug) adds debugging output, incl. C(filter_string), C(method), C(response), C(status) and C(url) information - If the value is not specified in the task, the value of environment variable C(ND_OUTPUT_LEVEL) will be used instead. type: str file_location: description: - The path and file name of the backup file to be restored. type: str encryption_key: description: - The encryption_key of a backup file. type: str validate_certs: description: - If C(no), SSL certificates will not be validated. - This should only set to C(no) when used on personally controlled sites using self-signed certificates. - If the value is not specified in the task, the value of environment variable C(ND_VALIDATE_CERTS) will be used instead. type: bool