- URL:https://<service-url>/start(POST only)
- Required Capability:Default administrator role | All authorized privileges
- 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.
Legacy:
At 10.9.1, when installing ArcGIS Server, you had the option to disable the ArcMap service runtime. This allowed you to migrate services published from ArcMap to the ArcGIS Pro service runtime before support for the ArcMap service runtime was discontinued at Enterprise 11.0. If the ArcMap service runtime was not disabled, services using ArcMap as their service provider (ArcObjects) could still be started.
Request parameters
| Parameter | Description |
|---|---|
| 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:
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=pjsonJSON Response examples
The following is a sample success response for the start operation, indicating that the service was started successfully:
{
"status": "success"
}The following error response is returned when an attempt is made to start a geocode service with ArcMap as its service provider:
{
"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:
{
"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
}