- URL:https://<service-url>/uploads
- Required Capability:GP and Mobile Service: Uploads, Image Service: Edit or Uploads, Feature Service: Create or Update, Geodata Service: Replication
- Version Introduced:10.1
Description
The uploads resource is the parent resource for upload related operations and resources. This resource is available only if the service or an extension supports the upload capability. For feature and image services, the upload capability is enabled when editing is turned on. For mobile and geoprocessing services, the upload capability can be explicitly enabled or disabled at publish time. For a geodata service, the upload capability is enabled when replication is turned on. If upload is enabled for a service, it is recommended that you secure the service to allow only authenticated users access to this capability.
Individual items can be uploaded using the upload operation.
To upload a large file, the file can be split into multiple parts. The item must be registered first using the register operation, and uploaded in parts using the uploadPart operation. Once parts of an item are uploaded, the commit operation can be used to complete the upload of that item.
Limiting upload file size and file types
The acceptable file types that can be uploaded and the file size are limited by the service or its extension properties AllowedUploadFileTypes and MaxUploadFileSize.
By default, each service or its extension has a predefined list of allowed file types and a maximum file size. This limit also applies to files uploaded using feature service add or update attachment operations. By default, ArcGIS Server imposes a 2 GB limit on the maximum size of file that can be uploaded. When uploading a single file, this is the maximum allowed size for that file. When a file is uploaded in parts, this is the maximum allowed size for the committed file.
ArcGIS Server also imposes a limit on the file types that can be uploaded. The file types allowed vary for each service type. By default, the most commonly used file extensions for that service type are allowed. If the file type (extension) does not match an allowed type when uploading a single file, the upload will fail. Similarly, the register operation will fail if the extension specified for the itemName is not an allowed type.
You can modify the AllowedUploadFileTypesand MaxUploadFileSize properties for a service or service extension using the ArcGIS Server Administrator Directory as follows:
- Log in to ArcGIS Server Administrator Directory: https://<host>:<port>/<instance>/admin.
- Browse to the service: https://<host>:<port>/<instance>/admin/services/<servicename>.<ServiceType>.
- The HTML view of the service lists the default values for Max upload file size and Allowed upload file types. Note the default properties.
- Edit the service.
- Update the maxUploadFileSizeproperty with a maximum allowed size in megabytes (MB).
- Update the allowedUploadFileTypes property by specifying a comma separated list of file extensions (for example, jpg,png,tif).
- Save the edits.
Note:
For FeatureService and MobileService, Max upload file size and Allowed upload file types are a property of their respective extensions.
All uploaded items are subject to the cleanup interval set in the System directory by the server administrator. Additionally, the administrator can explicitly delete uploaded items as soon as they become available in the uploaded items list in the Administrator Directory.
Request parameters
| Parameter | Details |
|---|---|
| f | The response format. This resource supports html output only. Values: html |