- URL:
- https://<root>/orgs/<orgID>/federation/servers/<serverID>/update
- Methods:
POST- Version Introduced:
- 11.2
Access requirements
Required privileges
The Enterprise Administrator API requires privilege-based access. An administrator must be assigned a specific user privilege, or role, to access any given endpoint. Listed below are the user privileges or roles an administrator can be assigned that provides access to this endpoint. If multiple privileges are listed, only one needs to be assigned to gain access.
Tokens
This API requires token-based authentication. A token is automatically generated for administrators who sign in to the Enterprise Administrator API directory's HTML interface. Tokens generated in this way are stored for the entirety of the session.
Those accessing the API directory outside of the HTML interface will need to acquire a session token from the generate operation in the Enterprise Directory API. For security reasons, all POST requests made to the Enterprise Administrator API must include a token in the request body.
Description
The update operation modifies the server role and server function of a federated server. Once federated, some servers will need to be updated using this operation to assign it its appropriate server function, which ensures the federated server is provided the appropriate resources and requirements it needs to operate according to its function type. At ArcGIS Enterprise on Kubernetes 11.2, this operation can be used to assign federated servers the Workflow function.
Modify server roles
When modifying server roles, a server can be set as a federated server or be modified to a federated server that has a restrictive access model enabled that controls who has administrative and publisher access to the federated server.
Setting the server role as FEDERATED will immediately restrict access to the federated server to only organization administrators. Organization members that have been assigned publisher privileges cannot access the federated server unless they are added to the publisher-specific group for the federated server or have the publisher-specific item shared to a group they belong to.
Modify server functions
At ArcGIS Enterprise on Kubernetes 11.2, the only server function a federated server can be assigned is Workflow. To configure a federated server as an ArcGIS Workflow Manager Server, the federated server must be an ArcGIS Workflow Manager Server with appropriate licensing.
Request parameters
| Parameter | Details |
|---|---|
| Specifies whether the server is a federated server or a federated server with restricted access to publishing. Values: |
| Specifies the functions for the federated server. The server can be assigned any of the values listed below as long as the server meets the requirements for each functional area. At 11.2, the only supported value for Values: |
| The response format. The default format is Values: |
Example usage
The following is a sample POST request for the update operation:
POST /<context>/admin/orgs/0123456789ABCDEF/federation/servers/SHsQDdugnlgV0dvc/update HTTP/1.1
Host: organization.example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
serverRole=FEDERATED_SERVER&serverFunction=WorkflowManager&f=pjson&token=pY3M_DuL7hEVVDhmLm6viSeZdZmAUNt0zub84D9bHL0dlLZ7CEEnyha1CwYLFa4W0avZ6lMntBgG3GtsTf6sHO4Mp6ML0jNIkhDqsdjAnhmTGNLNPr_uMw4DFY0oiK9MoPIlBI4byQpRkBM9k0TjHPfoeqGJZh_BOxegje_1F_43rIrQ__e2nDo77SMSXHmy46FixGIq3TjnXV339UiSMqwGeILQCND9qdMcibegIV7DhIYna9ouFdf3inbyy4bUJSON Response example
{
"serverId": "SHsQDdugnlgV0dvc",
"status": "success"
}