FRAMES | NO FRAMES Description | Parameters | Examples | Response
Upload (Operation)
URL http://<service-uploads-url>/upload (POST only)
Parent Resource Uploads
Required Capability Uploads

Description

This operation uploads an item to the server. Each uploaded item is identified by a unique itemID. Since this request uploads a file, it must be a multi-part request as per IETF RFC1867.

See section limiting Upload file size and file types to learn more about default file size and file type limitations imposed for uploads.

All uploaded items are subjected to the deletion rules set on the upload directory by the administrator of the server. Additionally, the administrator can explicitly delete an item as each uploaded item shows up in the list of all the uploaded items in Site Directory.

Users can provide arguments to the upload operation as query parameters. The parameter details are provided in the parameters table below.

Parameters

Parameter Details
f Description: The response format. The default response format is html.

Values: html | json
file Description: The file to be uploaded.
description Description: An optional description for the uploaded item.

Example Usage

Example 1: Upload a file:

http://servicesbeta2.esri.com/arcgis/rest/services/911CallsHotspot/GPServer/uploads/upload

The input parameter file to this operation is a file.

JSON Response Syntax

{
    "success": <true|false>,
    "item": {
        "itemID": "<itemID>",
        "itemName": "<itemName>",
        "description": "<description>",
        "date": <date>,
        "committed": <true|false>
    }
}

JSON Response Example

{
    "success": true,
    "item": {
        "itemID": "ib740c7bb-e5d0-4156-9cea-12fa7d3a472c",
        "itemName": "lake.tif",
        "description": "Lake Tahoe",
        "date": 1246060800000,
        "committed": true
    }
}