)]}'
{"api-guide/source/server_concepts.rst":[{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":152,"context_line":"   Response:"},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"   {"},{"line_number":155,"context_line":"       \"server\":["},{"line_number":156,"context_line":"       {"},{"line_number":157,"context_line":"           \"name\": \"t1\","},{"line_number":158,"context_line":"           \"OS-EXT-SRV-ATTR:host\": \"devstack\""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_d59530e4","line":155,"range":{"start_line":155,"start_character":8,"end_line":155,"end_character":14},"updated":"2016-01-04 03:03:50.000000000","message":"Here should be \"servers\" instead of \"server\".","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":172,"context_line":"   Response:"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"   {"},{"line_number":175,"context_line":"       \"server\":["},{"line_number":176,"context_line":"       {"},{"line_number":177,"context_line":"           \"name\": \"t1\","},{"line_number":178,"context_line":"           \"OS-EXT-SRV-ATTR:host\": \"devstack\""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_f598741d","line":175,"range":{"start_line":175,"start_character":7,"end_line":175,"end_character":15},"updated":"2016-01-04 03:03:50.000000000","message":"ditto","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":185,"context_line":""},{"line_number":186,"context_line":".. code::"},{"line_number":187,"context_line":"   Precondition:"},{"line_number":188,"context_line":"   Request with admin context:"},{"line_number":189,"context_line":"   GET /servers/detail"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"   Response:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_95449874","line":188,"range":{"start_line":188,"start_character":16,"end_line":188,"end_character":21},"updated":"2016-01-04 03:03:50.000000000","message":"s/admin/administrator/","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":191,"context_line":"   Response:"},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"   {"},{"line_number":194,"context_line":"       \"server\":["},{"line_number":195,"context_line":"       {"},{"line_number":196,"context_line":"           \"name\": \"test11\","},{"line_number":197,"context_line":"           ..."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_d54a1083","line":194,"range":{"start_line":194,"start_character":7,"end_line":194,"end_character":15},"updated":"2016-01-04 03:03:50.000000000","message":"ditto","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":211,"context_line":"       ]"},{"line_number":212,"context_line":"   }"},{"line_number":213,"context_line":""},{"line_number":214,"context_line":"   Request with admin context:"},{"line_number":215,"context_line":"   GET /servers/detail?name\u003dt1"},{"line_number":216,"context_line":""},{"line_number":217,"context_line":"   Response:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_b5475c76","line":214,"range":{"start_line":214,"start_character":16,"end_line":214,"end_character":21},"updated":"2016-01-04 03:03:50.000000000","message":"ditto","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":217,"context_line":"   Response:"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"   {"},{"line_number":220,"context_line":"       \"server\":["},{"line_number":221,"context_line":"       {"},{"line_number":222,"context_line":"           \"name\": \"test11\","},{"line_number":223,"context_line":"           ..."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_555f0041","line":220,"range":{"start_line":220,"start_character":8,"end_line":220,"end_character":14},"updated":"2016-01-04 03:03:50.000000000","message":"ditto","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":234,"context_line":"   }"},{"line_number":235,"context_line":""},{"line_number":236,"context_line":"-  **Speical keys are used to tweek the query**"},{"line_number":237,"context_line":"   ``changes-since`` returns instances updated after the given time,"},{"line_number":238,"context_line":"   ``deleted`` return (or exclude) deleted instances and ``soft_deleted``"},{"line_number":239,"context_line":"   modify behavior of \u0027deleted\u0027 to either include or exclude instances whose"},{"line_number":240,"context_line":"   vm_state is SOFT_DELETED."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_953b38eb","line":237,"range":{"start_line":237,"start_character":29,"end_line":237,"end_character":38},"updated":"2016-01-04 03:03:50.000000000","message":"s/instances/servers/ for consistent description.","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":247,"context_line":""},{"line_number":248,"context_line":"   Response:"},{"line_number":249,"context_line":"   {"},{"line_number":250,"context_line":"       \"server\":["},{"line_number":251,"context_line":"       {"},{"line_number":252,"context_line":"           \"name\": \"t1\""},{"line_number":253,"context_line":"           \"updated\": \"2015-12-15T15:55:52Z\""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_d531b00c","line":250,"range":{"start_line":250,"start_character":8,"end_line":250,"end_character":14},"updated":"2016-01-04 03:03:50.000000000","message":"ditto","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":284,"context_line":"   **Example: User query server with administrator only options**"},{"line_number":285,"context_line":""},{"line_number":286,"context_line":".. code::"},{"line_number":287,"context_line":"   Request with non-admin context:"},{"line_number":288,"context_line":"   GET /servers/detail?locked\u003d1"},{"line_number":289,"context_line":""},{"line_number":290,"context_line":"   Response:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_d518d086","line":287,"range":{"start_line":287,"start_character":16,"end_line":287,"end_character":25},"updated":"2016-01-04 03:03:50.000000000","message":"general user","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":289,"context_line":""},{"line_number":290,"context_line":"   Response:"},{"line_number":291,"context_line":"   {"},{"line_number":292,"context_line":"       \"server\":["},{"line_number":293,"context_line":"       {"},{"line_number":294,"context_line":"          \"name\":\"t1\","},{"line_number":295,"context_line":"          ..."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_b53e7cd8","line":292,"range":{"start_line":292,"start_character":8,"end_line":292,"end_character":14},"updated":"2016-01-04 03:03:50.000000000","message":"ditto","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":304,"context_line":"   **Example: Administrator query server with administrator only options**"},{"line_number":305,"context_line":""},{"line_number":306,"context_line":".. code::"},{"line_number":307,"context_line":"   Request with admin context:"},{"line_number":308,"context_line":"   GET /servers/detail?locked\u003d1"},{"line_number":309,"context_line":""},{"line_number":310,"context_line":"   Response:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_7521e4b3","line":307,"range":{"start_line":307,"start_character":16,"end_line":307,"end_character":22},"updated":"2016-01-04 03:03:50.000000000","message":"ditto","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"d50eccb555d24d00b04e7c1f67045081b7c81125","unresolved":false,"context_lines":[{"line_number":309,"context_line":""},{"line_number":310,"context_line":"   Response:"},{"line_number":311,"context_line":"   {"},{"line_number":312,"context_line":"       \"server\":["},{"line_number":313,"context_line":"       {"},{"line_number":314,"context_line":"          \"name\":\"t1\","},{"line_number":315,"context_line":"          ..."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa69d971_552620cf","line":312,"range":{"start_line":312,"start_character":8,"end_line":312,"end_character":14},"updated":"2016-01-04 03:03:50.000000000","message":"ditto","commit_id":"3eaf4c6064ff20eb77b725076201aae1f301d204"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"a519175264bcbbfc161b84e998fb31fcbc4e4dac","unresolved":false,"context_lines":[{"line_number":132,"context_line":"``class Instance``, e.g there is a field named \u0027locked\u0027 in the schema"},{"line_number":133,"context_line":"then the filter can use \u0027locked\u0027 as search options to filter servers."},{"line_number":134,"context_line":"Also, there are some special options such as ``changes-since`` can"},{"line_number":135,"context_line":"be used and interpreted by nova."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"-  **Exact matching and regex matching of the search options**"},{"line_number":138,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_1472a349","line":135,"updated":"2016-01-05 13:59:48.000000000","message":"Honestly, I think we need to think about our audience a bit more here. Our API users will not care about the db schema. We need to tell them exactly what is possible here.","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1fd191819ab688eb6017d6677b453c7f66c5baca","unresolved":false,"context_lines":[{"line_number":132,"context_line":"``class Instance``, e.g there is a field named \u0027locked\u0027 in the schema"},{"line_number":133,"context_line":"then the filter can use \u0027locked\u0027 as search options to filter servers."},{"line_number":134,"context_line":"Also, there are some special options such as ``changes-since`` can"},{"line_number":135,"context_line":"be used and interpreted by nova."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"-  **Exact matching and regex matching of the search options**"},{"line_number":138,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_2528b099","line":135,"in_reply_to":"fa69d971_1472a349","updated":"2016-01-11 21:02:28.000000000","message":"yes, you are right, maybe we should divided them into 2 parts\none for admin and one for user\n\nso user can focus on the supported items talked below","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"a519175264bcbbfc161b84e998fb31fcbc4e4dac","unresolved":false,"context_lines":[{"line_number":140,"context_line":"   using either exact matching or as regular expression matching."},{"line_number":141,"context_line":"   ``project_id``, ``user_id``, ``image_ref``, ``vm_state``,"},{"line_number":142,"context_line":"   ``instance_type_id``, ``uuid``, ``metadata``, ``host``, ``system_metadata``"},{"line_number":143,"context_line":"   are the options that are applied by exact matching when filtering."},{"line_number":144,"context_line":""},{"line_number":145,"context_line":"   **Example: User query server using exact matching on host**"},{"line_number":146,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_f4f02f93","line":143,"updated":"2016-01-05 13:59:48.000000000","message":"Can we please list the options that have regex filtering?\n\nWhat about admin vs non-admin. I think we should first document all the user options, then note the extra options if you are an admin.","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1fd191819ab688eb6017d6677b453c7f66c5baca","unresolved":false,"context_lines":[{"line_number":140,"context_line":"   using either exact matching or as regular expression matching."},{"line_number":141,"context_line":"   ``project_id``, ``user_id``, ``image_ref``, ``vm_state``,"},{"line_number":142,"context_line":"   ``instance_type_id``, ``uuid``, ``metadata``, ``host``, ``system_metadata``"},{"line_number":143,"context_line":"   are the options that are applied by exact matching when filtering."},{"line_number":144,"context_line":""},{"line_number":145,"context_line":"   **Example: User query server using exact matching on host**"},{"line_number":146,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_0814a3e6","line":143,"in_reply_to":"fa69d971_f4f02f93","updated":"2016-01-11 21:02:28.000000000","message":"ok, I moved admin and non-admin section to top","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"a519175264bcbbfc161b84e998fb31fcbc4e4dac","unresolved":false,"context_lines":[{"line_number":146,"context_line":""},{"line_number":147,"context_line":".. code::"},{"line_number":148,"context_line":"   Precondition:"},{"line_number":149,"context_line":"   Request with administrator context:"},{"line_number":150,"context_line":"   GET /servers/detail"},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"   Response:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_b42dd7ff","line":149,"updated":"2016-01-05 13:59:48.000000000","message":"Maybe can we go for non-admin examples? or is that silly?","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1fd191819ab688eb6017d6677b453c7f66c5baca","unresolved":false,"context_lines":[{"line_number":146,"context_line":""},{"line_number":147,"context_line":".. code::"},{"line_number":148,"context_line":"   Precondition:"},{"line_number":149,"context_line":"   Request with administrator context:"},{"line_number":150,"context_line":"   GET /servers/detail"},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"   Response:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_c8bf6bce","line":149,"in_reply_to":"fa69d971_b42dd7ff","updated":"2016-01-11 21:02:28.000000000","message":"um.. it\u0027s transparent to db layer since  it\u0027s only a search option, so I think maybe it\u0027s not needed","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"a519175264bcbbfc161b84e998fb31fcbc4e4dac","unresolved":false,"context_lines":[{"line_number":272,"context_line":"   }"},{"line_number":273,"context_line":""},{"line_number":274,"context_line":""},{"line_number":275,"context_line":"-  **General user \u0026 Administrator supported options**"},{"line_number":276,"context_line":"   General user can only use ``reservation_id``, ``name``, ``status``,"},{"line_number":277,"context_line":"   ``image``, ``flavor``, ``ip``, ``changes-since``, ``all_tenants``,"},{"line_number":278,"context_line":"   ``ip6 (microversion 2.5)`` options to filter servers. The other"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_740aff7a","line":275,"updated":"2016-01-05 13:59:48.000000000","message":"I think we should reverse this. Lets start with non-admin options, and just note the admin ones at the end, along with this note about users requesting admin options.\n\nSee comments above.","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1fd191819ab688eb6017d6677b453c7f66c5baca","unresolved":false,"context_lines":[{"line_number":272,"context_line":"   }"},{"line_number":273,"context_line":""},{"line_number":274,"context_line":""},{"line_number":275,"context_line":"-  **General user \u0026 Administrator supported options**"},{"line_number":276,"context_line":"   General user can only use ``reservation_id``, ``name``, ``status``,"},{"line_number":277,"context_line":"   ``image``, ``flavor``, ``ip``, ``changes-since``, ``all_tenants``,"},{"line_number":278,"context_line":"   ``ip6 (microversion 2.5)`` options to filter servers. The other"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_882173a0","line":275,"in_reply_to":"fa69d971_740aff7a","updated":"2016-01-11 21:02:28.000000000","message":"yeah, make sense to me , I will move this to top \nof this section in next patch","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"a519175264bcbbfc161b84e998fb31fcbc4e4dac","unresolved":false,"context_lines":[{"line_number":285,"context_line":""},{"line_number":286,"context_line":".. code::"},{"line_number":287,"context_line":"   Request with non-administrator context:"},{"line_number":288,"context_line":"   GET /servers/detail?locked\u003d1"},{"line_number":289,"context_line":""},{"line_number":290,"context_line":"   Response:"},{"line_number":291,"context_line":"   {"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_348c87d9","line":288,"updated":"2016-01-05 13:59:48.000000000","message":"This reminds me, should we give examples for each of the options, so its clear what you use.\n\nI do wonder if we should use true/false here, assuming that works, and its what would be output when you list the details for the servers?","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1fd191819ab688eb6017d6677b453c7f66c5baca","unresolved":false,"context_lines":[{"line_number":285,"context_line":""},{"line_number":286,"context_line":".. code::"},{"line_number":287,"context_line":"   Request with non-administrator context:"},{"line_number":288,"context_line":"   GET /servers/detail?locked\u003d1"},{"line_number":289,"context_line":""},{"line_number":290,"context_line":"   Response:"},{"line_number":291,"context_line":"   {"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_28cde765","line":288,"in_reply_to":"fa69d971_348c87d9","updated":"2016-01-11 21:02:28.000000000","message":"maybe for each option is too aggressive? \none typical example might be ok? \n\nI am sorry don\u0027t get 2nd half of the question, you mean locked\u003d1/locked\u003d0 here? I copied from devstack debug log, I think that\u0027s fine?","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"a519175264bcbbfc161b84e998fb31fcbc4e4dac","unresolved":false,"context_lines":[{"line_number":296,"context_line":"       }"},{"line_number":297,"context_line":"       {"},{"line_number":298,"context_line":"          \"name\":\"t2\","},{"line_number":299,"context_line":"          ...   "},{"line_number":300,"context_line":"       }"},{"line_number":301,"context_line":"       ]"},{"line_number":302,"context_line":"   }"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_94b9b37b","line":299,"updated":"2016-01-05 13:59:48.000000000","message":"should we not include the locked value returned in this response.","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1fd191819ab688eb6017d6677b453c7f66c5baca","unresolved":false,"context_lines":[{"line_number":296,"context_line":"       }"},{"line_number":297,"context_line":"       {"},{"line_number":298,"context_line":"          \"name\":\"t2\","},{"line_number":299,"context_line":"          ...   "},{"line_number":300,"context_line":"       }"},{"line_number":301,"context_line":"       ]"},{"line_number":302,"context_line":"   }"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_680d1fe7","line":299,"in_reply_to":"fa69d971_94b9b37b","updated":"2016-01-11 21:02:28.000000000","message":"yeah, will add it","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"a519175264bcbbfc161b84e998fb31fcbc4e4dac","unresolved":false,"context_lines":[{"line_number":311,"context_line":"   {"},{"line_number":312,"context_line":"       \"servers\":["},{"line_number":313,"context_line":"       {"},{"line_number":314,"context_line":"          \"name\":\"t1\","},{"line_number":315,"context_line":"          ..."},{"line_number":316,"context_line":"       }"},{"line_number":317,"context_line":"       ]"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_d46acbed","line":314,"updated":"2016-01-05 13:59:48.000000000","message":"as above, should we not include the locked value here.","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1fd191819ab688eb6017d6677b453c7f66c5baca","unresolved":false,"context_lines":[{"line_number":311,"context_line":"   {"},{"line_number":312,"context_line":"       \"servers\":["},{"line_number":313,"context_line":"       {"},{"line_number":314,"context_line":"          \"name\":\"t1\","},{"line_number":315,"context_line":"          ..."},{"line_number":316,"context_line":"       }"},{"line_number":317,"context_line":"       ]"}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_c80a0bd2","line":314,"in_reply_to":"fa69d971_d46acbed","updated":"2016-01-11 21:02:28.000000000","message":"yeah, will add it","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"a519175264bcbbfc161b84e998fb31fcbc4e4dac","unresolved":false,"context_lines":[{"line_number":316,"context_line":"       }"},{"line_number":317,"context_line":"       ]"},{"line_number":318,"context_line":"   }"},{"line_number":319,"context_line":"   "},{"line_number":320,"context_line":"Server actions"},{"line_number":321,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":322,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_14e1439a","line":319,"updated":"2016-01-05 13:59:48.000000000","message":"We should also include combining filters, a user example, maybe changes_since and name regex, or something like that?","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1fd191819ab688eb6017d6677b453c7f66c5baca","unresolved":false,"context_lines":[{"line_number":316,"context_line":"       }"},{"line_number":317,"context_line":"       ]"},{"line_number":318,"context_line":"   }"},{"line_number":319,"context_line":"   "},{"line_number":320,"context_line":"Server actions"},{"line_number":321,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":322,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"fa69d971_68a3df00","line":319,"in_reply_to":"fa69d971_14e1439a","updated":"2016-01-11 21:02:28.000000000","message":"ok, I can add a new one as combined example","commit_id":"8c205ddd1c33047c236e53d32363a46ee731dfd6"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"1107319909e5577e2f93d85370d37a4f81036aaa","unresolved":false,"context_lines":[{"line_number":145,"context_line":"   use the almost all the options except the options parameters for sorting"},{"line_number":146,"context_line":"   and pagination."},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"   **Example: User query server with administrator only options**"},{"line_number":149,"context_line":""},{"line_number":150,"context_line":".. code::"},{"line_number":151,"context_line":"   Request with non-administrator context:"}],"source_content_type":"text/x-rst","patch_set":3,"id":"da6ed579_1f95443f","line":148,"range":{"start_line":148,"start_character":14,"end_line":148,"end_character":18},"updated":"2016-01-18 09:58:34.000000000","message":"s/General user query/User query server/ I guess.\n\nI am guessing here picks \"locked\" as administrator only option, but here doesn\u0027t clarify it and I cannot understand the point of here..","commit_id":"245aad22e459aa6728275ba2e418fd67f4f0df1d"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1f1515b458c4ea538772afd2eed4b04ef989b231","unresolved":false,"context_lines":[{"line_number":145,"context_line":"   use the almost all the options except the options parameters for sorting"},{"line_number":146,"context_line":"   and pagination."},{"line_number":147,"context_line":""},{"line_number":148,"context_line":"   **Example: User query server with administrator only options**"},{"line_number":149,"context_line":""},{"line_number":150,"context_line":".. code::"},{"line_number":151,"context_line":"   Request with non-administrator context:"}],"source_content_type":"text/x-rst","patch_set":3,"id":"da6ed579_d2da4317","line":148,"range":{"start_line":148,"start_character":14,"end_line":148,"end_character":18},"in_reply_to":"da6ed579_1f95443f","updated":"2016-01-18 10:18:07.000000000","message":"ok, will update here with \u0027preconditions\u0027 and change the wording","commit_id":"245aad22e459aa6728275ba2e418fd67f4f0df1d"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"1107319909e5577e2f93d85370d37a4f81036aaa","unresolved":false,"context_lines":[{"line_number":162,"context_line":"       {"},{"line_number":163,"context_line":"          \"name\":\"t2\","},{"line_number":164,"context_line":"          \"locked\": \"true\","},{"line_number":165,"context_line":"          ...   "},{"line_number":166,"context_line":"       }"},{"line_number":167,"context_line":"       ]"},{"line_number":168,"context_line":"   }"}],"source_content_type":"text/x-rst","patch_set":3,"id":"da6ed579_7ff7a0f5","line":165,"range":{"start_line":165,"start_character":13,"end_line":165,"end_character":16},"updated":"2016-01-18 09:58:34.000000000","message":"nit: unnecessary spaces.","commit_id":"245aad22e459aa6728275ba2e418fd67f4f0df1d"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1f1515b458c4ea538772afd2eed4b04ef989b231","unresolved":false,"context_lines":[{"line_number":162,"context_line":"       {"},{"line_number":163,"context_line":"          \"name\":\"t2\","},{"line_number":164,"context_line":"          \"locked\": \"true\","},{"line_number":165,"context_line":"          ...   "},{"line_number":166,"context_line":"       }"},{"line_number":167,"context_line":"       ]"},{"line_number":168,"context_line":"   }"}],"source_content_type":"text/x-rst","patch_set":3,"id":"da6ed579_52fdf36c","line":165,"range":{"start_line":165,"start_character":13,"end_line":165,"end_character":16},"in_reply_to":"da6ed579_7ff7a0f5","updated":"2016-01-18 10:18:07.000000000","message":"Done","commit_id":"245aad22e459aa6728275ba2e418fd67f4f0df1d"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"1107319909e5577e2f93d85370d37a4f81036aaa","unresolved":false,"context_lines":[{"line_number":365,"context_line":"           ..."},{"line_number":366,"context_line":"       }"},{"line_number":367,"context_line":"   }"},{"line_number":368,"context_line":"   "},{"line_number":369,"context_line":"Server actions"},{"line_number":370,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":371,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"da6ed579_ff72b048","line":368,"range":{"start_line":368,"start_character":0,"end_line":368,"end_character":3},"updated":"2016-01-18 09:58:34.000000000","message":"unnecessary spaces","commit_id":"245aad22e459aa6728275ba2e418fd67f4f0df1d"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"1f1515b458c4ea538772afd2eed4b04ef989b231","unresolved":false,"context_lines":[{"line_number":365,"context_line":"           ..."},{"line_number":366,"context_line":"       }"},{"line_number":367,"context_line":"   }"},{"line_number":368,"context_line":"   "},{"line_number":369,"context_line":"Server actions"},{"line_number":370,"context_line":"~~~~~~~~~~~~~~~"},{"line_number":371,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"da6ed579_922a8be6","line":368,"range":{"start_line":368,"start_character":0,"end_line":368,"end_character":3},"in_reply_to":"da6ed579_ff72b048","updated":"2016-01-18 10:18:07.000000000","message":"Done","commit_id":"245aad22e459aa6728275ba2e418fd67f4f0df1d"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"62e56c87f8eea2a9ad52cf4b3fe760f0b6ea348b","unresolved":false,"context_lines":[{"line_number":131,"context_line":"For general user, ``reservation_id``, ``name``, ``status``, ``image``,"},{"line_number":132,"context_line":"``flavor``, ``ip``, ``changes-since``, ``all_tenants``,"},{"line_number":133,"context_line":"``ip6 (microversion 2.5)`` are supported options to be used. The other"},{"line_number":134,"context_line":"options will be ignored by nova silently only with a debug log."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"For administrator, there are more fields can be used."},{"line_number":137,"context_line":"Usually the filter is operated on the database schema definition of"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba63e191_318ce07e","line":134,"updated":"2016-01-19 22:46:02.000000000","message":"Ugh, I didn\u0027t realize that this was the case. It really should return a 406 or similar.","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"74f3dc8c35f7eac0e1b366b93c6146cf398f3814","unresolved":false,"context_lines":[{"line_number":131,"context_line":"For general user, ``reservation_id``, ``name``, ``status``, ``image``,"},{"line_number":132,"context_line":"``flavor``, ``ip``, ``changes-since``, ``all_tenants``,"},{"line_number":133,"context_line":"``ip6 (microversion 2.5)`` are supported options to be used. The other"},{"line_number":134,"context_line":"options will be ignored by nova silently only with a debug log."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"For administrator, there are more fields can be used."},{"line_number":137,"context_line":"Usually the filter is operated on the database schema definition of"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a68dd71_8b5eb174","line":134,"in_reply_to":"ba63e191_318ce07e","updated":"2016-01-21 21:05:55.000000000","message":"I remember some bps for this ,but seems no action till now","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"ebf01024629efd621b2a97968f257f2ecc73a552","unresolved":false,"context_lines":[{"line_number":134,"context_line":"options will be ignored by nova silently only with a debug log."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"For administrator, there are more fields can be used."},{"line_number":137,"context_line":"Usually the filter is operated on the database schema definition of"},{"line_number":138,"context_line":"``class Instance``, e.g there is a field named \u0027locked\u0027 in the schema"},{"line_number":139,"context_line":"then the filter can use \u0027locked\u0027 as search options to filter servers."},{"line_number":140,"context_line":"Also, there are some special options such as ``changes-since`` can"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba63e191_e772407c","line":137,"range":{"start_line":137,"start_character":38,"end_line":137,"end_character":64},"updated":"2016-01-19 07:54:39.000000000","message":"emm...we really need fix this in the future. we should have supported filter list which not depend on db schema.","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"74f3dc8c35f7eac0e1b366b93c6146cf398f3814","unresolved":false,"context_lines":[{"line_number":134,"context_line":"options will be ignored by nova silently only with a debug log."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"For administrator, there are more fields can be used."},{"line_number":137,"context_line":"Usually the filter is operated on the database schema definition of"},{"line_number":138,"context_line":"``class Instance``, e.g there is a field named \u0027locked\u0027 in the schema"},{"line_number":139,"context_line":"then the filter can use \u0027locked\u0027 as search options to filter servers."},{"line_number":140,"context_line":"Also, there are some special options such as ``changes-since`` can"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a68dd71_8bec7190","line":137,"range":{"start_line":137,"start_character":38,"end_line":137,"end_character":64},"in_reply_to":"ba63e191_e772407c","updated":"2016-01-21 21:05:55.000000000","message":"true, maybe something to be done in N","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"ebf01024629efd621b2a97968f257f2ecc73a552","unresolved":false,"context_lines":[{"line_number":142,"context_line":""},{"line_number":143,"context_line":"-  **General user \u0026 Administrator supported options**"},{"line_number":144,"context_line":"   General user suported options are listed above and administrator can"},{"line_number":145,"context_line":"   use the almost all the options except the options parameters for sorting"},{"line_number":146,"context_line":"   and pagination."},{"line_number":147,"context_line":""},{"line_number":148,"context_line":".. code::"},{"line_number":149,"context_line":"   Precondition:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba63e191_472b0c31","line":146,"range":{"start_line":145,"start_character":34,"end_line":146,"end_character":18},"updated":"2016-01-19 07:54:39.000000000","message":"after check the code, found this is true. curious why admin can use sorting and pagination.","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"62e56c87f8eea2a9ad52cf4b3fe760f0b6ea348b","unresolved":false,"context_lines":[{"line_number":142,"context_line":""},{"line_number":143,"context_line":"-  **General user \u0026 Administrator supported options**"},{"line_number":144,"context_line":"   General user suported options are listed above and administrator can"},{"line_number":145,"context_line":"   use the almost all the options except the options parameters for sorting"},{"line_number":146,"context_line":"   and pagination."},{"line_number":147,"context_line":""},{"line_number":148,"context_line":".. code::"},{"line_number":149,"context_line":"   Precondition:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba63e191_b15bf0f5","line":146,"range":{"start_line":145,"start_character":34,"end_line":146,"end_character":18},"in_reply_to":"ba63e191_472b0c31","updated":"2016-01-19 22:46:02.000000000","message":"Surprised me too.","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"74f3dc8c35f7eac0e1b366b93c6146cf398f3814","unresolved":false,"context_lines":[{"line_number":157,"context_line":"   }"},{"line_number":158,"context_line":"   {"},{"line_number":159,"context_line":"       \"name\":\"t2\","},{"line_number":160,"context_line":"       \"locked\": \"true\","},{"line_number":161,"context_line":"       ..."},{"line_number":162,"context_line":"   }"},{"line_number":163,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a68dd71_0b2c01aa","line":160,"range":{"start_line":160,"start_character":7,"end_line":160,"end_character":8},"updated":"2016-01-21 21:05:55.000000000","message":"actually, typo here, it should be false.. sorry","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"62e56c87f8eea2a9ad52cf4b3fe760f0b6ea348b","unresolved":false,"context_lines":[{"line_number":177,"context_line":"       }"},{"line_number":178,"context_line":"       {"},{"line_number":179,"context_line":"          \"name\":\"t2\","},{"line_number":180,"context_line":"          \"locked\": \"true\","},{"line_number":181,"context_line":"          ..."},{"line_number":182,"context_line":"       }"},{"line_number":183,"context_line":"       ]"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba63e191_11043cbe","line":180,"range":{"start_line":180,"start_character":21,"end_line":180,"end_character":25},"updated":"2016-01-19 22:46:02.000000000","message":"Based on the text below, I think that this should be \u0027false\u0027","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"74f3dc8c35f7eac0e1b366b93c6146cf398f3814","unresolved":false,"context_lines":[{"line_number":177,"context_line":"       }"},{"line_number":178,"context_line":"       {"},{"line_number":179,"context_line":"          \"name\":\"t2\","},{"line_number":180,"context_line":"          \"locked\": \"true\","},{"line_number":181,"context_line":"          ..."},{"line_number":182,"context_line":"       }"},{"line_number":183,"context_line":"       ]"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a68dd71_8ecebfb2","line":180,"range":{"start_line":180,"start_character":21,"end_line":180,"end_character":25},"in_reply_to":"ba63e191_11043cbe","updated":"2016-01-21 21:05:55.000000000","message":"thanks, actually I should remove them because locked is not returned through API","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"ebf01024629efd621b2a97968f257f2ecc73a552","unresolved":false,"context_lines":[{"line_number":187,"context_line":""},{"line_number":188,"context_line":".. code::"},{"line_number":189,"context_line":"   Request with administrator context:"},{"line_number":190,"context_line":"   GET /servers/detail?locked\u003d1"},{"line_number":191,"context_line":""},{"line_number":192,"context_line":"   Response:"},{"line_number":193,"context_line":"   {"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba63e191_279ff804","line":190,"range":{"start_line":190,"start_character":23,"end_line":190,"end_character":29},"updated":"2016-01-19 07:54:39.000000000","message":"the server \u0027t2\u0027 locked field is true also, why we didn\u0027t return it in the response?","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"62e56c87f8eea2a9ad52cf4b3fe760f0b6ea348b","unresolved":false,"context_lines":[{"line_number":247,"context_line":"       ]"},{"line_number":248,"context_line":"   }"},{"line_number":249,"context_line":"   "},{"line_number":250,"context_line":"   **Example: Query server using regex matching on name**"},{"line_number":251,"context_line":""},{"line_number":252,"context_line":".. code::"},{"line_number":253,"context_line":"   Precondition:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba63e191_f192c84a","line":250,"range":{"start_line":250,"start_character":33,"end_line":250,"end_character":38},"updated":"2016-01-19 22:46:02.000000000","message":"This really isn\u0027t \u0027regex\u0027 matching; it\u0027s just returning all servers beginning with the passed value. A regex would look like:\n\n   GET /servers/detail?name\u003dt1.*","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"74f3dc8c35f7eac0e1b366b93c6146cf398f3814","unresolved":false,"context_lines":[{"line_number":247,"context_line":"       ]"},{"line_number":248,"context_line":"   }"},{"line_number":249,"context_line":"   "},{"line_number":250,"context_line":"   **Example: Query server using regex matching on name**"},{"line_number":251,"context_line":""},{"line_number":252,"context_line":".. code::"},{"line_number":253,"context_line":"   Precondition:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a68dd71_0b55e11b","line":250,"range":{"start_line":250,"start_character":33,"end_line":250,"end_character":38},"in_reply_to":"ba63e191_f192c84a","updated":"2016-01-21 21:05:55.000000000","message":"yeah, good point","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"ebf01024629efd621b2a97968f257f2ecc73a552","unresolved":false,"context_lines":[{"line_number":345,"context_line":"   }"},{"line_number":346,"context_line":""},{"line_number":347,"context_line":"-  **Speical keys are used to tweek the query**"},{"line_number":348,"context_line":"   ``changes-since`` returns instances updated after the given time,"},{"line_number":349,"context_line":"   ``deleted`` return (or exclude) deleted instances and ``soft_deleted``"},{"line_number":350,"context_line":"   modify behavior of \u0027deleted\u0027 to either include or exclude instances whose"},{"line_number":351,"context_line":"   vm_state is SOFT_DELETED."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba63e191_27e8587c","line":348,"range":{"start_line":348,"start_character":5,"end_line":348,"end_character":18},"updated":"2016-01-19 07:54:39.000000000","message":"we have another whole section about this http://developer.openstack.org/api-guide/compute/polling_changes-since_parameter.html, Is there any chance we can merge them?","commit_id":"3817061459c3eeea7865481911b274c22b17debf"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"74f3dc8c35f7eac0e1b366b93c6146cf398f3814","unresolved":false,"context_lines":[{"line_number":345,"context_line":"   }"},{"line_number":346,"context_line":""},{"line_number":347,"context_line":"-  **Speical keys are used to tweek the query**"},{"line_number":348,"context_line":"   ``changes-since`` returns instances updated after the given time,"},{"line_number":349,"context_line":"   ``deleted`` return (or exclude) deleted instances and ``soft_deleted``"},{"line_number":350,"context_line":"   modify behavior of \u0027deleted\u0027 to either include or exclude instances whose"},{"line_number":351,"context_line":"   vm_state is SOFT_DELETED."}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a68dd71_cb4ee995","line":348,"range":{"start_line":348,"start_character":5,"end_line":348,"end_character":18},"in_reply_to":"ba63e191_27e8587c","updated":"2016-01-21 21:05:55.000000000","message":"I can add a refer to, this is for \u0027list all possible options to query server\u0027 :)","commit_id":"3817061459c3eeea7865481911b274c22b17debf"}]}