Reports REST API - Machine activity - Virtual machine usage

Use this REST API to manage the Machine activity - Virtual machine usage reports. The following REST API displays raw data from the Machine activity - Virtual machine usage report.

Get Machine activity - Virtual machine usage report

Table 1. Get Machine activity - Virtual machine usage report
REST API information	Value	Description
URI	/admin/resources/instancereport
Method	GET
Returns	200	Success
	400	You are not allowed to perform the requested function.
	500	Platform System Manager encountered an internal error while processing the request.

Returns the Machine activity - Virtual machine usage report data in JSON format.

Response body

[
   {
      "peakmemutil_gb": 0.0,
      "peakcpuutil": 0.0,
      "cg_name": "Share",
      "created_time_raw": null,
      "avgmemutil_gb": 0.0,
      "alloccpu": 0.11192307692307692,
      "instid": "6a36a3ea-fe1f-44eb-b505-bae9f92bd409",
      "hid": "38f811ef-72f6-4775-adc1-1cdbaa0d6a15",
      "allocmem": 2.0,
      "isas_rn": 1,
      "state": "pending_disk_delete",
      "updated_time": null,
      "hyp_name": "SN#23AVYE2",
      "tot_storage_gb": 12.0,
      "version": "2.0.0.1",
      "id": "/admin/resources/instancereport",
      "avgcpuutil": 0.0,
      "inst_name": "ipas-lpar-016-226-463-OS_Node.11404835513974",
      "updated_time_raw": null,
      "cgid": "8f0db67b-2566-4794-9ab4-40e4dba2bec8",
      "cpuutil": 0.0,
      "memutil_gb": 0.0,
      "deployment": null,
      "created_time": null
   },
   ...
]

alloccpu: The maximum number of physical CPU cores that are allocated to this virtual machine instance.
allocmem: The maximum amount of physical memory, in GB, allocated to this virtual machine instance.
avgcpuutil: The average number of physical CPU cores that are used by this virtual machine instance over the last 30 days.
avgmemutil_gb: The average memory utilization, in GB, for this virtual machine instance over the last 30 days.
cgid: The UUID for the cloud group that is associated with this virtual machine instance.
cg_name: The name of the cloud group that is associated with this virtual machine instance.
created_time: Not currently used. The date and time when the report data was created.
created_time_raw: Not currently used. The raw time, in milliseconds since 1970, when the report data was created.
cpuutil: The current number of physical CPU cores that are used by this virtual machine instance.
deployment: The Cloud Pak System System pattern that is deployed on this virtual machine instance.
hid: The UUID for the compute node that is running this virtual machine instance.
hyp_name: The name of the compute node that is running this virtual machine instance.
id: The REST URI for this machine activity report.
instid: The UUID for this virtual machine instance.
inst_name: The name of this virtual machine instance.
isas_rn: The row number of this virtual machine instance within this report.
memutil_gb: The current amount of memory, in GB, being used by this virtual machine instance.
peakcpuutil: The peak number of physical CPU cores that are used by this virtual machine instance over the last 30 days.
peakmemutil_gb: The peak memory utilization, in GB, for this virtual machine instance over the last 30 days.
state: The current state of this virtual machine.
tot_storage_gb: The total amount of disk storage, in GB, assigned to this virtual machine instance.
updated_time: Not currently used. The date and time when the report data was most recently updated.
updated_time_raw: Not currently used. The raw time, in milliseconds since 1970, when the report data was updated.
version: The Cloud Pak System System version.