)]}'
{"api-ref/source/parameters.yaml":[{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"8451dfea71f0aa64a2988a1bbbd51928e7068465","unresolved":false,"context_lines":[{"line_number":1791,"context_line":"  type: array"},{"line_number":1792,"context_line":"block_device_uuid:"},{"line_number":1793,"context_line":"  description: |"},{"line_number":1794,"context_line":"    This is the uuid of source resource. The uuid is point to different resource"},{"line_number":1795,"context_line":"    based on the ``source_type``. For example, if ``source_type`` is ``image``,"},{"line_number":1796,"context_line":"    the block device is created based on the specified image which is retrieved"},{"line_number":1797,"context_line":"    from the image service. Similarly, if ``source_type`` is ``snapshot`` then"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_aab06e41","line":1794,"range":{"start_line":1794,"start_character":50,"end_line":1794,"end_character":80},"updated":"2018-06-12 19:21:52.000000000","message":"points to different resources?","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"8168f85741e3606296e4587ba985f235161dcd53","unresolved":false,"context_lines":[{"line_number":1791,"context_line":"  type: array"},{"line_number":1792,"context_line":"block_device_uuid:"},{"line_number":1793,"context_line":"  description: |"},{"line_number":1794,"context_line":"    This is the uuid of source resource. The uuid is point to different resource"},{"line_number":1795,"context_line":"    based on the ``source_type``. For example, if ``source_type`` is ``image``,"},{"line_number":1796,"context_line":"    the block device is created based on the specified image which is retrieved"},{"line_number":1797,"context_line":"    from the image service. Similarly, if ``source_type`` is ``snapshot`` then"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_becbcfa1","line":1794,"range":{"start_line":1794,"start_character":50,"end_line":1794,"end_character":80},"in_reply_to":"5f7c97a3_aab06e41","updated":"2018-06-12 23:06:29.000000000","message":"Sure, might as well while I\u0027m in here.","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"8451dfea71f0aa64a2988a1bbbd51928e7068465","unresolved":false,"context_lines":[{"line_number":2123,"context_line":"  type: string"},{"line_number":2124,"context_line":"destination_type:"},{"line_number":2125,"context_line":"  description: |"},{"line_number":2126,"context_line":"    Defines where the block device mapping will reside. Value values are:"},{"line_number":2127,"context_line":""},{"line_number":2128,"context_line":"    * ``local``: The ephemeral disk resides local to the compute host on"},{"line_number":2129,"context_line":"      which the server runs"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_6aed7623","line":2126,"range":{"start_line":2126,"start_character":56,"end_line":2126,"end_character":61},"updated":"2018-06-12 19:21:52.000000000","message":"Valid","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"8168f85741e3606296e4587ba985f235161dcd53","unresolved":false,"context_lines":[{"line_number":2123,"context_line":"  type: string"},{"line_number":2124,"context_line":"destination_type:"},{"line_number":2125,"context_line":"  description: |"},{"line_number":2126,"context_line":"    Defines where the block device mapping will reside. Value values are:"},{"line_number":2127,"context_line":""},{"line_number":2128,"context_line":"    * ``local``: The ephemeral disk resides local to the compute host on"},{"line_number":2129,"context_line":"      which the server runs"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_5ec63b9c","line":2126,"range":{"start_line":2126,"start_character":56,"end_line":2126,"end_character":61},"in_reply_to":"5f7c97a3_6aed7623","updated":"2018-06-12 23:06:29.000000000","message":"heh, yup","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"8451dfea71f0aa64a2988a1bbbd51928e7068465","unresolved":false,"context_lines":[{"line_number":3132,"context_line":"  description: |"},{"line_number":3133,"context_line":"    Specifies the guest server disk file system format, such as ``ext2``,"},{"line_number":3134,"context_line":"    ``ext3``, ``ext4``, ``xfs`` or ``swap``. This parameter affects only"},{"line_number":3135,"context_line":"    the libvirt virt driver when a value other than ``swap`` is used."},{"line_number":3136,"context_line":""},{"line_number":3137,"context_line":"    Swap block device mappings have the following restrictions:"},{"line_number":3138,"context_line":""}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_caddaa70","line":3135,"range":{"start_line":3135,"start_character":28,"end_line":3135,"end_character":69},"updated":"2018-06-12 19:21:52.000000000","message":"meaning that ``swap`` affects other drivers?","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"8168f85741e3606296e4587ba985f235161dcd53","unresolved":false,"context_lines":[{"line_number":3132,"context_line":"  description: |"},{"line_number":3133,"context_line":"    Specifies the guest server disk file system format, such as ``ext2``,"},{"line_number":3134,"context_line":"    ``ext3``, ``ext4``, ``xfs`` or ``swap``. This parameter affects only"},{"line_number":3135,"context_line":"    the libvirt virt driver when a value other than ``swap`` is used."},{"line_number":3136,"context_line":""},{"line_number":3137,"context_line":"    Swap block device mappings have the following restrictions:"},{"line_number":3138,"context_line":""}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_de37abaf","line":3135,"range":{"start_line":3135,"start_character":28,"end_line":3135,"end_character":69},"in_reply_to":"5f7c97a3_caddaa70","updated":"2018-06-12 23:06:29.000000000","message":"Meaning that swap is driver agnostic. Only the libvirt driver looks at the guest_format for non-swap ephemeral block devices and creates a file system. I\u0027m not sure how to word this better. I\u0027m not really sure it needs to be said at all honestly, it just seems confusing to me.","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"8451dfea71f0aa64a2988a1bbbd51928e7068465","unresolved":false,"context_lines":[{"line_number":3138,"context_line":""},{"line_number":3139,"context_line":"    * The ``source_type`` must be ``blank``"},{"line_number":3140,"context_line":"    * The ``destination_type`` must be ``local``"},{"line_number":3141,"context_line":"    * There can only be one swap disk per server"},{"line_number":3142,"context_line":"    * The size of the swap disk must be less than or equal to the ``swap``"},{"line_number":3143,"context_line":"      size of the flavor"},{"line_number":3144,"context_line":"  in: body"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_0ac962aa","line":3141,"range":{"start_line":3141,"start_character":6,"end_line":3141,"end_character":27},"updated":"2018-06-12 19:21:52.000000000","message":"https://i.pinimg.com/originals/f1/40/bf/f140bf892f522c48b629d4c802b1dff1.jpg","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"8168f85741e3606296e4587ba985f235161dcd53","unresolved":false,"context_lines":[{"line_number":3138,"context_line":""},{"line_number":3139,"context_line":"    * The ``source_type`` must be ``blank``"},{"line_number":3140,"context_line":"    * The ``destination_type`` must be ``local``"},{"line_number":3141,"context_line":"    * There can only be one swap disk per server"},{"line_number":3142,"context_line":"    * The size of the swap disk must be less than or equal to the ``swap``"},{"line_number":3143,"context_line":"      size of the flavor"},{"line_number":3144,"context_line":"  in: body"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_5e4b9b29","line":3141,"range":{"start_line":3141,"start_character":6,"end_line":3141,"end_character":27},"in_reply_to":"5f7c97a3_0ac962aa","updated":"2018-06-12 23:06:29.000000000","message":"HIGHLANDER!!!","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"8451dfea71f0aa64a2988a1bbbd51928e7068465","unresolved":false,"context_lines":[{"line_number":5945,"context_line":"  type: array"},{"line_number":5946,"context_line":"source_type:"},{"line_number":5947,"context_line":"  description: |"},{"line_number":5948,"context_line":"    The source type of the block device. Value values are:"},{"line_number":5949,"context_line":""},{"line_number":5950,"context_line":"    * ``blank``: Depending on the ``destination_type`` and ``guest_format``,"},{"line_number":5951,"context_line":"      this will either be a blank persistent volume or an ephemeral (or swap)"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_cac60a9b","line":5948,"range":{"start_line":5948,"start_character":41,"end_line":5948,"end_character":46},"updated":"2018-06-12 19:21:52.000000000","message":"Valid","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"8168f85741e3606296e4587ba985f235161dcd53","unresolved":false,"context_lines":[{"line_number":5945,"context_line":"  type: array"},{"line_number":5946,"context_line":"source_type:"},{"line_number":5947,"context_line":"  description: |"},{"line_number":5948,"context_line":"    The source type of the block device. Value values are:"},{"line_number":5949,"context_line":""},{"line_number":5950,"context_line":"    * ``blank``: Depending on the ``destination_type`` and ``guest_format``,"},{"line_number":5951,"context_line":"      this will either be a blank persistent volume or an ephemeral (or swap)"}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_7e469723","line":5948,"range":{"start_line":5948,"start_character":41,"end_line":5948,"end_character":46},"in_reply_to":"5f7c97a3_cac60a9b","updated":"2018-06-12 23:06:29.000000000","message":"Done","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"8451dfea71f0aa64a2988a1bbbd51928e7068465","unresolved":false,"context_lines":[{"line_number":5960,"context_line":"      the existing persistent volume referenced via the"},{"line_number":5961,"context_line":"      ``block_device_mapping_v2.uuid`` parameter and attaches it to the server"},{"line_number":5962,"context_line":""},{"line_number":5963,"context_line":"    This parameter is required unless ``no_device`` is specified."},{"line_number":5964,"context_line":""},{"line_number":5965,"context_line":"    See `Block Device Mapping in Nova \u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_"},{"line_number":5966,"context_line":"    for more details on valid source and destination types."}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_aab70e21","line":5963,"range":{"start_line":5963,"start_character":38,"end_line":5963,"end_character":64},"updated":"2018-06-12 19:21:52.000000000","message":"where?","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"8168f85741e3606296e4587ba985f235161dcd53","unresolved":false,"context_lines":[{"line_number":5960,"context_line":"      the existing persistent volume referenced via the"},{"line_number":5961,"context_line":"      ``block_device_mapping_v2.uuid`` parameter and attaches it to the server"},{"line_number":5962,"context_line":""},{"line_number":5963,"context_line":"    This parameter is required unless ``no_device`` is specified."},{"line_number":5964,"context_line":""},{"line_number":5965,"context_line":"    See `Block Device Mapping in Nova \u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_"},{"line_number":5966,"context_line":"    for more details on valid source and destination types."}],"source_content_type":"text/x-yaml","patch_set":1,"id":"5f7c97a3_de600ba8","line":5963,"range":{"start_line":5963,"start_character":38,"end_line":5963,"end_character":64},"in_reply_to":"5f7c97a3_aab70e21","updated":"2018-06-12 23:06:29.000000000","message":"Should be ``block_device_mapping_v2.no_device`` - it\u0027s a parameter in the same bdm dict-o-doom.","commit_id":"3606b1e707f32216f6c92d55169590079332aa50"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"bec9dff54e2e8546850f6e3187dfa894e3b4400a","unresolved":false,"context_lines":[{"line_number":4555,"context_line":"  min_version: 2.48"},{"line_number":4556,"context_line":"no_device:"},{"line_number":4557,"context_line":"  description: |"},{"line_number":4558,"context_line":"    It is no device if ``True``."},{"line_number":4559,"context_line":"  in: body"},{"line_number":4560,"context_line":"  required: false"},{"line_number":4561,"context_line":"  type: boolean"}],"source_content_type":"text/x-yaml","patch_set":2,"id":"5f7c97a3_24bc89b9","line":4558,"updated":"2018-06-13 07:50:51.000000000","message":"is this the no device you are referring to below? Can we enhance this description as well? When does an API user need to use no_device in a bdm?","commit_id":"c8edb8ce72759007b9ce5fbe4fbd5b9c5724e17b"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"ef6480d6eaa7e7f3619dd3937310ec2e08b54149","unresolved":false,"context_lines":[{"line_number":4555,"context_line":"  min_version: 2.48"},{"line_number":4556,"context_line":"no_device:"},{"line_number":4557,"context_line":"  description: |"},{"line_number":4558,"context_line":"    It is no device if ``True``."},{"line_number":4559,"context_line":"  in: body"},{"line_number":4560,"context_line":"  required: false"},{"line_number":4561,"context_line":"  type: boolean"}],"source_content_type":"text/x-yaml","patch_set":2,"id":"5f7c97a3_45c6569c","line":4558,"in_reply_to":"5f7c97a3_24bc89b9","updated":"2018-06-13 15:19:57.000000000","message":"I hate this description but I don\u0027t have great words for it off the top of my head, it would require some investigation for when this is used and actually useful.","commit_id":"c8edb8ce72759007b9ce5fbe4fbd5b9c5724e17b"}]}