- URL:https://<services-url>/federate(POST only)
- Required Capability:Default administrator role | All authorized privileges
- Version Introduced:10.2
Description
This operation is used when federating ArcGIS Server with Portal for ArcGIS. It imports any services that you have previously published to your ArcGIS Server site and makes them available as items with Portal for ArcGIS. Beginning at 10.3, services are imported automatically as part of the federate process.
If the automatic import of services fails as part of the federation process, the following severe-level message will appear in the server logs:
Failed to import GIS services as items within portal.If this occurs, you can manually re-run the operation to import your services as items in the portal. Before you do this, obtain a portal token and then validate ArcGIS Server is federated with your portal using the portal website. This is done in My Organization > Edit Settings > Servers.
After you run the Federate operation, specify sharing properties to determine which users and groups will be able to access each service.
Note:
The Federate operation does not affect any items representing services published by portal users (in other words, services in the Hosted folder on ArcGIS Server). Those services are entirely managed by the portal.
Request parameters
| Parameter | Details |
|---|---|
| f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
Below is a sample POST request for federate:
POST /webadaptor/admin/services/federate HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
f=jsonJSON Response example
{"status": "success"}