Machine

URL:
https://<root>/machines/<machine>
Methods:
GET
Child Resources:
SSL Certificates, Hardware Info
Required Capability:
Access allowed with the "Security and Infrastructure" privilege
Version Introduced:
10.8

Description

The resource for an individual machine returns information on a specific portal machine registered with ArcGIS Enterprise portal, such as the administrative URL for the machine and its OS platform information. A portal machine represent a machine on which Portal for ArcGIS software has been installed and licensed. From this resource, you can review the status of the machine and manage SSL certificates when in a highly available portal environment.

Request parameters

ParameterDetails

f

The response format. The default response value is html.

Values: html | json | pjson

Example usage

The following is a sample request URL used to access an individual machine resource:

Use dark colors for code blocksCopy
1
https://machine.domain.com/webadaptor/portaladmin/machines/machine.domain.com?f=pjson

JSON Response syntax

Use dark colors for code blocksCopy
1
2
3
4
5
6
{
  "machineName": "<machine name>",
  "adminURL": "<admin URL>",
  "role": "<standby|primary>",
  "platform": "<OS platform information>"
}

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
5
6
{
  "machineName": "machine.domain.com",
  "adminURL": "https://machine.domain.com:7443/arcgis",
  "role": "primary",
  "platform": "Linux-amd64-5.4.17-2136.301.1.4.el8uek.x86_64"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.