)]}'
{"id":"openstack%2Fnova~765871","triplet_id":"openstack%2Fnova~master~Ic55669f5210b57f151f693393f205655765a8dc9","project":"openstack/nova","branch":"master","topic":"enhance-simple-usage-api-doc","hashtags":[],"change_id":"Ic55669f5210b57f151f693393f205655765a8dc9","subject":"Enhance simple usage API documentation","status":"MERGED","created":"2020-12-07 20:30:41.000000000","updated":"2020-12-08 21:22:29.000000000","submitted":"2020-12-08 21:20:07.000000000","submitter":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"total_comment_count":5,"unresolved_comment_count":4,"has_review_started":true,"submission_id":"765871-enhance-simple-usage-api-doc","meta_rev_id":"1d61c49028245efd2e3da115be68c99b1a63dbc0","_number":765871,"virtual_id_number":765871,"owner":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"actions":{},"labels":{"Verified":{"approved":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"all":[{"value":0,"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},{"value":0,"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},{"value":0,"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},{"tag":"autogenerated:zuul:gate","value":2,"date":"2020-12-08 21:20:03.000000000","permitted_voting_range":{"min":2,"max":2},"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]}],"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":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"all":[{"value":2,"date":"2020-12-08 21:05:56.000000000","permitted_voting_range":{"min":2,"max":2},"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},{"value":1,"date":"2020-12-08 12:42:25.000000000","permitted_voting_range":{"min":1,"max":2},"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},{"value":2,"date":"2020-12-08 12:25:30.000000000","permitted_voting_range":{"min":2,"max":2},"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},{"value":0,"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]}],"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":"","default_value":0,"optional":true},"Workflow":{"approved":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"all":[{"value":1,"date":"2020-12-08 21:05:56.000000000","permitted_voting_range":{"min":1,"max":1},"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},{"value":0,"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},{"value":0,"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},{"value":0,"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]}],"values":{"-1":"Work in progress"," 0":"Ready for reviews","+1":"Approved"},"description":"","default_value":0,"optional":true},"Review-Priority":{"all":[{"value":0,"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},{"value":0,"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},{"value":0,"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},{"value":0,"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]}],"values":{" 0":"Default Priority","+1":"Contributor Review Promise","+2":"Core Review Promise"},"description":"","default_value":0,"optional":true}},"removable_reviewers":[],"reviewers":{"REVIEWER":[{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]}],"CC":[{"_account_id":15941,"name":"DellEMC PowerFlex CI","email":"emc.scaleio.ci@emc.com","username":"emc-scaleio-ci","tags":["SERVICE_USER"]},{"_account_id":26515,"name":"Cloudbase Nova Hyper-V CI","email":"nova_hyperv_ci@cloudbasesolutions.com","username":"nova_hyperv_ci"}]},"pending_reviewers":{},"reviewer_updates":[{"updated":"2020-12-07 20:47:12.000000000","updated_by":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"reviewer":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"state":"REVIEWER"},{"updated":"2020-12-07 20:47:12.000000000","updated_by":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"reviewer":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"state":"REVIEWER"},{"updated":"2020-12-07 20:47:12.000000000","updated_by":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"reviewer":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"state":"REVIEWER"},{"updated":"2020-12-07 21:08:55.000000000","updated_by":{"_account_id":26515,"name":"Cloudbase Nova Hyper-V CI","email":"nova_hyperv_ci@cloudbasesolutions.com","username":"nova_hyperv_ci"},"reviewer":{"_account_id":26515,"name":"Cloudbase Nova Hyper-V CI","email":"nova_hyperv_ci@cloudbasesolutions.com","username":"nova_hyperv_ci"},"state":"CC"},{"updated":"2020-12-07 21:41:08.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"},{"updated":"2020-12-07 21:41:38.000000000","updated_by":{"_account_id":15941,"name":"DellEMC PowerFlex CI","email":"emc.scaleio.ci@emc.com","username":"emc-scaleio-ci","tags":["SERVICE_USER"]},"reviewer":{"_account_id":15941,"name":"DellEMC PowerFlex CI","email":"emc.scaleio.ci@emc.com","username":"emc-scaleio-ci","tags":["SERVICE_USER"]},"state":"CC"}],"messages":[{"id":"f06023d10e79426aa0e46716b48d77eed3bf39e1","tag":"autogenerated:gerrit:newPatchSet","author":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"date":"2020-12-07 20:30:41.000000000","message":"Uploaded patch set 1.","accounts_in_message":[],"_revision_number":1},{"id":"780a21a53243e63b5345983ae451b33422a3a7a0","tag":"autogenerated:gerrit:newPatchSet","author":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"date":"2020-12-07 20:34:42.000000000","message":"Uploaded patch set 2: Commit message was updated.","accounts_in_message":[],"_revision_number":2},{"id":"4ab261ad923b87f17866e22ba78ddd806f21fc2f","tag":"autogenerated:gerrit:newPatchSet","author":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"date":"2020-12-07 20:36:15.000000000","message":"Uploaded patch set 3: Commit message was updated.","accounts_in_message":[],"_revision_number":3},{"id":"c47c903474f03a7d39724f04c28fb98b17eeeb8e","tag":"autogenerated:gerrit:newPatchSet","author":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"date":"2020-12-07 20:39:10.000000000","message":"Uploaded patch set 4: Commit message was updated.","accounts_in_message":[],"_revision_number":4},{"id":"807e3febdfa3bb396f5dc58f3322dfa0605fc00d","author":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"date":"2020-12-07 20:47:12.000000000","message":"Patch Set 4: Code-Review+1\n\nLooks good to me, adding gibi and sean-k-mooney as they have context from the nova meeting.","accounts_in_message":[],"_revision_number":4},{"id":"88d458074827612ef6055aaca685968f28c19893","author":{"_account_id":26515,"name":"Cloudbase Nova Hyper-V CI","email":"nova_hyperv_ci@cloudbasesolutions.com","username":"nova_hyperv_ci"},"date":"2020-12-07 21:08:55.000000000","message":"Patch Set 4:\n\nFor rechecking only on the Cloudbase Nova Hyper-V CI, add a review comment with run-Cloudbase Nova Hyper-V CI\n\n- nova http://cloudbase-ci.com/nova/765871/4 : FAILURE in 28m 36s","accounts_in_message":[],"_revision_number":4},{"id":"67c6d6334782ddabf2e852db95f57d5ed8666ecc","tag":"autogenerated:zuul:check","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2020-12-07 21:41:08.000000000","message":"Patch Set 4: Verified+1\n\nBuild succeeded (check pipeline).\n\n- build-openstack-api-ref https://zuul.opendev.org/t/openstack/build/5cddb80ed56740848d920edca5c6faf2 : SUCCESS in 6m 27s\n- openstack-tox-pep8 https://zuul.opendev.org/t/openstack/build/f2543311939246759fe89c21b754769a : SUCCESS in 9m 45s\n- openstack-tox-docs https://zuul.opendev.org/t/openstack/build/5a0167804c4d44929d9e1fa512a41bff : SUCCESS in 11m 00s","accounts_in_message":[],"_revision_number":4},{"id":"ccd7ec64bda1c6571cef6e285b557103d4fefa2f","author":{"_account_id":15941,"name":"DellEMC PowerFlex CI","email":"emc.scaleio.ci@emc.com","username":"emc-scaleio-ci","tags":["SERVICE_USER"]},"date":"2020-12-07 21:41:38.000000000","message":"Patch Set 4:\n\nBuild failed.  For information on how to proceed, see https://docs.openstack.org/infra/manual/developers.html\n\n- EMC_PowerFlex_NOVA http://publiclogs.emc.com/71/765871/4/check/EMC_PowerFlex_NOVA/d70d138/EMC_PowerFlex_NOVA/None : NOT_REGISTERED\n\nLeave a comment with \u0027run-DellEMC PowerFlex CI\u0027 to trigger a recheck. For more information about CI, please see https://wiki.openstack.org/wiki/ThirdPartySystems/DellEMC_PowerFlex_CI","accounts_in_message":[],"_revision_number":4},{"id":"b0743ac027782c85a29ac245a817f30cddbb9d81","author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"date":"2020-12-08 12:25:30.000000000","message":"Patch Set 4: Code-Review+2\n\nLooks good. Thanks Rafael","accounts_in_message":[],"_revision_number":4},{"id":"c2565d3bae58bbc507d924f77454de840a687948","author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"date":"2020-12-08 12:42:25.000000000","message":"Patch Set 4: Code-Review+1\n\n(4 comments)\n\nyep this look fine to me too","accounts_in_message":[],"_revision_number":4},{"id":"3ed1c0b0e4f141839b5a3ce9b670f4085766364f","author":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"date":"2020-12-08 12:58:04.000000000","message":"Patch Set 4:\n\n(1 comment)\n\nThank you guys for the review. If you think that I need to change something here, let me know.","accounts_in_message":[],"_revision_number":4},{"id":"9d2889bf78baae57718ff5683d1a8a9085cbdd9e","author":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"},"date":"2020-12-08 21:05:56.000000000","message":"Patch Set 4: Code-Review+2 Workflow+1\n\nUpgrading to +2/+W as gibi and sean-k-mooney have given their ACK. Still LGTM","accounts_in_message":[],"_revision_number":4},{"id":"f614b172f19998f3921f32f9bc82181acb9bff87","tag":"autogenerated:zuul:gate","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2020-12-08 21:06:23.000000000","message":"Patch Set 4: -Verified\n\nStarting gate jobs.","accounts_in_message":[],"_revision_number":4},{"id":"2b4b247760ac5f54cbdc3a3a26789610bb47bd87","tag":"autogenerated:zuul:gate","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2020-12-08 21:20:03.000000000","message":"Patch Set 4: Verified+2\n\nBuild succeeded (gate pipeline).\n\n- build-openstack-api-ref https://zuul.opendev.org/t/openstack/build/946a8677c92f4311a2c1dba04ceda2ce : SUCCESS in 7m 20s\n- openstack-tox-pep8 https://zuul.opendev.org/t/openstack/build/9f3c0e36d57a485ba42103dddb67ba3d : SUCCESS in 8m 34s\n- openstack-tox-docs https://zuul.opendev.org/t/openstack/build/6f28eedd0c8246a5b20ecbb1f6a43dd8 : SUCCESS in 12m 05s","accounts_in_message":[],"_revision_number":4},{"id":"3f917c1d17a2e90ebcca0a3397b2e57ad64a4964","tag":"autogenerated:gerrit:merged","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2020-12-08 21:20:07.000000000","message":"Change has been successfully merged by Zuul","accounts_in_message":[],"_revision_number":4},{"id":"1d61c49028245efd2e3da115be68c99b1a63dbc0","tag":"autogenerated:zuul:promote","author":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]},"date":"2020-12-08 21:22:29.000000000","message":"Patch Set 4:\n\nBuild succeeded (promote pipeline).\n\n- promote-api-ref https://zuul.opendev.org/t/openstack/build/68f387c7f52d43e78bf481dd23f5c8b7 : SUCCESS in 51s\n- promote-openstack-tox-docs https://zuul.opendev.org/t/openstack/build/5b9f2a1590e74cf79baf362b4b42c9ad : SUCCESS in 58s","accounts_in_message":[],"_revision_number":4}],"current_revision_number":4,"current_revision":"01f0424930213b86219d9f05a2bcd28c6f3e19f9","revisions":{"b5d4e4a252dd8188f808c1f1cb695c81c6ce3df7":{"kind":"REWORK","_number":1,"created":"2020-12-07 20:30:41.000000000","uploader":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"ref":"refs/changes/71/765871/1","fetch":{"anonymous http":{"url":"https://review.opendev.org/openstack/nova","ref":"refs/changes/71/765871/1","commands":{"Checkout":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/1 \u0026\u0026 git checkout FETCH_HEAD","Cherry Pick":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/1 \u0026\u0026 git cherry-pick FETCH_HEAD","Format Patch":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/1 \u0026\u0026 git format-patch -1 --stdout FETCH_HEAD","Pull":"git pull https://review.opendev.org/openstack/nova refs/changes/71/765871/1"}}},"commit":{"parents":[{"commit":"97729aabaa7768e1af2fa4a0bdda0df7ad598426","subject":"Merge \"libvirt: check for AMD SEV only on x86-64\"","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/97729aabaa7768e1af2fa4a0bdda0df7ad598426"}]}],"author":{"name":"Rafael Weingärtner","email":"rafael@apache.org","date":"2020-12-07 20:26:33.000000000","tz":-180},"committer":{"name":"Rafael Weingärtner","email":"rafael@apache.org","date":"2020-12-07 20:28:29.000000000","tz":-180},"subject":"Enhance simple usage API documentation","message":"Enhance simple usage API documentation\n\nNova\u0027s `os-simple-tenant-usage` has the following statement.\n\n```\nReports usage statistics of compute and storage resources periodically for an\nindividual tenant or all tenants. The usage statistics will include all\ninstances’ CPU, memory and local disk during a specific period.\n\n```\n\nTo some people, when reading that, they might get the understanding that the\n`os-simple-tenant-usage` will report the actual use of resources. Therefore,\nif a VM is stopped and then started back again, it (the\n`os-simple-tenant-usage`) would only report the time the VM has been up and\nrunning. However, that is not what happens. The `os-simple-tenant-usage`\nreports the time that a virtual machine (VM) exists in the cloud environment.\nTherefore, actions such as pause, suspend, and stop do not affect the usage\naccounting.\n\nThis might be a problem for people using this API for billing, or for people\nthat use other systems (e.g. CloudKitty) for billing. End-users might try to\ncross-check the data from the billing from CloudKitty for instance, with the\nusage report found in Horizon that uses this API, and the numbers will not add\nup, as people might only consider the time a VM has been up and running to\ncharge users in CloudKitty.\n\nAn extension was proposed in [1], to allow operators to customize the usage\naccounting. However, during a meeting with the community [2], the extension\nwas rejected for two reasons:\n\n* Nova tries to avoid using config driven APIs. Meaning, APIs that change the\n   response according to server-side configurations;\n* The community has decided to get rid of usage and billing accounting in Nova.\n\nHaving said that, we would like to propose a documentation amendment. The idea\nis to explicitly say for users/operators that the simple usage API only considers\nthe time that the VM existed in the cloud for the accounting, and not the actual\ntime it has been up and running. This will save some misunderstanding and misuse\nof the API data.\n\nReferences\n\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\n[1] https://review.opendev.org/c/openstack/nova/+/711113\n[2] http://eavesdrop.openstack.org/meetings/nova/2020/nova.2020-12-03-16.00.log.txt\n\nCloses-Bug: #1907133\nChange-Id: Ic55669f5210b57f151f693393f205655765a8dc9\n","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/b5d4e4a252dd8188f808c1f1cb695c81c6ce3df7"}],"resolve_conflicts_web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/b5d4e4a252dd8188f808c1f1cb695c81c6ce3df7"}]},"branch":"refs/heads/master"},"a6dab54cc7aaf2ededc2b2f4eb3efa64c90e2d93":{"kind":"NO_CODE_CHANGE","_number":2,"created":"2020-12-07 20:34:42.000000000","uploader":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"ref":"refs/changes/71/765871/2","fetch":{"anonymous http":{"url":"https://review.opendev.org/openstack/nova","ref":"refs/changes/71/765871/2","commands":{"Checkout":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/2 \u0026\u0026 git checkout FETCH_HEAD","Cherry Pick":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/2 \u0026\u0026 git cherry-pick FETCH_HEAD","Format Patch":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/2 \u0026\u0026 git format-patch -1 --stdout FETCH_HEAD","Pull":"git pull https://review.opendev.org/openstack/nova refs/changes/71/765871/2"}}},"commit":{"parents":[{"commit":"97729aabaa7768e1af2fa4a0bdda0df7ad598426","subject":"Merge \"libvirt: check for AMD SEV only on x86-64\"","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/97729aabaa7768e1af2fa4a0bdda0df7ad598426"}]}],"author":{"name":"Rafael Weingärtner","email":"rafael@apache.org","date":"2020-12-07 20:26:33.000000000","tz":-180},"committer":{"name":"Rafael Weingärtner","email":"rafael@apache.org","date":"2020-12-07 20:34:09.000000000","tz":-180},"subject":"Nova\u0027s `os-simple-tenant-usage` has the following statement.","message":"Nova\u0027s `os-simple-tenant-usage` has the following statement.\n\n```\nReports usage statistics of compute and storage resources periodically\nfor an individual tenant or all tenants. The usage statistics will\ninclude all instances’ CPU, memory and local disk during a specific\nperiod.\n\n```\n\nTo some people, when reading that, they might get the understanding that\nthe `os-simple-tenant-usage` will report the actual use of resources.\nTherefore, if a VM is stopped and then started back again, it (the\n`os-simple-tenant-usage`) would only report the time the VM has been up\nand running. However, that is not what happens. The\n`os-simple-tenant-usage` reports the time that a virtual machine (VM)\nexists in the cloud environment. Therefore, actions such as pause,\nsuspend, and stop do not affect the usage accounting.\n\nThis might be a problem for people using this API for billing, or for\npeople that use other systems (e.g. CloudKitty) for billing.\nEnd-users might try to cross-check the data from the billing from\nCloudKitty for instance, with the usage report found in Horizon that\nuses this API, and the numbers will not add up, as people might only\nconsider the time a VM has been up and running to charge users in\nCloudKitty.\n\nAn extension was proposed in [1], to allow operators to customize\nthe usage accounting. However, during a meeting with the community [2],\nthe extension was rejected for two reasons:\n\n* Nova tries to avoid using config driven APIs. Meaning, APIs that change\n  the response according to server-side configurations;\n* The community has decided to get rid of usage and billing accounting\n  in Nova.\n\nHaving said that, we would like to propose a documentation amendment.\nThe idea is to explicitly say for users/operators that the simple usage\nAPI only considers the time that the VM existed in the cloud for the\naccounting, and not the actual time it has been up and running. This will\nsave some misunderstanding and misuse of the API data.\n\nReferences\n\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\n[1] https://review.opendev.org/c/openstack/nova/+/711113\n[2] http://eavesdrop.openstack.org/meetings/nova/2020/nova.2020-12-03-16.00.log.txt\n\nCloses-Bug: #1907133\nChange-Id: Ic55669f5210b57f151f693393f205655765a8dc9\n","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/a6dab54cc7aaf2ededc2b2f4eb3efa64c90e2d93"}],"resolve_conflicts_web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/a6dab54cc7aaf2ededc2b2f4eb3efa64c90e2d93"}]},"branch":"refs/heads/master"},"14a849e46817a125c739837b4d3482afb2128de4":{"kind":"NO_CODE_CHANGE","_number":3,"created":"2020-12-07 20:36:15.000000000","uploader":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"ref":"refs/changes/71/765871/3","fetch":{"anonymous http":{"url":"https://review.opendev.org/openstack/nova","ref":"refs/changes/71/765871/3","commands":{"Checkout":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/3 \u0026\u0026 git checkout FETCH_HEAD","Cherry Pick":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/3 \u0026\u0026 git cherry-pick FETCH_HEAD","Format Patch":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/3 \u0026\u0026 git format-patch -1 --stdout FETCH_HEAD","Pull":"git pull https://review.opendev.org/openstack/nova refs/changes/71/765871/3"}}},"commit":{"parents":[{"commit":"97729aabaa7768e1af2fa4a0bdda0df7ad598426","subject":"Merge \"libvirt: check for AMD SEV only on x86-64\"","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/97729aabaa7768e1af2fa4a0bdda0df7ad598426"}]}],"author":{"name":"Rafael Weingärtner","email":"rafael@apache.org","date":"2020-12-07 20:26:33.000000000","tz":-180},"committer":{"name":"Rafael Weingärtner","email":"rafael@apache.org","date":"2020-12-07 20:35:46.000000000","tz":-180},"subject":"Enhance simple usage API documentation","message":"Enhance simple usage API documentation\n\nNova\u0027s `os-simple-tenant-usage` has the following statement.\n\n```\nReports usage statistics of compute and storage resources periodically\nfor an individual tenant or all tenants. The usage statistics will\ninclude all instances’ CPU, memory and local disk during a specific\nperiod.\n\n```\n\nTo some people, when reading that, they might get the understanding that\nthe `os-simple-tenant-usage` will report the actual use of resources.\nTherefore, if a VM is stopped and then started back again, it (the\n`os-simple-tenant-usage`) would only report the time the VM has been up\nand running. However, that is not what happens. The\n`os-simple-tenant-usage` reports the time that a virtual machine (VM)\nexists in the cloud environment. Therefore, actions such as pause,\nsuspend, and stop do not affect the usage accounting.\n\nThis might be a problem for people using this API for billing, or for\npeople that use other systems (e.g. CloudKitty) for billing.\nEnd-users might try to cross-check the data from the billing from\nCloudKitty for instance, with the usage report found in Horizon that\nuses this API, and the numbers will not add up, as people might only\nconsider the time a VM has been up and running to charge users in\nCloudKitty.\n\nAn extension was proposed in [1], to allow operators to customize\nthe usage accounting. However, during a meeting with the community [2],\nthe extension was rejected for two reasons:\n\n* Nova tries to avoid using config driven APIs. Meaning, APIs that change\n  the response according to server-side configurations;\n* The community has decided to get rid of usage and billing accounting\n  in Nova.\n\nHaving said that, we would like to propose a documentation amendment.\nThe idea is to explicitly say for users/operators that the simple usage\nAPI only considers the time that the VM existed in the cloud for the\naccounting, and not the actual time it has been up and running. This will\nsave some misunderstanding and misuse of the API data.\n\nReferences\n\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\n[1] https://review.opendev.org/c/openstack/nova/+/711113\n[2] http://eavesdrop.openstack.org/meetings/nova/2020/nova.2020-12-03-16.00.log.txt\n\nCloses-Bug: #1907133\nChange-Id: Ic55669f5210b57f151f693393f205655765a8dc9\n","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/14a849e46817a125c739837b4d3482afb2128de4"}],"resolve_conflicts_web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/14a849e46817a125c739837b4d3482afb2128de4"}]},"branch":"refs/heads/master"},"01f0424930213b86219d9f05a2bcd28c6f3e19f9":{"kind":"NO_CODE_CHANGE","_number":4,"created":"2020-12-07 20:39:10.000000000","uploader":{"_account_id":28356,"name":"Rafael Weingartner","email":"rafael@apache.org","username":"rafaelweingartner"},"ref":"refs/changes/71/765871/4","fetch":{"anonymous http":{"url":"https://review.opendev.org/openstack/nova","ref":"refs/changes/71/765871/4","commands":{"Checkout":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/4 \u0026\u0026 git checkout FETCH_HEAD","Cherry Pick":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/4 \u0026\u0026 git cherry-pick FETCH_HEAD","Format Patch":"git fetch https://review.opendev.org/openstack/nova refs/changes/71/765871/4 \u0026\u0026 git format-patch -1 --stdout FETCH_HEAD","Pull":"git pull https://review.opendev.org/openstack/nova refs/changes/71/765871/4"}}},"commit":{"parents":[{"commit":"97729aabaa7768e1af2fa4a0bdda0df7ad598426","subject":"Merge \"libvirt: check for AMD SEV only on x86-64\"","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/97729aabaa7768e1af2fa4a0bdda0df7ad598426"}]}],"author":{"name":"Rafael Weingärtner","email":"rafael@apache.org","date":"2020-12-07 20:26:33.000000000","tz":-180},"committer":{"name":"Rafael Weingärtner","email":"rafael@apache.org","date":"2020-12-07 20:38:37.000000000","tz":-180},"subject":"Enhance simple usage API documentation","message":"Enhance simple usage API documentation\n\nNova\u0027s `os-simple-tenant-usage` has the following statement.\n\n```\nReports usage statistics of compute and storage resources periodically\nfor an individual tenant or all tenants. The usage statistics will\ninclude all instances’ CPU, memory and local disk during a specific\nperiod.\n\n```\n\nTo some people, when reading that, they might get the understanding that\nthe `os-simple-tenant-usage` will report the actual use of resources.\nTherefore, if a VM is stopped and then started back again, it (the\n`os-simple-tenant-usage`) would only report the time the VM has been up\nand running. However, that is not what happens. The\n`os-simple-tenant-usage` reports the time that a virtual machine (VM)\nexists in the cloud environment. Therefore, actions such as pause,\nsuspend, and stop do not affect the usage accounting.\n\nThis might be a problem for people using this API for billing, or for\npeople that use other systems (e.g. CloudKitty) for billing.\nEnd-users might try to cross-check the data from the billing from\nCloudKitty for instance, with the usage report found in Horizon that\nuses this API, and the numbers will not add up, as people might only\nconsider the time a VM has been up and running to charge users in\nCloudKitty.\n\nAn extension was proposed in [1], to allow operators to customize\nthe usage accounting. However, during a meeting with the community [2],\nthe extension was rejected for two reasons:\n\n* Nova tries to avoid using config driven APIs. Meaning, APIs that change\n  the response according to server-side configurations;\n* The community has decided to get rid of usage and billing accounting\n  in Nova.\n\nHaving said that, we would like to propose a documentation amendment.\nThe idea is to explicitly say for users/operators that the simple usage\nAPI only considers the time that the VM existed in the cloud for the\naccounting, and not the actual time it has been up and running.\nThis will save some misunderstanding and misuse of the API data.\n\nReferences\n\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\n[1] https://review.opendev.org/c/openstack/nova/+/711113\n[2] http://eavesdrop.openstack.org/meetings/nova/2020/nova.2020-12-03-16.00.log.txt\n\nCloses-Bug: #1907133\nChange-Id: Ic55669f5210b57f151f693393f205655765a8dc9\n","web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/01f0424930213b86219d9f05a2bcd28c6f3e19f9"}],"resolve_conflicts_web_links":[{"name":"gitea","tooltip":"Open in GitWeb","url":"https://opendev.org/openstack/nova/commit/01f0424930213b86219d9f05a2bcd28c6f3e19f9"}]},"branch":"refs/heads/master"}},"requirements":[],"submit_records":[{"status":"CLOSED","labels":[{"label":"Verified","status":"OK","applied_by":{"_account_id":22348,"name":"Zuul","username":"zuul","tags":["SERVICE_USER"]}},{"label":"Code-Review","status":"OK","applied_by":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"}},{"label":"Workflow","status":"OK","applied_by":{"_account_id":4690,"name":"melanie witt","display_name":"melwitt","email":"melwittt@gmail.com","username":"melwitt"}}]}],"submit_requirements":[{"name":"Verified","status":"SATISFIED","is_legacy":true,"submittability_expression_result":{"expression":"label:Verified\u003dCustom-Rule","fulfilled":true,"status":"PASS","passing_atoms":["label:Verified\u003dCustom-Rule"],"failing_atoms":[],"atom_explanations":{}}},{"name":"Workflow","status":"SATISFIED","is_legacy":true,"submittability_expression_result":{"expression":"label:Workflow\u003dCustom-Rule","fulfilled":true,"status":"PASS","passing_atoms":["label:Workflow\u003dCustom-Rule"],"failing_atoms":[],"atom_explanations":{}}},{"name":"Code-Review","status":"SATISFIED","is_legacy":true,"submittability_expression_result":{"expression":"label:Code-Review\u003dCustom-Rule","fulfilled":true,"status":"PASS","passing_atoms":["label:Code-Review\u003dCustom-Rule"],"failing_atoms":[],"atom_explanations":{}}}]}