Skip To Content
ArcGIS Developers
Dashboard

What's new in Server Administration API

Listed below are new resources and operations added to the ArcGIS Server Administrator API since version 10.1.

10.9

Deprecated items

The following items have been deprecated as of 10.9. Starting with Insights 2021.1, the registration and management of relational data store types should be performed with ArcGIS Insights. For more information, see Manage connector types.

  • The Register Relational Data Store Type operation was introduced at 10.5 and allowed the user to register a new relational data story type with the server. This has been deprecated as of 10.9.
  • The Edit Relational Data Store Type operation was introduced at 10.5 and allowed the user to edit a registered relational data storey type to update its properties.
  • The Relational Data Store Type resource was introduced at 10.5 and would return a list of the properties for a registered relational data store type.
  • The Relational Data Store Types resource was introduced at 10.5 and would return a list of the relational data store types that had been registered with the server.
  • The Unregister Relational Data Store Types operation was introduced at 10.5 and allowed the user to unregister a relational data store type from the server.

Updated operations and resources

The Server Properties, uploadFileExtensionWhiteList and

uploadItemInfoFileExtensionWhitelist
, have been updated at 10.9 to uploadFileExtensionAllowedList and uploadItemInfoFileExtensionAllowedList, respectively.

10.8.1

The following information has either been added or updated at 10.8.1:

  • Edit Service now supports the ability to specify if a service's virtual directories are secured and require authentication. This is associated with the site-wide property that can be set through the Update Security Configuration operation.

Privilege-based access

Access to the Server Admin API is based off the privileges included in either a user's custom or default role, enabling administrators to restrict or grant access to the resources and operations that are associated with, and required by, their assigned privileges. At 10.8, this functionality was first introduced through changes made to administrator access to the Portal Admin API directory. At 10.8.1, this same privilege-based system has been implemented for the ArcGIS Server Admin API directory.

10.8

  • Compatible map services published from ArcGIS Pro to ArcGIS Server, starting at 10.8, will initially use the shared instance pool by default. The default instance type can be changed either through the Server Manager or the Update Default Service Properties operation. As well, the instance type of an individual and compatible map service can be changed through the Change Provider operation.
  • The Update Site Mode operation has a new parameter, allowEditingViaServices, that specifies if edits for feature services are allowed while the site is in read-only mode.

10.7.1

  • The Federate Data Item operation can be used to create a data store item in your portal for a data store that has been registered with one of your portal's federated ArcGIS Server sites.
  • featureServiceXSSFilter is a new property in Server Properties that is used to set the value of the xssPreventionRule for feature services when they are published by either applying an XSS filter to any attribute data input into a feature service for new or updated features, or filtering the input data and output data for XSS strings.

Deprecated items

  • The Message Bus resource was introduced at 10.5 and allowed you to view and manage your message bus.
  • The Message Bus Health Check operation was introduced at 10.5 and was used to return information for each machine that participated in the Message Bus service.
  • The Message Bus Status resource was introduced at 10.5 and allowed you to view the status of the Message Bus service.
  • The Start Message Bus service operation was introduced at 10.5 and allowed you to run your message bus service.
  • The Stop Message Bus service operation was introduced at 10.5 and allowed you to stop your message bus service.

10.7

The following information has either been updated or added in Server Properties:

  • The allowLegacyURLParser property now allows double quotation marks in URL query strings when set to true.
  • enableNosniffHeader is a new property that, when set to true, has all network communication from ArcGIS Server including the X-Content-Type-Options response header with a value of nosniff, which helps protect against MIME confusion attacks.
  • ldapCertificateValidation is a new property. When set to true, any encrypted LDAP communication (LDAPS) made from ArcGIS Server to the user or role identity store will enforce certificate verification.
  • machineSuspendThreshold is a new property that defines the time period of inactivity after which a machine will be suspended from receiving administrative and publishing requests.
  • The percentageMaxAllowedComputeCores property sets the maximum percentage of CPU, out of the total CPU available on the machine, that will be used by the compute platform worker process on a single node.
  • The percentageMaxAllowedComputeMemory property sets the maximum percentage of memory, out of the total amount of memory available on the machine, that will be used by the compute platform worker process on a single node.
  • suspendedMachineUnregisterThreshold is a new property that defines the time period of inactivity after which a machine will be unregistered from the site.

Deprecated items

  • The Synchronization Service Health Check resource was introduced at 10.5 and was used to return information for each machine that participates in the synchronization service.
  • The AppServer property from the Server Properties resource was introduced at 10.6 and was used to override the optimized architecture of ArcGIS Server to use legacy architecture. However, the AppServer property was only relevant when the singleClusterMode deployment was set to true.

10.6

JSON content type

The content-types for JSON and JSON with callback responses have been changed from text/plain.

  • For JSON: Content-Type:application/json;charset=utf-8
  • For JSON with callback: Content-Type:application/javascript;charset=utf-8

10.5

  • The Relational Data Store Types resource indicates database platforms that have been registered with an ArcGIS Server site. Only sites that have been designated as a hosting server ever need to have relational data store types registered. Web clients (for example, Insights for ArcGIS) use these types when creating Relational Database Connection portal items. A Relational Database Connection portal item references a new service type: RelationalCatalogServer (in other words, Relational Catalog Service). At least one relational data store type must be registered with the hosting server before Relational Database Connections can be used.

10.4

  • You can control changes to your ArcGIS Server site using the site mode resource. The Update Site Mode operation changes the site mode. For more information about site modes, see About ArcGIS Server site mode in the ArcGIS Server help documentation.
  • Additional properties related to ArcGIS Server site mode have been added to serverProperties.
  • A new property has been added to editConfigStore to control the location of the local repository for read-only site mode.
  • unregisterDataItem now requires a new parameter force with the value set to true.
  • A new editDataItem operation is supported to allow editing of data store item connection information.

10.3.1

  • The Deployment resource is used to control the load-balancing functionality between GIS server machines. For example, in large sites with a single cluster, you can configure the site to remove the load balancing functionality between GIS server machines. This reduces network traffic between machines in the site and helps reduce load on your network.
  • The Get Available Time Zones resource has been deprecated.
  • The Service Types resource supports the dateFieldsTimezoneID and dateFieldsRespectsDaylightSavings properties for map and feature services.

10.3

10.2

  • The Export Site operation creates a backup of your site configuration. This includes information about the machines, services, server object extensions, users, roles, and other settings in your site. The Import Site operation restores the backup.
  • The Get Roles By Privilege operation returns a list of roles associated with a given privilege. For example, you could use this operation to get a list of all roles that have the Publisher privilege.
  • When configuring SSL on a machine, the Import Existing Server Certificate operation allows you to import a CA-signed certificate that you already own.

10.1 Service Pack 1

  • The Services In Cluster resource gives you a report of all services participating in a given cluster.
  • The Web Adaptors Configuration resource reports configuration information about your Web Adaptors, such as the shared key allowing encryption of items between your Web Adaptors and GIS server. You can set your own shared key and other properties using the new Update Web Adaptors Configuration operation.
  • The Datastore Configuration resource reports configuration information about your store of registered folders and databases, such as whether the server administrator has blocked service publishers from automatically copying data to the server at publish time. You can block data copying and set other properties using the new Update Datastore Configuration operation.