- URL:https://<itemInfo-url>/upload(POST only)
- Required Capability:Default administrator role | All authorized privileges
- Version Introduced:10.1
Description
This operation uploads a file associated with the item information to the server. The uploaded file is placed in a directory defined by the folder parameter. The file is accessible by appending the path and file name to the Item Information URL. Iteminfo uploads are filtered by a list of approved filename extensions:
- xml
- img
- png
- gif
- jpg
- jpeg
- bmp
- json
The default list can be overridden by setting the uploadItemInfoFileExtensionAllowedList property with the server properties API.
Note:
At 10.9, the name of this parameter has been updated from uploadItemInfoFileExtensionWhitelist to uploadItemInfoFileExtensionAllowedList.
Request parameters
| Parameter | Description |
|---|---|
| folder | The name of the folder on the server to which the file must be uploaded. |
| file | The file to upload to the server. |
| f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
Below is a sample POST request for upload:
POST /webadaptor/admin/services/FireWeatherWatch.MapServer/iteminfo/upload HTTP/1.1
Host: machine.domain.com
Content-Type: multipart/form-data; boundary=----boundary
Content-Length: []
------boundary
Content-Disposition: form-data; name="folder"
folderName
------boundary
Content-Disposition: form-data; name="file"; filename=""
Content-Type: application/octet-stream
thumbnail.jpg
------boundary
Content-Disposition: form-data; name="f"
pjson
------boundary
Content-Disposition: form-data; name="csrfPreventToken"
0aGn2YRklyOX7aHf91CHNH3dGj9CTSXru2llPr6C6Xcq-JJRKeq2GEXIRAY03GgMIp51WXmo8gquonKhIuuqQJziHfyY4s63NUhhfNfmPPgBb6m-0KcLN4cagbGzswKhQWPl85x4sMLByXSGKhaxjrcVQbUumSup8jClPeBa9xq9kaeCD_CQvNgjy42OtrN9,https://rpubs16016.ags.esri.com/server/admin
------boundary--JSON Response example
{"status": "success"}