Public bug reported: The pause:
https://developer.openstack.org/api-ref/compute/#pause-server-pause- action And suspend: https://developer.openstack.org/api-ref/compute/#suspend-server-suspend- action APIs just say they pause and suspend the server, which does not really tell the user anything about what the difference is between the APIs, why you'd want to use one over the other, etc. We should describe more there. For the libvirt driver, this describes the suspend operation: https://libvirt.org/sources/virshcmdref/html/sect-managedsave.html and https://wiki.libvirt.org/page/VM_lifecycle#States_that_a_guest_domain_can_be_in "Saved - Similar to the paused state, but the domain state is stored to persistent storage. Again, the domain in this state can be restored and it does not notice that any time has passed." And for pause with libvirt: https://wiki.libvirt.org/page/VM_lifecycle#Pausing_a_guest_domain ** Affects: nova Importance: Medium Status: Confirmed ** Tags: api-ref -- You received this bug notification because you are a member of Yahoo! Engineering Team, which is subscribed to OpenStack Compute (nova). https://bugs.launchpad.net/bugs/1785246 Title: Compute API reference should describe pause and suspend operations Status in OpenStack Compute (nova): Confirmed Bug description: The pause: https://developer.openstack.org/api-ref/compute/#pause-server-pause- action And suspend: https://developer.openstack.org/api-ref/compute/#suspend-server- suspend-action APIs just say they pause and suspend the server, which does not really tell the user anything about what the difference is between the APIs, why you'd want to use one over the other, etc. We should describe more there. For the libvirt driver, this describes the suspend operation: https://libvirt.org/sources/virshcmdref/html/sect-managedsave.html and https://wiki.libvirt.org/page/VM_lifecycle#States_that_a_guest_domain_can_be_in "Saved - Similar to the paused state, but the domain state is stored to persistent storage. Again, the domain in this state can be restored and it does not notice that any time has passed." And for pause with libvirt: https://wiki.libvirt.org/page/VM_lifecycle#Pausing_a_guest_domain To manage notifications about this bug go to: https://bugs.launchpad.net/nova/+bug/1785246/+subscriptions -- Mailing list: https://launchpad.net/~yahoo-eng-team Post to : yahoo-eng-team@lists.launchpad.net Unsubscribe : https://launchpad.net/~yahoo-eng-team More help : https://help.launchpad.net/ListHelp