I see server concepts from doc:
https://developer.openstack.org/api-guide/compute/server_concepts.html
From the description of "SUSPENDED" server status, it shows:
"""The server is suspended, either by request or necessity. This status appears for only the following hypervisors: XenServer/XCP, KVM, and ESXi. Administrative users may suspend a server if it is infrequently used or to perform system maintenance. When you suspend a server, its state is stored on disk, all memory is written to disk, and the server is stopped. Suspending a server is similar to placing a device in hibernation; memory and vCPUs become available to create other servers."""
However, after I suspend an active instance (named VM_1 on compute node CN_A), resource allocation of compute node CN_A has no change neither on OpenStack dashboard nor on database.
On the other hand, if I shelve this instance, the occupied resource (vCPU and memory) will be released.
Might the description of "SUSPENDED" server status should be modified as follows:
"""The server is suspended, either by request or necessity. This status appears for only the following hypervisors: XenServer/XCP, KVM, and ESXi. Administrative users may suspend a server if it is infrequently used or to perform system maintenance. When you suspend a server, its state is stored on disk, all memory is written to disk, and the server is stopped. Suspending a server is similar to placing a device in hibernation and its occupied resource will not be freed (kept for its next running). If an instance is infrequently used and the occupied resource needs to be freed to create other servers, it should be shelved."""
Is this just a request for a clarification in the docs or something more, like making the suspend API optional also shelve the server? Because the former is easy, the latter is a new more complicated feature which has been discussed before:
http://