For an existing file resource, you can update its name, description or file contents in several ways.
The simplest way is to PUT a file descriptor containing the new file in base64 encoding. This new definition of the file resource overwrites the previous one.
Method | URL | ||
PUT | http://<host>:<port>/jasperserver[-pro]/rest_v2/resources/path/to/resource | ||
Content-Type | Content | ||
application/repository.file+json application/repository.file+xml | A well defined file resource descriptor, as described in File. The new contents of the file are base64 encoded in the content attribute of the descriptor. | ||
Return Value on Success | Typical Return Values on Failure | ||
201 Created – The request was successful and, for confirmation, the response contains the full descriptor of the resource that was just created. | 400 Bad Request – Mismatch between the content-type and the fields or syntax of the actual descriptor. |
The second method allows you to update a file resource by direct streaming. You can specify the Content-Description and Content-Disposition headers to update the resource description or name, respectively.
Method | URL | ||
PUT | http://<host>:<port>/jasperserver[-pro]/rest_v2/resources/path/to/resource | ||
Options | |||
Content-Description: <file-description> - Becomes the description field of the created file resource Content-Disposition: attachment; filename=<filename> - Becomes the name of the file resource | |||
Content-Type | Content | ||
{MIME type} | The MIME type from File Types and MIME Types that corresponds to the desired file type. The body of the request then contains the binary data representation of that file format. | ||
Return Value on Success | Typical Return Values on Failure | ||
201 Created – The request was successful and, for confirmation, the response contains the full descriptor of the resource that was just created. | 400 Bad Request – Mismatch between the content-type and the fields or syntax of the actual descriptor. |
Recommended Comments
There are no comments to display.