GetPortalDescription

Summary

Returns a dictionary of portal information.

The GetPortalDescription function returns the view of the portal as seen by the current user, anonymous or signed in. It includes information such as the name, logo, featured items, and supported protocols (HTTP versus HTTPS) for the portal. If the user is not signed in, this call will return the default view of the portal. If the user is signed in, the view of the returned portal will be specific to the organization to which the user belongs. The default view of the portal is dependent on the culture of the user, which is obtained from the user's profile.

Discussion

The table below contains a list of the more important portal properties.


Property	Details
`access`	Determines who can view your organization as an anonymous user. Setting to `public` allows anonymous users to access your organization's custom URL. Setting to `private` restricts access to only members of your organization. The default is `public`. Values: `private` \| `public`
`allowedBetaFeatures`	An array of beta features that are enabled for the organization.
`allowedOrigins`	An array of up to 100 web app domains to restrict cross-origin resource sharing (CORS) access to the REST API. This property is only available to administrators.
`allowedRedirectUris`	A JSON array of allowed redirect URIs that represent portal instances with which you share secure content. This allows users in your organization to use organization logins to access the secured content through web apps hosted on these portals.
`allSSL`	Indicates whether the organization is using HTTPS. If set to `true`, all calls made using resources that belong to the organization require HTTPS. The default is `false`. Values: `true` \| `false`
`analysisLayersGroupQuery`	The query that identifies the group containing the layers shown in the Analysis Layers gallery for the analysis tools.
`appInfo`	Information about the application through which the resource was accessed. This information is based on the token used to access the resource.
`authorizedCrossOriginDomains`	An array of trusted servers that clients can send credentials to when making CORS requests to access web-tier secured services.
`authorizedCrossOriginNoCorsDomains`	Introduced at ArcGIS Enterprise 11.0. An array of trusted servers that JavaScript clients will initially send direct requests to handle authentication prior to making a (CORS) request. All trusted servers must already be listed in the `authorizedCrossOriginDomains` property prior to being added to this property. This property is only supported in ArcGIS Enterprise.
`availableCredits`	The total number of credits of the organization.
`backgroundImage`	The background image that displays behind all other components on the home page. Accept the default background image, specify a URL for a custom background image, or specify that no background image will be used.
`basemapGalleryGroupQuery`	The query that identifies the group containing the web maps that display in the Map Viewer basemap gallery.
`bingKey`	The Bing key to use for web maps using Bing Maps.
`canListApps`	An organization can list applications in the marketplace only if `canListApps` is `true`. Values: `true` \| `false`
`canListData`	An organization can list data services in the marketplace only if `canListData` is `true`. Values: `true` \| `false`
`canListPreProvisionedItems`	An organization can list preprovisioned items in the marketplace only if `canListPreProvisionedItems` is `true`. Values: `true` \| `false`
`canProvisionDirectPurchase`	An organization can provision direct purchases in the marketplace without a customer request only if `canProvisionDirectPurchase` is `true`. Values: `true` \| `false`
`canSearchPublic`	Includes or excludes public items, groups, and users in search queries. When `canSearchPublic` is `false`, no public items outside of the organization are included in searches. However, public items that are part of the organization are returned. The default is `true`. Values: `true` \| `false`
`canShareBingPublic`	The Bing key can be shared to the public and is returned as part of a portal's description call (`/sharing/rest/portals/<orgid>`). This requires that the `access` property of the portal be set to `public`. The `canShareBingPublic` property is not returned publicly and is only shown to users within the organization.
`canSharePublic`	Indicates whether an organization can share groups or items publicly. When `canSharePublic` is set to `false`, content cannot be shared with everyone. The default is `true`. Values: `true` \| `false`
`canSignInArcGIS`	Allows an organization with a configured enterprise IDP to turn on or off the ArcGIS sign in option. The default is `true`. Values: `true` \| `false`
`canSignInIDP`	Allows an organization with a configured enterprise IDP to turn on or off the enterprise sign in. The default is `true`. Values: `true` \| `false`
`colorSetsGroupQuery`	The query that identifies the group containing the color sets used for rendering in Map Viewer.
`commentsEnabled`	Allows the organization to disable commenting. The default is `true`. When `commentsEnabled` is `false`, comments are hidden but not removed, and `numComments` is set to zero for all items in the organization. Calls to add a comment and view comments will fail. If the organization reenables comments, the comments display and `numComments` is restored. Values: `true` \| `false`
`contacts`	An array of chosen administrators listed as points of contact whose email addresses will be listed as points of contact in the automatic email notifications sent to organization members when they request password resets, help with their usernames, modifications to their accounts, or any issues related to the allocation of credits to their accounts.
`contentCategorySetsGroupQuery`	The query that identifies the group containing the ArcGIS Online content category sets.
`created`	The date the organization was created, in UTC, using milliseconds since epoch.
`creditAssignments`	Indicates whether the organization has credit budgeting enabled. The default is `disabled`. Values: `enabled` \| `disabled`
`culture`	The default locale (language and country) information. The format for the culture code is based on a language code and a country code separated by a dash: The language code is based on the two-letter codes found at the Library of Congress Codes for the Representation of Names of Languages page. The country code is based on the two-letter codes found by searching the ISO Online Browsing Platform.
`cultureFormat`	The preferred number and date format according to CLDR. The `cultureFormat` property is only applicable to English and Spanish, that is, when `culture` is set to `en` or `es`. See Languages for supported formats.
`customBaseUrl`	The custom base URL for the portal.
`defaultBasemap`	The default basemap displayed in Map Viewer.
`defaultDevBasemap`	The default basemap displayed in Map Viewer for developer subscriptions.
`defaultExtent`	The default extent of the organization, used when users create a web map.
`defaultUserCreditAssignment`	The default allocation of credits for new members. The value is `-1` for no allocated limit.
`defaultVectorBasemap`	The default vector basemap displayed in Map Viewer when `useVectorBasemaps` is `true`.
`description`	The description of the organization. The description can be any length.
`devbasemapGalleryGroupQuery`	The query that identifies the group containing the web maps that display in the Map Viewer basemap gallery for developer subscriptions.
`eueiEnabled`	Indicates whether the organization allows ArcGIS Online to collect usage information from its members to improve the user experience.
`featuredGroups`	The featured groups for the organization. These are the groups that are highlighted on the Groups page in the portal home app.
`featuredItemsGroupQuery`	The query that identifies the group containing featured items for the gallery. Set a Group ID or, if null, the most viewed items in your organization are displayed in the gallery.
`galleryTemplatesGroupQuery`	The query that identifies whether the group containing gallery templates is allowed to build galleries that showcase the web maps and web mapping apps within a group.
`hasCategorySchema`	Indicates whether the organization has a content category set up.
`helpBase`	Provides the base URL for your organization's help documentation, which builds all the help URLs in the portal. Starting at ArcGIS Enterprise 10.8.1, `helpBase` can be updated to set the help topic provider as either a publicly available or installed source. By default, the source is set to the local, installed source. When internet is available, you can enable the option to deliver help topics from Esri's public web help from the Enterprise portal home app. Note: The documentation source only has an impact on documentation accessed through the Enterprise portal home app and does not impact ArcGIS Server or the ArcGIS REST API documentation.
`helperServices`	A JSON object of various services needed by client applications. The helper services can be overridden by the organization or the portal. The services include the following: `analysis`—Hosted geoprocessing services that perform analyses. `asyncClosestFacility`—ArcGIS geoprocessing service for asynchronous closest-facility analysis. `asyncGeocode`—ArcGIS geoprocessing service for performing batch geocoding asynchronously. (This helper service was added at ArcGIS Enterprise 10.5.) `asyncLocationAllocation`—ArcGIS geoprocessing service for asynchronous location-allocation network analysis. `asyncODCostMatrix`—ArcGIS geoprocessing service for generating origin-destination cost matrices asynchronously. `asyncRoute`—ArcGIS geoprocessing service for asynchronous route analysis. `asyncServiceArea`—ArcGIS geoprocessing service for asynchronous service-area analysis. `asyncVRP`—ArcGIS geoprocessing service for solving asynchronous vehicle routing problems. `closestFacility`—ArcGIS `NAServer` service for synchronous closest-facility analysis. `creditEstimation`—ArcGIS geoprocessing service for estimating credits to be charged to perform a certain task. `elevation`—ArcGIS geoprocessing service for elevation analysis. `defaultElevationLayers`—Limited Error Raster Compression (LERC) elevation service used by ArcGIS Pro and the web Scene Viewer. `elevationSync`—ArcGIS geoprocessing service for elevation analysis. `geocode`—Array of ArcGIS geocoding services to use for geocoding. `geoenrichment`—ArcGIS `GeoenrichmentServer` service. `geometry`—ArcGIS `GeometryServer` service for geometry functions. `hydrology`—ArcGIS geoprocessing service for hydrologic analysis. `iot`—ArcGIS Velocity region URL. `locationTracking`—ArcGIS feature service for organization-wide location tracking. `orthomappingElevation`—ArcGIS image service for Ortho Maker. `printTask`—ArcGIS `PrintServer` task for printing functionality. `rasterUtilities`—ArcGIS geoprocessing service that enables raster analysis and processing. `route`—ArcGIS `NAServer` service for synchronous route analysis. `routingServicesSource`—Introduced at Enterprise 11.0. The routing services' source and configuration information. `routingUtilities`—ArcGIS geoprocessing service that provides auxiliary information, such as travel modes, used by the different routing services. `serviceArea`—ArcGIS `NAServer` service for synchronous service-area analysis. `symbols`—Displays the symbol service URL used by the portal. `syncVRP`—ArcGIS geoprocessing service for solving synchronous vehicle routing problems. `traffic`—ArcGIS map service for displaying traffic speeds and traffic incidents. `packaging`—ArcGIS geoprocessing service for creating offline-use map areas and packages from web maps.
`homePageFeaturedContent`	The group that contains featured content to be displayed on the organization home page.
`homePageFeaturedContentCount`	The number of featured items that can be displayed on the home page. The maximum is 100. Only integers can be used.
`httpPort`	The port used by the portal for HTTP communication.
`httpsPort`	The port used by the portal for HTTPS communication.
`id`	The organization ID. If null, this is the default portal for anonymous and nonorganizational users.
`ipCntryCode`	The country code of the calling IP (ArcGIS Online only).
`isPortal`	Indicates whether the portal is on-premises.
`isVerified`	Indicates whether the organization identity is verified by Esri.
`layerTemplatesGroupQuery`	The query that identifies the group containing editing templates used in Map Viewer.
`livingAtlasGroupQuery`	The query that identifies the group containing the layers to be used in the Analysis Layers gallery.
`maxTokenExpirationMinutes`	The maximum validity in minutes of both OAuth and non-OAuth tokens issued for users of the organization. The default value is `-1`, which allows a maximum of 2 weeks for OAuth access tokens and ArcGIS tokens (non-OAuth), and a maximum of 90 days for OAuth refresh tokens. These are the maximum values supported. Specifying a smaller value will impact all three types of tokens (ArcGIS, OAuth access, and OAuth refresh).
`metadataEditable`	Indicates if the organization has metadata enabled. If `true`, all members of the organization can view the metadata. Only item owners and administrators can update metadata. If `false`, no one in the organization can access the metadata. Values: `true` \| `false`
`metadataFormats`	The metadata style used for the organization. The default is `iso19139`. Values: `fgdc` \| `inspire` \| `iso19139` \| `iso19139-3.2` \| `iso19115`
`mfaAdmins`	An array of at least two designated administrators who receive requests to troubleshoot members' multifactor authentication issues.
`mfaEnabled`	Indicates whether organization members are allowed to set up multifactor authentication for their individual accounts.
`modified`	The date the organization was last modified, in UTC, milliseconds since epoch.
`name`	The name of the organization or portal. The character limit is 250.
`orgEmail`	The contact email that appears on the Provider tab of the organization's listings in ArcGIS Marketplace.
`orgPhone`	The contact phone number that appears on the Provider tab of the organization's listings in ArcGIS Marketplace.
`orgUrl`	The website URL that appears on the Provider tab of the organization's listings in ArcGIS Marketplace.
`portalHostname`	The portal host's URL.
`portalMode`	Identifies whether it is `multitenant` or `singletenant`.
`portalName`	The portal's name.
`portalProperties`	Stores properties specific to the organization (for example, the Contact Us link, Home Page, Map Viewer and Search configuration). If the organization is public, the properties are visible to anonymous user.
`portalThumbnail`	The URL of the thumbnail of the portal.
`region`	The region for the organization.
`rotatorPanels`	The custom HTML for the home page.
`showHomePageDescription`	If `true`, the description of the organization displays on the home page. Values: `true` \| `false`
`storageQuota`	The total storage allowed in bytes. Starting at ArcGIS Enterprise 10.8, the organization storage quota increased to 10 TB. Prior to ArcGIS Enterprise 10.8, organization storage was at 2 TB. Nonorganization storage is 2 GB.
`storageUsage`	The total storage used in bytes.
`stylesGroupQuery`	The query that identifies the group containing a variety of styles that contain references to symbology that can be used in the organization.
`supportsHostedServices`	Indicates whether hosted services are supported.
`supportsOAuth`	Indicates whether OAuth is supported.
`symbolSetsGroupQuery`	The query that identifies the symbol set group for rendering in Map Viewer.
`templatesGroupQuery`	The query that identifies the template group used in Map Viewer.
`thumbnail`	The URL of the thumbnail of the organization.
`units`	Sets the units of measure for the organization's users. The user default is derived from the organization's region. Set units to `english` (for U.S. standards) or `metric`. Values: `english` \| `metric`
`updateUserProfileDisabled`	Indicates whether organization members are allowed to edit their biographical information and who can see their profiles.
`urlKey`	The prefix selected by the organization's administrator to be used with the `customBaseURL`, for example, `<urlKey>.maps.arcgis.com`.
`user`	User information for the accessing user is returned only when a token is passed in. Group information is not provided. See User for response properties.
`useStandardizedQuery`	If `true`, only simple WHERE clauses that are compliant with SQL92 can be used when querying layers and tables. The recommended security setting is `true`. Values: `true` \| `false`
`useVectorBasemaps`	If `true`, the organization uses the Esri vector basemaps in supported ArcGIS apps, and `basemapGalleryGroupQuery` will not be editable and will be set to the default query. Values: `true` \| `false`
`vectorBasemapGalleryGroupQuery`	The query that identifies the group containing vector basemaps that are used to display in the Map Viewer basemap gallery. Use this query only when `useVectorBasemaps` is `true`.


Property	Details
`orgCapabilities`	Returns subscription information about the current portal by ID, for authentication of organizational extensions.

Syntax

GetPortalDescription({portal_URL})

Parameter	Explanation	Data Type
portal_URL	The portal URL. If unspecified, the active portal will be used.	String

Return value

Data Type	Explanation
Dictionary	A dictionary containing portal information.

Code sample

GetPortalDescription example 1

Get a dictionary of a portal's helper services URLs.

import arcpy

portal_desc = arcpy.GetPortalDescription()
helper_services = portal_desc['helperServices']

GetPortalDescription example 2

Get user privileges from a portal.

import arcpy

portal_desc = arcpy.GetPortalDescription()
user_name = portal_desc['user']['fullName']
user_privileges = portal_desc['user']['privileges']