)]}'
{"api-guide/source/server_concepts.rst":[{"author":{"_account_id":15888,"name":"Zhenyu Zheng","email":"zheng.zhenyu@outlook.com","username":"Kevin_Zheng"},"change_message_id":"90d1691d0d4861add89178fd433443e196b45f8d","unresolved":false,"context_lines":[{"line_number":592,"context_line":"Block Device Mapping"},{"line_number":593,"context_line":"~~~~~~~~~~~~~~~~~~~~"},{"line_number":594,"context_line":""},{"line_number":595,"context_line":"Simple speaking, Block Device Mapping is how the `cloud` block devices been"},{"line_number":596,"context_line":"exposed to the cloud server, there are 2 version of block device mapping,"},{"line_number":597,"context_line":"see `Block Device Mapping \u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":598,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"ff82abbf_4f6ff591","line":595,"range":{"start_line":595,"start_character":0,"end_line":595,"end_character":6},"updated":"2017-11-22 07:22:07.000000000","message":"simply?","commit_id":"3cdd0dea40c3c9a8247dc533d6e08233f1938753"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"e11e6a2716759b3008c4a32694a2bf64b0067a74","unresolved":false,"context_lines":[{"line_number":592,"context_line":"Block Device Mapping"},{"line_number":593,"context_line":"~~~~~~~~~~~~~~~~~~~~"},{"line_number":594,"context_line":""},{"line_number":595,"context_line":"Simple speaking, Block Device Mapping is how the `cloud` block devices been"},{"line_number":596,"context_line":"exposed to the cloud server, there are 2 version of block device mapping,"},{"line_number":597,"context_line":"see `Block Device Mapping \u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":598,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"ff82abbf_fc7ead69","line":595,"range":{"start_line":595,"start_character":0,"end_line":595,"end_character":6},"in_reply_to":"ff82abbf_4f6ff591","updated":"2017-11-27 00:26:15.000000000","message":"Done","commit_id":"3cdd0dea40c3c9a8247dc533d6e08233f1938753"},{"author":{"_account_id":15888,"name":"Zhenyu Zheng","email":"zheng.zhenyu@outlook.com","username":"Kevin_Zheng"},"change_message_id":"b2461d75d60e3c456364ae7b709a3a4e690fb6f6","unresolved":false,"context_lines":[{"line_number":608,"context_line":""},{"line_number":609,"context_line":"This will create a 100G size volume type block device from an image, it will"},{"line_number":610,"context_line":"be used as first order boot device (boot_index\u003d0), and this block device will"},{"line_number":611,"context_line":"not be deleted if we terminate the Nova instance."},{"line_number":612,"context_line":""},{"line_number":613,"context_line":".. code-block:: Json"},{"line_number":614,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"ff82abbf_aa69b38b","line":611,"range":{"start_line":611,"start_character":40,"end_line":611,"end_character":48},"updated":"2017-11-23 03:29:15.000000000","message":"server? for consistancy","commit_id":"c938cce5f15e3ba21661b73b80c59409cfe77db0"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"518da3081e16324505caed6210f4b5add10c80de","unresolved":false,"context_lines":[{"line_number":616,"context_line":"        \"block_device_mapping\": ["},{"line_number":617,"context_line":"            {"},{"line_number":618,"context_line":"                \"boot_index\": \"0\""},{"line_number":619,"context_line":"                \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","},{"line_number":620,"context_line":"                \"volume_size\": \"100\","},{"line_number":621,"context_line":"                \"source_type\": \"image\","},{"line_number":622,"context_line":"                \"destination_type\": \"volume\","}],"source_content_type":"text/x-rst","patch_set":4,"id":"ff82abbf_f03a4c32","line":619,"range":{"start_line":619,"start_character":25,"end_line":619,"end_character":61},"updated":"2017-11-23 05:53:46.000000000","message":"Add some words to indicate this is the uuid of image, that will help the reader understand this example.","commit_id":"2d0ef88afd3a1303cc17b0dbab2861b54626693e"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"6233d5a3a9e7aca0db63a375357f41f50903216c","unresolved":false,"context_lines":[{"line_number":601,"context_line":"- Guest format"},{"line_number":602,"context_line":"- Device type"},{"line_number":603,"context_line":"- Disk bus"},{"line_number":604,"context_line":"- Shutdown action"},{"line_number":605,"context_line":"- Boot order"},{"line_number":606,"context_line":""},{"line_number":607,"context_line":"**Example**"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_78f8497a","line":604,"range":{"start_line":604,"start_character":2,"end_line":604,"end_character":17},"updated":"2017-11-24 07:21:04.000000000","message":"this might lead user to think it\u0027s shutdown the volume?","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"e11e6a2716759b3008c4a32694a2bf64b0067a74","unresolved":false,"context_lines":[{"line_number":601,"context_line":"- Guest format"},{"line_number":602,"context_line":"- Device type"},{"line_number":603,"context_line":"- Disk bus"},{"line_number":604,"context_line":"- Shutdown action"},{"line_number":605,"context_line":"- Boot order"},{"line_number":606,"context_line":""},{"line_number":607,"context_line":"**Example**"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_dd028e3d","line":604,"range":{"start_line":604,"start_character":2,"end_line":604,"end_character":17},"in_reply_to":"ff82abbf_78f8497a","updated":"2017-11-27 00:26:15.000000000","message":"This is the server shutdown action \"delete_on_termination\"","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"82fc78a2dfea447e3e1a954940ffa7bec8cac4fa","unresolved":false,"context_lines":[{"line_number":603,"context_line":"- Disk bus"},{"line_number":604,"context_line":"- Shutdown action"},{"line_number":605,"context_line":"- Boot order"},{"line_number":606,"context_line":""},{"line_number":607,"context_line":"**Example**"},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"This will create a 100G size volume type block device from an image(uuid is"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_cf25f75d","line":606,"range":{"start_line":606,"start_character":0,"end_line":606,"end_character":0},"updated":"2017-11-25 12:41:10.000000000","message":"can we mention about 2 available options for BDM and those cannot be specified together in same request. \ndifference of those and why 2 make it more useful doc for user.","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"e11e6a2716759b3008c4a32694a2bf64b0067a74","unresolved":false,"context_lines":[{"line_number":603,"context_line":"- Disk bus"},{"line_number":604,"context_line":"- Shutdown action"},{"line_number":605,"context_line":"- Boot order"},{"line_number":606,"context_line":""},{"line_number":607,"context_line":"**Example**"},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"This will create a 100G size volume type block device from an image(uuid is"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_7dfb4246","line":606,"range":{"start_line":606,"start_character":0,"end_line":606,"end_character":0},"in_reply_to":"ff82abbf_cf25f75d","updated":"2017-11-27 00:26:15.000000000","message":"Sure, I think you are taking about the bdm and bdm_v2 ?","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"6233d5a3a9e7aca0db63a375357f41f50903216c","unresolved":false,"context_lines":[{"line_number":608,"context_line":""},{"line_number":609,"context_line":"This will create a 100G size volume type block device from an image(uuid is"},{"line_number":610,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as first order boot"},{"line_number":611,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":612,"context_line":"terminate the Nova server."},{"line_number":613,"context_line":""},{"line_number":614,"context_line":".. code-block:: Json"}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_d8de3510","line":611,"range":{"start_line":611,"start_character":71,"end_line":611,"end_character":73},"updated":"2017-11-24 07:21:04.000000000","message":"s/we/d","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"82fc78a2dfea447e3e1a954940ffa7bec8cac4fa","unresolved":false,"context_lines":[{"line_number":608,"context_line":""},{"line_number":609,"context_line":"This will create a 100G size volume type block device from an image(uuid is"},{"line_number":610,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as first order boot"},{"line_number":611,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":612,"context_line":"terminate the Nova server."},{"line_number":613,"context_line":""},{"line_number":614,"context_line":".. code-block:: Json"},{"line_number":615,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_0f30bf9e","line":612,"range":{"start_line":611,"start_character":65,"end_line":612,"end_character":26},"updated":"2017-11-25 12:41:10.000000000","message":"\"after server is terminated\"","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"6233d5a3a9e7aca0db63a375357f41f50903216c","unresolved":false,"context_lines":[{"line_number":609,"context_line":"This will create a 100G size volume type block device from an image(uuid is"},{"line_number":610,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as first order boot"},{"line_number":611,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":612,"context_line":"terminate the Nova server."},{"line_number":613,"context_line":""},{"line_number":614,"context_line":".. code-block:: Json"},{"line_number":615,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_f8e3f9d7","line":612,"range":{"start_line":612,"start_character":14,"end_line":612,"end_character":18},"updated":"2017-11-24 07:21:04.000000000","message":"s/Nova/d","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"e11e6a2716759b3008c4a32694a2bf64b0067a74","unresolved":false,"context_lines":[{"line_number":608,"context_line":""},{"line_number":609,"context_line":"This will create a 100G size volume type block device from an image(uuid is"},{"line_number":610,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as first order boot"},{"line_number":611,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":612,"context_line":"terminate the Nova server."},{"line_number":613,"context_line":""},{"line_number":614,"context_line":".. code-block:: Json"},{"line_number":615,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_9df88649","line":612,"range":{"start_line":611,"start_character":65,"end_line":612,"end_character":26},"in_reply_to":"ff82abbf_0f30bf9e","updated":"2017-11-27 00:26:15.000000000","message":"sure","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"82fc78a2dfea447e3e1a954940ffa7bec8cac4fa","unresolved":false,"context_lines":[{"line_number":614,"context_line":".. code-block:: Json"},{"line_number":615,"context_line":""},{"line_number":616,"context_line":"    {"},{"line_number":617,"context_line":"        \"block_device_mapping\": ["},{"line_number":618,"context_line":"            {"},{"line_number":619,"context_line":"                \"boot_index\": \"0\""},{"line_number":620,"context_line":"                \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_2f35838f","line":617,"range":{"start_line":617,"start_character":9,"end_line":617,"end_character":29},"updated":"2017-11-25 12:41:10.000000000","message":"can we give example for \u0027block_device_mapping_v2\u0027","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"e11e6a2716759b3008c4a32694a2bf64b0067a74","unresolved":false,"context_lines":[{"line_number":614,"context_line":".. code-block:: Json"},{"line_number":615,"context_line":""},{"line_number":616,"context_line":"    {"},{"line_number":617,"context_line":"        \"block_device_mapping\": ["},{"line_number":618,"context_line":"            {"},{"line_number":619,"context_line":"                \"boot_index\": \"0\""},{"line_number":620,"context_line":"                \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_5d9c3e0e","line":617,"range":{"start_line":617,"start_character":9,"end_line":617,"end_character":29},"in_reply_to":"ff82abbf_2f35838f","updated":"2017-11-27 00:26:15.000000000","message":"hmm. this is just api guide, if user are more interested with api(s), they can search for api-ref to read ? make sense?","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"e92db18bead1011271d7a8422a4351b2c48adaa2","unresolved":false,"context_lines":[{"line_number":614,"context_line":".. code-block:: Json"},{"line_number":615,"context_line":""},{"line_number":616,"context_line":"    {"},{"line_number":617,"context_line":"        \"block_device_mapping\": ["},{"line_number":618,"context_line":"            {"},{"line_number":619,"context_line":"                \"boot_index\": \"0\""},{"line_number":620,"context_line":"                \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff82abbf_9b5e4e10","line":617,"range":{"start_line":617,"start_character":9,"end_line":617,"end_character":29},"in_reply_to":"ff82abbf_2f35838f","updated":"2017-11-27 02:38:55.000000000","message":"ops, I think I\u0027v made a mistake, this should be block_device_mapping_v2, after checking the schema from https://github.com/openstack/nova/blob/master/nova/api/openstack/compute/schemas/block_device_mapping.py#L26","commit_id":"47595a4dfe8600ac33c5fac0c2a9e4d914b32f78"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"2150c641d9864325bfb7cd6df32e8b478e059917","unresolved":false,"context_lines":[{"line_number":606,"context_line":"exposed to the server. There are some desirable independent attributes in Block"},{"line_number":607,"context_line":"Device Mapping:"},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"- Source type"},{"line_number":610,"context_line":"- Destination type"},{"line_number":611,"context_line":"- Guest format"},{"line_number":612,"context_line":"- Device type"},{"line_number":613,"context_line":"- Disk bus"},{"line_number":614,"context_line":"- Shutdown action (delete device or not)"},{"line_number":615,"context_line":"- Boot order"},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"For some historical reasons, Nova has 2 version of block device mapping,"},{"line_number":618,"context_line":"``block_device_mapping`` and ``block_device_mapping_v2``, user can not"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_16cf73b0","line":615,"range":{"start_line":609,"start_character":0,"end_line":615,"end_character":12},"updated":"2017-11-27 03:58:51.000000000","message":"are those all in v1 ?","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"1a1c42aefccba33c67b198339c1342f3c66bdac4","unresolved":false,"context_lines":[{"line_number":606,"context_line":"exposed to the server. There are some desirable independent attributes in Block"},{"line_number":607,"context_line":"Device Mapping:"},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"- Source type"},{"line_number":610,"context_line":"- Destination type"},{"line_number":611,"context_line":"- Guest format"},{"line_number":612,"context_line":"- Device type"},{"line_number":613,"context_line":"- Disk bus"},{"line_number":614,"context_line":"- Shutdown action (delete device or not)"},{"line_number":615,"context_line":"- Boot order"},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"For some historical reasons, Nova has 2 version of block device mapping,"},{"line_number":618,"context_line":"``block_device_mapping`` and ``block_device_mapping_v2``, user can not"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_ce672fb7","line":615,"range":{"start_line":609,"start_character":0,"end_line":615,"end_character":12},"in_reply_to":"ff82abbf_0e3f57b4","updated":"2017-11-27 07:22:24.000000000","message":"We should use bdmv2 as an example at here, and mention that it is v2.","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"b82d70ed36445b03e7309128f762812943087b83","unresolved":false,"context_lines":[{"line_number":606,"context_line":"exposed to the server. There are some desirable independent attributes in Block"},{"line_number":607,"context_line":"Device Mapping:"},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"- Source type"},{"line_number":610,"context_line":"- Destination type"},{"line_number":611,"context_line":"- Guest format"},{"line_number":612,"context_line":"- Device type"},{"line_number":613,"context_line":"- Disk bus"},{"line_number":614,"context_line":"- Shutdown action (delete device or not)"},{"line_number":615,"context_line":"- Boot order"},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"For some historical reasons, Nova has 2 version of block device mapping,"},{"line_number":618,"context_line":"``block_device_mapping`` and ``block_device_mapping_v2``, user can not"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_0e3f57b4","line":615,"range":{"start_line":609,"start_character":0,"end_line":615,"end_character":12},"in_reply_to":"ff82abbf_16cf73b0","updated":"2017-11-27 07:07:56.000000000","message":"no, since this is just the api guide, not api-ref, we don\u0027t need to have detail for each api.\n\nThere are only description words, for end user to understand what\u0027 the api for, make sense?","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"391f07f44c2d438dfca707fa56da8e3bb12fc9b5","unresolved":false,"context_lines":[{"line_number":606,"context_line":"exposed to the server. There are some desirable independent attributes in Block"},{"line_number":607,"context_line":"Device Mapping:"},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"- Source type"},{"line_number":610,"context_line":"- Destination type"},{"line_number":611,"context_line":"- Guest format"},{"line_number":612,"context_line":"- Device type"},{"line_number":613,"context_line":"- Disk bus"},{"line_number":614,"context_line":"- Shutdown action (delete device or not)"},{"line_number":615,"context_line":"- Boot order"},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"For some historical reasons, Nova has 2 version of block device mapping,"},{"line_number":618,"context_line":"``block_device_mapping`` and ``block_device_mapping_v2``, user can not"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_ee223352","line":615,"range":{"start_line":609,"start_character":0,"end_line":615,"end_character":12},"in_reply_to":"ff82abbf_ce672fb7","updated":"2017-11-27 07:24:40.000000000","message":"yep, sure.","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"2150c641d9864325bfb7cd6df32e8b478e059917","unresolved":false,"context_lines":[{"line_number":616,"context_line":""},{"line_number":617,"context_line":"For some historical reasons, Nova has 2 version of block device mapping,"},{"line_number":618,"context_line":"``block_device_mapping`` and ``block_device_mapping_v2``, user can not"},{"line_number":619,"context_line":"specify them simultaneously."},{"line_number":620,"context_line":""},{"line_number":621,"context_line":"``block device mapping`` general structure closely mirrored that of the EC2"},{"line_number":622,"context_line":"API. During the Havana release of Nova, an additional field"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_36d4f747","line":619,"range":{"start_line":619,"start_character":13,"end_line":619,"end_character":27},"updated":"2017-11-27 03:58:51.000000000","message":"in the same request","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"1b13f0ee31a98c675dd971ce4119e0214943932e","unresolved":false,"context_lines":[{"line_number":616,"context_line":""},{"line_number":617,"context_line":"For some historical reasons, Nova has 2 version of block device mapping,"},{"line_number":618,"context_line":"``block_device_mapping`` and ``block_device_mapping_v2``, user can not"},{"line_number":619,"context_line":"specify them simultaneously."},{"line_number":620,"context_line":""},{"line_number":621,"context_line":"``block device mapping`` general structure closely mirrored that of the EC2"},{"line_number":622,"context_line":"API. During the Havana release of Nova, an additional field"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_317868c2","line":619,"range":{"start_line":619,"start_character":13,"end_line":619,"end_character":27},"in_reply_to":"ff82abbf_36d4f747","updated":"2017-11-28 01:23:02.000000000","message":"Done","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":15888,"name":"Zhenyu Zheng","email":"zheng.zhenyu@outlook.com","username":"Kevin_Zheng"},"change_message_id":"8494f5d927c8361040b69e0b2733b4e14e78a700","unresolved":false,"context_lines":[{"line_number":606,"context_line":"exposed to the server. There are some desirable independent attributes in Block"},{"line_number":607,"context_line":"Device Mapping:"},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"- Source type"},{"line_number":610,"context_line":"- Destination type"},{"line_number":611,"context_line":"- Guest format"},{"line_number":612,"context_line":"- Device type"},{"line_number":613,"context_line":"- Disk bus"},{"line_number":614,"context_line":"- Shutdown action (delete device or not)"},{"line_number":615,"context_line":"- Boot order"},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"For some historical reasons, Nova has 2 version of block device mapping,"},{"line_number":618,"context_line":"``block_device_mapping`` and ``block_device_mapping_v2``, user can not"},{"line_number":619,"context_line":"specify them simultaneously."},{"line_number":620,"context_line":""},{"line_number":621,"context_line":"``block device mapping`` general structure closely mirrored that of the EC2"},{"line_number":622,"context_line":"API. During the Havana release of Nova, an additional field"},{"line_number":623,"context_line":"``block_device_mapping_v2`` was added, which expose additional details and"},{"line_number":624,"context_line":"features."},{"line_number":625,"context_line":""},{"line_number":626,"context_line":"**Example for block device mapping v2**"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_f6576fc9","line":623,"range":{"start_line":609,"start_character":0,"end_line":623,"end_character":74},"updated":"2017-11-27 04:01:26.000000000","message":"good point, maybe we should say that there are two versions first and present what fields can be included accordingly","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":6062,"name":"jichenjc","email":"jichenjc@cn.ibm.com","username":"jichenjc"},"change_message_id":"2150c641d9864325bfb7cd6df32e8b478e059917","unresolved":false,"context_lines":[{"line_number":619,"context_line":"specify them simultaneously."},{"line_number":620,"context_line":""},{"line_number":621,"context_line":"``block device mapping`` general structure closely mirrored that of the EC2"},{"line_number":622,"context_line":"API. During the Havana release of Nova, an additional field"},{"line_number":623,"context_line":"``block_device_mapping_v2`` was added, which expose additional details and"},{"line_number":624,"context_line":"features."},{"line_number":625,"context_line":""},{"line_number":626,"context_line":"**Example for block device mapping v2**"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_f6c9afab","line":623,"range":{"start_line":622,"start_character":40,"end_line":623,"end_character":37},"updated":"2017-11-27 03:58:51.000000000","message":"not sure it\u0027s a \u0027field\u0027, it\u0027s a input format ?","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"e6f857e737bb4db99a8c026a5bdecd0ed0e151fc","unresolved":false,"context_lines":[{"line_number":619,"context_line":"specify them simultaneously."},{"line_number":620,"context_line":""},{"line_number":621,"context_line":"``block device mapping`` general structure closely mirrored that of the EC2"},{"line_number":622,"context_line":"API. During the Havana release of Nova, an additional field"},{"line_number":623,"context_line":"``block_device_mapping_v2`` was added, which expose additional details and"},{"line_number":624,"context_line":"features."},{"line_number":625,"context_line":""},{"line_number":626,"context_line":"**Example for block device mapping v2**"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_7185a659","line":623,"range":{"start_line":622,"start_character":40,"end_line":623,"end_character":37},"in_reply_to":"ff82abbf_4e59df32","updated":"2017-11-27 08:25:51.000000000","message":"i think giving ref to that link is very helpful. we can just mentioned something like:\n\n\nFor some historical reasons, Nova has 2 way to mention the block device mapping information in create server request body.\n -  ``block_device_mapping``. This is legacy way and supported for backward compatibility.\n -  ``block_device_mapping_v2``. This is new and recommended format of specify the BDM information in create server request body. \n  \nMore Details are here \u003cref to https://docs.openstack.org/nova/latest/user/block-device-mapping.html#data-format-and-its-history\u003e","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"1b13f0ee31a98c675dd971ce4119e0214943932e","unresolved":false,"context_lines":[{"line_number":619,"context_line":"specify them simultaneously."},{"line_number":620,"context_line":""},{"line_number":621,"context_line":"``block device mapping`` general structure closely mirrored that of the EC2"},{"line_number":622,"context_line":"API. During the Havana release of Nova, an additional field"},{"line_number":623,"context_line":"``block_device_mapping_v2`` was added, which expose additional details and"},{"line_number":624,"context_line":"features."},{"line_number":625,"context_line":""},{"line_number":626,"context_line":"**Example for block device mapping v2**"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_5175ecc9","line":623,"range":{"start_line":622,"start_character":40,"end_line":623,"end_character":37},"in_reply_to":"ff82abbf_7185a659","updated":"2017-11-28 01:23:02.000000000","message":"Done","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"b82d70ed36445b03e7309128f762812943087b83","unresolved":false,"context_lines":[{"line_number":619,"context_line":"specify them simultaneously."},{"line_number":620,"context_line":""},{"line_number":621,"context_line":"``block device mapping`` general structure closely mirrored that of the EC2"},{"line_number":622,"context_line":"API. During the Havana release of Nova, an additional field"},{"line_number":623,"context_line":"``block_device_mapping_v2`` was added, which expose additional details and"},{"line_number":624,"context_line":"features."},{"line_number":625,"context_line":""},{"line_number":626,"context_line":"**Example for block device mapping v2**"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff82abbf_4e59df32","line":623,"range":{"start_line":622,"start_character":40,"end_line":623,"end_character":37},"in_reply_to":"ff82abbf_f6c9afab","updated":"2017-11-27 07:07:56.000000000","message":"Please refer https://docs.openstack.org/nova/latest/user/block-device-mapping.html#data-format-and-its-history","commit_id":"f7ebe2b40c875947bcb5f5ade311e48a16639dbc"},{"author":{"_account_id":7634,"name":"Takashi Natsume","email":"takanattie@gmail.com","username":"natsumet"},"change_message_id":"13b6d33ab26133f19c646df633559500b929c069","unresolved":false,"context_lines":[{"line_number":638,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":639,"context_line":"terminate the Nova server."},{"line_number":640,"context_line":""},{"line_number":641,"context_line":".. code::"},{"line_number":642,"context_line":""},{"line_number":643,"context_line":"    {"},{"line_number":644,"context_line":"        \"server\": {"},{"line_number":645,"context_line":"            ..."},{"line_number":646,"context_line":"        },"},{"line_number":647,"context_line":"        \"block_device_mapping_v2\": ["},{"line_number":648,"context_line":"            {"},{"line_number":649,"context_line":"                \"boot_index\": \"0\""},{"line_number":650,"context_line":"                \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","},{"line_number":651,"context_line":"                \"volume_size\": \"100\","},{"line_number":652,"context_line":"                \"source_type\": \"image\","},{"line_number":653,"context_line":"                \"destination_type\": \"volume\","},{"line_number":654,"context_line":"                \"delete_on_termination\": false"},{"line_number":655,"context_line":"            }"},{"line_number":656,"context_line":"        ]"},{"line_number":657,"context_line":"    }"},{"line_number":658,"context_line":""},{"line_number":659,"context_line":"Scheduler Hints"},{"line_number":660,"context_line":"~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":8,"id":"df87a7cf_af55411f","line":657,"range":{"start_line":641,"start_character":0,"end_line":657,"end_character":5},"updated":"2017-12-06 08:25:32.000000000","message":"Is it a request body for creating a server?\nIf so, it is not correct.\n\n\u0027block_device_mapping_v2\u0027 should be inside of \"server\".\n\nhttps://github.com/openstack/nova/blob/9f46043f2f2463695385a6a14634664be4833e8e/nova/api/openstack/compute/servers.py#L656-L666","commit_id":"7a476ddbdf7e26e679a65bd3f29e51da2e4c6453"},{"author":{"_account_id":15888,"name":"Zhenyu Zheng","email":"zheng.zhenyu@outlook.com","username":"Kevin_Zheng"},"change_message_id":"bbb4aefa6a024acf53298b5751667389637b64fa","unresolved":false,"context_lines":[{"line_number":638,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":639,"context_line":"terminate the Nova server."},{"line_number":640,"context_line":""},{"line_number":641,"context_line":".. code::"},{"line_number":642,"context_line":""},{"line_number":643,"context_line":"    {"},{"line_number":644,"context_line":"        \"server\": {"},{"line_number":645,"context_line":"            ..."},{"line_number":646,"context_line":"        },"},{"line_number":647,"context_line":"        \"block_device_mapping_v2\": ["},{"line_number":648,"context_line":"            {"},{"line_number":649,"context_line":"                \"boot_index\": \"0\""},{"line_number":650,"context_line":"                \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","},{"line_number":651,"context_line":"                \"volume_size\": \"100\","},{"line_number":652,"context_line":"                \"source_type\": \"image\","},{"line_number":653,"context_line":"                \"destination_type\": \"volume\","},{"line_number":654,"context_line":"                \"delete_on_termination\": false"},{"line_number":655,"context_line":"            }"},{"line_number":656,"context_line":"        ]"},{"line_number":657,"context_line":"    }"},{"line_number":658,"context_line":""},{"line_number":659,"context_line":"Scheduler Hints"},{"line_number":660,"context_line":"~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":8,"id":"df87a7cf_de287835","line":657,"range":{"start_line":641,"start_character":0,"end_line":657,"end_character":5},"in_reply_to":"df87a7cf_af55411f","updated":"2017-12-06 09:19:27.000000000","message":"++","commit_id":"7a476ddbdf7e26e679a65bd3f29e51da2e4c6453"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"7df973fb5d6df4c706b08df5411b9a26af659c25","unresolved":false,"context_lines":[{"line_number":638,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":639,"context_line":"terminate the Nova server."},{"line_number":640,"context_line":""},{"line_number":641,"context_line":".. code::"},{"line_number":642,"context_line":""},{"line_number":643,"context_line":"    {"},{"line_number":644,"context_line":"        \"server\": {"},{"line_number":645,"context_line":"            ..."},{"line_number":646,"context_line":"        },"},{"line_number":647,"context_line":"        \"block_device_mapping_v2\": ["},{"line_number":648,"context_line":"            {"},{"line_number":649,"context_line":"                \"boot_index\": \"0\""},{"line_number":650,"context_line":"                \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","},{"line_number":651,"context_line":"                \"volume_size\": \"100\","},{"line_number":652,"context_line":"                \"source_type\": \"image\","},{"line_number":653,"context_line":"                \"destination_type\": \"volume\","},{"line_number":654,"context_line":"                \"delete_on_termination\": false"},{"line_number":655,"context_line":"            }"},{"line_number":656,"context_line":"        ]"},{"line_number":657,"context_line":"    }"},{"line_number":658,"context_line":""},{"line_number":659,"context_line":"Scheduler Hints"},{"line_number":660,"context_line":"~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":8,"id":"df87a7cf_8215749e","line":657,"range":{"start_line":641,"start_character":0,"end_line":657,"end_character":5},"in_reply_to":"df87a7cf_de287835","updated":"2017-12-08 08:30:37.000000000","message":"Thank you guys, it\u0027s good to know. I see this is from the old nova docs, which really need to be cleanup.","commit_id":"7a476ddbdf7e26e679a65bd3f29e51da2e4c6453"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"3fefebed6ad7c0f9031b08d2a87a6b64a92a9cf5","unresolved":false,"context_lines":[{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"},{"line_number":613,"context_line":"  compatibility for EC2 API."},{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is new and recommended format of specify"},{"line_number":615,"context_line":"  Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User can not specify them simultaneously in the same request."}],"source_content_type":"text/x-rst","patch_set":9,"id":"bf8cb3f7_36575305","line":614,"range":{"start_line":614,"start_character":36,"end_line":614,"end_character":42},"updated":"2017-12-27 08:50:29.000000000","message":"nit: s/is new/is the new/","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"3fefebed6ad7c0f9031b08d2a87a6b64a92a9cf5","unresolved":false,"context_lines":[{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"},{"line_number":613,"context_line":"  compatibility for EC2 API."},{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is new and recommended format of specify"},{"line_number":615,"context_line":"  Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User can not specify them simultaneously in the same request."}],"source_content_type":"text/x-rst","patch_set":9,"id":"bf8cb3f7_f6400b38","line":614,"range":{"start_line":614,"start_character":66,"end_line":614,"end_character":68},"updated":"2017-12-27 08:50:29.000000000","message":"to","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"4cee60c8ef645ffaf8e6ded5e3202d35365517d5","unresolved":false,"context_lines":[{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"},{"line_number":613,"context_line":"  compatibility for EC2 API."},{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is new and recommended format of specify"},{"line_number":615,"context_line":"  Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User can not specify them simultaneously in the same request."}],"source_content_type":"text/x-rst","patch_set":9,"id":"9f91af0f_5eed8ded","line":614,"range":{"start_line":614,"start_character":36,"end_line":614,"end_character":42},"in_reply_to":"bf8cb3f7_36575305","updated":"2018-01-02 01:36:56.000000000","message":"Done","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"4cee60c8ef645ffaf8e6ded5e3202d35365517d5","unresolved":false,"context_lines":[{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"},{"line_number":613,"context_line":"  compatibility for EC2 API."},{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is new and recommended format of specify"},{"line_number":615,"context_line":"  Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User can not specify them simultaneously in the same request."}],"source_content_type":"text/x-rst","patch_set":9,"id":"9f91af0f_febb41e2","line":614,"range":{"start_line":614,"start_character":66,"end_line":614,"end_character":68},"in_reply_to":"bf8cb3f7_f6400b38","updated":"2018-01-02 01:36:56.000000000","message":"Done","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"3fefebed6ad7c0f9031b08d2a87a6b64a92a9cf5","unresolved":false,"context_lines":[{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is new and recommended format of specify"},{"line_number":615,"context_line":"  Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User can not specify them simultaneously in the same request."},{"line_number":618,"context_line":""},{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."}],"source_content_type":"text/x-rst","patch_set":9,"id":"bf8cb3f7_b64a8352","line":617,"range":{"start_line":617,"start_character":0,"end_line":617,"end_character":61},"updated":"2017-12-27 08:50:29.000000000","message":"User cannot mix the two formats in the same request.","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"4cee60c8ef645ffaf8e6ded5e3202d35365517d5","unresolved":false,"context_lines":[{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is new and recommended format of specify"},{"line_number":615,"context_line":"  Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User can not specify them simultaneously in the same request."},{"line_number":618,"context_line":""},{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."}],"source_content_type":"text/x-rst","patch_set":9,"id":"9f91af0f_beb5b9f0","line":617,"range":{"start_line":617,"start_character":0,"end_line":617,"end_character":61},"in_reply_to":"bf8cb3f7_b64a8352","updated":"2018-01-02 01:36:56.000000000","message":"Done","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"3fefebed6ad7c0f9031b08d2a87a6b64a92a9cf5","unresolved":false,"context_lines":[{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some desirable"},{"line_number":623,"context_line":"independent attributes in ``block_device_mapping_v2``:"},{"line_number":624,"context_line":""},{"line_number":625,"context_line":"- Source type"},{"line_number":626,"context_line":"- Volume UUID"}],"source_content_type":"text/x-rst","patch_set":9,"id":"bf8cb3f7_76763ba7","line":623,"range":{"start_line":622,"start_character":55,"end_line":623,"end_character":53},"updated":"2017-12-27 08:50:29.000000000","message":"It is not clear to me what this sentence want to communicate.","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"3fefebed6ad7c0f9031b08d2a87a6b64a92a9cf5","unresolved":false,"context_lines":[{"line_number":634,"context_line":""},{"line_number":635,"context_line":"**Example for block device mapping v2**"},{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image(uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as first order boot"},{"line_number":639,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."}],"source_content_type":"text/x-rst","patch_set":9,"id":"bf8cb3f7_f669ebbd","line":637,"updated":"2017-12-27 08:50:29.000000000","message":"missing a space before \u0027(\u0027","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"4cee60c8ef645ffaf8e6ded5e3202d35365517d5","unresolved":false,"context_lines":[{"line_number":634,"context_line":""},{"line_number":635,"context_line":"**Example for block device mapping v2**"},{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image(uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as first order boot"},{"line_number":639,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."}],"source_content_type":"text/x-rst","patch_set":9,"id":"9f91af0f_7e7df11a","line":637,"in_reply_to":"bf8cb3f7_f669ebbd","updated":"2018-01-02 01:36:56.000000000","message":"Done","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"3fefebed6ad7c0f9031b08d2a87a6b64a92a9cf5","unresolved":false,"context_lines":[{"line_number":635,"context_line":"**Example for block device mapping v2**"},{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image(uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as first order boot"},{"line_number":639,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."},{"line_number":641,"context_line":""},{"line_number":642,"context_line":".. code::"}],"source_content_type":"text/x-rst","patch_set":9,"id":"bf8cb3f7_b66363dc","line":639,"range":{"start_line":638,"start_character":60,"end_line":639,"end_character":6},"updated":"2017-12-27 08:50:29.000000000","message":"the first boot device","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"4cee60c8ef645ffaf8e6ded5e3202d35365517d5","unresolved":false,"context_lines":[{"line_number":635,"context_line":"**Example for block device mapping v2**"},{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image(uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as first order boot"},{"line_number":639,"context_line":"device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."},{"line_number":641,"context_line":""},{"line_number":642,"context_line":".. code::"}],"source_content_type":"text/x-rst","patch_set":9,"id":"9f91af0f_de88bd20","line":639,"range":{"start_line":638,"start_character":60,"end_line":639,"end_character":6},"in_reply_to":"bf8cb3f7_b66363dc","updated":"2018-01-02 01:36:56.000000000","message":"Done","commit_id":"3bb2e2b7a2887de6d19a3be2d6986d0e911e71e0"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":606,"context_line":"Simply speaking, Block Device Mapping describes how the block devices been"},{"line_number":607,"context_line":"exposed to the server."},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"For some historical reasons, Nova has 2 ways to mention the block device"},{"line_number":610,"context_line":"mapping in server creation request body."},{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_67948145","line":609,"range":{"start_line":609,"start_character":29,"end_line":609,"end_character":33},"updated":"2018-01-02 14:29:11.000000000","message":"nova","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":606,"context_line":"Simply speaking, Block Device Mapping describes how the block devices been"},{"line_number":607,"context_line":"exposed to the server."},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"For some historical reasons, Nova has 2 ways to mention the block device"},{"line_number":610,"context_line":"mapping in server creation request body."},{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_a7aa8982","line":609,"range":{"start_line":609,"start_character":38,"end_line":609,"end_character":39},"updated":"2018-01-02 14:29:11.000000000","message":"two","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":606,"context_line":"Simply speaking, Block Device Mapping describes how the block devices been"},{"line_number":607,"context_line":"exposed to the server."},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"For some historical reasons, Nova has 2 ways to mention the block device"},{"line_number":610,"context_line":"mapping in server creation request body."},{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_ead59244","line":609,"range":{"start_line":609,"start_character":29,"end_line":609,"end_character":33},"in_reply_to":"9f91af0f_67948145","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":606,"context_line":"Simply speaking, Block Device Mapping describes how the block devices been"},{"line_number":607,"context_line":"exposed to the server."},{"line_number":608,"context_line":""},{"line_number":609,"context_line":"For some historical reasons, Nova has 2 ways to mention the block device"},{"line_number":610,"context_line":"mapping in server creation request body."},{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_8acc06bd","line":609,"range":{"start_line":609,"start_character":38,"end_line":609,"end_character":39},"in_reply_to":"9f91af0f_a7aa8982","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":609,"context_line":"For some historical reasons, Nova has 2 ways to mention the block device"},{"line_number":610,"context_line":"mapping in server creation request body."},{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"},{"line_number":613,"context_line":"  compatibility for EC2 API."},{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is the new and recommended format to"},{"line_number":615,"context_line":"  specify Block Device Mapping information in server creation request body."}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_479b7d71","line":612,"range":{"start_line":612,"start_character":55,"end_line":612,"end_character":62},"updated":"2018-01-02 14:29:11.000000000","message":"supports","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":609,"context_line":"For some historical reasons, Nova has 2 ways to mention the block device"},{"line_number":610,"context_line":"mapping in server creation request body."},{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"},{"line_number":613,"context_line":"  compatibility for EC2 API."},{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is the new and recommended format to"},{"line_number":615,"context_line":"  specify Block Device Mapping information in server creation request body."}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_4ac6fe9c","line":612,"range":{"start_line":612,"start_character":55,"end_line":612,"end_character":62},"in_reply_to":"9f91af0f_479b7d71","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"},{"line_number":613,"context_line":"  compatibility for EC2 API."},{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is the new and recommended format to"},{"line_number":615,"context_line":"  specify Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User cannot mix the two formats in the same request."},{"line_number":618,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_c788ed20","line":615,"range":{"start_line":614,"start_character":0,"end_line":615,"end_character":75},"updated":"2018-01-02 14:29:11.000000000","message":"nit: These would probably look better as definition lists\n\n  ``block_device_mapping_v2``\n    This is the new ...","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":611,"context_line":""},{"line_number":612,"context_line":"- ``block_device_mapping``. This is the legacy way and support backward"},{"line_number":613,"context_line":"  compatibility for EC2 API."},{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is the new and recommended format to"},{"line_number":615,"context_line":"  specify Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User cannot mix the two formats in the same request."},{"line_number":618,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_ca376eb0","line":615,"range":{"start_line":614,"start_character":0,"end_line":615,"end_character":75},"in_reply_to":"9f91af0f_c788ed20","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is the new and recommended format to"},{"line_number":615,"context_line":"  specify Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User cannot mix the two formats in the same request."},{"line_number":618,"context_line":""},{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_4774dd35","line":617,"range":{"start_line":617,"start_character":0,"end_line":617,"end_character":4},"updated":"2018-01-02 14:29:11.000000000","message":"Users","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":614,"context_line":"- ``block_device_mapping_v2``. This is the new and recommended format to"},{"line_number":615,"context_line":"  specify Block Device Mapping information in server creation request body."},{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User cannot mix the two formats in the same request."},{"line_number":618,"context_line":""},{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_8a41660e","line":617,"range":{"start_line":617,"start_character":0,"end_line":617,"end_character":4},"in_reply_to":"9f91af0f_4774dd35","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User cannot mix the two formats in the same request."},{"line_number":618,"context_line":""},{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_e78e5126","line":619,"range":{"start_line":619,"start_character":22,"end_line":619,"end_character":35},"updated":"2018-01-02 14:29:11.000000000","message":"refer to","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":616,"context_line":""},{"line_number":617,"context_line":"User cannot mix the two formats in the same request."},{"line_number":618,"context_line":""},{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_4a4b5e2a","line":619,"range":{"start_line":619,"start_character":22,"end_line":619,"end_character":35},"in_reply_to":"9f91af0f_e78e5126","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some"},{"line_number":623,"context_line":"attributes in ``block_device_mapping_v2`` user can sepcify:"},{"line_number":624,"context_line":""},{"line_number":625,"context_line":"- Source type"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_07949536","line":622,"range":{"start_line":622,"start_character":53,"end_line":622,"end_character":60},"updated":"2018-01-02 14:29:11.000000000","message":"example. There are...","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":619,"context_line":"For more information, you can refer `Block Device Mapping"},{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some"},{"line_number":623,"context_line":"attributes in ``block_device_mapping_v2`` user can sepcify:"},{"line_number":624,"context_line":""},{"line_number":625,"context_line":"- Source type"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_6a466224","line":622,"range":{"start_line":622,"start_character":53,"end_line":622,"end_character":60},"in_reply_to":"9f91af0f_07949536","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some"},{"line_number":623,"context_line":"attributes in ``block_device_mapping_v2`` user can sepcify:"},{"line_number":624,"context_line":""},{"line_number":625,"context_line":"- Source type"},{"line_number":626,"context_line":"- Volume UUID"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_67a2419d","line":623,"range":{"start_line":623,"start_character":51,"end_line":623,"end_character":58},"updated":"2018-01-02 14:29:11.000000000","message":"specify","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some"},{"line_number":623,"context_line":"attributes in ``block_device_mapping_v2`` user can sepcify:"},{"line_number":624,"context_line":""},{"line_number":625,"context_line":"- Source type"},{"line_number":626,"context_line":"- Volume UUID"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_879f454f","line":623,"range":{"start_line":623,"start_character":42,"end_line":623,"end_character":46},"updated":"2018-01-02 14:29:11.000000000","message":"the user","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some"},{"line_number":623,"context_line":"attributes in ``block_device_mapping_v2`` user can sepcify:"},{"line_number":624,"context_line":""},{"line_number":625,"context_line":"- Source type"},{"line_number":626,"context_line":"- Volume UUID"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_0a5556c6","line":623,"range":{"start_line":623,"start_character":51,"end_line":623,"end_character":58},"in_reply_to":"9f91af0f_67a2419d","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":12175,"name":"Eli Qiao","email":"qiaoliyong@gmail.com","username":"Eli"},"change_message_id":"2c83cd60ec15ac868bd372ef53d8f11d68274efb","unresolved":false,"context_lines":[{"line_number":620,"context_line":"\u003chttps://docs.openstack.org/nova/latest/user/block-device-mapping.html\u003e`_."},{"line_number":621,"context_line":""},{"line_number":622,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example, there are some"},{"line_number":623,"context_line":"attributes in ``block_device_mapping_v2`` user can sepcify:"},{"line_number":624,"context_line":""},{"line_number":625,"context_line":"- Source type"},{"line_number":626,"context_line":"- Volume UUID"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_2a505ad4","line":623,"range":{"start_line":623,"start_character":42,"end_line":623,"end_character":46},"in_reply_to":"9f91af0f_879f454f","updated":"2018-01-04 03:01:17.000000000","message":"Done","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":634,"context_line":""},{"line_number":635,"context_line":"**Example for block device mapping v2**"},{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image (uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as the first order"},{"line_number":639,"context_line":"boot device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_a7b129e4","line":637,"range":{"start_line":637,"start_character":19,"end_line":637,"end_character":23},"updated":"2018-01-02 14:29:11.000000000","message":"100 GB","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":634,"context_line":""},{"line_number":635,"context_line":"**Example for block device mapping v2**"},{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image (uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as the first order"},{"line_number":639,"context_line":"boot device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_07bd75b6","line":637,"range":{"start_line":637,"start_character":69,"end_line":637,"end_character":73},"updated":"2018-01-02 14:29:11.000000000","message":"with UUID of ...","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":635,"context_line":"**Example for block device mapping v2**"},{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image (uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as the first order"},{"line_number":639,"context_line":"boot device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."},{"line_number":641,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_e7b731d8","line":638,"range":{"start_line":638,"start_character":0,"end_line":638,"end_character":39},"updated":"2018-01-02 14:29:11.000000000","message":"Need double backticks here","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":635,"context_line":"**Example for block device mapping v2**"},{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image (uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as the first order"},{"line_number":639,"context_line":"boot device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."},{"line_number":641,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_27c5193d","line":638,"range":{"start_line":638,"start_character":39,"end_line":638,"end_character":43},"updated":"2018-01-02 14:29:11.000000000","message":"``. It will be...","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"59b3d81f8c940c6b29bdb97768890aefe5cb903b","unresolved":false,"context_lines":[{"line_number":636,"context_line":""},{"line_number":637,"context_line":"This will create a 100G size volume type block device from an image (uuid is"},{"line_number":638,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as the first order"},{"line_number":639,"context_line":"boot device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":640,"context_line":"terminate the Nova server."},{"line_number":641,"context_line":""},{"line_number":642,"context_line":".. code::"}],"source_content_type":"text/x-rst","patch_set":10,"id":"9f91af0f_07e255d6","line":639,"range":{"start_line":639,"start_character":13,"end_line":639,"end_character":25},"updated":"2018-01-02 14:29:11.000000000","message":"``boot_index\u003d0``","commit_id":"eb9a9fa4297fd333dec8b911f84e44e647695942"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"db051b2c980f3d099b7a26e5012acdbf25775682","unresolved":false,"context_lines":[{"line_number":635,"context_line":""},{"line_number":636,"context_line":"**Example for block device mapping v2**"},{"line_number":637,"context_line":""},{"line_number":638,"context_line":"This will create a 100G size volume type block device from an image (uuid is"},{"line_number":639,"context_line":"`bb02b1a3-bc77-4d17-ab5b-421d89850fca`), it will be used as the first order"},{"line_number":640,"context_line":"boot device (boot_index\u003d0), and this block device will not be deleted after we"},{"line_number":641,"context_line":"terminate the Nova server."},{"line_number":642,"context_line":""},{"line_number":643,"context_line":".. code::"},{"line_number":644,"context_line":""},{"line_number":645,"context_line":"    {"},{"line_number":646,"context_line":"        \"server\": {"},{"line_number":647,"context_line":"            ..."},{"line_number":648,"context_line":"            \"block_device_mapping_v2\": ["},{"line_number":649,"context_line":"                {"},{"line_number":650,"context_line":"                    \"boot_index\": \"0\""},{"line_number":651,"context_line":"                    \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","},{"line_number":652,"context_line":"                    \"volume_size\": \"100\","},{"line_number":653,"context_line":"                    \"source_type\": \"image\","},{"line_number":654,"context_line":"                    \"destination_type\": \"volume\","},{"line_number":655,"context_line":"                    \"delete_on_termination\": false"},{"line_number":656,"context_line":"                }"},{"line_number":657,"context_line":"            ]"},{"line_number":658,"context_line":"        }"},{"line_number":659,"context_line":"    }"},{"line_number":660,"context_line":""},{"line_number":661,"context_line":"Scheduler Hints"},{"line_number":662,"context_line":"~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":11,"id":"9f91af0f_4b283633","line":659,"range":{"start_line":638,"start_character":0,"end_line":659,"end_character":5},"updated":"2018-01-04 16:13:52.000000000","message":"Comments from previous PS still stand [1]\n\n[1] https://review.openstack.org/#/c/522084/10/api-guide/source/server_concepts.rst@637","commit_id":"417dbe8f290b41d542933fb721545a321cb2f8fd"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"9c55b91e5038b438b2003edc0ccff1c6b5a810a0","unresolved":false,"context_lines":[{"line_number":623,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example. There are some"},{"line_number":624,"context_line":"attributes in ``block_device_mapping_v2`` the user can specify:"},{"line_number":625,"context_line":""},{"line_number":626,"context_line":"- Source type"},{"line_number":627,"context_line":"- Volume UUID"},{"line_number":628,"context_line":"- Image UUID"},{"line_number":629,"context_line":"- Destination type"},{"line_number":630,"context_line":"- Guest format"},{"line_number":631,"context_line":"- Device type"},{"line_number":632,"context_line":"- Disk bus"},{"line_number":633,"context_line":"- Boot order"},{"line_number":634,"context_line":"- Shutdown action (delete the volume after server shutdown)"},{"line_number":635,"context_line":""},{"line_number":636,"context_line":"**Example for block device mapping v2**"},{"line_number":637,"context_line":""}],"source_content_type":"text/x-rst","patch_set":12,"id":"9f6a8fd7_51a04642","line":634,"range":{"start_line":626,"start_character":2,"end_line":634,"end_character":59},"updated":"2018-04-25 20:45:45.000000000","message":"nit: it would be nice to add actual parameter names like\n\n - Source type (source_type)\n - Volume UUID (uuid)\n - Image UUID (image_id)\n ...\n\nto understand the following sample easily.\nEspecially delete_on_termination is a little difficult to understand at first looking.","commit_id":"195cf6d5ecc11c9ce4649e0e17589aa1a17adc1a"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"519606e58c356c020ccdcdede0599605d7e33bc1","unresolved":false,"context_lines":[{"line_number":623,"context_line":"Let\u0027s take ``block_device_mapping_v2`` for an example. There are some"},{"line_number":624,"context_line":"attributes in ``block_device_mapping_v2`` the user can specify:"},{"line_number":625,"context_line":""},{"line_number":626,"context_line":"- Source type"},{"line_number":627,"context_line":"- Volume UUID"},{"line_number":628,"context_line":"- Image UUID"},{"line_number":629,"context_line":"- Destination type"},{"line_number":630,"context_line":"- Guest format"},{"line_number":631,"context_line":"- Device type"},{"line_number":632,"context_line":"- Disk bus"},{"line_number":633,"context_line":"- Boot order"},{"line_number":634,"context_line":"- Shutdown action (delete the volume after server shutdown)"},{"line_number":635,"context_line":""},{"line_number":636,"context_line":"**Example for block device mapping v2**"},{"line_number":637,"context_line":""}],"source_content_type":"text/x-rst","patch_set":12,"id":"9fb8cfa7_9d24bc5f","line":634,"range":{"start_line":626,"start_character":2,"end_line":634,"end_character":59},"in_reply_to":"9f6a8fd7_51a04642","updated":"2019-06-13 15:35:12.000000000","message":"Our API reference is actually quite detailed on these now - I\u0027m torn between just linking to the API reference vs copying that same information here.\n\nAlso missing volume_size here which is in the example below. tag and volume_type are also new since this was written - so it\u0027s probably better to just link to the API reference.","commit_id":"195cf6d5ecc11c9ce4649e0e17589aa1a17adc1a"},{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"9c55b91e5038b438b2003edc0ccff1c6b5a810a0","unresolved":false,"context_lines":[{"line_number":647,"context_line":"            ..."},{"line_number":648,"context_line":"            \"block_device_mapping_v2\": ["},{"line_number":649,"context_line":"                {"},{"line_number":650,"context_line":"                    \"boot_index\": \"0\""},{"line_number":651,"context_line":"                    \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","},{"line_number":652,"context_line":"                    \"volume_size\": \"100\","},{"line_number":653,"context_line":"                    \"source_type\": \"image\","}],"source_content_type":"text/x-rst","patch_set":12,"id":"9f6a8fd7_d148d6b3","line":650,"range":{"start_line":650,"start_character":34,"end_line":650,"end_character":37},"updated":"2018-04-25 20:45:45.000000000","message":"I recommend to use an integer value instead of string, because the sample server-create-req.json shows 0 and the integer clarifies what kind of value.\n\nIn addition, \",\" is necessary before a new line.","commit_id":"195cf6d5ecc11c9ce4649e0e17589aa1a17adc1a"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"519606e58c356c020ccdcdede0599605d7e33bc1","unresolved":false,"context_lines":[{"line_number":647,"context_line":"            ..."},{"line_number":648,"context_line":"            \"block_device_mapping_v2\": ["},{"line_number":649,"context_line":"                {"},{"line_number":650,"context_line":"                    \"boot_index\": \"0\""},{"line_number":651,"context_line":"                    \"uuid\": \"bb02b1a3-bc77-4d17-ab5b-421d89850fca\","},{"line_number":652,"context_line":"                    \"volume_size\": \"100\","},{"line_number":653,"context_line":"                    \"source_type\": \"image\","}],"source_content_type":"text/x-rst","patch_set":12,"id":"9fb8cfa7_7db9c812","line":650,"range":{"start_line":650,"start_character":34,"end_line":650,"end_character":37},"in_reply_to":"9f6a8fd7_d148d6b3","updated":"2019-06-13 15:35:12.000000000","message":"Done","commit_id":"195cf6d5ecc11c9ce4649e0e17589aa1a17adc1a"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"cbce1377746d0778561d90d85071a11612e98b74","unresolved":false,"context_lines":[{"line_number":713,"context_line":"**Example for block_device_mapping_v2**"},{"line_number":714,"context_line":""},{"line_number":715,"context_line":"This will create a 100GB size volume type block device from an image (with UUID"},{"line_number":716,"context_line":"of bb02b1a3-bc77-4d17-ab5b-421d89850fca). It will be used as the first order"},{"line_number":717,"context_line":"boot device (``boot_index\u003d0``), and this block device will not be deleted after"},{"line_number":718,"context_line":"we terminate the server."},{"line_number":719,"context_line":""}],"source_content_type":"text/x-rst","patch_set":13,"id":"9fb8cfa7_3d37d001","line":716,"range":{"start_line":716,"start_character":3,"end_line":716,"end_character":39},"updated":"2019-06-13 15:49:03.000000000","message":"Wonder if this should be a ``literal``? Meh","commit_id":"198f486f06824041c7e70254559c358c5ad6c054"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"9230a579560617d3694c89b1c19ad39c691745a4","unresolved":false,"context_lines":[{"line_number":713,"context_line":"**Example for block_device_mapping_v2**"},{"line_number":714,"context_line":""},{"line_number":715,"context_line":"This will create a 100GB size volume type block device from an image (with UUID"},{"line_number":716,"context_line":"of bb02b1a3-bc77-4d17-ab5b-421d89850fca). It will be used as the first order"},{"line_number":717,"context_line":"boot device (``boot_index\u003d0``), and this block device will not be deleted after"},{"line_number":718,"context_line":"we terminate the server."},{"line_number":719,"context_line":""}],"source_content_type":"text/x-rst","patch_set":13,"id":"9fb8cfa7_f0cddfb6","line":716,"range":{"start_line":716,"start_character":3,"end_line":716,"end_character":39},"in_reply_to":"9fb8cfa7_3d37d001","updated":"2019-06-13 15:56:57.000000000","message":"Done","commit_id":"198f486f06824041c7e70254559c358c5ad6c054"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"cbce1377746d0778561d90d85071a11612e98b74","unresolved":false,"context_lines":[{"line_number":717,"context_line":"boot device (``boot_index\u003d0``), and this block device will not be deleted after"},{"line_number":718,"context_line":"we terminate the server."},{"line_number":719,"context_line":""},{"line_number":720,"context_line":".. code::"},{"line_number":721,"context_line":""},{"line_number":722,"context_line":"    {"},{"line_number":723,"context_line":"        \"server\": {"}],"source_content_type":"text/x-rst","patch_set":13,"id":"9fb8cfa7_9d27dcca","line":720,"range":{"start_line":720,"start_character":0,"end_line":720,"end_character":9},"updated":"2019-06-13 15:49:03.000000000","message":"Probably could/should be formatted as JSON\n\n    .. code-block:: json\n\nLater: Actually, this isn\u0027t valid JSON, so you\u0027d have to remove the \u0027...\u0027. Still probably worth doing","commit_id":"198f486f06824041c7e70254559c358c5ad6c054"},{"author":{"_account_id":6873,"name":"Matt Riedemann","email":"mriedem.os@gmail.com","username":"mriedem"},"change_message_id":"9230a579560617d3694c89b1c19ad39c691745a4","unresolved":false,"context_lines":[{"line_number":717,"context_line":"boot device (``boot_index\u003d0``), and this block device will not be deleted after"},{"line_number":718,"context_line":"we terminate the server."},{"line_number":719,"context_line":""},{"line_number":720,"context_line":".. code::"},{"line_number":721,"context_line":""},{"line_number":722,"context_line":"    {"},{"line_number":723,"context_line":"        \"server\": {"}],"source_content_type":"text/x-rst","patch_set":13,"id":"9fb8cfa7_90c823a6","line":720,"range":{"start_line":720,"start_character":0,"end_line":720,"end_character":9},"in_reply_to":"9fb8cfa7_9d27dcca","updated":"2019-06-13 15:56:57.000000000","message":"Done","commit_id":"198f486f06824041c7e70254559c358c5ad6c054"}]}