Start Service

URL:
https://<root>/services/<serviceName>.<serviceType>/start
Methods:
POST
Required Capability:
Access allowed with any authorized privilege
Version Introduced:
10.1

Description

The start operation starts a specific service. When a service is started, the server creates the minimum instances on all server machines in the site. If the minimum instances are 0, the instances are created dynamically based on the incoming requests. Starting at ArcGIS Enterprise 11.0, publishing services from ArcMap is no longer supported. After upgrading to version 11.0 or later, any remaining geocode or geoprocessing services that were originally published from ArcMap cannot be started and must be republished from ArcGIS Pro.

Request parameters

ParameterDescription

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

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

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /webadaptor/admin/services/Maps/SeattleMap.MapServer/start HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

f=pjson

JSON Response examples

The following is a sample success response for the start operation, indicating that the service was started successfully:

Use dark colors for code blocksCopy
1
2
3
{
  "status": "success"
}

The following error response is returned when an attempt is made to start a geocode service with ArcMap as its service provider:

Use dark colors for code blocksCopy
1
2
3
4
5
{
  "status": "error",
  "messages": ["This geocode service cannot be started because it was created for use with the ArcMap service runtime that is no longer supported at this version. Please republish this service using ArcGIS Pro. Information on how to migrate services to use the ArcGIS Pro service runtime is available in the help topic 'Migrating services to the ArcGIS Pro service runtime'."],
  "code": 500
}

The following error response is returned when an attempt is made to start a geoprocessing service with ArcMap as its service provider:

Use dark colors for code blocksCopy
1
2
3
4
5
{
  "status": "error",
  "messages": ["This geoprocessing service cannot be started because it was created for use with the ArcMap service runtime that is no longer supported at this version. Please republish this service using ArcGIS Pro. Information on how to migrate services to use the ArcGIS Pro service runtime is available in the help topic 'Migrating services to the ArcGIS Pro service runtime'."],
  "code": 500
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.