Every portal has a unique instance of a portal service. The portal service provides the functionality to securely create, manage, and access content, data services, users, and groups in a portal. You can also use it to organize and search for items, users, and groups. The service supports the REST API that can be accessed with ArcGIS tools, ArcGIS Maps SDKs, open source libraries and scripting APIs.
You use the portal service to build applications that can:
This topic provides an overview of the common operations you can perform with the portal service.
NoteArcGIS Location Platform and ArcGIS Online portals and ArcGIS Enterprise portals support a portal service. Learn more about the different portals in Introduction to portals
Access a portal serviceTo access a portal, you need an ArcGIS account. Your account is associated with an organization and it gives you access to a private space in a portal where you can store and manage your own content. It also allows you to sign in with tools, such as ArcGIS Online and the Location Platform Dashboard to create, manage, share, and search content. With an account you can also create API keys and OAuth 2.0 tokens that can be used to access the portal service operations.
To access the portal service directly, you need to get the URL from your organization and make a self
request to extract the supported operations.
Use dark colors for code blocks Copy
1
https://www.arcgis.com/sharing/rest
Use dark colors for code blocks Copy
1
https://www.arcgis.com/sharing/rest
Use dark colors for code blocks Copy
1
https://{machine.domain.com}/{webadaptor}/rest
Example
This example shows how to execute a self
request using the portal service.
HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
POST arcgis.com/sharing/rest/portals/self HTTP/1.1
Content-Type: application/x-www-form-urlencoded
&f=json
&token=<ACCESS_TOKEN>
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
{
"helperServices": {
// Other parameters
"analysis": {
"url": "https://<YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer"
},
"geoenrichment": {
"url": "https://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer"
}
}
}
Manage content items
The portal service offers the ability to store, manage, and access geospatial data for individuals and organizations. All content are managed as items.
You use the portal service to:
https://{host}/sharing/rest/content/users/{organizationId}/{operation}?{parameters}
https://{host}/sharing/rest/content/users/{organizationId}/{operation}?{parameters}
https://{host}/{webadaptor}/sharing/rest/content/users/{organizationId}/{operation}?{parameters}
The common content management operations are below:
Use case Description Create an item Upload an item file, submit text content, or submit the item URL to a portal. Delete an item Removes the item and its data from a portal. Copy an item Creates a new item that is a copy of the original item on the server side. The newly created item will have a newitemID
. Move an item Moves an item from the current folder to the specified target folder. Update an item Update item information such as title, description, and tags or use it to update an item's file, URL, or text.
To learn more about organizing your content using the portal service, go to Administer > Manage content.
Sharing using the portal service promotes collaboration, accessibility, security, and integration of your content. With the the support for sharing, you can:
https://{host}/sharing/rest/content/users/{organizationId}/items/{itemId}/share?{parameters}
https://{host}/sharing/rest/content/users/{organizationId}/items/{itemId}/share?{parameters}
https://{host}/{webadaptor}/sharing/rest/content/users/{organizationId}/items/{itemId}/share?{parameters}
The common sharing operations are below:
Use case Description Share an item Share an item with a set of specific groups that the user belongs to. Unshare an item Unshares one or many items with the specified list of groups. Publish an item Publishes a hosted service based on an existing source item. Prior to publishing, items must be added using Add item.To learn more about the levels of sharing an item, go to Items > Sharing.
Search for itemsSearching using the portal service allows you to discover and access geospatial content, including maps, layers, apps, and more.
You use the search capabilities when you want to:
https://{host}/sharing/rest/search?{parameters}
https://{host}/sharing/rest/search?{parameters}
https://{host}/{webadaptor}/sharing/rest/search?{parameters}
The common search operations are below:
To learn more about the capabilities for searching items using the portal service, go to search items.
User and group management UsersA user is an individual who has an account and can access and interact with features of the portal service. A user can create and share maps, apps, and data, collaborate with others, perform analysis, and manage their own content.
You generally work with users when you want to:
https://{host}/sharing/rest/content/users/{operation}?{parameters}
https://{host}/sharing/rest/content/users/{operation}?{parameters}
https://{host}/{webadaptor}/sharing/rest/content/users/{operation}?{parameters}
The common user operations are below:
To learn more about authenticating and managing users, go to Items > Manage users.
GroupsGroups serve as collaborative spaces where users with common interests or working on similar projects can share and manage content collectively. Groups can be created by administrators or users with the appropriate permissions.
You use groups to:
https://{host}/sharing/rest/community/{operation}?{parameters}
https://{host}/sharing/rest/community/{operation}?{parameters}
https://{host}/{webadaptor}/sharing/rest/community/{operation}?{parameters}
The common group operations are below:
To learn more about securing your data using groups, go to Items > Manage groups.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4