Hardware

URL:
https://<root>/machines/<machine>/hardware
Methods:
GET
Required Capability:
Access allowed with the "Security and Infrastructure" privilege
Version Introduced:
11.3

Description

The hardware resource returns information related to the hardware on a specific portal machine, including the CPU and core information, memory usage, and disk usage.

Request parameters

ParameterDetails

f

The response format. The default format is html.

Values: html | json | pjson

Response properties

PropertyDetails

osInformation

The machine's operating system.

cpuInformation

The specifications of the machine's central processing unit (CPU).

systemMemory

The amount of system memory (in MB).

systemMemoryAvailable

The amount of available system memory (in MB).

physicalProcessorCount

The number of physical cores in the CPU.

logicalProcessorCount

The number of logical cores in the CPU. This value is the number of physical cores multiplied by the number of threads each core can run via hyperthreading.

localDiskUsage

The disk usage information for Portal for ArcGIS. This property lists the mount, disk space, and path of each directory. The table below outlines each of the properties included in localDiskUsage.

Properties for localDiskUsage

PropertyDetails

mount

The the drive or partition the directory is on. If it's a Windows share, this will be represented as N/A.

diskTotalSpaceGB

The total amount of disk space on the drive (in GB).

diskUsableSpaceGB

The amount of usable space on the drive (in GB).

exceededDiskSpaceThreshold

Determines whether the available disk space on the drive is less than the value set by the diskSpaceThresholdGB property. If the diskSpaceThresholdGB is not defined as part of the system properties, the threshold is 5GB. If the available disk space is less than the threshold value (either set by the system property or the default of 5GB), this property will return as true, indicating that additional space may need to be made available on those drives.

Values: true | false

directory

The directory type.

Values: TEMP | CONTENT | INSTALL | INDEX | DB

path

The directory path.

Example usage

The following is a sample request URL used to access the hardware resource:

1
https://machine.domain.com/webadaptor/portaladmin/machines/machine.domain.com/hardware?f=pjson

JSON Response example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
  "osInformation": "GNU/Linux Oracle Linux Server 8.9 (unknown) build 5.4.17-2136.328.3.el8uek.x86_64",
  "cpuInformation": "Intel(R) Xeon(R) Gold 6252 CPU @ 2.10GHz\n 2 physical CPU package(s)\n 2 physical CPU core(s)\n 2 logical CPU(s)\nIdentifier: Intel64 Family 6 Model 45 Stepping 2\nProcessorID: 0F8BFBFF000206D2\nMicroarchitecture: Sandy Bridge (Server)",
  "systemMemory": 14698,
  "systemMemoryAvailable": 9202,
  "physicalProcessorCount": 2,
  "logicalProcessorCount": 2,
  "localDiskUsage": [
    {
      "mount": "/data",
      "diskTotalSpaceGB": 185,
      "diskUsableSpaceGB": 141,
      "exceededDiskSpaceThreshold": false,
      "directory": "TEMP",
      "path": "/data/arcgis/portal/usr/arcgisportal/temp"
    },
    {
      "mount": "/data",
      "diskTotalSpaceGB": 185,
      "diskUsableSpaceGB": 141,
      "exceededDiskSpaceThreshold": false,
      "directory": "CONTENT",
      "path": "/data/arcgis/portal/usr/arcgisportal/content"
    },
    {
      "mount": "/data",
      "diskTotalSpaceGB": 185,
      "diskUsableSpaceGB": 141,
      "exceededDiskSpaceThreshold": false,
      "directory": "INSTALL",
      "path": "/data/arcgis/portal/"
    },
    {
      "mount": "/data",
      "diskTotalSpaceGB": 185,
      "diskUsableSpaceGB": 141,
      "exceededDiskSpaceThreshold": false,
      "directory": "INDEX",
      "path": "/data/arcgis/portal/usr/arcgisportal/index"
    },
    {
      "mount": "/data",
      "diskTotalSpaceGB": 185,
      "diskUsableSpaceGB": 141,
      "exceededDiskSpaceThreshold": false,
      "directory": "DB",
      "path": "/data/arcgis/portal/usr/arcgisportal/db"
    }
  ]
}

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

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close