SYNO.PhotoStation.Photo copy
Copy or move a set of photos and/or videos.
Request
| Parameter | Description | Required? |
|---|---|---|
id |
Comma separated list of items (photos or videos) | Yes |
sharepath |
Album ID of destination album | Yes |
mode |
copy or move |
Yes |
duplicate |
rename, ignore or overwrite |
Yes |
Sample Response
{
"success": true
}
Unfortunately the response is not particularly informative as it does not show any per-item status. Additionally, some errors (for example, attempting to copy an invalid ID) are never reported.
Cancellation
The copy command supports cancellation via the cancel command.
In order for cancel to stop copying or moving of the items being processed, the
cancellation id parameter must match the copy id parameter exactly,
otherwise cancellation will not find a matching operation. This means if
one is copying/moving multiple items in a single request, all the
item operations must be cancelled (if desired) with a single request.
Also note that cancellation is best effort and does not ensure the item(s) will not have already been copied or moved by the time the cancellation operation is received. There is no undo operation.
Errors
On error, cancel can return one of the following error values:
| Error Value | Description |
|---|---|
PHOTOSTATION_PHOTO_BAD_PARAMS |
Missing parameters or invalid destination album |
PHOTOSTATION_PHOTO_ACCESS_DENY |
User does not have upload access to destination album |
PHOTOSTATION_PHOTO_SELECT_CONFLICT |
Current and destination album are identical and duplicate != rename |