api-ref: rebuild server does not mention pre-conditions

Bug #1775665 reported by Matt Riedemann
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
OpenStack Compute (nova)
Fix Released
Low
Matt Riedemann

Bug Description

The API reference for the rebuild server action does not mention the preconditions required for rebuild a server, which are pretty basic:

https://developer.openstack.org/api-ref/compute/#rebuild-server-rebuild-action

https://github.com/openstack/nova/blob/54c9a944c618dc173bd1214be4de9a44479c8959/nova/compute/api.py#L2972

The server "status" must be ACTIVE, ERROR or SHUTOFF and "OS-SRV-USG:launched_at" must not be null.

The server must not also be locked, but that's generally true of all server actions, so it's probably not worth mentioning explicitly.

Matt Riedemann (mriedem)
Changed in nova:
importance: Undecided → Medium
importance: Medium → Low
status: New → Confirmed
jichenjc (jichenjc)
Changed in nova:
assignee: nobody → jichenjc (jichenjc)
Revision history for this message
jichenjc (jichenjc) wrote :

yes, mention the status seems enough, the lock should be much overkill

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to nova (master)

Fix proposed to branch: master
Review: https://review.openstack.org/576438

Changed in nova:
status: Confirmed → In Progress
Changed in nova:
assignee: jichenjc (jichenjc) → Matt Riedemann (mriedem)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to nova (master)

Reviewed: https://review.openstack.org/576438
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=1a079a6394b567ea38cc892146ad13829c1c0256
Submitter: Zuul
Branch: master

commit 1a079a6394b567ea38cc892146ad13829c1c0256
Author: jichenjc <email address hidden>
Date: Fri Jun 8 14:59:05 2018 +0800

    Mention server status in api-ref when rebuild

    Add description about server status in active, shutoff,
    error can accept a rebuild action.

    Closes-Bug: 1775665

    Change-Id: Id52acb9fdb264b337a6a9748049aeecd22901bf4

Changed in nova:
status: In Progress → Fix Released
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/nova 18.0.0.0b3

This issue was fixed in the openstack/nova 18.0.0.0b3 development milestone.

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.