Change Provider

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

Description

The changeProvider operation updates an individual service to use either a dedicated or shared instance type.

You can use either shared or dedicated instances for compatible services published to an ArcGIS Server site from ArcGIS Pro. At 10.8, qualifying services published to a newly created site will be automatically set to use shared instances, or the shared instance pool, by default.

When using this operation, services may populate other provider types as values for the provider parameter, such as ArcObjects and SDS. For SDS provider types, this operation does not support changing the provider of these services to either ArcObjects11 or DMaps. Services with SDS as their provider cannot change their instance type. For more information about shared instances and which services qualify to be set as a shared instance, see Configure service instance settings.

At 10.9, the changeProvider operation supports the migration of map, image, and geodata services from using the ArcMap service runtime to the newer ArcGIS Pro service runtime by changing the provider parameter from ArcObjects to ArcObjects11.

Starting at ArcGIS Enterprise 11.0, the ArcMap service runtime has been removed and only ArcGIS Pro-based services are supported. When upgrading to 11.x, all map, image, and geodata services will migrate to using the ArcGIS Pro service runtime and the ArcObjects11 provider. After upgrading to 11.x, any remaining geocode or geoprocessing services that were originally published from ArcMap cannot be started and must be republished from ArcGIS Pro. Using changeProvider to edit geocode and geoprocessing services is not supported. For more information, see Migrating services to the ArcGIS Pro service runtime.

Request parameters

ParameterDetails

provider

Specifies the service instance as either a shared (DMaps) or dedicated (ArcObjects11) instance type.

Values: ArcObjects11 | DMaps

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 changeProvider operation, demonstrating changing a service from ArcObjects11 (dedicated instance) to DMaps (shared instance):

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

provider=DMaps&f=json

JSON Response examples

Success response example

The following response indicates that the changeProvider operation was executed successfully:

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

Error response example

The following error response occurs when setting a provider value that is incompatible with the service. For example, if the original provider for TestMap.MapServer was ArcObjects, indicating that the service was published from ArcMap, an attempt to change the provider to DMaps will result in an error. Services published from ArcMap are not compatible with the DMaps provider.

Use dark colors for code blocksCopy
1
2
3
4
5
{
  "status": "error",
  "messages": ["Changing the provider of the service 'TestMap.MapServer' to 'DMaps' is not permitted. "],
  "code": 500
}

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