Skip To Content
ArcGIS Developers
Dashboard

What's New in the Portal Administration REST API

Listed below are new and updated resources and operations added to the ArcGIS Portal Administration API at each release.

10.9

New Operations and Resources

Updated Operations and Resources

  • Four new properties have been added to the list of system properties: enablePrintService, enableLegendsService, enableRssService, enableKmlService
  • The securityConfig parameter for the Update Identity Store operation supports two new properties: saslAuthenticationScheme and krb5ConfigFilePath

10.8.1

New Operations and Resources

  • Email Settings returns the email settings that have been configured for your organization. These email settings enable email notifications regarding password policy updates, license expirations, as well as allows for users with built-in accounts to recover forgotten passwords via email.
  • Update Email Settings allows you to configure the email settings, such as the SMTP server, SMTP port, and encryption method for messages delivered from ArcGIS Enterprise portal.
  • Test Email Settings can be used to send a test email to ensure that the settings configured through the Update Email Settings operation have been applied correctly and emails are able to be sent from ArcGIS Enterprise portal and received by users.
  • Delete Email Settings deletes all previously configured email settings. Once these settings have been deleted, all email notifications will cease and users will no longer be able to use email to retrieve forgotten passwords.

Updated Operations and Resources

Update Server now supports WorkflowManager as a ArcGIS Server function value.

10.8

Read-only Mode

ArcGIS Enterprise now supports a read-only mode that maintains availability during upgrades. The Update Mode operation, new at 10.8, allows you to switch your deployment in and out read only mode, as well as create a custom message that appears for users whenever an attempt is made to update, create, or delete content through the API.

Certificate Management

The Machines resource has been updated to allow modifications of certificates for associated machines from a single URL. Prior to this change, in order to manage certificates on each machine, you would need to sign into the Portal Administrator Directory from each individual machine.

Privilege-based Access

Access to the Portal Admin API is based off the privileges included in either a user's custom or default role, enabling Enterprise portal administrators to restrict or grant access to the resources and operations that are associated with, and required by, their assigned privileges. For example, administrators can limit the ability for some administrators to interact with Enterprise portal settings pertaining to its look and feel. They may also restrict access to manage federates Enterprise or update security settings. This allows organizations to better delegate administrative tasks as well as create and assign roles that more effectively align with their existing administrative infrastructure without granting full access to the Portal Admin API.

Licensing Updates

User type extensions allow you to assign members of your organization access to Utility Network and Parcel Fabric functionalities. The GIS Professional Standard and GIS Professional Advanced user types include both the Utility Network and Parcel Fabric extensions. The Parcel Fabric extension can be included as an add-on for user types with at least the capability to view and edit data such as Editor, Field Worker, Creator and GIS Professional Basic user types. The Utility Network extension is compatible with all user types.

You can view your organization's licensing information with the License resource.

New Operations and Resources

  • Mode returns if an Enterprise deployment is set to read-only mode.
  • Update Mode enables and disables read-only mode.
  • SSL Certificates (HA) lists all certificates created for the Enterprise machines.
  • SSL Certificate (HA) returns specific details on a SSL certificate.
  • Delete Certificate (HA) deletes an SSL certificate. This operation is only accessible for highly available Enterprise portals.
  • Export Certificate (HA) downloads an SSL certificate. This operation is only accessible for highly available Enterprise portals.
  • Generate CSR (HA) generates a certificate signing request for a self-signed certificate. This operation is only accessible for highly available Enterprise portals.
  • Generate Certificate (HA) creates a self-signed certificate. This operation is only accessible for highly available Enterprise portals.
  • Import Existing Server Certificate (HA) imports an existing certificate into the key store. This operation is only accessible for highly available Enterprise portals.
  • Import Root or Intermediate Certificate (HA) imports a certificate authority's root and intermediate certificates into the key store. This operation is only accessible for highly available Enterprise portals.
  • Import Signed Certificate (HA) imports a certificate authority signed SSL certificate into the key store. This operation is only accessible for highly available Enterprise portals.
  • Update Web Server Certificate (HA)configures properties, such as TLS protocols, used by the portal. This operation is only accessible for highly available Enterprise portals.

Updated Operations and Resources

  • The Update Security Configuration is no longer used to set the default user type and default user role for new members. The defaults for new members is now configured on the New Member Defaults tab in the Organization Settings of the Enterprise portal or through the Set User Default Settings operation in the Sharing API.

10.7.1

Updated Operations and Resources

  • Populate License applies the information from your license file after creating or upgrading the Enterprise portal.
  • The License resource now returns detailed information regarding add-on apps and app bundles.

10.7

New Operations and Resources

  • Import License imports a new license file.
  • License is a new resource that returns information for user types that have been licensed to your organization.
  • Populate License applies the information from your license file to either create or upgrade Enterprise portal.
  • Validate License validates an input license file.

Updated Operations and Resources

Deprecated Items