Create a Post
Showing results for 
Search instead for 
Did you mean: 
Employee Alumnus
Employee Alumnus

R80.10 Management API "put-file" command's undocumented flag

The Management API "put-file" command allows uploading a file to a management server or a gateway.

If you run this API command using a mgmt_cli tool, you may use a new "--treat-value-as-file-by-prefix" flag, which will replace the value of file-content argument with the content of a file on your machine.

Here is an example using the standard syntax - 

mgmt_cli put-file file-path "/home/admin/" file-name "vsx_conf" file-content "vs ip\nvs2 ip" targets.1 "corporate-gateway"

Here is an example using the new syntax - 

mgmt_cli put-file file-path "/home/admin/" file-name "vsx_conf" file-content @my_file.txt --treat-value-as-file-by-prefix @ targets.1 "corporate-gateway"

while the content of the file my_file.txt will be "vs ip\nvs2 ip".

The new flag informs the mgmt_cli tool that an argument file-content with a value my_file.txt starting with a '@' character, should have a new value - the content of my_file.txt file.

You may use any prefix of any length for this flag.

If the file is not located in the current directory, you should specify an absolute path.

3 Replies
Employee Alumnus
Employee Alumnus

Hey Robert,

Thanks for explanation. 
Is it possible to use the mgmt-cli to simply put a file at the target?

mgmt_cli put-file file-path "/home/admin/" file-name "my_file.txt" targets.1 "corporate-gateway"

And then the file located in my directory will be in the target directory of the command?



0 Kudos
Employee Alumnus
Employee Alumnus

This command eventually uploads the content of the file to the specified target.

You must specify either the parameter for the file-content argument or use the new flag mentioned above.


0 Kudos

Another way of transferring files. Python SDK:
f = open("dynamic_id_users_info.lst", "r")
filecontent =

put_file_response = client.api_call("put-file", {"file-path" : "/var/opt/CPshrd-R80.40/conf/", "file-name" : "dynamic_id_users_info.lst", "file-content" : f"{filecontent}", "targets" : [ "target1","target2" ]})

0 Kudos