Register (Upload)

• URL:https://<root>/uploads/register(POST only)
  
• Required Capability:Default administrator role | Publisher role
• Version Introduced:10.9

Description

The register operation directs the server to reserve space for a new item to be uploaded that is made up of one or more parts. Once the operation is completed, you must use the uploadPart operation to upload individual parts. After all the parts are uploaded, you must use the commit operation to consolidate the parts.

Request parameters

Parameter	Details
itemName (Required)	The name of the item that will be uploaded. Example itemName=TestUpload_WaterDistributionNetwork.kmz
description (Optional)	The description of the item that will be uploaded. Example description=Test upload of Water Distribution Network template

Example usage

The following is a sample POST request for the register operation:

POST /context/admin/uploads/register HTTP/1.1
Host: organization.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

itemName=TestUpload_WaterDistributionNetwork.kmz&description=Test upload of Water Distribution Network template&token=ELIMsyURgefHIZ-x6PzynYsaxLNR30GbWE6PCpgD0Hu7dWQ3vmBLz3bljwvJC8a74K_XARVfs5lpmCkjLkMZANHIDgMHiwgwnNiQBbTWHEbNqJeodE9ipXYeUmlGkveMQ44JjNQlNGYim-LqV4DcrPynxBlvO0CsIT4RIB-OsYp6oU_jqS9xVHxcHwCtvu3rnikAqeb3S96aS0ntC-414Y23t1CWAVhDSmRrl7NyWgw-jN4VBZ3FvPnDDDoFooY

JSON Response syntax

{
  "status": "success",
  "item": <item>
}

JSON Response example

{
  "status": "success",
  "item": {
    "itemID": "ie3b7610b-b229-4ca0-a8bc-d2c02069149a",
    "itemName": "TestUpload_WaterDistributionNetwork.kmz",
    "description": "Test upload of Water Distribution Network template",
    "pathOnServer": "C:\\arcgis\\arcgisserver\\directories\\arcgissystem\\kml",
    "date": 1566936940842,
    "committed": false,
    "serviceName": "",
    "contentType": "application/octet-stream"
  }
}