)]}'
{"placement-api-ref/source/allocation_candidates.inc":[{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"1fd9e57c4b1dace8401bbf1d97788d808b2fda10","unresolved":false,"context_lines":[{"line_number":4,"context_line":""},{"line_number":5,"context_line":".. note:: Allocation candidates API requests are availiable starting from version 1.10."},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Show allocation candidates"},{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"}],"source_content_type":"text/x-c++src","patch_set":1,"id":"3f1d235d_d148b85c","line":7,"range":{"start_line":7,"start_character":0,"end_line":7,"end_character":4},"updated":"2017-07-07 06:29:59.000000000","message":"List","commit_id":"a1aaa9c4efdc630d8e242e6ef8fb9724225f8527"},{"author":{"_account_id":21813,"name":"Andrey Volkov","email":"m@amadev.ru","username":"avolkov"},"change_message_id":"0f78504995225f2b37342a65cdf549820f9f424a","unresolved":false,"context_lines":[{"line_number":4,"context_line":""},{"line_number":5,"context_line":".. note:: Allocation candidates API requests are availiable starting from version 1.10."},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Show allocation candidates"},{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"}],"source_content_type":"text/x-c++src","patch_set":1,"id":"3f1d235d_14b5f4cd","line":7,"range":{"start_line":7,"start_character":0,"end_line":7,"end_character":4},"in_reply_to":"3f1d235d_d148b85c","updated":"2017-07-07 12:02:05.000000000","message":"Done","commit_id":"a1aaa9c4efdc630d8e242e6ef8fb9724225f8527"},{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"1fd9e57c4b1dace8401bbf1d97788d808b2fda10","unresolved":false,"context_lines":[{"line_number":21,"context_line":""},{"line_number":22,"context_line":".. rest_parameters:: parameters.yaml"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"  - resources: resources_query"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"Response"},{"line_number":27,"context_line":"--------"}],"source_content_type":"text/x-c++src","patch_set":1,"id":"3f1d235d_1c764771","line":24,"range":{"start_line":24,"start_character":15,"end_line":24,"end_character":30},"updated":"2017-07-07 06:29:59.000000000","message":"In \"List resource providers\" (GET /resource_providers), the \u0027resources\u0027 parameter is optional. But in this API, it is required.\n\nhttps://github.com/openstack/nova/blob/6d4e65925ac714fd462841428f088dbaca18d9c5/nova/api/openstack/placement/handlers/allocation_candidate.py#L41-L43","commit_id":"a1aaa9c4efdc630d8e242e6ef8fb9724225f8527"},{"author":{"_account_id":21813,"name":"Andrey Volkov","email":"m@amadev.ru","username":"avolkov"},"change_message_id":"0f78504995225f2b37342a65cdf549820f9f424a","unresolved":false,"context_lines":[{"line_number":21,"context_line":""},{"line_number":22,"context_line":".. rest_parameters:: parameters.yaml"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"  - resources: resources_query"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"Response"},{"line_number":27,"context_line":"--------"}],"source_content_type":"text/x-c++src","patch_set":1,"id":"3f1d235d_f4c9585a","line":24,"range":{"start_line":24,"start_character":15,"end_line":24,"end_character":30},"in_reply_to":"3f1d235d_1c764771","updated":"2017-07-07 12:02:05.000000000","message":"Done","commit_id":"a1aaa9c4efdc630d8e242e6ef8fb9724225f8527"},{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"1fd9e57c4b1dace8401bbf1d97788d808b2fda10","unresolved":false,"context_lines":[{"line_number":28,"context_line":""},{"line_number":29,"context_line":".. rest_parameters:: parameters.yaml"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"  - allocation_requests: allocation_requests"},{"line_number":32,"context_line":"  - provider_summaries: provider_summaries"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"Response Example"},{"line_number":35,"context_line":"----------------"}],"source_content_type":"text/x-c++src","patch_set":1,"id":"3f1d235d_dcee8feb","line":32,"range":{"start_line":31,"start_character":0,"end_line":32,"end_character":42},"updated":"2017-07-07 06:29:59.000000000","message":"The following parameters in the response example should be added.\n\n* resource_provider\n* uuid\n* allocations\n* resources\n* capacity\n* used","commit_id":"a1aaa9c4efdc630d8e242e6ef8fb9724225f8527"},{"author":{"_account_id":21813,"name":"Andrey Volkov","email":"m@amadev.ru","username":"avolkov"},"change_message_id":"0f78504995225f2b37342a65cdf549820f9f424a","unresolved":false,"context_lines":[{"line_number":28,"context_line":""},{"line_number":29,"context_line":".. rest_parameters:: parameters.yaml"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"  - allocation_requests: allocation_requests"},{"line_number":32,"context_line":"  - provider_summaries: provider_summaries"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"Response Example"},{"line_number":35,"context_line":"----------------"}],"source_content_type":"text/x-c++src","patch_set":1,"id":"3f1d235d_d4c65c4a","line":32,"range":{"start_line":31,"start_character":0,"end_line":32,"end_character":42},"in_reply_to":"3f1d235d_dcee8feb","updated":"2017-07-07 12:02:05.000000000","message":"Done","commit_id":"a1aaa9c4efdc630d8e242e6ef8fb9724225f8527"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"4e5c19916914b0e89cad532caaf07a663f5db854","unresolved":false,"context_lines":[{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and provider summaries."},{"line_number":12,"context_line":""},{"line_number":13,"context_line":".. rest_method:: GET /allocation_candidates"},{"line_number":14,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":5,"id":"3f1d235d_a8ea11d5","line":11,"updated":"2017-07-11 11:17:40.000000000","message":"s/provider/resource provider/\n\nProbably also useful to provide an explanation of what one does with allocation candidates (probably using the info you\u0027ve provided in parameters.yaml for allocations as a starting point).","commit_id":"cc6c60d0c003a9df6ab4d4022d4bcb91bd55dd62"},{"author":{"_account_id":21813,"name":"Andrey Volkov","email":"m@amadev.ru","username":"avolkov"},"change_message_id":"915438983854dcb3f876b96d13d29028bdc63369","unresolved":false,"context_lines":[{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and provider summaries."},{"line_number":12,"context_line":""},{"line_number":13,"context_line":".. rest_method:: GET /allocation_candidates"},{"line_number":14,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":5,"id":"1f1a1f67_556c7f07","line":11,"in_reply_to":"3f1d235d_a8ea11d5","updated":"2017-07-12 13:11:19.000000000","message":"Done","commit_id":"cc6c60d0c003a9df6ab4d4022d4bcb91bd55dd62"},{"author":{"_account_id":7,"name":"Jay Pipes","email":"jaypipes@gmail.com","username":"jaypipes"},"change_message_id":"0857c43880782444b6f03d02acd3430e41a0de12","unresolved":false,"context_lines":[{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has a base"},{"line_number":12,"context_line":"information to form a PUT allocation request to claim resources"},{"line_number":13,"context_line":"against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocations"}],"source_content_type":"text/x-c++src","patch_set":10,"id":"df3967d1_05adfd99","line":11,"range":{"start_line":11,"start_character":60,"end_line":11,"end_character":67},"updated":"2017-08-04 16:07:08.000000000","message":"s/a base//","commit_id":"060fa02d19b7b4c3357615f447144f8195d2e2d1"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"bba3674b02ba28595735ba1eef584f4d8fe6d652","unresolved":false,"context_lines":[{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has a base"},{"line_number":12,"context_line":"information to form a PUT allocation request to claim resources"},{"line_number":13,"context_line":"against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocations"}],"source_content_type":"text/x-c++src","patch_set":10,"id":"bf3e73b7_c22c399b","line":11,"range":{"start_line":11,"start_character":60,"end_line":11,"end_character":67},"in_reply_to":"df3967d1_05adfd99","updated":"2017-08-10 09:58:46.000000000","message":"Done","commit_id":"060fa02d19b7b4c3357615f447144f8195d2e2d1"},{"author":{"_account_id":7,"name":"Jay Pipes","email":"jaypipes@gmail.com","username":"jaypipes"},"change_message_id":"0857c43880782444b6f03d02acd3430e41a0de12","unresolved":false,"context_lines":[{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has a base"},{"line_number":12,"context_line":"information to form a PUT allocation request to claim resources"},{"line_number":13,"context_line":"against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocations"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"}],"source_content_type":"text/x-c++src","patch_set":10,"id":"df3967d1_658de930","line":12,"range":{"start_line":12,"start_character":22,"end_line":12,"end_character":37},"updated":"2017-08-04 16:07:08.000000000","message":"s/PUT allocation/PUT \\/allocations\\/{consumer_uuid}/","commit_id":"060fa02d19b7b4c3357615f447144f8195d2e2d1"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"bba3674b02ba28595735ba1eef584f4d8fe6d652","unresolved":false,"context_lines":[{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has a base"},{"line_number":12,"context_line":"information to form a PUT allocation request to claim resources"},{"line_number":13,"context_line":"against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocations"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"}],"source_content_type":"text/x-c++src","patch_set":10,"id":"bf3e73b7_a22135a2","line":12,"range":{"start_line":12,"start_character":22,"end_line":12,"end_character":37},"in_reply_to":"df3967d1_658de930","updated":"2017-08-10 09:58:46.000000000","message":"Done","commit_id":"060fa02d19b7b4c3357615f447144f8195d2e2d1"},{"author":{"_account_id":7,"name":"Jay Pipes","email":"jaypipes@gmail.com","username":"jaypipes"},"change_message_id":"0857c43880782444b6f03d02acd3430e41a0de12","unresolved":false,"context_lines":[{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has a base"},{"line_number":12,"context_line":"information to form a PUT allocation request to claim resources"},{"line_number":13,"context_line":"against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocations"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information that a client can use to sort/weigh the"}],"source_content_type":"text/x-c++src","patch_set":10,"id":"df3967d1_a5abd172","line":14,"range":{"start_line":14,"start_character":56,"end_line":14,"end_character":67},"updated":"2017-08-04 16:07:08.000000000","message":"s/allocations/allocation/","commit_id":"060fa02d19b7b4c3357615f447144f8195d2e2d1"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"bba3674b02ba28595735ba1eef584f4d8fe6d652","unresolved":false,"context_lines":[{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has a base"},{"line_number":12,"context_line":"information to form a PUT allocation request to claim resources"},{"line_number":13,"context_line":"against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocations"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information that a client can use to sort/weigh the"}],"source_content_type":"text/x-c++src","patch_set":10,"id":"bf3e73b7_223545db","line":14,"range":{"start_line":14,"start_character":56,"end_line":14,"end_character":67},"in_reply_to":"df3967d1_a5abd172","updated":"2017-08-10 09:58:46.000000000","message":"Done","commit_id":"060fa02d19b7b4c3357615f447144f8195d2e2d1"},{"author":{"_account_id":7,"name":"Jay Pipes","email":"jaypipes@gmail.com","username":"jaypipes"},"change_message_id":"0857c43880782444b6f03d02acd3430e41a0de12","unresolved":false,"context_lines":[{"line_number":13,"context_line":"against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocations"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information that a client can use to sort/weigh the"},{"line_number":18,"context_line":"results of the call when making its destination host decisions."},{"line_number":19,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":10,"id":"df3967d1_45954532","line":16,"range":{"start_line":16,"start_character":0,"end_line":16,"end_character":8},"updated":"2017-08-04 16:07:08.000000000","message":"s/decision/decision, /","commit_id":"060fa02d19b7b4c3357615f447144f8195d2e2d1"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"bba3674b02ba28595735ba1eef584f4d8fe6d652","unresolved":false,"context_lines":[{"line_number":13,"context_line":"against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocations"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information that a client can use to sort/weigh the"},{"line_number":18,"context_line":"results of the call when making its destination host decisions."},{"line_number":19,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":10,"id":"bf3e73b7_023241f2","line":16,"range":{"start_line":16,"start_character":0,"end_line":16,"end_character":8},"in_reply_to":"df3967d1_45954532","updated":"2017-08-10 09:58:46.000000000","message":"Done","commit_id":"060fa02d19b7b4c3357615f447144f8195d2e2d1"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"6b8963ec698ccce950752c3bf72cfa42583df2e9","unresolved":false,"context_lines":[{"line_number":7,"context_line":"List allocation candidates"},{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has"},{"line_number":12,"context_line":"information to form a ``PUT /allocations/{consumer_uuid}`` request to claim"},{"line_number":13,"context_line":"resources against a related set of resource providers, additional parameters"}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_32c338f0","line":10,"range":{"start_line":10,"start_character":0,"end_line":10,"end_character":6},"updated":"2017-08-09 15:51:58.000000000","message":"Returns?","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"388f614ed9b02839593db7e6e86a9495a442bdec","unresolved":false,"context_lines":[{"line_number":7,"context_line":"List allocation candidates"},{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has"},{"line_number":12,"context_line":"information to form a ``PUT /allocations/{consumer_uuid}`` request to claim"},{"line_number":13,"context_line":"resources against a related set of resource providers, additional parameters"}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_3af418cf","line":10,"range":{"start_line":10,"start_character":0,"end_line":10,"end_character":6},"in_reply_to":"9f436f4f_32c338f0","updated":"2017-08-10 09:58:09.000000000","message":"In the placement api ref, seems like this form is used, but in nova\u0027s api-ref, it is like you suggest. Will change to returns","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"6b8963ec698ccce950752c3bf72cfa42583df2e9","unresolved":false,"context_lines":[{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has"},{"line_number":12,"context_line":"information to form a ``PUT /allocations/{consumer_uuid}`` request to claim"},{"line_number":13,"context_line":"resources against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocation"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_52635c1b","line":13,"range":{"start_line":13,"start_character":53,"end_line":13,"end_character":54},"updated":"2017-08-09 15:51:58.000000000","message":"; or \". Additional parameters...\"","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"388f614ed9b02839593db7e6e86a9495a442bdec","unresolved":false,"context_lines":[{"line_number":10,"context_line":"Return a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has"},{"line_number":12,"context_line":"information to form a ``PUT /allocations/{consumer_uuid}`` request to claim"},{"line_number":13,"context_line":"resources against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocation"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_fafd70b1","line":13,"range":{"start_line":13,"start_character":53,"end_line":13,"end_character":54},"in_reply_to":"9f436f4f_52635c1b","updated":"2017-08-10 09:58:09.000000000","message":"Done","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"6b8963ec698ccce950752c3bf72cfa42583df2e9","unresolved":false,"context_lines":[{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has"},{"line_number":12,"context_line":"information to form a ``PUT /allocations/{consumer_uuid}`` request to claim"},{"line_number":13,"context_line":"resources against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocation"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information that a client can use to sort/weigh the"}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_126dd403","line":14,"range":{"start_line":14,"start_character":17,"end_line":14,"end_character":21},"updated":"2017-08-09 15:51:58.000000000","message":", see?","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"388f614ed9b02839593db7e6e86a9495a442bdec","unresolved":false,"context_lines":[{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has"},{"line_number":12,"context_line":"information to form a ``PUT /allocations/{consumer_uuid}`` request to claim"},{"line_number":13,"context_line":"resources against a related set of resource providers, additional parameters"},{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocation"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information that a client can use to sort/weigh the"}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_da2e2c42","line":14,"range":{"start_line":14,"start_character":17,"end_line":14,"end_character":21},"in_reply_to":"9f436f4f_126dd403","updated":"2017-08-10 09:58:09.000000000","message":"Done","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"6b8963ec698ccce950752c3bf72cfa42583df2e9","unresolved":false,"context_lines":[{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocation"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information that a client can use to sort/weigh the"},{"line_number":18,"context_line":"results of the call when making its destination host decisions."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":".. rest_method:: GET /allocation_candidates"},{"line_number":21,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_727d40b0","line":18,"range":{"start_line":17,"start_character":31,"end_line":18,"end_character":63},"updated":"2017-08-09 15:51:58.000000000","message":"Same as my comment in the parameters file - this is either too specific or we should maybe explain that one possible use is, for example, the nova-scheduler FilterScheduler using this to make decisions about where to build a server instance.","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"388f614ed9b02839593db7e6e86a9495a442bdec","unresolved":false,"context_lines":[{"line_number":14,"context_line":"might be required see `Update allocations`_. As several allocation"},{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information that a client can use to sort/weigh the"},{"line_number":18,"context_line":"results of the call when making its destination host decisions."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":".. rest_method:: GET /allocation_candidates"},{"line_number":21,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_7a1180ac","line":18,"range":{"start_line":17,"start_character":31,"end_line":18,"end_character":63},"in_reply_to":"9f436f4f_727d40b0","updated":"2017-08-10 09:58:09.000000000","message":"Done","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"6b8963ec698ccce950752c3bf72cfa42583df2e9","unresolved":false,"context_lines":[{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Normal Response Codes: 200"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Error response codes: badRequest(400)"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"Request"},{"line_number":27,"context_line":"-------"}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_92e424ae","line":24,"range":{"start_line":24,"start_character":0,"end_line":24,"end_character":37},"updated":"2017-08-09 15:51:58.000000000","message":"We seem to be inconsistent about this. For example, you can get a 400 from the GET /usages API but it wasn\u0027t documented in that patch, so I was guessing that 400 is assumed for anything that uses jsonschema validation.\n\nhttps://review.openstack.org/#/c/480563/12/placement-api-ref/source/usages.inc","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"388f614ed9b02839593db7e6e86a9495a442bdec","unresolved":false,"context_lines":[{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Normal Response Codes: 200"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"Error response codes: badRequest(400)"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"Request"},{"line_number":27,"context_line":"-------"}],"source_content_type":"text/x-c++src","patch_set":11,"id":"9f436f4f_3a1d380f","line":24,"range":{"start_line":24,"start_character":0,"end_line":24,"end_character":37},"in_reply_to":"9f436f4f_92e424ae","updated":"2017-08-10 09:58:09.000000000","message":"right, so leaving this for now.","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"2e3a6302cd5888865eb9928bcd2ad3bc2383f1e3","unresolved":false,"context_lines":[{"line_number":7,"context_line":"List allocation candidates"},{"line_number":8,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"Returns a dictionary representing a collection of allocation requests"},{"line_number":11,"context_line":"and resource provider summaries. Each allocation request has"},{"line_number":12,"context_line":"information to form a ``PUT /allocations/{consumer_uuid}`` request to claim"},{"line_number":13,"context_line":"resources against a related set of resource providers. Additional parameters"}],"source_content_type":"text/x-c++src","patch_set":12,"id":"9f436f4f_79be2d66","line":10,"updated":"2017-08-10 11:25:07.000000000","message":"Return maintains the active voice started with the section header, but Returns is fine too.","commit_id":"90cd00eeb8c0f3d55a65125ef13b306deecdcc4d"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"2e3a6302cd5888865eb9928bcd2ad3bc2383f1e3","unresolved":false,"context_lines":[{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information. For example, this information is used by"},{"line_number":18,"context_line":"nova-scheduler\u0027s FilterScheduler to make decisions about which compute host to"},{"line_number":19,"context_line":"build the server instance on."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":".. rest_method:: GET /allocation_candidates"},{"line_number":22,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":12,"id":"9f436f4f_79950de4","line":19,"updated":"2017-08-10 11:25:07.000000000","message":"to make decisions about on which compute host to build a server","commit_id":"90cd00eeb8c0f3d55a65125ef13b306deecdcc4d"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"9ec71983f4b24eaa8d5a107b4fb9abfc98330d55","unresolved":false,"context_lines":[{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information. For example, this information is used by"},{"line_number":18,"context_line":"nova-scheduler\u0027s FilterScheduler to make decisions about which compute host to"},{"line_number":19,"context_line":"build the server instance on."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":".. rest_method:: GET /allocation_candidates"},{"line_number":22,"context_line":""}],"source_content_type":"text/x-c++src","patch_set":12,"id":"9f436f4f_396d4504","line":19,"in_reply_to":"9f436f4f_79950de4","updated":"2017-08-10 11:26:58.000000000","message":"Done","commit_id":"90cd00eeb8c0f3d55a65125ef13b306deecdcc4d"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"29407355d6d1c6daa828b1ec857a84db50421ca5","unresolved":false,"context_lines":[{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information. For example, this information is used by"},{"line_number":18,"context_line":"nova-scheduler\u0027s FilterScheduler to make decisions about on which compute host"},{"line_number":19,"context_line":"to build a server."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":".. rest_method:: GET /allocation_candidates"}],"source_content_type":"text/x-c++src","patch_set":13,"id":"9f436f4f_b4434613","line":18,"range":{"start_line":18,"start_character":57,"end_line":18,"end_character":65},"updated":"2017-08-11 21:07:27.000000000","message":"excellent avoidance of ending with a preposition","commit_id":"d0af9820e1aa365dfd61535036ee119742737aa7"},{"author":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"change_message_id":"c3c35d4e470b97f24ab55b2db8ff486fcd7405a6","unresolved":false,"context_lines":[{"line_number":15,"context_line":"requests are available it\u0027s necessary to select one. To make a"},{"line_number":16,"context_line":"decision, resource provider summaries are provided with the"},{"line_number":17,"context_line":"inventory/capacity information. For example, this information is used by"},{"line_number":18,"context_line":"nova-scheduler\u0027s FilterScheduler to make decisions about on which compute host"},{"line_number":19,"context_line":"to build a server."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":".. rest_method:: GET /allocation_candidates"}],"source_content_type":"text/x-c++src","patch_set":13,"id":"9f436f4f_74939e5c","line":18,"range":{"start_line":18,"start_character":57,"end_line":18,"end_character":65},"in_reply_to":"9f436f4f_b4434613","updated":"2017-08-11 21:18:38.000000000","message":"+1","commit_id":"d0af9820e1aa365dfd61535036ee119742737aa7"}],"placement-api-ref/source/parameters.yaml":[{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"1fd9e57c4b1dace8401bbf1d97788d808b2fda10","unresolved":false,"context_lines":[{"line_number":110,"context_line":"  \u003c\u003c: *allocation_ratio"},{"line_number":111,"context_line":"  required: false"},{"line_number":112,"context_line":"allocation_requests:"},{"line_number":113,"context_line":"  type: object"},{"line_number":114,"context_line":"  in: body"},{"line_number":115,"context_line":"  required: true"},{"line_number":116,"context_line":"  description: \u003e"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"3f1d235d_d18f9872","line":113,"range":{"start_line":113,"start_character":8,"end_line":113,"end_character":14},"updated":"2017-07-07 06:29:59.000000000","message":"It is an \u0027array\u0027 in the example file.","commit_id":"a1aaa9c4efdc630d8e242e6ef8fb9724225f8527"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"4e5c19916914b0e89cad532caaf07a663f5db854","unresolved":false,"context_lines":[{"line_number":118,"context_line":"  required: true"},{"line_number":119,"context_line":"  description: \u003e"},{"line_number":120,"context_line":"    A list of objects that contain a"},{"line_number":121,"context_line":"    serialized HTTP body that the scheduler may subsequently use in a call"},{"line_number":122,"context_line":"    to PUT /allocations/{consumer_uuid} to claim resources against a"},{"line_number":123,"context_line":"    related set of resource providers."},{"line_number":124,"context_line":"allocations_array:"}],"source_content_type":"text/x-yaml","patch_set":5,"id":"3f1d235d_a8c33157","line":121,"updated":"2017-07-11 11:17:40.000000000","message":"s/the scheduler/a client/","commit_id":"cc6c60d0c003a9df6ab4d4022d4bcb91bd55dd62"},{"author":{"_account_id":21813,"name":"Andrey Volkov","email":"m@amadev.ru","username":"avolkov"},"change_message_id":"915438983854dcb3f876b96d13d29028bdc63369","unresolved":false,"context_lines":[{"line_number":118,"context_line":"  required: true"},{"line_number":119,"context_line":"  description: \u003e"},{"line_number":120,"context_line":"    A list of objects that contain a"},{"line_number":121,"context_line":"    serialized HTTP body that the scheduler may subsequently use in a call"},{"line_number":122,"context_line":"    to PUT /allocations/{consumer_uuid} to claim resources against a"},{"line_number":123,"context_line":"    related set of resource providers."},{"line_number":124,"context_line":"allocations_array:"}],"source_content_type":"text/x-yaml","patch_set":5,"id":"1f1a1f67_b57cf3b5","line":121,"in_reply_to":"3f1d235d_a8c33157","updated":"2017-07-12 13:11:19.000000000","message":"Done","commit_id":"cc6c60d0c003a9df6ab4d4022d4bcb91bd55dd62"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"e8e23364ac925b0812ec7be564d9bc9c14c0d922","unresolved":false,"context_lines":[{"line_number":175,"context_line":"  description: \u003e"},{"line_number":176,"context_line":"    A dictionary keyed by resource provider UUID,"},{"line_number":177,"context_line":"    of dictionaries of inventory/capacity information that a client"},{"line_number":178,"context_line":"    can use to sort/weigh the results of the call when making its"},{"line_number":179,"context_line":"    destination host decisions."},{"line_number":180,"context_line":"reserved: \u0026reserved"},{"line_number":181,"context_line":"  type: integer"},{"line_number":182,"context_line":"  in: body"}],"source_content_type":"text/x-yaml","patch_set":11,"id":"9f436f4f_b2696826","line":179,"range":{"start_line":178,"start_character":50,"end_line":179,"end_character":31},"updated":"2017-08-09 15:43:41.000000000","message":"Isn\u0027t this still a tad too close to the nova-scheduler scenario. Maybe this should just be generic and say:\n\n\"A dictionary keyed by resource provider UUID, of dictionaries of inventory/capacity information.\"","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"388f614ed9b02839593db7e6e86a9495a442bdec","unresolved":false,"context_lines":[{"line_number":175,"context_line":"  description: \u003e"},{"line_number":176,"context_line":"    A dictionary keyed by resource provider UUID,"},{"line_number":177,"context_line":"    of dictionaries of inventory/capacity information that a client"},{"line_number":178,"context_line":"    can use to sort/weigh the results of the call when making its"},{"line_number":179,"context_line":"    destination host decisions."},{"line_number":180,"context_line":"reserved: \u0026reserved"},{"line_number":181,"context_line":"  type: integer"},{"line_number":182,"context_line":"  in: body"}],"source_content_type":"text/x-yaml","patch_set":11,"id":"9f436f4f_7ab980e7","line":179,"range":{"start_line":178,"start_character":50,"end_line":179,"end_character":31},"in_reply_to":"9f436f4f_b2696826","updated":"2017-08-10 09:58:09.000000000","message":"Done","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"6b8963ec698ccce950752c3bf72cfa42583df2e9","unresolved":false,"context_lines":[{"line_number":234,"context_line":"  in: body"},{"line_number":235,"context_line":"  required: true"},{"line_number":236,"context_line":"  description: \u003e"},{"line_number":237,"context_line":"    A dictionary contains uuid of the resource provider."},{"line_number":238,"context_line":"resource_provider_usages:"},{"line_number":239,"context_line":"  type: object"},{"line_number":240,"context_line":"  in: body"}],"source_content_type":"text/x-yaml","patch_set":11,"id":"9f436f4f_f2a3704e","line":237,"range":{"start_line":237,"start_character":17,"end_line":237,"end_character":30},"updated":"2017-08-09 15:51:58.000000000","message":"which contains the uuid?","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"},{"author":{"_account_id":12356,"name":"Vladyslav Drok","email":"vdrok@mirantis.com","username":"vdrok"},"change_message_id":"388f614ed9b02839593db7e6e86a9495a442bdec","unresolved":false,"context_lines":[{"line_number":234,"context_line":"  in: body"},{"line_number":235,"context_line":"  required: true"},{"line_number":236,"context_line":"  description: \u003e"},{"line_number":237,"context_line":"    A dictionary contains uuid of the resource provider."},{"line_number":238,"context_line":"resource_provider_usages:"},{"line_number":239,"context_line":"  type: object"},{"line_number":240,"context_line":"  in: body"}],"source_content_type":"text/x-yaml","patch_set":11,"id":"9f436f4f_7aae2099","line":237,"range":{"start_line":237,"start_character":17,"end_line":237,"end_character":30},"in_reply_to":"9f436f4f_f2a3704e","updated":"2017-08-10 09:58:09.000000000","message":"Done","commit_id":"11dd09bf8937fa71ff37536ebd8cea037c1934e5"}]}