IBM Aspera HST Admin Manual page 206

1. Get the ID of the Watch Folder that you want to update by getting a list of Watch Folders:
# curl -k --user node_api_user:node_api_password -H "X-aspera-WF-
version:2017_10_23" -X GET https://host:node_api_port/v3/watchfolders
2. Save the Watch Folder configuration file for editing:
# curl -ks -u node_api_user:node_api_password -H "X-aspera-
WF-version:2017_10_23" -X GET https://host:node_api_port/v3/
watchfolders/watchfolder_id > config_file.json
3. Open the configuration file in an editor, make your changes, and save the file.
Note: When aswatchfolderadmin returns the JSON configuration, it obfuscates the password for the host
with asterisks (******). If you do not want to update the password, leave it obfuscated (as asterisks) in the new
file and the old password is used. To update the password, enter the new string. If no password is specified, then
the password value is empty and transfers cannot be authenticated.
4. Update the Watch Folder configuration by sending the updated configuration file:
# curl -kv --user node_api_user:node_api_password -H "X-aspera-WF-
version:2017_10_23" -X PUT -d @/path_to_json https://host:node_api_port/
v3/watchfolders/watchfolder_id
Note: The header "X-aspera-WF-version:2017_10_23" is required when submitting POST, PUT, and
GET requests to /v3/watchfolders on servers that are version 3.8.0 or newer. This enables Watch Folders to parse
the JSON "source" and "target" objects in the format that was introduced in version 3.8.0.
For example:
# curl -kv --user watchfolder_admin:XF324cd28 -H "X-aspera-
WF-version:2017_10_23" -X PUT -d @/tmp/wf_config_update.json
https://198.51.100.22:9092/v3/watchfolders/b394d0ee-1cda-4f0d-b785-
efdc6496c585
If the update is successful, then the following is returned:
HTTP/1.1 100 Continue
HTTP/1.1 200 OK
Moving a Watch Folder from one user or daemon to another
To move a Watch Folder configuration, you must first retrieve the Watch Folder's configuration, make the desired
changes, and then create a new Watch Folder with the modified configuration file. Follow the steps provided
previously to query and save a configuration for the Watch Folder.
Open the configuration file in an editor and make the following changes:
1. Remove the "id" field.
2. Remove the "version" field.
3. Re-enter the password in the "pass" field.
4. Set proper watchfolderd IDs in the ("wfd_id") fields
Save the configuration file and then run the following command, specifying the modified configuration file as the
JSON file:
# curl -k --user node_api_user:node_api_password -H "X-
aspera-WF-version:2017_10_23" -X POST -d @path/to/json_file
https://host:node_api_port/v3/watchfolders
| Watch Folders and the Aspera Watch Service | 206