ArcGIS REST API

Update Tiles

Description

The updateTiles operation supports updating the cooking extent and cache levels in a hosted map service. The result of this operation is a response indicating success, which redirects you to the Job Statistics page, or failure, which includes an error code and description.

Parameters

ParameterDetails
f

The response format. The default response format is html.

Values: html | json | pjson

token

An access token that identifies the authenticated user and controls access to restricted resources and operations.

extent

The cooking extent of the map service to update.

{"xmin":3950569,"ymin":4015211,"xmax":3951304,"ymax":4016043,"spatialReference":{"wkid":102100}}

levels

The cache levels of the map service to update.

0-5,10,11-20 [OR] 1,2,3 [OR] 0-5

mergeBundle

<Optional> Default is false and applicable to compact cache storage format. It controls whether bundles from the update are merged with the existing ones on the service, otherwise bundle files are overwritten.

replaceTiles

<Optional> Default is false, applicable to compact cache storage format and used when mergeBundle=true. It controls whether new tiles will replace the existing ones when merging bundles.

JSON Response syntax

{
  "id":<id>,
  "name": <service name>,
  "status": <success | failed>,
  "itemId": <item id>,
  "type": <map service>,
  "jobId": <job id>,
  "error": {
    "code": <code>,
    "message": "<description>",
    "details": [
      "<message>"
    ]
  }
}

HTML Response example (when updateTiles succeeds)

The HTML response will redirect you to the Job Statistics.

JSON Response example (when updateTiles succeeds)

{
  "id" : "ca377ba3-6f19-4ebb-bd15-aaae0c055373", 
  "name" : "WorldService", 
  "status" : "Success", 
  "itemId" : "ca377ba36f194ebbbd15aaae0c055373", 
  "type" : "Map Service", 
  "jobId" : "e2e8a0bb-4b40-46ac-813a-0bbdf522195f", 
  "message" : "success"
}

JSON Response example (when updateTiles - Cooking Extent fails)

{
  "error" : 
  {
    "code" : 400, 
    "message" : "", 
    "details" : [
      "Invalid extent."
    ]
  }
}

JSON Response example (when updateTiles - Cache Levels fails)

{
  "error" : 
  {
    "code" : 400, 
    "message" : "", 
    "details" : [
      "Invalid cache levels."
    ]
  }
}