Deletes an existing map or image service cache, including all associated files on disk.
This is an unrecoverable operation so only use if you are sure you no longer need the cache. If you want to delete tiles but leave the cache folder structure and tiling scheme, use the Manage Map Server Cache Tiles tool with Update Mode set to DELETE_TILES.
After this tool runs, the service will be restarted.
The map or image service whose cache will be deleted.
This is a string containing both the server and service information. To see how to construct this string, open ArcCatalog, select your service in the Catalog tree, and note the text in the Location toolbar. Change the backslashes to forward slashes, for example, GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer.
|Image Service; MapServer|
The total number of instances of the System/CachingTools service that you want to dedicate toward running this tool. You can increase the maximum number of instances per machine of the System/CachingTools service using the Service Editor window available through an administrative connection to ArcGIS Server. Ensure your server machines can support the chosen number of instances.
The Delete Map Server Cache tool requires a minimum of two instances to run successfully.
The output URL.
DeleteMapServerCache example (stand-alone script)
This example uses DeleteMapServerCache to delete a cache for a map service named Rainfall.
# Name: DeleteMapServerCache.py # Description: The following stand-alone script demonstrates how to delete map server cache # tiles if the corresponding cache schema or tiles has been created # Requirements: os, sys, time & traceback modules # Any line that begins with a pound sign is a comment and will not be executed # Empty quotes take the default value. # To accept arguments from the command line replace values of variables to # "sys.argv" # Import system modules import arcpy from arcpy import env import os, sys, time, datetime, traceback, string # Set environment settings env.workspace = "C:/data" # List of variables for mapservice properties connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog" server = "arcgis on MyServer_6080 (publisher)" serviceName = "Rainfall.MapServer" inputService = connectionFile + "\\" + server + "\\" + serviceName numOfCachingServiceInstances = 2 currentTime = datetime.datetime.now() arg1 = currentTime.strftime("%H-%M") arg2 = currentTime.strftime("%Y-%m-%d %H:%M") file = 'C:/data/report_%s.txt' % arg1 # print results of the script to a report report = open (file,'w') # To Recreate all the tiles for the default number of scales generated try: starttime = time.clock() result = arcpy.DeleteMapServerCache_server(inputService, numOfCachingServiceInstances) finishtime = time.clock() elapsedtime = finishtime - starttime #print messages to a file while result.status < 4: time.sleep(0.2) resultValue = result.getMessages() report.write ("completed " + str(resultValue)) print "Deleted cache tiles & schema for mapservice " + serviceName "\n in " + str(elapsedtime) + " sec \n on " + arg2 except Exception, e: # If an error occurred, print line number and error message tb = sys.exc_info() report.write("Failed at \n" "Line %i" % tb.tb_lineno) report.write(e.message) print "Deleted Map server Cache Tiles " report.close()
This tool does not use any geoprocessing environments.
- Basic: Yes
- Standard: Yes
- Advanced: Yes