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:

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:

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:

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:

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.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close