)]}'
{"specs/api/v2/sharing-image-api-v2.rst":[{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"bacf67a537d0f378188e2a9355ac727c15dbe1ad","unresolved":false,"context_lines":[{"line_number":420,"context_line":"A community image is an image whose ``visibility`` value is ``community``."},{"line_number":421,"context_line":"The ability to communitize an image may be prohibited or restricted to"},{"line_number":422,"context_line":"specific users at the discreation of the cloud operator."},{"line_number":423,"context_line":""},{"line_number":424,"context_line":"Community images do not appear in the default image list of any user other"},{"line_number":425,"context_line":"than the image owner.  In order to discover community images, make the"},{"line_number":426,"context_line":"image-list call with a \u0027visibility\u0027 filter:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a430d35_abe52aa9","line":423,"updated":"2017-02-03 16:43:07.000000000","message":"\"This can be done via an image update call.\" ?","commit_id":"32e9d2978e5acfa6ac27a3a32f1e6da073500f32"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"5cf413a96eeb574626f14563679c6c2b328943a0","unresolved":false,"context_lines":[{"line_number":420,"context_line":"A community image is an image whose ``visibility`` value is ``community``."},{"line_number":421,"context_line":"The ability to communitize an image may be prohibited or restricted to"},{"line_number":422,"context_line":"specific users at the discreation of the cloud operator."},{"line_number":423,"context_line":""},{"line_number":424,"context_line":"Community images do not appear in the default image list of any user other"},{"line_number":425,"context_line":"than the image owner.  In order to discover community images, make the"},{"line_number":426,"context_line":"image-list call with a \u0027visibility\u0027 filter:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a430d35_ef62ddd7","line":423,"in_reply_to":"1a430d35_abe52aa9","updated":"2017-02-03 16:52:37.000000000","message":"Good suggestion, I\u0027ll add that.","commit_id":"32e9d2978e5acfa6ac27a3a32f1e6da073500f32"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"bacf67a537d0f378188e2a9355ac727c15dbe1ad","unresolved":false,"context_lines":[{"line_number":429,"context_line":""},{"line_number":430,"context_line":"As with the standard image-list call, other filters may be applied to the"},{"line_number":431,"context_line":"request.  For example, to see the community images supplied by the image"},{"line_number":432,"context_line":"producer identified by ``931efe8a-0ad7-4610-9116-c199f8807cda``, the"},{"line_number":433,"context_line":"following call would be made:"},{"line_number":434,"context_line":""},{"line_number":435,"context_line":"``GET v2/images?visibility\u003dcommunity\u0026owner\u003d931efe8a-0ad7-4610-9116-c199f8807cda``"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a430d35_4b81264a","line":432,"range":{"start_line":432,"start_character":22,"end_line":432,"end_character":23},"updated":"2017-02-03 16:43:07.000000000","message":"his/her tenant id","commit_id":"32e9d2978e5acfa6ac27a3a32f1e6da073500f32"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"5cf413a96eeb574626f14563679c6c2b328943a0","unresolved":false,"context_lines":[{"line_number":429,"context_line":""},{"line_number":430,"context_line":"As with the standard image-list call, other filters may be applied to the"},{"line_number":431,"context_line":"request.  For example, to see the community images supplied by the image"},{"line_number":432,"context_line":"producer identified by ``931efe8a-0ad7-4610-9116-c199f8807cda``, the"},{"line_number":433,"context_line":"following call would be made:"},{"line_number":434,"context_line":""},{"line_number":435,"context_line":"``GET v2/images?visibility\u003dcommunity\u0026owner\u003d931efe8a-0ad7-4610-9116-c199f8807cda``"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a430d35_af41b53b","line":432,"range":{"start_line":432,"start_character":22,"end_line":432,"end_character":23},"in_reply_to":"1a430d35_4b81264a","updated":"2017-02-03 16:52:37.000000000","message":"see below","commit_id":"32e9d2978e5acfa6ac27a3a32f1e6da073500f32"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"bacf67a537d0f378188e2a9355ac727c15dbe1ad","unresolved":false,"context_lines":[{"line_number":432,"context_line":"producer identified by ``931efe8a-0ad7-4610-9116-c199f8807cda``, the"},{"line_number":433,"context_line":"following call would be made:"},{"line_number":434,"context_line":""},{"line_number":435,"context_line":"``GET v2/images?visibility\u003dcommunity\u0026owner\u003d931efe8a-0ad7-4610-9116-c199f8807cda``"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a430d35_abb9aa30","line":435,"range":{"start_line":435,"start_character":43,"end_line":435,"end_character":79},"updated":"2017-02-03 16:43:07.000000000","message":"how about just giving \"\u003ctenant-id\u003e\"","commit_id":"32e9d2978e5acfa6ac27a3a32f1e6da073500f32"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"5cf413a96eeb574626f14563679c6c2b328943a0","unresolved":false,"context_lines":[{"line_number":432,"context_line":"producer identified by ``931efe8a-0ad7-4610-9116-c199f8807cda``, the"},{"line_number":433,"context_line":"following call would be made:"},{"line_number":434,"context_line":""},{"line_number":435,"context_line":"``GET v2/images?visibility\u003dcommunity\u0026owner\u003d931efe8a-0ad7-4610-9116-c199f8807cda``"}],"source_content_type":"text/x-rst","patch_set":1,"id":"1a430d35_cfda8178","line":435,"range":{"start_line":435,"start_character":43,"end_line":435,"end_character":79},"in_reply_to":"1a430d35_abb9aa30","updated":"2017-02-03 16:52:37.000000000","message":"The problem is that we have the owner_is_tenant configuration option, so this could be tenant_id, or it could be a user_id, depending on how the cloud is set up.\n\nFei Long had me add a section about the this to the api-ref last cycle.  I\u0027ll look over these docs and make sure that the implications of owner_is_tenant are mentioned somewhere.","commit_id":"32e9d2978e5acfa6ac27a3a32f1e6da073500f32"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"ddb40234a4953472a0be0ca40b1a86be2633ca97","unresolved":false,"context_lines":[{"line_number":23,"context_line":"   modify the member status of an image member."},{"line_number":24,"context_line":"-  An image consumer may change his or her member status, but may not"},{"line_number":25,"context_line":"   add or remove him or herself as an image member."},{"line_number":26,"context_line":"-  A consumer may boot an instance from a shared image regardless of"},{"line_number":27,"context_line":"   whether he/she has \"accepted\" the image."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":".. _owner_is_tenant:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_8320529d","line":26,"range":{"start_line":26,"start_character":42,"end_line":26,"end_character":48},"updated":"2017-02-03 18:26:44.000000000","message":"s/shared/\u0027shared\u0027","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"4678dc886360dc3402361694e42c754780f94352","unresolved":false,"context_lines":[{"line_number":23,"context_line":"   modify the member status of an image member."},{"line_number":24,"context_line":"-  An image consumer may change his or her member status, but may not"},{"line_number":25,"context_line":"   add or remove him or herself as an image member."},{"line_number":26,"context_line":"-  A consumer may boot an instance from a shared image regardless of"},{"line_number":27,"context_line":"   whether he/she has \"accepted\" the image."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":".. _owner_is_tenant:"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_78b5cccb","line":26,"range":{"start_line":26,"start_character":42,"end_line":26,"end_character":48},"in_reply_to":"1a430d35_8320529d","updated":"2017-02-03 19:57:29.000000000","message":"We\u0027re talking about the kind of image here, not its visibility value, so don\u0027t need the quotes.","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"ddb40234a4953472a0be0ca40b1a86be2633ca97","unresolved":false,"context_lines":[{"line_number":25,"context_line":"   add or remove him or herself as an image member."},{"line_number":26,"context_line":"-  A consumer may boot an instance from a shared image regardless of"},{"line_number":27,"context_line":"   whether he/she has \"accepted\" the image."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":".. _owner_is_tenant:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"How do you identify a producer or consumer?"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_d8232504","line":28,"updated":"2017-02-03 18:26:44.000000000","message":"Add this?\n- A consumer may boot an instance from a \u0027community\u0027 image that is discoverable by him/her.","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"4678dc886360dc3402361694e42c754780f94352","unresolved":false,"context_lines":[{"line_number":25,"context_line":"   add or remove him or herself as an image member."},{"line_number":26,"context_line":"-  A consumer may boot an instance from a shared image regardless of"},{"line_number":27,"context_line":"   whether he/she has \"accepted\" the image."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":".. _owner_is_tenant:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"How do you identify a producer or consumer?"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_d8c40042","line":28,"in_reply_to":"1a430d35_d8232504","updated":"2017-02-03 19:57:29.000000000","message":"Reorganized the text so that it should be clear at this point that we\u0027re only talking about member-based sharing.","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"13ff3b26e44e99c4086c9dcdd691d5cb3036941c","unresolved":false,"context_lines":[{"line_number":25,"context_line":"   add or remove him or herself as an image member."},{"line_number":26,"context_line":"-  A consumer may boot an instance from a shared image regardless of"},{"line_number":27,"context_line":"   whether he/she has \"accepted\" the image."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":".. _owner_is_tenant:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"How do you identify a producer or consumer?"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_47874d61","line":28,"in_reply_to":"1a430d35_d8c40042","updated":"2017-02-03 22:36:54.000000000","message":"Thanks Brian.","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"ddb40234a4953472a0be0ca40b1a86be2633ca97","unresolved":false,"context_lines":[{"line_number":58,"context_line":"are owned by *projects*, so if the local documentation doesn\u0027t say anything,"},{"line_number":59,"context_line":"it\u0027s a good bet that the default is being used.)"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"Producer-Consumer Communication"},{"line_number":62,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"No provision is made in this API for producer-consumer communication."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_58cc9535","line":61,"range":{"start_line":61,"start_character":0,"end_line":61,"end_character":31},"updated":"2017-02-03 18:26:44.000000000","message":"Producer-Consumer Communication for shared images","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"ddb40234a4953472a0be0ca40b1a86be2633ca97","unresolved":false,"context_lines":[{"line_number":59,"context_line":"it\u0027s a good bet that the default is being used.)"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"Producer-Consumer Communication"},{"line_number":62,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"No provision is made in this API for producer-consumer communication."},{"line_number":65,"context_line":"All such communication must be done independently of the API."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_589ad515","line":62,"updated":"2017-02-03 18:26:44.000000000","message":"Or if we retain as it is, I think it should include appropriate information about community images too . Cos, this file is talking about \"v2 sharing\" and community images also falls under that category.","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"4678dc886360dc3402361694e42c754780f94352","unresolved":false,"context_lines":[{"line_number":59,"context_line":"it\u0027s a good bet that the default is being used.)"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"Producer-Consumer Communication"},{"line_number":62,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"No provision is made in this API for producer-consumer communication."},{"line_number":65,"context_line":"All such communication must be done independently of the API."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_b83c9430","line":62,"in_reply_to":"1a430d35_589ad515","updated":"2017-02-03 19:57:29.000000000","message":"Left this as is, but added something to the community image section.","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"ddb40234a4953472a0be0ca40b1a86be2633ca97","unresolved":false,"context_lines":[{"line_number":69,"context_line":"1. The producer posts the availability of specific images on a public"},{"line_number":70,"context_line":"   website."},{"line_number":71,"context_line":"2. A potential consumer provides the producer with his/her appropriate"},{"line_number":72,"context_line":"   identifier (see above) and email address."},{"line_number":73,"context_line":"3. The producer uses the Images v2 API to share the image with the"},{"line_number":74,"context_line":"   consumer."},{"line_number":75,"context_line":"4. The producer notifies the consumer via email that the image has been"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_9846fd21","line":72,"range":{"start_line":72,"start_character":15,"end_line":72,"end_character":24},"updated":"2017-02-03 18:26:44.000000000","message":"Either your project-id or user-id.\n\nI would not like to \"see above\".. I feel the same for any user reading this too.","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"ddb40234a4953472a0be0ca40b1a86be2633ca97","unresolved":false,"context_lines":[{"line_number":74,"context_line":"   consumer."},{"line_number":75,"context_line":"4. The producer notifies the consumer via email that the image has been"},{"line_number":76,"context_line":"   shared and what its UUID is."},{"line_number":77,"context_line":"5. If the consumer wishes the image to appear in his/her image list, the"},{"line_number":78,"context_line":"   Images v2 API is used to change the image status to ``accepted``."},{"line_number":79,"context_line":"6. If the consumer subsequently wishes to hide the image, the Images v2"},{"line_number":80,"context_line":"   API may be used to change the member status to ``rejected``. If the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_f558ec58","line":77,"range":{"start_line":77,"start_character":30,"end_line":77,"end_character":35},"updated":"2017-02-03 18:26:44.000000000","message":"s/image/shared image","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"4678dc886360dc3402361694e42c754780f94352","unresolved":false,"context_lines":[{"line_number":74,"context_line":"   consumer."},{"line_number":75,"context_line":"4. The producer notifies the consumer via email that the image has been"},{"line_number":76,"context_line":"   shared and what its UUID is."},{"line_number":77,"context_line":"5. If the consumer wishes the image to appear in his/her image list, the"},{"line_number":78,"context_line":"   Images v2 API is used to change the image status to ``accepted``."},{"line_number":79,"context_line":"6. If the consumer subsequently wishes to hide the image, the Images v2"},{"line_number":80,"context_line":"   API may be used to change the member status to ``rejected``. If the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_f81d3cbe","line":77,"range":{"start_line":77,"start_character":30,"end_line":77,"end_character":35},"in_reply_to":"1a430d35_f558ec58","updated":"2017-02-03 19:57:29.000000000","message":"missed this one, let me know if you think it\u0027s important","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"13ff3b26e44e99c4086c9dcdd691d5cb3036941c","unresolved":false,"context_lines":[{"line_number":74,"context_line":"   consumer."},{"line_number":75,"context_line":"4. The producer notifies the consumer via email that the image has been"},{"line_number":76,"context_line":"   shared and what its UUID is."},{"line_number":77,"context_line":"5. If the consumer wishes the image to appear in his/her image list, the"},{"line_number":78,"context_line":"   Images v2 API is used to change the image status to ``accepted``."},{"line_number":79,"context_line":"6. If the consumer subsequently wishes to hide the image, the Images v2"},{"line_number":80,"context_line":"   API may be used to change the member status to ``rejected``. If the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a430d35_47d58d41","line":77,"range":{"start_line":77,"start_character":30,"end_line":77,"end_character":35},"in_reply_to":"1a430d35_f81d3cbe","updated":"2017-02-03 22:36:54.000000000","message":"If uploading a new PS, we can update it. Else, it is cool cos the heading in our new PS clearly says that we are talking about shared images.","commit_id":"9bb50a5ee891ff7a40c9d29fb84c8c0d216e53ad"},{"author":{"_account_id":22448,"name":"Alexander Bashmakov","email":"abashmak@yahoo.com","username":"abashmak"},"change_message_id":"17b92fc09cd6e9fa2749c83e8abf2a0beadf4851","unresolved":false,"context_lines":[{"line_number":16,"context_line":"  name).  Community images are discussed below in the section"},{"line_number":17,"context_line":"  :ref:`one-all-sharing`."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"To keep the discussion to follow clear, here\u0027s some vocabulary so that we\u0027re"},{"line_number":20,"context_line":"all talking about the same things."},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"producer"},{"line_number":23,"context_line":"  A user who owns an image that\u0027s going to be shared with other users."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_db907a98","line":20,"range":{"start_line":19,"start_character":0,"end_line":20,"end_character":34},"updated":"2017-02-03 20:29:44.000000000","message":"nit: To keep the below discussion clear, here\u0027s some terminology that will be used:","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"6d6ade21103200b0204bc994193c2447bc97d5d9","unresolved":false,"context_lines":[{"line_number":16,"context_line":"  name).  Community images are discussed below in the section"},{"line_number":17,"context_line":"  :ref:`one-all-sharing`."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"To keep the discussion to follow clear, here\u0027s some vocabulary so that we\u0027re"},{"line_number":20,"context_line":"all talking about the same things."},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"producer"},{"line_number":23,"context_line":"  A user who owns an image that\u0027s going to be shared with other users."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_8c2b1a30","line":20,"range":{"start_line":19,"start_character":0,"end_line":20,"end_character":34},"in_reply_to":"1a430d35_db907a98","updated":"2017-02-03 22:47:18.000000000","message":"good rewording, thanks","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":22448,"name":"Alexander Bashmakov","email":"abashmak@yahoo.com","username":"abashmak"},"change_message_id":"17b92fc09cd6e9fa2749c83e8abf2a0beadf4851","unresolved":false,"context_lines":[{"line_number":29,"context_line":"  An image that\u0027s been made accessible to specific other users, as described in"},{"line_number":30,"context_line":"  :ref:`one-one-sharing`.  Since version 2.5 of the API, the ``visibility``"},{"line_number":31,"context_line":"  property of such an image is ``shared``.  (Prior to version 2.5, the"},{"line_number":32,"context_line":"  ``visibility`` would be ``private``.)"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"community image"},{"line_number":35,"context_line":"  An image that\u0027s been made accessible to all users, as described in"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_5bf3aa0a","line":32,"range":{"start_line":32,"start_character":17,"end_line":32,"end_character":25},"updated":"2017-02-03 20:29:44.000000000","message":"nit: would have been","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"6d6ade21103200b0204bc994193c2447bc97d5d9","unresolved":false,"context_lines":[{"line_number":29,"context_line":"  An image that\u0027s been made accessible to specific other users, as described in"},{"line_number":30,"context_line":"  :ref:`one-one-sharing`.  Since version 2.5 of the API, the ``visibility``"},{"line_number":31,"context_line":"  property of such an image is ``shared``.  (Prior to version 2.5, the"},{"line_number":32,"context_line":"  ``visibility`` would be ``private``.)"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"community image"},{"line_number":35,"context_line":"  An image that\u0027s been made accessible to all users, as described in"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_cc1d2211","line":32,"range":{"start_line":32,"start_character":17,"end_line":32,"end_character":25},"in_reply_to":"1a430d35_5bf3aa0a","updated":"2017-02-03 22:47:18.000000000","message":"will change to \u0027is\u0027 (this is aimed at readers who aren\u0027t using 2.5 yet)","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":22448,"name":"Alexander Bashmakov","email":"abashmak@yahoo.com","username":"abashmak"},"change_message_id":"17b92fc09cd6e9fa2749c83e8abf2a0beadf4851","unresolved":false,"context_lines":[{"line_number":32,"context_line":"  ``visibility`` would be ``private``.)"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"community image"},{"line_number":35,"context_line":"  An image that\u0027s been made accessible to all users, as described in"},{"line_number":36,"context_line":"  :ref:`one-all-sharing`.  Since version 2.5 of the API, the ``visibility``"},{"line_number":37,"context_line":"  property of such an image is ``community``.  (This type of image was not"},{"line_number":38,"context_line":"  available prior to version 2.5.)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_5bcacaa2","line":35,"range":{"start_line":35,"start_character":42,"end_line":35,"end_character":51},"updated":"2017-02-03 20:29:44.000000000","message":"all users of a particular project/tenant?","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"0f78fd8ad8afa27d4c7a9dbe5590a45908a36af1","unresolved":false,"context_lines":[{"line_number":32,"context_line":"  ``visibility`` would be ``private``.)"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"community image"},{"line_number":35,"context_line":"  An image that\u0027s been made accessible to all users, as described in"},{"line_number":36,"context_line":"  :ref:`one-all-sharing`.  Since version 2.5 of the API, the ``visibility``"},{"line_number":37,"context_line":"  property of such an image is ``community``.  (This type of image was not"},{"line_number":38,"context_line":"  available prior to version 2.5.)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_8c723ae4","line":35,"range":{"start_line":35,"start_character":42,"end_line":35,"end_character":51},"in_reply_to":"1a430d35_5bcacaa2","updated":"2017-02-03 22:36:35.000000000","message":"Alex, it is not confined to a project/tenant.","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"6d6ade21103200b0204bc994193c2447bc97d5d9","unresolved":false,"context_lines":[{"line_number":32,"context_line":"  ``visibility`` would be ``private``.)"},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"community image"},{"line_number":35,"context_line":"  An image that\u0027s been made accessible to all users, as described in"},{"line_number":36,"context_line":"  :ref:`one-all-sharing`.  Since version 2.5 of the API, the ``visibility``"},{"line_number":37,"context_line":"  property of such an image is ``community``.  (This type of image was not"},{"line_number":38,"context_line":"  available prior to version 2.5.)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_6cdd0e42","line":35,"range":{"start_line":35,"start_character":42,"end_line":35,"end_character":51},"in_reply_to":"1a430d35_5bcacaa2","updated":"2017-02-03 22:47:18.000000000","message":"no, the consumers are unrestricted.  I\u0027ll add some text about sharing to/within a project to the produced/consumer id section below.","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"6d6ade21103200b0204bc994193c2447bc97d5d9","unresolved":false,"context_lines":[{"line_number":34,"context_line":"community image"},{"line_number":35,"context_line":"  An image that\u0027s been made accessible to all users, as described in"},{"line_number":36,"context_line":"  :ref:`one-all-sharing`.  Since version 2.5 of the API, the ``visibility``"},{"line_number":37,"context_line":"  property of such an image is ``community``.  (This type of image was not"},{"line_number":38,"context_line":"  available prior to version 2.5.)"},{"line_number":39,"context_line":""},{"line_number":40,"context_line":".. _one-one-sharing:"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_4cbf72d0","line":37,"range":{"start_line":37,"start_character":67,"end_line":37,"end_character":70},"updated":"2017-02-03 22:47:18.000000000","message":"will change to \u0027is\u0027 to be consistent with line 32","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":22448,"name":"Alexander Bashmakov","email":"abashmak@yahoo.com","username":"abashmak"},"change_message_id":"17b92fc09cd6e9fa2749c83e8abf2a0beadf4851","unresolved":false,"context_lines":[{"line_number":72,"context_line":"As an image producer, you know who you are, but how do you identify a potential"},{"line_number":73,"context_line":"consumer of your image?  As an image consumer, how do you refer to yourself,"},{"line_number":74,"context_line":"and if you want to consume community images, what do you use to identify the"},{"line_number":75,"context_line":"producer of an image you\u0027re looking for?  These are actually a complicated"},{"line_number":76,"context_line":"questions, because Glance allows an operator to decide whether images will be"},{"line_number":77,"context_line":"owned by *projects* or whether they will be owned by *users*.  (The default is"},{"line_number":78,"context_line":"that images are owned by *projects*, so that\u0027s what you\u0027ll see most often.)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_db6cfa9e","line":75,"range":{"start_line":75,"start_character":61,"end_line":75,"end_character":62},"updated":"2017-02-03 20:29:44.000000000","message":"nit: s/a //","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"6d6ade21103200b0204bc994193c2447bc97d5d9","unresolved":false,"context_lines":[{"line_number":72,"context_line":"As an image producer, you know who you are, but how do you identify a potential"},{"line_number":73,"context_line":"consumer of your image?  As an image consumer, how do you refer to yourself,"},{"line_number":74,"context_line":"and if you want to consume community images, what do you use to identify the"},{"line_number":75,"context_line":"producer of an image you\u0027re looking for?  These are actually a complicated"},{"line_number":76,"context_line":"questions, because Glance allows an operator to decide whether images will be"},{"line_number":77,"context_line":"owned by *projects* or whether they will be owned by *users*.  (The default is"},{"line_number":78,"context_line":"that images are owned by *projects*, so that\u0027s what you\u0027ll see most often.)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_6cb42ef2","line":75,"range":{"start_line":75,"start_character":61,"end_line":75,"end_character":62},"in_reply_to":"1a430d35_db6cfa9e","updated":"2017-02-03 22:47:18.000000000","message":"Done","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"0f78fd8ad8afa27d4c7a9dbe5590a45908a36af1","unresolved":false,"context_lines":[{"line_number":104,"context_line":"No provision is made in this API for producer-consumer communication."},{"line_number":105,"context_line":"All such communication must be done independently of the API."},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"An example workflow for shared images is:"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"1. The producer posts the availability of specific images on a public"},{"line_number":110,"context_line":"   website."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_47ee6d23","line":107,"range":{"start_line":107,"start_character":20,"end_line":107,"end_character":37},"updated":"2017-02-03 22:36:35.000000000","message":"nice. :)","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":22448,"name":"Alexander Bashmakov","email":"abashmak@yahoo.com","username":"abashmak"},"change_message_id":"17b92fc09cd6e9fa2749c83e8abf2a0beadf4851","unresolved":false,"context_lines":[{"line_number":405,"context_line":"        \"updated_at\": \"2014-02-20T04:15:17Z\""},{"line_number":406,"context_line":"    }"},{"line_number":407,"context_line":""},{"line_number":408,"context_line":"The image owner (the producer) may make this call successfully for each image"},{"line_number":409,"context_line":"member. An image member (a consumer) may make this call successfully only when"},{"line_number":410,"context_line":"MEMBER\\_ID is the correct identifier for that consumer. For any other"},{"line_number":411,"context_line":"MEMBER\\_ID, the consumer receives a 404 response."},{"line_number":412,"context_line":""},{"line_number":413,"context_line":"List Image Members"},{"line_number":414,"context_line":"^^^^^^^^^^^^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_dbadda89","line":411,"range":{"start_line":408,"start_character":0,"end_line":411,"end_character":49},"updated":"2017-02-03 20:29:44.000000000","message":"This is not clear to me. So a consumer can only show image membership for his/her self? Is there any reason to do that besides determining his/hers pending vs accepted status for that image?","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"0f78fd8ad8afa27d4c7a9dbe5590a45908a36af1","unresolved":false,"context_lines":[{"line_number":405,"context_line":"        \"updated_at\": \"2014-02-20T04:15:17Z\""},{"line_number":406,"context_line":"    }"},{"line_number":407,"context_line":""},{"line_number":408,"context_line":"The image owner (the producer) may make this call successfully for each image"},{"line_number":409,"context_line":"member. An image member (a consumer) may make this call successfully only when"},{"line_number":410,"context_line":"MEMBER\\_ID is the correct identifier for that consumer. For any other"},{"line_number":411,"context_line":"MEMBER\\_ID, the consumer receives a 404 response."},{"line_number":412,"context_line":""},{"line_number":413,"context_line":"List Image Members"},{"line_number":414,"context_line":"^^^^^^^^^^^^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_e74bd957","line":411,"range":{"start_line":408,"start_character":0,"end_line":411,"end_character":49},"in_reply_to":"1a430d35_dbadda89","updated":"2017-02-03 22:36:35.000000000","message":"Alex, only if the consumer has his/her PROJECT-ID/USER-ID \u003d\u003d MEMBER-ID for that shared image, this request will succeed.","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"6d6ade21103200b0204bc994193c2447bc97d5d9","unresolved":false,"context_lines":[{"line_number":405,"context_line":"        \"updated_at\": \"2014-02-20T04:15:17Z\""},{"line_number":406,"context_line":"    }"},{"line_number":407,"context_line":""},{"line_number":408,"context_line":"The image owner (the producer) may make this call successfully for each image"},{"line_number":409,"context_line":"member. An image member (a consumer) may make this call successfully only when"},{"line_number":410,"context_line":"MEMBER\\_ID is the correct identifier for that consumer. For any other"},{"line_number":411,"context_line":"MEMBER\\_ID, the consumer receives a 404 response."},{"line_number":412,"context_line":""},{"line_number":413,"context_line":"List Image Members"},{"line_number":414,"context_line":"^^^^^^^^^^^^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_cc79a231","line":411,"range":{"start_line":408,"start_character":0,"end_line":411,"end_character":49},"in_reply_to":"1a430d35_dbadda89","updated":"2017-02-03 22:47:18.000000000","message":"Yes, a consumer would only do this to see member status on the image.","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":22448,"name":"Alexander Bashmakov","email":"abashmak@yahoo.com","username":"abashmak"},"change_message_id":"17b92fc09cd6e9fa2749c83e8abf2a0beadf4851","unresolved":false,"context_lines":[{"line_number":516,"context_line":"   See :ref:`owner_is_tenant` for information about how to determine"},{"line_number":517,"context_line":"   an image producer\u0027s identifier."},{"line_number":518,"context_line":""},{"line_number":519,"context_line":"As mentioned earlier, no provision is made in this API for producer-consumer"},{"line_number":520,"context_line":"communication.  All such communication must be done independently of the API."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_9b26f214","line":519,"range":{"start_line":519,"start_character":0,"end_line":519,"end_character":20},"updated":"2017-02-03 20:29:44.000000000","message":"Where is this mentioned? Perhaps add a link here?","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"6d6ade21103200b0204bc994193c2447bc97d5d9","unresolved":false,"context_lines":[{"line_number":516,"context_line":"   See :ref:`owner_is_tenant` for information about how to determine"},{"line_number":517,"context_line":"   an image producer\u0027s identifier."},{"line_number":518,"context_line":""},{"line_number":519,"context_line":"As mentioned earlier, no provision is made in this API for producer-consumer"},{"line_number":520,"context_line":"communication.  All such communication must be done independently of the API."}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a430d35_8c031a73","line":519,"range":{"start_line":519,"start_character":0,"end_line":519,"end_character":20},"in_reply_to":"1a430d35_9b26f214","updated":"2017-02-03 22:47:18.000000000","message":"The section starting at line 101.\n\nI could put a link, but the sample workflow in that section is really just for shared images.  I may just eliminate the \"mentioned earlier\" and add a sample workflow down here to keep this self-contained.","commit_id":"17168daabe4d65cc61467ad68d4ae9856b2115f5"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"10949f45eeaf59b7fba13e1e88e7519a804a541e","unresolved":false,"context_lines":[{"line_number":43,"context_line":"------------------------------------"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Let the \"producer\" be the owner of image 71c675ab-d94f-49cd-a114-e12490b328d9,"},{"line_number":46,"context_line":"and let the \"consumer\" be a user who would like to boot an instance from that"},{"line_number":47,"context_line":"image."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"The producer can share the image with the consumer by making the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_e6524434","line":46,"range":{"start_line":46,"start_character":28,"end_line":46,"end_character":32},"updated":"2017-02-09 01:09:27.000000000","message":"The use of \u0027user\u0027 here confuses the note below about users vs projects. Further the owner sees the image and can boot an instance from that image, does that make them a consumer implicitly?","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"5b5a235a896a815287e2346bc128c6a72a84a563","unresolved":false,"context_lines":[{"line_number":43,"context_line":"------------------------------------"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Let the \"producer\" be the owner of image 71c675ab-d94f-49cd-a114-e12490b328d9,"},{"line_number":46,"context_line":"and let the \"consumer\" be a user who would like to boot an instance from that"},{"line_number":47,"context_line":"image."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"The producer can share the image with the consumer by making the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_e5a93a92","line":46,"range":{"start_line":46,"start_character":28,"end_line":46,"end_character":32},"in_reply_to":"1a430d35_a3aca98c","updated":"2017-02-09 16:55:42.000000000","message":"I\u0027m not sure I have a great suggestion but, \"anyone\" might work better than \"a user\".","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"d9a3c26aa2ea0884c4bc169e97b5dd3a43bd0aea","unresolved":false,"context_lines":[{"line_number":43,"context_line":"------------------------------------"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Let the \"producer\" be the owner of image 71c675ab-d94f-49cd-a114-e12490b328d9,"},{"line_number":46,"context_line":"and let the \"consumer\" be a user who would like to boot an instance from that"},{"line_number":47,"context_line":"image."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"The producer can share the image with the consumer by making the"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_a3aca98c","line":46,"range":{"start_line":46,"start_character":28,"end_line":46,"end_character":32},"in_reply_to":"1a430d35_e6524434","updated":"2017-02-09 03:35:51.000000000","message":"I think \u0027user\u0027 is correct here, because no matter whether the image is available to the user directly (if owner_is_tenant is False) or because it\u0027s available to the user because the user\u0027s in a project that the image has been shared with, an individual user is making the API call to boot an instance from the image.\n\nAn image owner could be a producer or consumer, it depends on what they want to do with the image at a particular time.  The producer is the \"sharer\" and the consumer is the \"sharee\".  I\u0027m not sure if there\u0027s a clearer way to say this, but you may have some ideas.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"10949f45eeaf59b7fba13e1e88e7519a804a541e","unresolved":false,"context_lines":[{"line_number":66,"context_line":""},{"line_number":67,"context_line":".. _owner_is_tenant:"},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"How do you identify a producer or consumer?"},{"line_number":70,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"As an image producer, you know who you are, but how do you identify a potential"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_66b2d4e6","line":69,"range":{"start_line":69,"start_character":1,"end_line":69,"end_character":43},"updated":"2017-02-09 01:09:27.000000000","message":"is there a more accurate title?","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"d9a3c26aa2ea0884c4bc169e97b5dd3a43bd0aea","unresolved":false,"context_lines":[{"line_number":66,"context_line":""},{"line_number":67,"context_line":".. _owner_is_tenant:"},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"How do you identify a producer or consumer?"},{"line_number":70,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"As an image producer, you know who you are, but how do you identify a potential"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_56c74195","line":69,"range":{"start_line":69,"start_character":1,"end_line":69,"end_character":43},"in_reply_to":"1a430d35_66b2d4e6","updated":"2017-02-09 03:35:51.000000000","message":"The section is about how you determine what identifier to use when you create an image member (or when you use the \u0027owner\u0027 filter on a list images call), so I think the title is pretty accurate.  (I am open to suggestions, though.)","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"10949f45eeaf59b7fba13e1e88e7519a804a541e","unresolved":false,"context_lines":[{"line_number":69,"context_line":"How do you identify a producer or consumer?"},{"line_number":70,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"As an image producer, you know who you are, but how do you identify a potential"},{"line_number":73,"context_line":"consumer of your image?  As an image consumer, how do you refer to yourself,"},{"line_number":74,"context_line":"and if you want to consume community images, what do you use to identify the"},{"line_number":75,"context_line":"producer of an image you\u0027re looking for?  These are actually complicated"},{"line_number":76,"context_line":"questions, because Glance allows an operator to decide whether images will be"},{"line_number":77,"context_line":"owned by *projects* or whether they will be owned by *users*.  (The default is"},{"line_number":78,"context_line":"that images are owned by *projects*, so that\u0027s what you\u0027ll see most often.)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_268e0c2e","line":75,"range":{"start_line":72,"start_character":0,"end_line":75,"end_character":40},"updated":"2017-02-09 01:09:27.000000000","message":"Existential discussion is fun but I\u0027m not sure this text adds anything to either clarifying ownership or \"identifying\" producers or consumers.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"d9a3c26aa2ea0884c4bc169e97b5dd3a43bd0aea","unresolved":false,"context_lines":[{"line_number":69,"context_line":"How do you identify a producer or consumer?"},{"line_number":70,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"As an image producer, you know who you are, but how do you identify a potential"},{"line_number":73,"context_line":"consumer of your image?  As an image consumer, how do you refer to yourself,"},{"line_number":74,"context_line":"and if you want to consume community images, what do you use to identify the"},{"line_number":75,"context_line":"producer of an image you\u0027re looking for?  These are actually complicated"},{"line_number":76,"context_line":"questions, because Glance allows an operator to decide whether images will be"},{"line_number":77,"context_line":"owned by *projects* or whether they will be owned by *users*.  (The default is"},{"line_number":78,"context_line":"that images are owned by *projects*, so that\u0027s what you\u0027ll see most often.)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_3659d535","line":75,"range":{"start_line":72,"start_character":0,"end_line":75,"end_character":40},"in_reply_to":"1a430d35_268e0c2e","updated":"2017-02-09 03:35:51.000000000","message":"I could remove the fun section, but I think this is a good way to get the reader to think about the issue, which is: when you create an image member, what do you do pass in the request? and when you want to search for images supplied by some particular producer, what do you put in the query string?","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"5b5a235a896a815287e2346bc128c6a72a84a563","unresolved":false,"context_lines":[{"line_number":69,"context_line":"How do you identify a producer or consumer?"},{"line_number":70,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"As an image producer, you know who you are, but how do you identify a potential"},{"line_number":73,"context_line":"consumer of your image?  As an image consumer, how do you refer to yourself,"},{"line_number":74,"context_line":"and if you want to consume community images, what do you use to identify the"},{"line_number":75,"context_line":"producer of an image you\u0027re looking for?  These are actually complicated"},{"line_number":76,"context_line":"questions, because Glance allows an operator to decide whether images will be"},{"line_number":77,"context_line":"owned by *projects* or whether they will be owned by *users*.  (The default is"},{"line_number":78,"context_line":"that images are owned by *projects*, so that\u0027s what you\u0027ll see most often.)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_85c0762c","line":75,"range":{"start_line":72,"start_character":0,"end_line":75,"end_character":40},"in_reply_to":"1a430d35_3659d535","updated":"2017-02-09 16:55:42.000000000","message":"I mainly have some concern that it won\u0027t work well for non native speakers, but just a concern.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"44f5096889cd66c59197e321b04faf3de763c454","unresolved":false,"context_lines":[{"line_number":72,"context_line":"As an image producer, you know who you are, but how do you identify a potential"},{"line_number":73,"context_line":"consumer of your image?  As an image consumer, how do you refer to yourself,"},{"line_number":74,"context_line":"and if you want to consume community images, what do you use to identify the"},{"line_number":75,"context_line":"producer of an image you\u0027re looking for?  These are actually complicated"},{"line_number":76,"context_line":"questions, because Glance allows an operator to decide whether images will be"},{"line_number":77,"context_line":"owned by *projects* or whether they will be owned by *users*.  (The default is"},{"line_number":78,"context_line":"that images are owned by *projects*, so that\u0027s what you\u0027ll see most often.)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"fa31d9ce_db516c10","line":75,"in_reply_to":"1a430d35_85c0762c","updated":"2017-02-10 05:00:36.000000000","message":"I didn\u0027t think of that.  Let\u0027s merge this and I\u0027ll put out a message on the i18n list asking whether this would be a problem for nonnative speakers, and if so, we can put up a new patch.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"10949f45eeaf59b7fba13e1e88e7519a804a541e","unresolved":false,"context_lines":[{"line_number":74,"context_line":"and if you want to consume community images, what do you use to identify the"},{"line_number":75,"context_line":"producer of an image you\u0027re looking for?  These are actually complicated"},{"line_number":76,"context_line":"questions, because Glance allows an operator to decide whether images will be"},{"line_number":77,"context_line":"owned by *projects* or whether they will be owned by *users*.  (The default is"},{"line_number":78,"context_line":"that images are owned by *projects*, so that\u0027s what you\u0027ll see most often.)"},{"line_number":79,"context_line":""},{"line_number":80,"context_line":".. note::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_a6f67c8c","line":77,"range":{"start_line":77,"start_character":63,"end_line":77,"end_character":64},"updated":"2017-02-09 01:09:27.000000000","message":"no real need for this to be paranthetical","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"d9a3c26aa2ea0884c4bc169e97b5dd3a43bd0aea","unresolved":false,"context_lines":[{"line_number":74,"context_line":"and if you want to consume community images, what do you use to identify the"},{"line_number":75,"context_line":"producer of an image you\u0027re looking for?  These are actually complicated"},{"line_number":76,"context_line":"questions, because Glance allows an operator to decide whether images will be"},{"line_number":77,"context_line":"owned by *projects* or whether they will be owned by *users*.  (The default is"},{"line_number":78,"context_line":"that images are owned by *projects*, so that\u0027s what you\u0027ll see most often.)"},{"line_number":79,"context_line":""},{"line_number":80,"context_line":".. note::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_b645c543","line":77,"range":{"start_line":77,"start_character":63,"end_line":77,"end_character":64},"in_reply_to":"1a430d35_a6f67c8c","updated":"2017-02-09 03:35:51.000000000","message":"OK","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"10949f45eeaf59b7fba13e1e88e7519a804a541e","unresolved":false,"context_lines":[{"line_number":82,"context_line":"   was the original OpenStack term for a project.  It\u0027s been phased out"},{"line_number":83,"context_line":"   because the word \"tenant\" in English is often used to refer to a person,"},{"line_number":84,"context_line":"   and this makes it easy to confuse a tenant with an *owner*.  But when"},{"line_number":85,"context_line":"   you hear someone say \"tenant\" or \"tenant ID\" in OpenStack, they really"},{"line_number":86,"context_line":"   mean \"project\" or \"project ID\"."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"* In clouds where an image owner is a *project*, the way to identify an image"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_c62e28a4","line":85,"range":{"start_line":85,"start_character":3,"end_line":85,"end_character":23},"updated":"2017-02-09 01:09:27.000000000","message":"documentation or members of the OpenStack community refer to a","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"d9a3c26aa2ea0884c4bc169e97b5dd3a43bd0aea","unresolved":false,"context_lines":[{"line_number":82,"context_line":"   was the original OpenStack term for a project.  It\u0027s been phased out"},{"line_number":83,"context_line":"   because the word \"tenant\" in English is often used to refer to a person,"},{"line_number":84,"context_line":"   and this makes it easy to confuse a tenant with an *owner*.  But when"},{"line_number":85,"context_line":"   you hear someone say \"tenant\" or \"tenant ID\" in OpenStack, they really"},{"line_number":86,"context_line":"   mean \"project\" or \"project ID\"."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"* In clouds where an image owner is a *project*, the way to identify an image"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_566bc1b6","line":85,"range":{"start_line":85,"start_character":3,"end_line":85,"end_character":23},"in_reply_to":"1a430d35_c62e28a4","updated":"2017-02-09 03:35:51.000000000","message":"good suggestion","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"10949f45eeaf59b7fba13e1e88e7519a804a541e","unresolved":false,"context_lines":[{"line_number":82,"context_line":"   was the original OpenStack term for a project.  It\u0027s been phased out"},{"line_number":83,"context_line":"   because the word \"tenant\" in English is often used to refer to a person,"},{"line_number":84,"context_line":"   and this makes it easy to confuse a tenant with an *owner*.  But when"},{"line_number":85,"context_line":"   you hear someone say \"tenant\" or \"tenant ID\" in OpenStack, they really"},{"line_number":86,"context_line":"   mean \"project\" or \"project ID\"."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"* In clouds where an image owner is a *project*, the way to identify an image"},{"line_number":89,"context_line":"  producer or consumer is to use their **project ID**."}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_717e0c6b","line":86,"range":{"start_line":85,"start_character":62,"end_line":86,"end_character":7},"updated":"2017-02-09 01:09:27.000000000","message":"should match the the subject and verb. if those are updated this should be too.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"d9a3c26aa2ea0884c4bc169e97b5dd3a43bd0aea","unresolved":false,"context_lines":[{"line_number":82,"context_line":"   was the original OpenStack term for a project.  It\u0027s been phased out"},{"line_number":83,"context_line":"   because the word \"tenant\" in English is often used to refer to a person,"},{"line_number":84,"context_line":"   and this makes it easy to confuse a tenant with an *owner*.  But when"},{"line_number":85,"context_line":"   you hear someone say \"tenant\" or \"tenant ID\" in OpenStack, they really"},{"line_number":86,"context_line":"   mean \"project\" or \"project ID\"."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"* In clouds where an image owner is a *project*, the way to identify an image"},{"line_number":89,"context_line":"  producer or consumer is to use their **project ID**."}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_167bf97b","line":86,"range":{"start_line":85,"start_character":62,"end_line":86,"end_character":7},"in_reply_to":"1a430d35_717e0c6b","updated":"2017-02-09 03:35:51.000000000","message":"Your suggestion above will make the subject plural, so that will fix this problem, too.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"10949f45eeaf59b7fba13e1e88e7519a804a541e","unresolved":false,"context_lines":[{"line_number":102,"context_line":"    to have access to the image."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Note that image producers or consumers do *not* get to decide which identifier"},{"line_number":105,"context_line":"to use.  This is decided for the entire cloud by the cloud administrator."},{"line_number":106,"context_line":"Consult your cloud\u0027s local documentation to find out which applies in a"},{"line_number":107,"context_line":"particular cloud you\u0027re using.  (As mentioned above, the default is that images"},{"line_number":108,"context_line":"are owned by *projects*, so if the local documentation doesn\u0027t say anything,"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_f14f5c31","line":105,"range":{"start_line":105,"start_character":46,"end_line":105,"end_character":73},"updated":"2017-02-09 01:09:27.000000000","message":"I would like to have a reference (probably a link) to the mechanism for specifying that here. Not really necessary and questionably appropriate for this document, but hyperlinks are awesome.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"44f5096889cd66c59197e321b04faf3de763c454","unresolved":false,"context_lines":[{"line_number":102,"context_line":"    to have access to the image."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Note that image producers or consumers do *not* get to decide which identifier"},{"line_number":105,"context_line":"to use.  This is decided for the entire cloud by the cloud administrator."},{"line_number":106,"context_line":"Consult your cloud\u0027s local documentation to find out which applies in a"},{"line_number":107,"context_line":"particular cloud you\u0027re using.  (As mentioned above, the default is that images"},{"line_number":108,"context_line":"are owned by *projects*, so if the local documentation doesn\u0027t say anything,"}],"source_content_type":"text/x-rst","patch_set":4,"id":"fa31d9ce_bbcf58b2","line":105,"in_reply_to":"1a430d35_d6d2515b","updated":"2017-02-10 05:00:36.000000000","message":"I\u0027m going to leave this as-is, because I\u0027m stressing to the reader that they don\u0027t get to choose how it works, and linking to a config option they can\u0027t change would be confusing.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"d9a3c26aa2ea0884c4bc169e97b5dd3a43bd0aea","unresolved":false,"context_lines":[{"line_number":102,"context_line":"    to have access to the image."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Note that image producers or consumers do *not* get to decide which identifier"},{"line_number":105,"context_line":"to use.  This is decided for the entire cloud by the cloud administrator."},{"line_number":106,"context_line":"Consult your cloud\u0027s local documentation to find out which applies in a"},{"line_number":107,"context_line":"particular cloud you\u0027re using.  (As mentioned above, the default is that images"},{"line_number":108,"context_line":"are owned by *projects*, so if the local documentation doesn\u0027t say anything,"}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_d6d2515b","line":105,"range":{"start_line":105,"start_character":46,"end_line":105,"end_character":73},"in_reply_to":"1a430d35_f14f5c31","updated":"2017-02-09 03:35:51.000000000","message":"I\u0027m not sure about that either.  I\u0027m not entirely clear on who exactly these \"narrative\" API docs are aimed at, to tell you the truth, though I think they\u0027re aimed at API consumers (who could be administrators, but aren\u0027t necessarily).","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"5b5a235a896a815287e2346bc128c6a72a84a563","unresolved":false,"context_lines":[{"line_number":546,"context_line":"   call as in the example above to discover the available images and to"},{"line_number":547,"context_line":"   determine the UUID of an image to be consumed."},{"line_number":548,"context_line":""},{"line_number":549,"context_line":"3. The consumer uses the UUID in Images v2 API calls to access the image."}],"source_content_type":"text/x-rst","patch_set":4,"id":"1a430d35_74e6d945","line":549,"updated":"2017-02-09 16:55:42.000000000","message":"It might be valuable to add another note to the effect that image names are not unique and so the use of an image name to identify a community image from the image-list call is potentially unsafe.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"44f5096889cd66c59197e321b04faf3de763c454","unresolved":false,"context_lines":[{"line_number":546,"context_line":"   call as in the example above to discover the available images and to"},{"line_number":547,"context_line":"   determine the UUID of an image to be consumed."},{"line_number":548,"context_line":""},{"line_number":549,"context_line":"3. The consumer uses the UUID in Images v2 API calls to access the image."}],"source_content_type":"text/x-rst","patch_set":4,"id":"fa31d9ce_fbc9d0ad","line":549,"in_reply_to":"1a430d35_74e6d945","updated":"2017-02-10 05:00:36.000000000","message":"That\u0027s a really good point, I\u0027ll add something.","commit_id":"8ed1c19d8914383fd30511f5c44cee2f4a6c73cd"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"83c38cd59f342533ec41329b777bed815bc21437","unresolved":false,"context_lines":[{"line_number":527,"context_line":"   an image producer\u0027s identifier."},{"line_number":528,"context_line":""},{"line_number":529,"context_line":"Keep in mind that the ``name`` property of an image is not required to be"},{"line_number":530,"context_line":"unique, so filtering by name may result in multiple hits.  If you want to find"},{"line_number":531,"context_line":"only images supplied by some particular producer, filtering by ``owner`` will"},{"line_number":532,"context_line":"give you more accurate results."},{"line_number":533,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"fa31d9ce_a41f25b6","line":530,"range":{"start_line":530,"start_character":43,"end_line":530,"end_character":56},"updated":"2017-02-16 20:14:03.000000000","message":"matches seems better than hits.\n\nI feel like there is an unaddressed concern lurking here still, with respect to image names being retired and reused in a way which creates a security risk. That isn\u0027t a multiple-match situation.","commit_id":"666915d614308053049e525e04e034fc1c72794b"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"b7c354cdb81b034a0a945a6792ea0cfb59c848e7","unresolved":false,"context_lines":[{"line_number":527,"context_line":"   an image producer\u0027s identifier."},{"line_number":528,"context_line":""},{"line_number":529,"context_line":"Keep in mind that the ``name`` property of an image is not required to be"},{"line_number":530,"context_line":"unique, so filtering by name may result in multiple hits.  If you want to find"},{"line_number":531,"context_line":"only images supplied by some particular producer, filtering by ``owner`` will"},{"line_number":532,"context_line":"give you more accurate results."},{"line_number":533,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"fa31d9ce_c6e33e04","line":530,"range":{"start_line":530,"start_character":43,"end_line":530,"end_character":56},"in_reply_to":"fa31d9ce_a41f25b6","updated":"2017-02-16 20:34:06.000000000","message":"Yeah, I\u0027ve got elasticsearch on my brain.  Matches is better.\n\nGood point about the name re-use problem.  I\u0027ll rewrite this section.","commit_id":"666915d614308053049e525e04e034fc1c72794b"},{"author":{"_account_id":21722,"name":"Dharini Chandrasekar","email":"dharini.chandrasekar@intel.com","username":"dharinic"},"change_message_id":"3ffe818542dd5f414be8285cda42e6cbaed0e5c7","unresolved":false,"context_lines":[{"line_number":26,"context_line":"  A user who wants to use an image."},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"shared image"},{"line_number":29,"context_line":"  An image that\u0027s been made accessible to specific other users, as described in"},{"line_number":30,"context_line":"  :ref:`one-one-sharing`.  Since version 2.5 of the API, the ``visibility``"},{"line_number":31,"context_line":"  property of such an image is ``shared``.  (If you are using a prior version"},{"line_number":32,"context_line":"  of the API, the ``visibility`` is ``private``.)"}],"source_content_type":"text/x-rst","patch_set":6,"id":"fa31d9ce_40172e54","line":29,"range":{"start_line":29,"start_character":51,"end_line":29,"end_character":62},"updated":"2017-02-17 00:11:59.000000000","message":"Nit: other users of the cloud","commit_id":"fbdd3381ca2f05e340b0439abdbcacfe7d88fd89"}]}
