Annette,
Because there were no responses on the question, a support case was created automatically. It was acknowledged that the documentation is lacking in this area and I haven't needed to check if it was updated. As further deliberations occurred, the PCA integration was removed from scope so we got out of it but the artifacts requested remained unavailable.
The following pieces of useful information was provided, however.
The most detail I've found in previous cases is that READ permissions are required for all objects on the Oracle VM API.
My thinking would be this could be potentially restricted further, but I'd need the insight of the Engineering team there.
| API Function Name | Usage |
| login | Provides authentication information to connect to the Web Service API |
| logout | Logs out of the Web Service connection at the end of each Session |
| managerGetInfo or managerGet depending on OVM version | Returns Manager object, which represents the Oracle VM Manager itself. This may be used to retrieve the VM Manager instance's current state, active time, UUID and version. |
| clusterGetAll | Returns a list of all Clusters available in the VM Manager; this can be used to retrieve individual Cluster timeout, File system IDs, heartbeat devices, associated servers, and the associated server pool. |
| serverPoolGetAll | Provides a list of all Server Pools; A grouping of associated Servers and VMs that may run on this server (also includes Affinity Groups). This can be used to gather data on Affinity Groups, the default keymap used for VMs in this Server Pool, settings such as whether Secure VM Migration is in use, associated VMs (assigned and unassigned) and the Server Pool's associated Zone if applicable |
| serverGetAll | Returns a list of all Servers, outlining Access Groups, the agent login account, BIOS information, Cluster information for that Server, hardware and CPU information, network information e.g. hostname and IP address, the current status of the server, version information for Oracle VM, network IDs, hosted VM and serial number information |
| vmGetAll | Returns all associated VMs. Can bee used to outline VM 'hardware', software and current VM status information, including Operating System information, allocated memory, communication information for said VM, and that VM's state |
| serverPoolPolicyGetAll | Returns all Server Pools' policy information; the ServerPoolPolicy controls DPM/DRS behaviour for VMs, based on processor usage - this can be used to confirm whether these settings are enabled, how often this is examined, which Servers are incorporated into this policy, policy modes and how the DPM/DRS is configured |
| ethernetPortGetAll | Lists all associated Ethernet ports; outlines IP Addresses, MAC information, the state and type of these ports, the associated Server of said ports, and interface information. |
