)]}'
{"id":"openstack%2Fplacement~669955","triplet_id":"openstack%2Fplacement~master~I42e76785e0fe456b107fe843dbb242f2c5f5b9f7","project":"openstack/placement","branch":"master","topic":"story/2006180","hashtags":[],"change_id":"I42e76785e0fe456b107fe843dbb242f2c5f5b9f7","subject":"api-ref: Document generations","status":"MERGED","created":"2019-07-09 22:15:22.000000000","updated":"2019-07-12 17:25:57.000000000","submitted":"2019-07-12 17:25:57.000000000","submitter":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"total_comment_count":24,"unresolved_comment_count":0,"has_review_started":true,"submission_id":"669955-1562952357802-a65eadfb","meta_rev_id":"7dfcdec997c43247d76f58eaaaaeb8db8d8051a8","_number":669955,"virtual_id_number":669955,"owner":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"actions":{},"labels":{"Verified":{"approved":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"all":[{"value":0,"date":"2019-07-12 16:15:08.000000000","_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},{"value":0,"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},{"value":0,"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},{"value":2,"date":"2019-07-12 17:25:57.000000000","permitted_voting_range":{"min":2,"max":2},"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},{"value":0,"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},{"value":0,"_account_id":28543,"name":"shupeng","email":"15050873171@163.com","username":"Vieri"}],"values":{"-2":"Fails","-1":"Doesn\u0027t seem to work"," 0":"No score","+1":"Works for me","+2":"Verified"},"description":"","default_value":0,"optional":true},"Code-Review":{"approved":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"recommended":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"all":[{"value":0,"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},{"value":1,"date":"2019-07-12 14:18:06.000000000","permitted_voting_range":{"min":1,"max":2},"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},{"value":2,"date":"2019-07-12 15:19:27.000000000","_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},{"value":0,"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},{"value":2,"date":"2019-07-11 21:42:25.000000000","permitted_voting_range":{"min":2,"max":2},"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},{"value":1,"date":"2019-07-12 07:25:04.000000000","permitted_voting_range":{"min":1,"max":1},"_account_id":28543,"name":"shupeng","email":"15050873171@163.com","username":"Vieri"}],"values":{"-2":"Do not merge","-1":"This patch needs further work before it can be merged"," 0":"No score","+1":"Looks good to me, but someone else must approve","+2":"Looks good to me (core reviewer)"},"description":"","value":1,"default_value":0,"optional":true},"Workflow":{"approved":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"all":[{"value":0,"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},{"value":0,"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},{"value":1,"date":"2019-07-12 15:19:27.000000000","_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},{"value":0,"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},{"value":0,"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},{"value":0,"_account_id":28543,"name":"shupeng","email":"15050873171@163.com","username":"Vieri"}],"values":{"-1":"Work in progress"," 0":"Ready for reviews","+1":"Approved"},"description":"","default_value":0,"optional":true},"Review-Priority":{"all":[{"value":0,"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},{"value":0,"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},{"value":0,"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},{"value":0,"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},{"value":0,"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},{"value":0,"_account_id":28543,"name":"shupeng","email":"15050873171@163.com","username":"Vieri"}],"values":{" 0":"Default Priority","+1":"Contributor Review Promise","+2":"Core Review Promise"},"description":"","default_value":0,"optional":true}},"removable_reviewers":[],"reviewers":{"REVIEWER":[{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},{"_account_id":28543,"name":"shupeng","email":"15050873171@163.com","username":"Vieri"}]},"pending_reviewers":{},"reviewer_updates":[{"updated":"2019-07-11 21:42:25.000000000","updated_by":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"reviewer":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"state":"REVIEWER"},{"updated":"2019-07-12 07:25:04.000000000","updated_by":{"_account_id":28543,"name":"shupeng","email":"15050873171@163.com","username":"Vieri"},"reviewer":{"_account_id":28543,"name":"shupeng","email":"15050873171@163.com","username":"Vieri"},"state":"REVIEWER"},{"updated":"2019-07-12 14:18:06.000000000","updated_by":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"reviewer":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"state":"REVIEWER"},{"updated":"2019-07-12 15:19:27.000000000","updated_by":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"reviewer":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"state":"REVIEWER"},{"updated":"2019-07-12 17:25:57.000000000","updated_by":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"reviewer":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"state":"REVIEWER"}],"messages":[{"id":"a11cd510351cdea02ee62f9a52df91bfeec9072d","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-09 22:15:22.000000000","message":"Uploaded patch set 1.","accounts_in_message":[],"_revision_number":1},{"id":"4fcad7695f83c10c0455351cee78c38bc8746389","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-09 22:17:28.000000000","message":"Patch Set 1:\n\n(1 comment)","accounts_in_message":[],"_revision_number":1},{"id":"38ab0272a7564e5cf46d8cba4cd4cba3c558e17a","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2019-07-09 22:26:18.000000000","message":"Patch Set 1: Verified+1\n\nBuild succeeded (check pipeline).\n\n- build-openstack-api-ref http://logs.openstack.org/55/669955/1/check/build-openstack-api-ref/75638fc/html/ : SUCCESS in 4m 26s\n- openstack-tox-docs http://logs.openstack.org/55/669955/1/check/openstack-tox-docs/6b873a3/html/ : SUCCESS in 3m 50s\n- openstack-tox-pep8 http://logs.openstack.org/55/669955/1/check/openstack-tox-pep8/cb05633/ : SUCCESS in 4m 25s","accounts_in_message":[],"_revision_number":1},{"id":"529320f8ea8ffd70432bac7e76ec5356dc7616ca","author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"date":"2019-07-10 00:54:06.000000000","message":"Patch Set 1:\n\n(2 comments)","accounts_in_message":[],"_revision_number":1},{"id":"197eb23fb7573ca8452f27955ac0bc6bf31c31c1","author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"date":"2019-07-10 07:31:37.000000000","message":"Patch Set 1: Code-Review-1\n\n(3 comments)\n\nSuggested clarification within.\n\nBTW, these sorts of things I often hope will get fixed by people other than cores. Part of the reason for my generally sloppy reviews is to make sure there is sufficient flakiness for there to be noticeable problems in docs and functionality that users have to come back and participate. If we send it out perfect we make the boundary impermeable.\n\nI recognise that this is impractical, idealistic, and probably heretical (to some), and I\u0027m not actually suggesting we not fix bugs, but rather that we keep in our minds that we\u0027d like (and need) other people to fix bugs and we need to make space for that so we need to adjust our mindset somewhat.\n\nSo, in this particular case that could have meant that the story associated with this commit could have languished for more than a couple days and that would have been okay.\n\n(Again fully recognising that I\u0027m being overly idealistic and idealogical in an environment that might not be able to be that way...)","accounts_in_message":[],"_revision_number":1},{"id":"20b78b9322c96d53d4c1776cf552bfe08a0f0957","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-10 22:28:01.000000000","message":"Patch Set 1:\n\n(1 comment)\n\nThese were already more detailed than any of the other descriptions of error codes in the reference, and I really didn\u0027t want to go into a lot of detail (and later repeat that detail elsewhere).\n\nSo I made a section in the front matter describing generations, and linked to it from these two affected bits while keeping their text relatively terse.\n\nSee if you like.\n\n\u003e So, in this particular case that could have meant that the story associated with this commit could have languished for more than a couple days and that would have been okay.\n\n...if they ever got picked up. Maybe my workflow needs fixing, but if I don\u0027t hit something like this pretty much as soon as I see it, I never will. And it sounds like you\u0027re saying maybe I shouldn\u0027t. Maybe random non-core contributors will come along looking for things like this. For good or ill, I have lower expectations.","accounts_in_message":[],"_revision_number":1},{"id":"a8f7983ae14104eecd2d589335d67c8826b92876","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-10 22:32:37.000000000","message":"Uploaded patch set 2.","accounts_in_message":[],"_revision_number":2},{"id":"5a3fc5d16d1dc594808aec752456670c3208403a","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-10 22:33:49.000000000","message":"Patch Set 2:\n\n(1 comment)","accounts_in_message":[],"_revision_number":2},{"id":"13ef9b45f8cd8776f782ee3f359c186fcd99140e","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2019-07-11 00:57:47.000000000","message":"Patch Set 2: Verified+1\n\nBuild succeeded (check pipeline).\n\n- build-openstack-api-ref http://logs.openstack.org/55/669955/2/check/build-openstack-api-ref/09151b0/html/ : SUCCESS in 4m 55s\n- openstack-tox-docs http://logs.openstack.org/55/669955/2/check/openstack-tox-docs/8f982ea/html/ : SUCCESS in 4m 19s\n- openstack-tox-pep8 http://logs.openstack.org/55/669955/2/check/openstack-tox-pep8/81b4551/ : SUCCESS in 4m 24s","accounts_in_message":[],"_revision_number":2},{"id":"768ead1809fd2a07597afe03e0e12c41319bad06","author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"date":"2019-07-11 09:00:21.000000000","message":"Patch Set 2:\n\n\u003e ...if they ever got picked up. Maybe my workflow needs fixing, but\n \u003e if I don\u0027t hit something like this pretty much as soon as I see it,\n \u003e I never will. And it sounds like you\u0027re saying maybe I shouldn\u0027t.\n \u003e Maybe random non-core contributors will come along looking for\n \u003e things like this. For good or ill, I have lower expectations.\n\nI too have low expectations, but I also have high hopes for things to be different. The issue at play here is that if nobody downstream notices these gaps, then there is no reason to be filling them (they don\u0027t care and we shouldn\u0027t be busting our backs trying to make something for them to make a few $billion off), and it is only by way of the gaps that we have some metric for what people care about and if they care at all. If we fill them too quickly, we lose the metric.\n\nI\u0027m not trying to discourage you from making these fixes. Please do. I understand that you are very stack-based in your workflow. This isn\u0027t about any specific fix or change, but the overall picture.","accounts_in_message":[],"_revision_number":2},{"id":"e2fa9ae0919a88b20012968c44876ac466fd46e2","author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"date":"2019-07-11 09:11:05.000000000","message":"Patch Set 2: Code-Review-1\n\n(5 comments)\n\nThis is mostly good, but some suggestions with to make things more clear/accurate","accounts_in_message":[],"_revision_number":2},{"id":"869504a51535f78b90a05b0decf3358bb2d09eec","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-11 17:33:01.000000000","message":"Patch Set 2:\n\n(3 comments)\n\nThis is becoming quite the ideological patch.","accounts_in_message":[],"_revision_number":2},{"id":"07ba6d256d4db6927a038967c37a6a650a686795","author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"date":"2019-07-11 18:55:49.000000000","message":"Patch Set 2: -Code-Review\n\n(2 comments)\n\n\u003e This is becoming quite the ideological patch.\n\ndood, it\u0027s what we do\n\nAnd, I think it is pretty important: Ideology begets culture.\n\nI\u0027d still prefer resource or entity over object, but I won\u0027t die on a hill for it.","accounts_in_message":[],"_revision_number":2},{"id":"4532f3ccfebb2bdd4fb4f07ff51e9a7a5097c8cb","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-11 21:35:49.000000000","message":"Patch Set 2:\n\n(2 comments)","accounts_in_message":[],"_revision_number":2},{"id":"25e98a565f719a48e003cb6961cd8698be7e1628","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-11 21:35:54.000000000","message":"Uploaded patch set 3.","accounts_in_message":[],"_revision_number":3},{"id":"6be277be8c37de9ff8eb628c6df669e9efa84aee","author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"date":"2019-07-11 21:42:25.000000000","message":"Patch Set 3: Code-Review+2\n\nwfm, thanks for riding it out","accounts_in_message":[],"_revision_number":3},{"id":"f8fcc8c2a3f523cdc155c56eef02653bb0ad6ff6","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2019-07-11 22:28:47.000000000","message":"Patch Set 3: Verified+1\n\nBuild succeeded (check pipeline).\n\n- build-openstack-api-ref http://logs.openstack.org/55/669955/3/check/build-openstack-api-ref/c438595/html/ : SUCCESS in 3m 56s\n- openstack-tox-docs http://logs.openstack.org/55/669955/3/check/openstack-tox-docs/0f41487/html/ : SUCCESS in 4m 22s\n- openstack-tox-pep8 http://logs.openstack.org/55/669955/3/check/openstack-tox-pep8/12df9a7/ : SUCCESS in 4m 14s","accounts_in_message":[],"_revision_number":3},{"id":"74609b6bf0e4c4e2fe13cf136613d1273306985f","author":{"_account_id":28543,"name":"shupeng","email":"15050873171@163.com","username":"Vieri"},"date":"2019-07-12 07:25:04.000000000","message":"Patch Set 3: Code-Review+1","accounts_in_message":[],"_revision_number":3},{"id":"13e5ded5576293909e9280dcf1216744f1208cb7","author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"date":"2019-07-12 14:18:06.000000000","message":"Patch Set 3: Code-Review+1\n\n(2 comments)\n\nI won\u0027t +2 this because I think someone with more know-how than I, but this matches what _I_ know about generations","accounts_in_message":[],"_revision_number":3},{"id":"8e38b92c7e1b2f91146a40a5d3a37bca4d8d157c","author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"date":"2019-07-12 15:19:27.000000000","message":"Patch Set 3: Code-Review+2 Workflow+1\n\nLooks OK to me. Above and beyond what I expected.","accounts_in_message":[],"_revision_number":3},{"id":"9f3ac97354f59758cd81396419977a02dc21179b","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2019-07-12 15:20:24.000000000","message":"Patch Set 3: -Verified\n\nStarting gate jobs.","accounts_in_message":[],"_revision_number":3},{"id":"9573b4efa4b880ca6ce026f0f88bcbf946946862","author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"date":"2019-07-12 16:15:08.000000000","message":"Patch Set 3:\n\n(2 comments)","accounts_in_message":[],"_revision_number":3},{"id":"c878462b0e2ae0c369ff5cc2156b8bf1c71358d1","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2019-07-12 17:25:57.000000000","message":"Change has been successfully merged by Zuul","accounts_in_message":[],"_revision_number":3},{"id":"a2d34e993bfd4914abf5cebd39c649d8dbecaaa7","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2019-07-12 17:25:57.000000000","message":"Patch Set 3: Verified+2\n\nBuild succeeded (gate pipeline).\n\n- build-openstack-api-ref http://logs.openstack.org/55/669955/3/gate/build-openstack-api-ref/434e68f/html/ : SUCCESS in 6m 20s\n- openstack-tox-docs http://logs.openstack.org/55/669955/3/gate/openstack-tox-docs/01fa8e1/html/ : SUCCESS in 5m 57s\n- openstack-tox-pep8 http://logs.openstack.org/55/669955/3/gate/openstack-tox-pep8/784d5e1/ : SUCCESS in 5m 08s","accounts_in_message":[],"_revision_number":3}],"current_revision_number":3,"current_revision":"a09defd661bb3ae57ef92bd49989c45c12b7aabd","revisions":{"2b3009f496c67297029717388e150b999f527021":{"kind":"REWORK","_number":1,"created":"2019-07-09 22:15:22.000000000","uploader":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"ref":"refs/changes/55/669955/1","fetch":{"anonymous http":{"url":"https://review.opendev.org/openstack/placement","ref":"refs/changes/55/669955/1","commands":{"Checkout":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/1 \u0026\u0026 git checkout FETCH_HEAD","Cherry Pick":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/1 \u0026\u0026 git cherry-pick FETCH_HEAD","Format Patch":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/1 \u0026\u0026 git format-patch -1 --stdout FETCH_HEAD","Pull":"git pull https://review.opendev.org/openstack/placement refs/changes/55/669955/1"}}},"commit":{"parents":[{"commit":"23300f2813e4ae02c566122896b05e883c3ec1c3","subject":"Trivial: Fix docs for functions","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/23300f2813e4ae02c566122896b05e883c3ec1c3"}]}],"author":{"name":"Eric Fried","email":"openstack@fried.cc","date":"2019-07-09 22:10:59.000000000","tz":-300},"committer":{"name":"Eric Fried","email":"openstack@fried.cc","date":"2019-07-09 22:10:59.000000000","tz":-300},"subject":"api-ref: Add consumer 409 in PUT/POST allocs","message":"api-ref: Add consumer 409 in PUT/POST allocs\n\nThe API reference for POST /allocations [1] and PUT\n/allocations/{consumer_uuid} [2] specifically mentions that you can get\na 409 on provider/inventory conflict. In microversion 1.28, it also\nbecame possible to get a 409 on an allocation (consumer generation)\nconflict, so this commit adds that information.\n\n[1] https://developer.openstack.org/api-ref/placement/?expanded\u003dmanage-allocations-detail#manage-allocations\n[2] https://developer.openstack.org/api-ref/placement/?expanded\u003dupdate-allocations-detail#update-allocations\n\nChange-Id: I42e76785e0fe456b107fe843dbb242f2c5f5b9f7\nStory: #2006180\nTask: #35705\n","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/2b3009f496c67297029717388e150b999f527021"}],"resolve_conflicts_web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/2b3009f496c67297029717388e150b999f527021"}]},"branch":"refs/heads/master"},"aef290c56a0e66dd62a483a424b2912fc2e05421":{"kind":"REWORK","_number":2,"created":"2019-07-10 22:32:37.000000000","uploader":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"ref":"refs/changes/55/669955/2","fetch":{"anonymous http":{"url":"https://review.opendev.org/openstack/placement","ref":"refs/changes/55/669955/2","commands":{"Checkout":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/2 \u0026\u0026 git checkout FETCH_HEAD","Cherry Pick":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/2 \u0026\u0026 git cherry-pick FETCH_HEAD","Format Patch":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/2 \u0026\u0026 git format-patch -1 --stdout FETCH_HEAD","Pull":"git pull https://review.opendev.org/openstack/placement refs/changes/55/669955/2"}}},"commit":{"parents":[{"commit":"23300f2813e4ae02c566122896b05e883c3ec1c3","subject":"Trivial: Fix docs for functions","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/23300f2813e4ae02c566122896b05e883c3ec1c3"}]}],"author":{"name":"Eric Fried","email":"openstack@fried.cc","date":"2019-07-09 22:10:59.000000000","tz":-300},"committer":{"name":"Eric Fried","email":"openstack@fried.cc","date":"2019-07-10 22:28:09.000000000","tz":-300},"subject":"api-ref: Document generations","message":"api-ref: Document generations\n\nThe API reference for POST /allocations [1] and PUT\n/allocations/{consumer_uuid} [2] specifically mentions that you can get\na 409 on provider/inventory conflict. In microversion 1.28, it also\nbecame possible to get a 409 on an allocation (consumer generation)\nconflict.\n\nIn the process of adding that information, it became evident that we\nweren\u0027t doing a good job explaining the whole generation thing in\ngeneral, so this commit also adds a descriptive section to the front\nmatter of the API reference.\n\nLinks are included from the updated descriptions for the two affected\nallocations operations. Future commits can add links from other\nappropriate sections of the reference (e.g. the parameters.yaml entries\nfor resource provider and consumer generation fields). Future commits\ncould also enhance the descriptions of error codes for other operations\nto (at least) the level of detail at which these have ended up.\n\n[1] https://developer.openstack.org/api-ref/placement/?expanded\u003dmanage-allocations-detail#manage-allocations\n[2] https://developer.openstack.org/api-ref/placement/?expanded\u003dupdate-allocations-detail#update-allocations\n\nChange-Id: I42e76785e0fe456b107fe843dbb242f2c5f5b9f7\nStory: #2006180\nTask: #35705\n","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/aef290c56a0e66dd62a483a424b2912fc2e05421"}],"resolve_conflicts_web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/aef290c56a0e66dd62a483a424b2912fc2e05421"}]},"branch":"refs/heads/master"},"a09defd661bb3ae57ef92bd49989c45c12b7aabd":{"kind":"REWORK","_number":3,"created":"2019-07-11 21:35:54.000000000","uploader":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"ref":"refs/changes/55/669955/3","fetch":{"anonymous http":{"url":"https://review.opendev.org/openstack/placement","ref":"refs/changes/55/669955/3","commands":{"Checkout":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/3 \u0026\u0026 git checkout FETCH_HEAD","Cherry Pick":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/3 \u0026\u0026 git cherry-pick FETCH_HEAD","Format Patch":"git fetch https://review.opendev.org/openstack/placement refs/changes/55/669955/3 \u0026\u0026 git format-patch -1 --stdout FETCH_HEAD","Pull":"git pull https://review.opendev.org/openstack/placement refs/changes/55/669955/3"}}},"commit":{"parents":[{"commit":"23300f2813e4ae02c566122896b05e883c3ec1c3","subject":"Trivial: Fix docs for functions","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/23300f2813e4ae02c566122896b05e883c3ec1c3"}]}],"author":{"name":"Eric Fried","email":"openstack@fried.cc","date":"2019-07-09 22:10:59.000000000","tz":-300},"committer":{"name":"Eric Fried","email":"openstack@fried.cc","date":"2019-07-11 21:31:28.000000000","tz":-300},"subject":"api-ref: Document generations","message":"api-ref: Document generations\n\nThe API reference for POST /allocations [1] and PUT\n/allocations/{consumer_uuid} [2] specifically mentions that you can get\na 409 on provider/inventory conflict. In microversion 1.28, it also\nbecame possible to get a 409 on an allocation (consumer generation)\nconflict.\n\nIn the process of adding that information, it became evident that we\nweren\u0027t doing a good job explaining the whole generation thing in\ngeneral, so this commit also adds a descriptive section to the front\nmatter of the API reference.\n\nLinks are included from the updated descriptions for the two affected\nallocations operations. Future commits can add links from other\nappropriate sections of the reference (e.g. the parameters.yaml entries\nfor resource provider and consumer generation fields). Future commits\ncould also enhance the descriptions of error codes for other operations\nto (at least) the level of detail at which these have ended up.\n\n[1] https://developer.openstack.org/api-ref/placement/?expanded\u003dmanage-allocations-detail#manage-allocations\n[2] https://developer.openstack.org/api-ref/placement/?expanded\u003dupdate-allocations-detail#update-allocations\n\nChange-Id: I42e76785e0fe456b107fe843dbb242f2c5f5b9f7\nStory: #2006180\nTask: #35705\n","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/a09defd661bb3ae57ef92bd49989c45c12b7aabd"}],"resolve_conflicts_web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/placement/commit/a09defd661bb3ae57ef92bd49989c45c12b7aabd"}]},"branch":"refs/heads/master"}},"requirements":[],"submit_records":[],"submit_requirements":[]}