- URL:
- https://[root]/portals/[portalID]/settings/update
- Methods:
POST
- Version Introduced:
- 10.8
Example usage
The following is a sample ArcGIS Online POST request for the update
operation:
POST /sharing/rest/portals/0123456789ABCDEF/settings/update HTTP/1.1
Host: org.arcgis.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
anonymousAccessNotice={
title": "Anonymous Access Notice Title",
text": "Anonymous Access Notice Text",
"buttons": "acceptAndDecline",
"enabled": true
}&authenticatedAccessNotice=authenticatedAccessNotice={
"title": "Authenticated Access Notice Title",
"text": "Authenticated Access Notice Text",
"buttons": "okOnly",
"enabled":true
}&informationalBanner={
"text": "Header Text",
"bgColor": "grey",
"fontColor": "blue",
"enabled": true
}&f=pjson
The following is a sample ArcGIS Enterprise POST request for the update
operation, formatted for readability. At 11.0, this operation includes the portal
parameter:
POST /webadaptor/sharing/rest/portals/0123456789ABCDEF/settings/update HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
anonymousAccessNotice={
title": "Anonymous Access Notice Title",
text": "Anonymous Access Notice Text",
"buttons": "acceptAndDecline",
"enabled": true
}&authenticatedAccessNotice=authenticatedAccessNotice={
"title": "Authenticated Access Notice Title",
"text": "Authenticated Access Notice Text",
"buttons": "okOnly",
"enabled":true
}&informationalBanner={
"text": "Header Text",
"bgColor": "grey",
"fontColor": "blue",
"enabled": true
}&portalConfigProperties={
"extentService": "https://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer",
"footerLinks": [],
"gcsBasemapService": "https://wi.maptiles.arcgis.com/arcgis/rest/services/World_Imagery/MapServer",
"httpsDomains": [
"arcgis.com",
"arcgisonline.com",
"esrikr.com",
"premiumservices.blackbridge.com",
"esripremium.accuweather.com",
"gbm.digitalglobe.com",
"firstlook.digitalglobe.com",
"msi.digitalglobe.com"
],
"longTokenExpiration": 20160,
"searchArcGISOnlineEnabled": true,
"surveyUrl": "https://survey123.arcgis.com",
"tokenExpiration": 120,
"configurePortalAGOEnv": "www.arcgis.com",
"portalAGOConfigEnabled": true,
"portalLivingAtlasConfigEnabled": true,
"iotViewerUrl": "https://velocity.arcgis.com"
}&f=pjson
Description
The update
operation allows you to enable and customize an access notice and informational banner for your organization, as well as set advanced portal settings for the organization. The access notice, for authenticated and anonymous access, acts as a terms of service that users must agree to before accessing the portal site. The informational banner allows you to alert members of your organization about the site's current status and content, such as a notice that the site is currently in read-only mode or containing content of a specific classification level. For more information, see Configure security settings.
Starting at ArcGIS Enterprise 11.0, this operation also customizes advanced portal options, such as configuring a disconnected deployment using the portal
parameter. Previously, administrators who needed to customize the portal's behavior made updates to the editable version of the portal's configuration file (config.js
). Though administrators no longer need to update the configuration file, it is recommended that a backup of it be made before upgrading to an 11.0 deployment to preserve the portal's previous customization and settings as a reference. After the upgrade, the properties defined in the configuration file must be manually applied to the portal
parameter, as the Sharing API does not automatically collect and apply the information in the file. For a list of the properties supported by portal
and their default values, see the Advanced portal configuration properties section below.
Request parameters
Parameter | Details |
---|---|
| A JSON object representing a notice that is shown to your organization's anonymous users. For the required properties for this parameter, see the Access notification properties section below. Example
|
| A JSON object representing a notice that is shown to your organization's authenticated users. For the required properties for this parameter, see the Access notification properties section below. Example
|
| A JSON object representing the informational banner that is shown at the top of your organization's page. For the required properties for this parameter, see the Informational banner properties section below. Example
|
| Introduced at ArcGIS Enterprise 11.0. A JSON object representing advanced configuration options for the portal. The properties can be used to customize the behavior of the portal to match the organization's needs or to configure a disconnected deployment. For information about the configurable properties, see the Advanced portal configuration properties section below. Example
|
| The response format. The default response format is Values: |
Access notification properties
The table below outlines the properties required by the anonymous
and authenticated
parameters.
Property | Details |
---|---|
| The title of the access notice. Example
|
| The text displayed in the access notice. Example
|
| Specifies the button option for the access notice. Users will be prompted to select either Accept or Decline, or only OK. Values: |
| Specifies whether the access notice is enabled. Values: |
Information banner properties
The table below outlines the properties required by the informational
parameter.
Property | Details |
---|---|
| The text displayed in the informational banner. Example
|
| The background color of the informational banner. This property recognizes common color names (such as red or blue) and hexadecimal color values. While you can choose any color for this property, it is recommended that you choose a color that contrasts appropriately with the Example
|
| The font color of the informational banner. This property recognizes common color names (such as red or blue) and hexadecimal color values. While you can choose any color for this property, it is recommended that you choose a color that contrasts appropriately with the Example
|
| Specifies whether the informational banner is enabled. Values: |
Advanced portal configuration properties
The following table outlines the configurable properties for the portal
parameter and their default values.
Property | Details |
---|---|
| Introduced at ArcGIS Enterprise 11.0. The service that will be used to update, or set the extent of, a web map item. The service must be a tiled map service that uses the WGS84 geographic coordinate system with well-known ID (WKID) 4326. Example
|
| Introduced at ArcGIS Enterprise 11.0. The user-specified links displayed on all page footers, such as the Terms of Use, Privacy, Contact Us, and Report Abuse links. By default, this property is an empty array. Example
|
| Introduced at ArcGIS Enterprise 11.0. The service that will be used as the basemap for OGC WMS services that do not support the Web Mercator coordinate system. Example
|
| Introduced at ArcGIS Enterprise 11.0. A list of federated servers that Map Viewer Classic can use to switch services from using HTTP to HTTPS. Example
|
| Introduced at ArcGIS Enterprise 11.0. The expiration time for tokens created when a user selects Keep me signed in when signing in. If Keep me signed in is not selected, the Example
|
| Introduced at ArcGIS Enterprise 11.0. Specifies whether the Organization page of the portal is visible to all organization members. If this property is set to Values: |
| Introduced at ArcGIS Enterprise 11.0. Specifies whether the option to search for ArcGIS Online layers using both Map Viewer Classic and, starting at ArcGIS Enterprise 11.2, Map Viewer is enabled. When disabled ( Values: |
| Introduced at ArcGIS Enterprise 11.0. Specifies whether ArcGIS Dashboards is accessible in the portal. If disabled ( Values: |
| Introduced at ArcGIS Enterprise 11.0. A list of Esri applications that display in the app launcher. Entries must be separated by a comma and match the application title expected by ArcGIS Enterprise. The example below shows the most recent default list of applications. For the list of default applications supported at your deployment's version of ArcGIS Enterprise, reference your Portal Directory API installed help. Example
|
| Introduced at ArcGIS Enterprise 11.0. Specifies whether Scene Viewer is accessible in the portal. When disabled ( Values: |
| Introduced at ArcGIS Enterprise 11.0. The URL used to access the Survey123 website. This URL can point to an installed Survey123 website, including any port numbers or reverse proxy access points. Example
|
| Introduced at ArcGIS Enterprise 11.0. The expiration time for tokens generated when a user signs in. If, when signing in, a user selects Keep me signed in, the Example
|
| Introduced at ArcGIS Enterprise 11.0. Specifies whether ArcGIS Web AppBuilder is accessible to the portal. When disabled ( Values: |
| Introduced at ArcGIS Enterprise 11.0. The proxy used for configured utility services. For a disconnected environment, set this property to Example
|
| Introduced at ArcGIS Enterprise 11.0. Specifies whether the ArcGIS Online tab is displayed on the portal's Organization Settings page. If you're configuring a disconnected environment, set this property to Values: |
| Introduced at ArcGIS Enterprise 11.0. Specifies whether the Configure Living Atlas Content section will be displayed on the ArcGIS Online tab on the portal's Organization Settings page. In a disconnected environment, set this property to Values: |
| Introduced at ArcGIS Enterprise 11.1. This is the URL to access the ArcGIS Velocity application that can point to an installed ArcGIS Velocity deployment. Example
|
| Introduced at ArcGIS Enterprise 11.3. Indicates whether the Web Editor setup has been installed. When this property is Values: |
JSON Response example
{"success": true}