ce_file_copy - Копирование файла на удалённое устройство cloudengine по SCP на коммутаторах HUAWEI CloudEngine.
Новая версия 2.4.
Краткое описание
- Копирование файла на удалённое устройство cloudengine по SCP на коммутаторах HUAWEI CloudEngine.
Параметры
| параметр | обязательно | значение по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| file_system | нет | flash: | Удаленная файловая система устройства. Если опущено, устройства, поддерживающие параметр file_system, будут использовать свои значения по умолчанию. Файловая система указывает на носитель хранения и может быть задана следующим образом: 1) 'flash:' — корневой каталог флэш-памяти на основном MPU. 2) 'slave#flash:' — корневой каталог флэш-памяти на подчиненном MPU. Если подчиненного MPU нет, этот диск недоступен. 3) 'ID корпуса/номер слота#flash:' — корневой каталог флэш-памяти на устройстве в стеке. Например, 1/5#flash указывает на флэш-память с ID корпуса 1 и номером слота 5. | |
| local_file | да | Путь к локальному файлу. Локальный каталог должен существовать. Максимальная длина local_file — 4096. | ||
| remote_file | нет | Удаленный путь к файлу для копирования. Удаленные каталоги должны существовать. Если опущено, будет использовано имя локального файла. Максимальная длина remote_file — 4096. |
Примеры
- name: File copy test
hosts: cloudengine
connection: local
gather_facts: no
vars:
cli:
host: "{{ inventory_hostname }}"
port: "{{ ansible_ssh_port }}"
username: "{{ username }}"
password: "{{ password }}"
transport: cli
tasks:
- name: "Copy a local file to remote device"
ce_file_copy:
local_file: /usr/vrpcfg.cfg
remote_file: /vrpcfg.cfg
file_system: 'flash:'
provider: "{{ cli }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращено | тип | пример |
|---|---|---|---|---|
| changed | проверка внесения изменений на устройстве | всегда | boolean | True |
| local_file | Путь к локальному файлу. | всегда | string | /usr/work/vrpcfg.zip |
| remote_file | Путь к удалённому файлу. | всегда | string | /vrpcfg.zip |
| transfer_result | информация о результате передачи. | всегда | string | Локальный файл успешно передан на устройство. |
Примечания
Примечание
- Функция должна быть включена с помощью функции scp-server.
- Если файл уже существует, передача не произойдёт.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимый.
Для получения помощи в разработке модулей, если у вас есть желание, прочитайте Информация о сообществе и внесение вклада, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ce_file_copy_module.html
