)]}'
{"specs/newton/approved/host-command-with-POST.rst":[{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"affd8fc56b3cf2bf852fee77c7ae7043619eed14","unresolved":false,"context_lines":[{"line_number":13,"context_line":"Problem description"},{"line_number":14,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"Currently, nova host related command such as startup, shutdown, and reboot"},{"line_number":17,"context_line":"are accpeting GET `resource GET`_ to take actions, this is not align with"},{"line_number":18,"context_line":"`resource ApiWG`_ :GET method."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":".. _resource GET: http://developer.openstack.org/api-ref-compute-v2.1.html#reboothost"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9a061dce_48a75d4f","line":17,"range":{"start_line":16,"start_character":0,"end_line":17,"end_character":49},"updated":"2016-04-09 00:08:50.000000000","message":"big +1 for this change.\nCurrent these APIs make Tempest also dirty due to this behavior.","commit_id":"9835ddaba982775589ddc739b32b8e3ffd49b68b"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"affd8fc56b3cf2bf852fee77c7ae7043619eed14","unresolved":false,"context_lines":[{"line_number":46,"context_line":"REST API impact"},{"line_number":47,"context_line":"---------------"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"All commands like reboot, shutdown, startup will accept new method:"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":"    POST /v2.1/{tenant_id}/os-hosts/{host_name}/reboot"},{"line_number":52,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"9a061dce_6b4b3b5a","line":49,"range":{"start_line":49,"start_character":0,"end_line":49,"end_character":67},"updated":"2016-04-09 00:08:50.000000000","message":"This means\n\n - each action still exist on the separated resources\n - make each action accept POST\n\nright?\nIf so, how about denying GET on the new microversion?\nIf supporting both as the same operation, users will be confused.","commit_id":"9835ddaba982775589ddc739b32b8e3ffd49b68b"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"58f90b550a22a49f9eeaaa9b934104b85fcaacff","unresolved":false,"context_lines":[{"line_number":46,"context_line":"REST API impact"},{"line_number":47,"context_line":"---------------"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"All commands like reboot, shutdown, startup will accept new method:"},{"line_number":50,"context_line":""},{"line_number":51,"context_line":"    POST /v2.1/{tenant_id}/os-hosts/{host_name}/reboot"},{"line_number":52,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"7a1b2928_1cf92b81","line":49,"range":{"start_line":49,"start_character":0,"end_line":49,"end_character":67},"in_reply_to":"9a061dce_6b4b3b5a","updated":"2016-04-11 19:15:37.000000000","message":"yeah, good catch!\nI thought we won\u0027t allow this kind of action but checked micorversion history and seems this \u0027deny original supported actions\u0027 should be supported, will add description","commit_id":"9835ddaba982775589ddc739b32b8e3ffd49b68b"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"affd8fc56b3cf2bf852fee77c7ae7043619eed14","unresolved":false,"context_lines":[{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Response ::"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"    {"},{"line_number":56,"context_line":"         \"host\": \"9557750dbc464741a89c907921c1cb31\","},{"line_number":57,"context_line":"         \"power_action\": \"reboot\""},{"line_number":58,"context_line":"    }"},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Security impact"},{"line_number":61,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9a061dce_eba46b09","line":58,"range":{"start_line":55,"start_character":0,"end_line":58,"end_character":5},"updated":"2016-04-09 00:08:50.000000000","message":"This response is the same as the existing one, I know.\n\nbut users will not know any new thing from this response, because all thing is specified from users.\nIs it worth returning it?","commit_id":"9835ddaba982775589ddc739b32b8e3ffd49b68b"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"58f90b550a22a49f9eeaaa9b934104b85fcaacff","unresolved":false,"context_lines":[{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Response ::"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"    {"},{"line_number":56,"context_line":"         \"host\": \"9557750dbc464741a89c907921c1cb31\","},{"line_number":57,"context_line":"         \"power_action\": \"reboot\""},{"line_number":58,"context_line":"    }"},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Security impact"},{"line_number":61,"context_line":"---------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"7a1b2928_dc0cd396","line":58,"range":{"start_line":55,"start_character":0,"end_line":58,"end_character":5},"in_reply_to":"9a061dce_eba46b09","updated":"2016-04-11 19:15:37.000000000","message":"um.. I can do the change, seems server POST also don\u0027t have this response body, thanks","commit_id":"9835ddaba982775589ddc739b32b8e3ffd49b68b"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"fa9d09e88d7ed90524e002ee93bb578c5cf10ec0","unresolved":false,"context_lines":[{"line_number":55,"context_line":"    Return code 200 for success and others indicate corresponding error."},{"line_number":56,"context_line":"    No respones body will be returned."},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"All originally actions \u0027GET\u0027 will be rejected as **405 Method Not Allowed**."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"    GET /v2.1/{tenant_id}/os-hosts/{host_name}/reboot"},{"line_number":61,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"dab17558_192ed38b","line":58,"range":{"start_line":58,"start_character":0,"end_line":58,"end_character":76},"updated":"2016-05-17 02:00:15.000000000","message":"Yes, this error code seems right according to api-wg guideline.\n\n* If a request is made to a known resource URI, but the HTTP method used for\n  the request is not supported for that resource, the return code should be\n  **405 Method Not Allowed**. The response should include the `Allow` header\n  with the list of accepted request methods for the resource.","commit_id":"d4d5ae0e6c438fcc357b6edfb12f5b2479fa342b"}],"specs/ocata/approved/host-command-with-POST.rst":[{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"5d8139a2960db5c71eb969112593ffcda13a5a67","unresolved":false,"context_lines":[{"line_number":19,"context_line":""},{"line_number":20,"context_line":".. _resource GET: http://developer.openstack.org/api-ref-compute-v2.1.html#reboothost"},{"line_number":21,"context_line":""},{"line_number":22,"context_line":".. _resource ApiWG: https://github.com/openstack/api-wg/blob/master/guidelines/http.rst"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Use Cases"},{"line_number":25,"context_line":"---------"}],"source_content_type":"text/x-rst","patch_set":8,"id":"5a8bc5a2_6db33c0b","line":22,"updated":"2016-09-28 11:26:01.000000000","message":"This link is fine, but if you want to use the canonical url for the guideline that is: http://specs.openstack.org/openstack/api-wg/guidelines/http.html","commit_id":"76907324713f636ed377558fb3b3eface89904ef"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"03d77d4915ceb1788af63f3dfa52f3593ceca441","unresolved":false,"context_lines":[{"line_number":19,"context_line":""},{"line_number":20,"context_line":".. _resource GET: http://developer.openstack.org/api-ref-compute-v2.1.html#reboothost"},{"line_number":21,"context_line":""},{"line_number":22,"context_line":".. _resource ApiWG: https://github.com/openstack/api-wg/blob/master/guidelines/http.rst"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Use Cases"},{"line_number":25,"context_line":"---------"}],"source_content_type":"text/x-rst","patch_set":8,"id":"1a95cdbc_d7866812","line":22,"in_reply_to":"5a8bc5a2_6db33c0b","updated":"2016-10-06 09:46:16.000000000","message":"ok, will update","commit_id":"76907324713f636ed377558fb3b3eface89904ef"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"5d8139a2960db5c71eb969112593ffcda13a5a67","unresolved":false,"context_lines":[{"line_number":29,"context_line":"Proposed change"},{"line_number":30,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"As we can\u0027t make backword incompatible changes, we should keep the old"},{"line_number":33,"context_line":"interface so not break existing user. Then bump microversion to provide POST"},{"line_number":34,"context_line":"command on the actions of os-hosts resource."},{"line_number":35,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5a8bc5a2_cdca906e","line":32,"updated":"2016-09-28 11:26:01.000000000","message":"backward","commit_id":"76907324713f636ed377558fb3b3eface89904ef"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"03d77d4915ceb1788af63f3dfa52f3593ceca441","unresolved":false,"context_lines":[{"line_number":29,"context_line":"Proposed change"},{"line_number":30,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"As we can\u0027t make backword incompatible changes, we should keep the old"},{"line_number":33,"context_line":"interface so not break existing user. Then bump microversion to provide POST"},{"line_number":34,"context_line":"command on the actions of os-hosts resource."},{"line_number":35,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"1a95cdbc_f77d241d","line":32,"in_reply_to":"5a8bc5a2_cdca906e","updated":"2016-10-06 09:46:16.000000000","message":"Done","commit_id":"76907324713f636ed377558fb3b3eface89904ef"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"5d8139a2960db5c71eb969112593ffcda13a5a67","unresolved":false,"context_lines":[{"line_number":30,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"As we can\u0027t make backword incompatible changes, we should keep the old"},{"line_number":33,"context_line":"interface so not break existing user. Then bump microversion to provide POST"},{"line_number":34,"context_line":"command on the actions of os-hosts resource."},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"Alternatives"}],"source_content_type":"text/x-rst","patch_set":8,"id":"5a8bc5a2_cd78d02e","line":33,"updated":"2016-09-28 11:26:01.000000000","message":"s/so/to/; s/user/users/; s/provide/provide a/","commit_id":"76907324713f636ed377558fb3b3eface89904ef"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"03d77d4915ceb1788af63f3dfa52f3593ceca441","unresolved":false,"context_lines":[{"line_number":30,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"As we can\u0027t make backword incompatible changes, we should keep the old"},{"line_number":33,"context_line":"interface so not break existing user. Then bump microversion to provide POST"},{"line_number":34,"context_line":"command on the actions of os-hosts resource."},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"Alternatives"}],"source_content_type":"text/x-rst","patch_set":8,"id":"1a95cdbc_1779b02f","line":33,"in_reply_to":"5a8bc5a2_cd78d02e","updated":"2016-10-06 09:46:16.000000000","message":"Done","commit_id":"76907324713f636ed377558fb3b3eface89904ef"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"5d8139a2960db5c71eb969112593ffcda13a5a67","unresolved":false,"context_lines":[{"line_number":53,"context_line":"Response ::"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"    Return code 200 for success and others indicate corresponding error."},{"line_number":56,"context_line":"    No respones body will be returned."},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"All originally actions \u0027GET\u0027 will be rejected as **405 Method Not Allowed**."},{"line_number":59,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5a8bc5a2_2db5b4cf","line":56,"updated":"2016-09-28 11:26:01.000000000","message":"s/respones/response/\n\nIf the response body is empty then the response could should be 204, however, the existing GET method does return (a perhaps not useful?) response. Should that response be maintained? If so, then 200 would be correct.","commit_id":"76907324713f636ed377558fb3b3eface89904ef"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"03d77d4915ceb1788af63f3dfa52f3593ceca441","unresolved":false,"context_lines":[{"line_number":53,"context_line":"Response ::"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"    Return code 200 for success and others indicate corresponding error."},{"line_number":56,"context_line":"    No respones body will be returned."},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"All originally actions \u0027GET\u0027 will be rejected as **405 Method Not Allowed**."},{"line_number":59,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"1a95cdbc_d77108e2","line":56,"in_reply_to":"5a8bc5a2_2db5b4cf","updated":"2016-10-06 09:46:16.000000000","message":"ok, will change to 204 as no meaningful response will be returned ..","commit_id":"76907324713f636ed377558fb3b3eface89904ef"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"5d1727fcda0382d346cdb0a0a58f3c7507cff18b","unresolved":false,"context_lines":[{"line_number":62,"context_line":"    }"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"All originally actions \u0027GET\u0027 will be rejected as **405 Method Not Allowed**."},{"line_number":65,"context_line":""},{"line_number":66,"context_line":"    GET /v2.1/{tenant_id}/os-hosts/{host_name}/reboot"},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"Response ::"}],"source_content_type":"text/x-rst","patch_set":11,"id":"1a95cdbc_cdfe82ad","line":65,"updated":"2016-10-07 21:45:25.000000000","message":"This 405 seems good because of https://httpstatusdogs.com/405-method-not-allowed","commit_id":"41c11d1efd182db2f3f245d5aa2bb0a4d6081497"}]}