vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/evs/api-ref/evs_04_2065.html
Zaoxu, Li 305c41bb57 EVS 2.0.38 SP1 version 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com>
Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
2022-10-19 22:27:18 +00:00

697 lines
62 KiB
HTML
Raw Blame History

<a name="evs_04_2065"></a><a name="evs_04_2065"></a>
<h1 class="topictitle1">Creating EVS Disks</h1>
<div id="body1494051692064"><div class="section" id="evs_04_2065__section60214390"><h4 class="sectiontitle">Function</h4><p id="evs_04_2065__p43967757">This API is used to create one or multiple EVS disks.</p>
</div>
<div class="section" id="evs_04_2065__section5058598"><h4 class="sectiontitle">URI</h4><ul id="evs_04_2065__ul4618564"><li id="evs_04_2065__li41567079">URI format<p id="evs_04_2065__p11490242"><a name="evs_04_2065__li41567079"></a><a name="li41567079"></a>POST /v2/{project_id}/volumes</p>
</li><li id="evs_04_2065__li36303315">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__table58294385" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__row24683273"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.2.1.1.4.1.1"><p id="evs_04_2065__p53188122">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.2.1.1.4.1.2"><p id="evs_04_2065__p13270664">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.2.2.1.1.4.1.3"><p id="evs_04_2065__p1182010">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__row28634009"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.1 "><p id="evs_04_2065__p37653388">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.2 "><p id="evs_04_2065__p30025596">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.2.2.1.1.4.1.3 "><p id="evs_04_2065__p16154192">Specifies the project ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="evs_04_2065__section45527389"><h4 class="sectiontitle">Request</h4><ul id="evs_04_2065__ul20316194142423"><li id="evs_04_2065__li2087514296820">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__table14875192916817" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__row787616296812"><th align="left" class="cellrowborder" valign="top" width="17%" id="mcps1.3.3.2.1.1.1.5.1.1"><p id="evs_04_2065__p16876529689">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.3.2.1.1.1.5.1.2"><p id="evs_04_2065__p787612917814">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.2.1.1.1.5.1.3"><p id="evs_04_2065__p1876122910813">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="49%" id="mcps1.3.3.2.1.1.1.5.1.4"><p id="evs_04_2065__p1387612912813">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__row178767291181"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.3.2.1.1.1.5.1.1 "><p id="evs_04_2065__p6877132916817">volume</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.2.1.1.1.5.1.2 "><p id="evs_04_2065__evs_04_2010_p159017261855">Object</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.1.1.5.1.3 "><p id="evs_04_2065__p38777298820">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.2.1.1.1.5.1.4 "><p id="evs_04_2065__p138771229785">Specifies the information of the disks to be created. For details, see <a href="#evs_04_2065__li10966323">Parameters in the volume field</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2065__li10966323"><a name="evs_04_2065__li10966323"></a><a name="li10966323"></a>Parameters in the <strong id="evs_04_2065__b1412162720391">volume</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__table31588048" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__row57330849"><th align="left" class="cellrowborder" valign="top" width="17.49%" id="mcps1.3.3.2.2.2.1.5.1.1"><p id="evs_04_2065__p13287175">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.530000000000001%" id="mcps1.3.3.2.2.2.1.5.1.2"><p id="evs_04_2065__p2519427">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.36%" id="mcps1.3.3.2.2.2.1.5.1.3"><p id="evs_04_2065__p2747002">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.62%" id="mcps1.3.3.2.2.2.1.5.1.4"><p id="evs_04_2065__p21180630">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__row19750463"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p56283646">availability_zone</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p62681466">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p44033946">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p2830512315431">Specifies the AZ where you want to create the disk. If the AZ does not exist, the disk will fail to create.</p>
<div class="note" id="evs_04_2065__note18354235112810"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2065__p14110155594414">For details about how to obtain the AZ, see <a href="evs_04_2081.html">Querying All AZs</a>.</p>
</div></div>
</td>
</tr>
<tr id="evs_04_2065__row38837194143627"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p56611368143638">source_volid</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p22118134143638">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p46738440143638">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p27717319143638">Specifies the source disk ID. If this parameter is specified, the disk is cloned from an existing disk. Currently, this function is not supported.</p>
</td>
</tr>
<tr id="evs_04_2065__row22709757"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p27551015">description</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p17039762">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p38043494">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p5711105614375">Specifies the disk description. <span id="evs_04_2065__text36053742182144">The value can contain a maximum of 255 bytes.</span></p>
</td>
</tr>
<tr id="evs_04_2065__row28636870143814"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p42660241143822">snapshot_id</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p32927512143822">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p49882844143822">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p13978564143822">Specifies the snapshot ID. If this parameter is specified, the disk is created from a snapshot.</p>
<div class="note" id="evs_04_2065__note13293123112911"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2065__p129419232297">For details about how to obtain the snapshot ID, see <a href="evs_04_2097.html">Querying Details About EVS Snapshots</a>.</p>
</div></div>
</td>
</tr>
<tr id="evs_04_2065__row35520574142458"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p55945721142836">size</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p35309578142836">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p41503608142836">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><div class="p" id="evs_04_2065__evs_04_2013_p27784979">Specifies the disk size, in GB. Its value can be as follows:<ul id="evs_04_2065__evs_04_2013_ul24506304547"><li id="evs_04_2065__evs_04_2013_li13450103010545">System disk: 1 GB to 1024 GB</li><li id="evs_04_2065__evs_04_2013_li124501630205416">Data disk: 10 GB to 32768 GB</li></ul>
</div>
<p id="evs_04_2065__evs_04_2013_p1869819398426">This parameter is mandatory when you create an empty disk. You can specify the parameter value as required within the value range.</p>
<p id="evs_04_2065__evs_04_2013_p433134181712">This parameter is mandatory when you create the disk from a snapshot. Ensure that the disk size is greater than or equal to the snapshot size.</p>
<p id="evs_04_2065__evs_04_2013_p108486266429">This parameter is mandatory when you create the disk from an image. Ensure that the disk size is greater than or equal to the minimum disk capacity required by <strong id="evs_04_2065__b11303145264115">min_disk</strong> in the image attributes.</p>
</td>
</tr>
<tr id="evs_04_2065__row729385014252"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p29547213143016">name</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p44514090143016">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p48871527143016">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p44011641143911">Specifies the disk name. <span id="evs_04_2065__text816587925182150">The value can contain a maximum of 255 bytes.</span></p>
</td>
</tr>
<tr id="evs_04_2065__row4663112514255"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p4059158214322">imageRef</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p6669267314322">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p3339747014322">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p2084053914322">Specifies the image ID. If this parameter is specified, the disk is created from an image.</p>
<div class="note" id="evs_04_2065__note13789049151930"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2065__p56992577151930">BMS system disks cannot be created from BMS images.</p>
<p id="evs_04_2065__p257253253318">For how to obtain the image ID, see <strong id="evs_04_2065__b890312719431">Querying Images</strong> in the <em id="evs_04_2065__i89044774316">Image Management Service API Reference</em>.</p>
</div></div>
</td>
</tr>
<tr id="evs_04_2065__row1270246214258"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p31198636143253">volume_type</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p44061594143253">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p12219401143253">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p14380476104717">Specifies the disk type.</p>
<div class="p" id="evs_04_2065__p12887229134510">Currently, the value can be <strong id="evs_04_2065__evs_04_2003_b842352706164929">SSD</strong>, <strong id="evs_04_2065__evs_04_2003_b842352706164932">SAS</strong>, <strong id="evs_04_2065__evs_04_2003_b842352706164937">SATA</strong>, <strong id="evs_04_2065__evs_04_2003_b842352706164941">co-p1</strong>, or <strong id="evs_04_2065__evs_04_2003_b842352706164944">uh-l1</strong>.<ul id="evs_04_2065__evs_04_2003_ul11489121916439"><li id="evs_04_2065__evs_04_2003_li15488111934310"><strong id="evs_04_2065__evs_04_2003_b842352706165021">SSD</strong>: specifies the ultra-high I/O disk type.</li><li id="evs_04_2065__evs_04_2003_li0488119194318"><strong id="evs_04_2065__evs_04_2003_b1784237562165049">SAS</strong>: specifies the high I/O disk type.</li><li id="evs_04_2065__evs_04_2003_li348881917438"><strong id="evs_04_2065__evs_04_2003_b3295367816515">SATA</strong>: specifies the common I/O disk type.</li><li id="evs_04_2065__evs_04_2003_li848817193433"><strong id="evs_04_2065__evs_04_2003_b141033785">co-p1</strong>: specifies the high I/O (performance-optimized I) disk type.</li><li id="evs_04_2065__evs_04_2003_li548917194430"><strong id="evs_04_2065__evs_04_2003_b1336833005">uh-l1</strong>: specifies the ultra-high I/O (latency-optimized) disk type.<p id="evs_04_2065__evs_04_2003_p14488819154320">Disks of the <strong id="evs_04_2065__evs_04_2003_b108664633815116">co-p1</strong> and <strong id="evs_04_2065__evs_04_2003_b104594858115116">uh-l1</strong> types are used exclusively for HPC ECSs and SAP HANA ECSs.</p>
</li></ul>
</div>
<p id="evs_04_2065__p62741351184614">If the specified disk type is not available in the AZ, the disk will fail to create.</p>
<div class="note" id="evs_04_2065__note21808274104217"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="evs_04_2065__ul5307015718498"><li id="evs_04_2065__p62056744104217"><span id="evs_04_2065__text7492111913438">If the disk is created from a snapshot, the volume_type field must be the same as that of the snapshot's source disk.</span></li><li id="evs_04_2065__li1553612312507">For details about disk types, see <strong id="evs_04_2065__b1948292818449">Disk Types and Disk Performance</strong> in the <em id="evs_04_2065__i1548392874414">Elastic Volume Service User Guide</em>.</li></ul>
</div></div>
</td>
</tr>
<tr id="evs_04_2065__row5295776142511"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p1235117143943">metadata</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p32935684143943">Object</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p50544710143943">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p480861143943">Specifies the disk metadata. <span id="evs_04_2065__text124606225420127">The length of the key or value in the metadata cannot exceed 255 bytes.</span></p>
<p id="evs_04_2065__p618213246557">For details about <strong id="evs_04_2065__b84235270610317">metadata</strong>, see <a href="#evs_04_2065__li4145283210319">Parameters in the metadata field</a>. The table lists some fields. You can also specify other fields based on the disk creation requirements.</p>
<div class="note" id="evs_04_2065__note660019322131"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2065__evs_04_2013_p1600173216137">Parameter values under <strong id="evs_04_2065__evs_04_2013_b8423527062049">metadata</strong> cannot be <strong id="evs_04_2065__evs_04_2013_b842352706103415">null</strong>.</p>
</div></div>
</td>
</tr>
<tr id="evs_04_2065__row24630747142515"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p38669085144023">source_replica</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p45188191144023">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p36364878144023">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p59874001144023">Specifies the source disk ID. If this parameter is specified, the disk is cloned from an existing disk. Currently, this function is not supported.</p>
</td>
</tr>
<tr id="evs_04_2065__row33780455142518"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p56697807144126">consistencygroup_id</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p29119653144126">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p9881663144126">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p62217221144126"><span id="evs_04_2065__text13343838181111">Reserved field</span></p>
</td>
</tr>
<tr id="evs_04_2065__row7839669175144"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p3052489817525">shareable</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p5659770517525">String</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p2101135517525">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><p id="evs_04_2065__p2419821017525">Specifies whether the disk is shareable. The value can be <strong id="evs_04_2065__b539464902718">true</strong> (sharable) or <strong id="evs_04_2065__b123995492273">false</strong> (not sharable). This is an extended attribute. </p>
<div class="note" id="evs_04_2065__note1645730517525"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2065__evs_04_2013_p45212589213213">This field is no longer used. Use <strong id="evs_04_2065__evs_04_2013_b84235270610834">multiattach</strong>.</p>
</div></div>
</td>
</tr>
<tr id="evs_04_2065__row46893009142655"><td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.2.2.2.1.5.1.1 "><p id="evs_04_2065__p16191875144233">multiattach</p>
</td>
<td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.3.2.2.2.1.5.1.2 "><p id="evs_04_2065__p36473476144233">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="16.36%" headers="mcps1.3.3.2.2.2.1.5.1.3 "><p id="evs_04_2065__p1561611144233">No</p>
</td>
<td class="cellrowborder" valign="top" width="52.62%" headers="mcps1.3.3.2.2.2.1.5.1.4 "><div class="p" id="evs_04_2065__p4531155053519">Specifies whether the disk is shareable. The default value is <strong id="evs_04_2065__b789259195017">false</strong>.<ul id="evs_04_2065__ul202952187368"><li id="evs_04_2065__li182958188365"><strong id="evs_04_2065__b2087914016511">true</strong>: specifies a shared disk.</li><li id="evs_04_2065__li0295171811366"><strong id="evs_04_2065__b11149315519">false</strong>: specifies a non-shared disk.</li></ul>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="evs_04_2065__note1826402105335"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="evs_04_2065__p16437621105335">Specifying either two of the <span class="parmname" id="evs_04_2065__parmname808459360103045"><b>source_volid</b></span>, <span class="parmname" id="evs_04_2065__parmname1181435307103045"><b>snapshot_id</b></span>, and <span class="parmname" id="evs_04_2065__parmname1312653178103045"><b>imageRef</b></span> fields is not supported.</p>
</div></div>
</li><li id="evs_04_2065__li4145283210319"><a name="evs_04_2065__li4145283210319"></a><a name="li4145283210319"></a>Parameters in the <strong id="evs_04_2065__b842352706152641">metadata</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__evs_04_2013_table3430728295554" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__evs_04_2013_row4496975195554"><th align="left" class="cellrowborder" valign="top" width="17%" id="mcps1.3.3.2.3.2.1.5.1.1"><p id="evs_04_2065__evs_04_2013_p5979314595726">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.3.2.3.2.1.5.1.2"><p id="evs_04_2065__evs_04_2013_p1140655395726">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.3.2.3.2.1.5.1.3"><p id="evs_04_2065__evs_04_2013_p5151561095726">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46%" id="mcps1.3.3.2.3.2.1.5.1.4"><p id="evs_04_2065__evs_04_2013_p1201488395726">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__evs_04_2013_row456195295554"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.3.2.3.2.1.5.1.1 "><p id="evs_04_2065__evs_04_2013_p1562408795622">__system__encrypted</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.2.3.2.1.5.1.2 "><p id="evs_04_2065__evs_04_2013_p5759155095622">String</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.2.3.2.1.5.1.3 "><p id="evs_04_2065__evs_04_2013_p3440400295622">No</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.3.3.2.3.2.1.5.1.4 "><p id="evs_04_2065__p4269864016712">Specifies the encryption field in <strong id="evs_04_2065__b09671351612">metadata</strong>. The value can be <strong id="evs_04_2065__b1296817511117">0</strong> (not encrypted) or <strong id="evs_04_2065__b79683516119">1</strong> (encrypted).</p>
<p id="evs_04_2065__evs_04_2013_p3526077895622">If this parameter does not exist, the disk will not be encrypted by default.</p>
</td>
</tr>
<tr id="evs_04_2065__evs_04_2013_row247050109562"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.3.2.3.2.1.5.1.1 "><p id="evs_04_2065__evs_04_2013_p241272995622">__system__cmkid</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.2.3.2.1.5.1.2 "><p id="evs_04_2065__evs_04_2013_p6121338895622">String</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.2.3.2.1.5.1.3 "><p id="evs_04_2065__evs_04_2013_p5933737595622">No</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.3.3.2.3.2.1.5.1.4 "><p id="evs_04_2065__evs_04_2013_p4159804295622">Specifies the encryption CMK ID in <strong id="evs_04_2065__b192621292220">metadata</strong>. This parameter is used together with <strong id="evs_04_2065__b1926819291927">__system__encrypted</strong> for encryption. The length of <strong id="evs_04_2065__b42683296215">cmkid</strong> is fixed at 36 bytes.</p>
<div class="note" id="evs_04_2065__note1483983117491"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2065__evs_04_2013_p399515405333">For details about how to obtain the CMK ID, see <strong id="evs_04_2065__evs_04_2013_b842352706154213">Querying the List of CMKs</strong> in the <em id="evs_04_2065__evs_04_2013_i842352697153936">Key Management Service API Reference</em>.</p>
</div></div>
</td>
</tr>
<tr id="evs_04_2065__evs_04_2013_row60499086104915"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.3.2.3.2.1.5.1.1 "><p id="evs_04_2065__evs_04_2013_p1478896104915">hw:passthrough</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.2.3.2.1.5.1.2 "><p id="evs_04_2065__evs_04_2013_p52681767104915">String</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.2.3.2.1.5.1.3 "><p id="evs_04_2065__evs_04_2013_p39364763104915">No</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.3.3.2.3.2.1.5.1.4 "><ul id="evs_04_2065__evs_04_2013_ul14462208141855"><li id="evs_04_2065__evs_04_2013_li16942218141855">If this parameter is set to <strong id="evs_04_2065__b141716512562">true</strong>, the disk device type is SCSI, that is, Small Computer System Interface (SCSI), which allows ECS OSs to directly access the underlying storage media and supports SCSI reservation commands.</li><li id="evs_04_2065__evs_04_2013_li42055621173515">If this parameter is set to <strong id="evs_04_2065__b84235270620394">false</strong>, the disk device type will be VBD, which supports only simple SCSI read/write commands.</li><li id="evs_04_2065__li922714915316">If this parameter does not appear, the disk device type is VBD.<div class="note" id="evs_04_2065__evs_04_2013_note30831239112110"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2065__evs_04_2013_p9045701112110">If parameter <strong id="evs_04_2065__b566443801111854">shareable</strong> is set to <strong id="evs_04_2065__b840555499111854">true</strong> and parameter <strong id="evs_04_2065__b347106191111854">hw:passthrough</strong> is not specified, shared VBD disks are created.</p>
</div></div>
</li></ul>
</td>
</tr>
<tr id="evs_04_2065__row6091294618292"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.3.2.3.2.1.5.1.1 "><p id="evs_04_2065__p3500156018292">full_clone</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.2.3.2.1.5.1.2 "><p id="evs_04_2065__p1655411118292">String</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.2.3.2.1.5.1.3 "><p id="evs_04_2065__p6581460618292">No</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.3.3.2.3.2.1.5.1.4 "><p id="evs_04_2065__p47931946183150">If the disk is created from a snapshot and linked cloning needs to be used, set this parameter to <strong id="evs_04_2065__b46641830125217">0</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="evs_04_2065__evs_04_2013_note2244462910238"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="evs_04_2065__p1553010586315">The preceding table provides only some parameters in <strong id="evs_04_2065__b842352706103555">metadata</strong> for your reference. You can also specify other fields based on the disk creation requirements.</p>
<ul id="evs_04_2065__evs_04_2013_ul157155141073"><li id="evs_04_2065__evs_04_2013_li672755311017">If the disk is created from a snapshot, <span class="parmname" id="evs_04_2065__evs_04_2013_parmname7812047010180"><b>__system__encrypted</b></span> and <span class="parmname" id="evs_04_2065__evs_04_2013_parmname92561345110180"><b>__system__cmkid</b></span> are not supported, and the newly created disk has the same encryption attribute as that of the snapshot's source disk.</li><li id="evs_04_2065__evs_04_2013_li6525963611054">If the disk is created from an image, <span class="parmname" id="evs_04_2065__evs_04_2013_parmname663022275101940"><b>__system__encrypted</b></span> and <span class="parmname" id="evs_04_2065__evs_04_2013_parmname809594445101940"><b>__system__cmkid</b></span> are not supported, and the newly created disk has the same encryption attribute as that of the image.</li><li id="evs_04_2065__evs_04_2013_li238323541073">If the disk is created from a snapshot, <span class="parmname" id="evs_04_2065__evs_04_2013_parmname1169725898102044"><b>hw:passthrough</b></span> is not supported, and the newly created disk has the same device type as that of the snapshot's source disk.</li><li id="evs_04_2065__evs_04_2013_li425622071076">If the disk is created from an image, <span class="parmname" id="evs_04_2065__evs_04_2013_parmname150998616102812"><b>hw:passthrough</b></span> is not supported, and the device type of newly created disk is VBD.</li></ul>
</div></div>
</li><li id="evs_04_2065__li47101587144650">Example request<pre class="screen" id="evs_04_2065__screen443421891318">{
"volume": {
"name": "openapi_vol01",
"imageRef": "027cf713-45a6-45f0-ac1b-0ccc57ac12e2",
"availability_zone": "az-dc-1",
"description": "create for api test",
"volume_type": "SATA",
"metadata": {
"volume_owner": "openapi"
},
"multiattach": false,
"size": 40
},
}</pre>
</li></ul>
</div>
<div class="section" id="evs_04_2065__section7093323"><h4 class="sectiontitle">Response</h4><ul id="evs_04_2065__ul37131542"><li id="evs_04_2065__li11266091410">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__table192671691419" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__row1626713984113"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.1.1.4.1.1"><p id="evs_04_2065__p626716915410">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.35%" id="mcps1.3.4.2.1.1.1.4.1.2"><p id="evs_04_2065__p10268199164120">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.65%" id="mcps1.3.4.2.1.1.1.4.1.3"><p id="evs_04_2065__p226814984116">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__row20268997416"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="evs_04_2065__p192684913418">volume</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="evs_04_2065__p1326816984113">Object</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="evs_04_2065__p1826816912416">Specifies the information of the created disks. For details, see <a href="#evs_04_2065__li3451542201439">Parameters in the volumes field</a>.</p>
</td>
</tr>
<tr id="evs_04_2065__row197012674215"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="evs_04_2065__p129522216412">error</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="evs_04_2065__p1595262111415">Object</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="evs_04_2065__p109527215417">Specifies the error message returned when an error occurs. For details, see <a href="#evs_04_2065__li0419202382514">Parameters in the error field</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2065__li3451542201439"><a name="evs_04_2065__li3451542201439"></a><a name="li3451542201439"></a>Parameters in the <strong id="evs_04_2065__b19847533543">volumes</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__table34701445142557" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__row12524911142557"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.2.1.4.1.1"><p id="evs_04_2065__p7884856142557">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.35%" id="mcps1.3.4.2.2.2.1.4.1.2"><p id="evs_04_2065__p34693598142557">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.65%" id="mcps1.3.4.2.2.2.1.4.1.3"><p id="evs_04_2065__p58539486142557">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__row444782011610"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p18308336144438">id</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p6580236144438">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p21928856144438">Specifies the disk ID.</p>
</td>
</tr>
<tr id="evs_04_2065__row44077962142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p14226985144438">links</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p11535156144438">list</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p50473003144438">Specifies the disk URI. For details, see <a href="#evs_04_2065__li1043159617124">Parameters in the links field</a>.</p>
</td>
</tr>
<tr id="evs_04_2065__row16186817142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p19162411144438">name</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p8651439144438">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p55103877144438">Specifies the disk name.</p>
</td>
</tr>
<tr id="evs_04_2065__row2987651144410"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p39625821144438">status</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p55574965144438">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p24889213144438">Specifies the disk status. For details, see <a href="evs_04_0040.html">EVS Disk Status</a>.</p>
</td>
</tr>
<tr id="evs_04_2065__row45785905142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p24843442144438">attachments</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p66161799144438">list</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p27432950144438">Specifies the disk attachment information. For details, see <a href="#evs_04_2065__li3900093617124">Parameters in the attachments field</a>.</p>
</td>
</tr>
<tr id="evs_04_2065__row35247553142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p179170144438">availability_zone</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p14512814144438">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p58206487144438">Specifies the AZ to which the disk belongs.</p>
</td>
</tr>
<tr id="evs_04_2065__row27126244142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p19727534144438">bootable</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p54426427144438">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><div class="p" id="evs_04_2065__evs_04_2010_p8780414125315">Specifies whether the disk is bootable.<ul id="evs_04_2065__ul185931714111"><li id="evs_04_2065__li135936114118"><strong id="evs_04_2065__b1867946184516">true</strong>: specifies a bootable disk.</li><li id="evs_04_2065__li1593611917"><strong id="evs_04_2065__b1317878184511">false</strong>: specifies a non-bootable disk.</li></ul>
</div>
</td>
</tr>
<tr id="evs_04_2065__row17610291172344"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p5866739172351">encrypted</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p5443865172351">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p15286422172351"><span id="evs_04_2065__text115706570229">Currently, this field is not supported by EVS.</span></p>
</td>
</tr>
<tr id="evs_04_2065__row49237196142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p28651206144438">created_at</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p1296456144535">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p28821893144438">Specifies the time when the disk was created.</p>
<p id="evs_04_2065__p586613505312"><span id="evs_04_2065__text28661350936">Time format: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX</span></p>
</td>
</tr>
<tr id="evs_04_2065__row39017307142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p6085885144438">description</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p18611115144535">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p44410693144438">Specifies the disk description.</p>
</td>
</tr>
<tr id="evs_04_2065__row20107664142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p28923171144438">volume_type</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p22198851144535">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p9630579144438">Specifies the disk type.</p>
<div class="p" id="evs_04_2065__p123901859171916">Currently, the value can be <strong id="evs_04_2065__evs_04_2003_b842352706164929_1">SSD</strong>, <strong id="evs_04_2065__evs_04_2003_b842352706164932_1">SAS</strong>, <strong id="evs_04_2065__evs_04_2003_b842352706164937_1">SATA</strong>, <strong id="evs_04_2065__evs_04_2003_b842352706164941_1">co-p1</strong>, or <strong id="evs_04_2065__evs_04_2003_b842352706164944_1">uh-l1</strong>.<ul id="evs_04_2065__evs_04_2003_ul11489121916439_1"><li id="evs_04_2065__evs_04_2003_li15488111934310_1"><strong id="evs_04_2065__evs_04_2003_b842352706165021_1">SSD</strong>: specifies the ultra-high I/O disk type.</li><li id="evs_04_2065__evs_04_2003_li0488119194318_1"><strong id="evs_04_2065__evs_04_2003_b1784237562165049_1">SAS</strong>: specifies the high I/O disk type.</li><li id="evs_04_2065__evs_04_2003_li348881917438_1"><strong id="evs_04_2065__evs_04_2003_b3295367816515_1">SATA</strong>: specifies the common I/O disk type.</li><li id="evs_04_2065__evs_04_2003_li848817193433_1"><strong id="evs_04_2065__evs_04_2003_b141033785_1">co-p1</strong>: specifies the high I/O (performance-optimized I) disk type.</li><li id="evs_04_2065__evs_04_2003_li548917194430_1"><strong id="evs_04_2065__evs_04_2003_b1336833005_1">uh-l1</strong>: specifies the ultra-high I/O (latency-optimized) disk type.<p id="evs_04_2065__evs_04_2003_p14488819154320_1">Disks of the <strong id="evs_04_2065__evs_04_2003_b108664633815116_1">co-p1</strong> and <strong id="evs_04_2065__evs_04_2003_b104594858115116_1">uh-l1</strong> types are used exclusively for HPC ECSs and SAP HANA ECSs.</p>
</li></ul>
</div>
</td>
</tr>
<tr id="evs_04_2065__row12897861142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p41370851144438">replication_status</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p7354807144535">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p27786537144438"><span id="evs_04_2065__text6498181171119">Reserved field</span></p>
</td>
</tr>
<tr id="evs_04_2065__row45680217142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p56617581144438">consistencygroup_id</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p25180208144535">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p40860550144438">Specifies the ID of the consistency group where the disk belongs.</p>
<p id="evs_04_2065__p1919420431188"><span id="evs_04_2065__text161944439182">Currently, this field is not supported by EVS.</span></p>
</td>
</tr>
<tr id="evs_04_2065__row47480567142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p58114746144438">source_volid</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p47440982144535">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p52975605144438">Specifies the source disk ID.</p>
<p id="evs_04_2065__p14532184716186"><span id="evs_04_2065__text12532347191815">Currently, this field is not supported by EVS.</span></p>
</td>
</tr>
<tr id="evs_04_2065__row31517135142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p31619531144438">snapshot_id</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p66078031144535">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p57055846144438">Specifies the snapshot ID.</p>
</td>
</tr>
<tr id="evs_04_2065__row15610713142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p53325033144438">metadata</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p24360403144438">Object</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p42403730144438">Specifies the disk metadata. For details, see <a href="#evs_04_2065__li29114110314">Parameters in the metadata field</a>.</p>
</td>
</tr>
<tr id="evs_04_2065__row5657368142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p42241765144438">size</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p66139813144438">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p17400122144438">Specifies the disk size, in GB.</p>
</td>
</tr>
<tr id="evs_04_2065__row39412545144428"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p1113688144438">user_id</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p51894643144540">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p26218517352">Reserved field</p>
</td>
</tr>
<tr id="evs_04_2065__row25381049144431"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p26680804144438">updated_at</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p39072645144540">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p42877354144438">Specifies the time when the disk was updated.</p>
<p id="evs_04_2065__p15772145473814"><span id="evs_04_2065__text151181202390">Time format: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX</span></p>
</td>
</tr>
<tr id="evs_04_2065__row48384415144425"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p51969649144438">shareable</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p5099125121957">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><p id="evs_04_2065__p15113052144438">Specifies whether the disk is shareable.</p>
<div class="note" id="evs_04_2065__note182866179314"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="evs_04_2065__evs_04_2013_p45212589213213_1">This field is no longer used. Use <strong id="evs_04_2065__evs_04_2013_b84235270610834_1">multiattach</strong>.</p>
</div></div>
</td>
</tr>
<tr id="evs_04_2065__row42462677142557"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.2.1.4.1.1 "><p id="evs_04_2065__p11561839144438">multiattach</p>
</td>
<td class="cellrowborder" valign="top" width="22.35%" headers="mcps1.3.4.2.2.2.1.4.1.2 "><p id="evs_04_2065__p64093800144438">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="57.65%" headers="mcps1.3.4.2.2.2.1.4.1.3 "><div class="p" id="evs_04_2065__evs_04_2010_p4781191416535">Specifies whether the disk is shareable.<ul id="evs_04_2065__ul161621719119"><li id="evs_04_2065__li91631519818"><strong id="evs_04_2065__b181751317104517">true</strong>: specifies a shared disk.</li><li id="evs_04_2065__li1916311191410"><strong id="evs_04_2065__b9244660">false</strong>: specifies a non-shared disk.</li></ul>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2065__li1043159617124"><a name="evs_04_2065__li1043159617124"></a><a name="li1043159617124"></a>Parameters in the <strong id="evs_04_2065__b858017508218">links</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__table4005083311851" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__row4647546111851"><th align="left" class="cellrowborder" valign="top" width="19.27807219278072%" id="mcps1.3.4.2.3.2.1.4.1.1"><p id="evs_04_2065__p641601411851">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.0975902409759%" id="mcps1.3.4.2.3.2.1.4.1.2"><p id="evs_04_2065__p4993509511851">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.624337566243376%" id="mcps1.3.4.2.3.2.1.4.1.3"><p id="evs_04_2065__p6579322611851">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__row2765107611851"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.3.2.1.4.1.1 "><p id="evs_04_2065__p2514470311851">href</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.3.2.1.4.1.2 "><p id="evs_04_2065__p2345507511851">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.3.2.1.4.1.3 "><p id="evs_04_2065__p812224311851">Specifies the corresponding shortcut link.</p>
</td>
</tr>
<tr id="evs_04_2065__row599132611851"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.3.2.1.4.1.1 "><p id="evs_04_2065__p1553537811851">rel</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.3.2.1.4.1.2 "><p id="evs_04_2065__p5040609911851">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.3.2.1.4.1.3 "><p id="evs_04_2065__p193416911851">Specifies the shortcut link marker name.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2065__li3900093617124"><a name="evs_04_2065__li3900093617124"></a><a name="li3900093617124"></a>Parameters in the <strong id="evs_04_2065__b1846055612113">attachments</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__table3471673811913" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__row950913211913"><th align="left" class="cellrowborder" valign="top" width="19.27807219278072%" id="mcps1.3.4.2.4.2.1.4.1.1"><p id="evs_04_2065__p3204224811913">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.0975902409759%" id="mcps1.3.4.2.4.2.1.4.1.2"><p id="evs_04_2065__p4528532911913">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.624337566243376%" id="mcps1.3.4.2.4.2.1.4.1.3"><p id="evs_04_2065__p2610634411913">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__row3423911011913"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.4.2.1.4.1.1 "><p id="evs_04_2065__p2190452911913">server_id</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.4.2.1.4.1.2 "><p id="evs_04_2065__p2943640011913">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.4.2.1.4.1.3 "><p id="evs_04_2065__p6002094011913">Specifies the ID of the server to which the disk is attached.</p>
</td>
</tr>
<tr id="evs_04_2065__row331754911913"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.4.2.1.4.1.1 "><p id="evs_04_2065__p28604711913">attachment_id</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.4.2.1.4.1.2 "><p id="evs_04_2065__p2316983311913">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.4.2.1.4.1.3 "><p id="evs_04_2065__p1570218411913">Specifies the ID of the attachment information.</p>
</td>
</tr>
<tr id="evs_04_2065__row41611216113819"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.4.2.1.4.1.1 "><p id="evs_04_2065__p26997962113823">attached_at</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.4.2.1.4.1.2 "><p id="evs_04_2065__p39351338113823">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.4.2.1.4.1.3 "><p id="evs_04_2065__p16333436113823">Specifies the time when the disk was attached.</p>
<p id="evs_04_2065__p103581088395"><span id="evs_04_2065__text136037162396">Time format: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX</span></p>
</td>
</tr>
<tr id="evs_04_2065__row710192811913"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.4.2.1.4.1.1 "><p id="evs_04_2065__p3838529111913">host_name</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.4.2.1.4.1.2 "><p id="evs_04_2065__p2220087511913">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.4.2.1.4.1.3 "><p id="evs_04_2065__p3370764811913">Specifies the name of the physical host accommodating the server to which the disk is attached.</p>
</td>
</tr>
<tr id="evs_04_2065__row3493337611913"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.4.2.1.4.1.1 "><p id="evs_04_2065__p1103121411913">volume_id</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.4.2.1.4.1.2 "><p id="evs_04_2065__p2111318111913">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.4.2.1.4.1.3 "><p id="evs_04_2065__p1089110111913">Specifies the disk ID.</p>
</td>
</tr>
<tr id="evs_04_2065__row3091104611913"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.4.2.1.4.1.1 "><p id="evs_04_2065__p2076682611913">device</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.4.2.1.4.1.2 "><p id="evs_04_2065__p439134611913">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.4.2.1.4.1.3 "><p id="evs_04_2065__p2192276811913">Specifies the device name.</p>
</td>
</tr>
<tr id="evs_04_2065__row6308718811913"><td class="cellrowborder" valign="top" width="19.27807219278072%" headers="mcps1.3.4.2.4.2.1.4.1.1 "><p id="evs_04_2065__p978858311913">id</p>
</td>
<td class="cellrowborder" valign="top" width="24.0975902409759%" headers="mcps1.3.4.2.4.2.1.4.1.2 "><p id="evs_04_2065__p5467773011913">String</p>
</td>
<td class="cellrowborder" valign="top" width="56.624337566243376%" headers="mcps1.3.4.2.4.2.1.4.1.3 "><p id="evs_04_2065__p4371205011913">Specifies the ID of the attached resource.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2065__li29114110314"><a name="evs_04_2065__li29114110314"></a><a name="li29114110314"></a>Parameters in the <strong id="evs_04_2065__evs_04_3004_b1734614164165">metadata</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__evs_04_3004_table3430728295554" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__evs_04_3004_row4496975195554"><th align="left" class="cellrowborder" valign="top" width="20.24%" id="mcps1.3.4.2.5.2.1.4.1.1"><p id="evs_04_2065__evs_04_3004_p8809200174410">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.62%" id="mcps1.3.4.2.5.2.1.4.1.2"><p id="evs_04_2065__evs_04_3004_p168135017449">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.14%" id="mcps1.3.4.2.5.2.1.4.1.3"><p id="evs_04_2065__evs_04_3004_p1282213034412">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__evs_04_3004_row456195295554"><td class="cellrowborder" valign="top" width="20.24%" headers="mcps1.3.4.2.5.2.1.4.1.1 "><p id="evs_04_2065__evs_04_3004_p1562408795622">__system__encrypted</p>
</td>
<td class="cellrowborder" valign="top" width="22.62%" headers="mcps1.3.4.2.5.2.1.4.1.2 "><p id="evs_04_2065__evs_04_3004_p5759155095622">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.2.5.2.1.4.1.3 "><div class="p" id="evs_04_2065__evs_04_3004_p177192813501">Specifies the parameter that describes the encryption function in <strong id="evs_04_2065__evs_04_3004_b84235270614509">metadata</strong>. The value can be <strong id="evs_04_2065__evs_04_3004_b842352706145015">0</strong> or <strong id="evs_04_2065__evs_04_3004_b842352706145020">1</strong>.<ul id="evs_04_2065__evs_04_3004_ul141951225145011"><li id="evs_04_2065__evs_04_3004_li191951925125013"><strong id="evs_04_2065__evs_04_3004_b842352706145038">0</strong>: indicates the disk is not encrypted.</li><li id="evs_04_2065__evs_04_3004_li11195192510508"><strong id="evs_04_2065__evs_04_3004_b842352706145058">1</strong>: indicates the disk is encrypted.</li><li id="evs_04_2065__evs_04_3004_li191958257506">If this parameter does not appear, the disk is not encrypted by default.</li></ul>
</div>
</td>
</tr>
<tr id="evs_04_2065__evs_04_3004_row247050109562"><td class="cellrowborder" valign="top" width="20.24%" headers="mcps1.3.4.2.5.2.1.4.1.1 "><p id="evs_04_2065__evs_04_3004_p241272995622">__system__cmkid</p>
</td>
<td class="cellrowborder" valign="top" width="22.62%" headers="mcps1.3.4.2.5.2.1.4.1.2 "><p id="evs_04_2065__evs_04_3004_p6121338895622">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.2.5.2.1.4.1.3 "><p id="evs_04_2065__evs_04_3004_p4159804295622">Specifies the encryption CMK ID in <strong id="evs_04_2065__evs_04_3004_b84235270615116">metadata</strong>. This parameter is used together with <strong id="evs_04_2065__evs_04_3004_b842352706143827">__system__encrypted</strong> for encryption. The length of <strong id="evs_04_2065__evs_04_3004_b84235270614396">cmkid</strong> is fixed at 36 bytes.</p>
</td>
</tr>
<tr id="evs_04_2065__evs_04_3004_row60499086104915"><td class="cellrowborder" valign="top" width="20.24%" headers="mcps1.3.4.2.5.2.1.4.1.1 "><p id="evs_04_2065__evs_04_3004_p1478896104915">hw:passthrough</p>
</td>
<td class="cellrowborder" valign="top" width="22.62%" headers="mcps1.3.4.2.5.2.1.4.1.2 "><p id="evs_04_2065__evs_04_3004_p52681767104915">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.2.5.2.1.4.1.3 "><div class="p" id="evs_04_2065__evs_04_3004_p17177177145116">Specifies the parameter that describes the disk device type in <strong id="evs_04_2065__evs_04_3004_b84235270615173">metadata</strong>. The value can be <strong id="evs_04_2065__evs_04_3004_b842352706151718">true</strong> or <strong id="evs_04_2065__evs_04_3004_b842352706151722">false</strong>.<ul id="evs_04_2065__evs_04_3004_ul14462208141855"><li id="evs_04_2065__evs_04_3004_li16942218141855">If this parameter is set to <strong id="evs_04_2065__evs_04_3004_b55868159103732">true</strong>, the disk device type is SCSI, which allows ECS OSs to directly access the underlying storage media and supports SCSI reservation commands.</li><li id="evs_04_2065__evs_04_3004_li42055621173515">If this parameter is set to <strong id="evs_04_2065__evs_04_3004_b1524131935716">false</strong>, the disk device type is VBD (the default type), that is, Virtual Block Device (VBD), which supports only simple SCSI read/write commands.</li><li id="evs_04_2065__evs_04_3004_li922714915316">If this parameter does not appear, the disk device type is VBD.</li></ul>
</div>
</td>
</tr>
<tr id="evs_04_2065__evs_04_3004_row991210132288"><td class="cellrowborder" valign="top" width="20.24%" headers="mcps1.3.4.2.5.2.1.4.1.1 "><p id="evs_04_2065__evs_04_3004_p3500156018292">full_clone</p>
</td>
<td class="cellrowborder" valign="top" width="22.62%" headers="mcps1.3.4.2.5.2.1.4.1.2 "><p id="evs_04_2065__evs_04_3004_p1655411118292">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.14%" headers="mcps1.3.4.2.5.2.1.4.1.3 "><p id="evs_04_2065__evs_04_3004_p47931946183150">Specifies the clone method. When the disk is created from a snapshot, the parameter value is <strong id="evs_04_2065__evs_04_3004_b84235270616922">0</strong>, indicating the linked cloning method.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2065__li0419202382514"><a name="evs_04_2065__li0419202382514"></a><a name="li0419202382514"></a>Parameters in the <strong id="evs_04_2065__evs_04_2013_b1288034833610">error</strong> field
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="evs_04_2065__evs_04_2013_table15441099103019" frame="border" border="1" rules="all"><thead align="left"><tr id="evs_04_2065__evs_04_2013_row54094047103019"><th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.4.2.6.2.1.4.1.1"><p id="evs_04_2065__evs_04_2013_p19541716103019">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.17788221177882%" id="mcps1.3.4.2.6.2.1.4.1.2"><p id="evs_04_2065__evs_04_2013_p39375186103019">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.64423557644236%" id="mcps1.3.4.2.6.2.1.4.1.3"><p id="evs_04_2065__evs_04_2013_p38578950103019">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="evs_04_2065__evs_04_2013_row59401790103019"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.6.2.1.4.1.1 "><p id="evs_04_2065__evs_04_2013_p46815658103019">message</p>
</td>
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.6.2.1.4.1.2 "><p id="evs_04_2065__evs_04_2013_p33971979103019">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.4.2.6.2.1.4.1.3 "><p id="evs_04_2065__evs_04_2013_p21623243103019">Specifies the error message returned when an error occurs.</p>
</td>
</tr>
<tr id="evs_04_2065__evs_04_2013_row60391466103019"><td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.6.2.1.4.1.1 "><p id="evs_04_2065__evs_04_2013_p59870541103019">code</p>
</td>
<td class="cellrowborder" valign="top" width="21.17788221177882%" headers="mcps1.3.4.2.6.2.1.4.1.2 "><p id="evs_04_2065__evs_04_2013_p17675690103019">String</p>
</td>
<td class="cellrowborder" valign="top" width="57.64423557644236%" headers="mcps1.3.4.2.6.2.1.4.1.3 "><p id="evs_04_2065__evs_04_2013_p6087468103019">Specifies the error code returned when an error occurs.</p>
<p id="evs_04_2065__evs_04_2013_p54787218103019">For details about the error code, see <a href="evs_04_0038.html">Error Codes</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="evs_04_2065__li65748423">Example response<pre class="screen" id="evs_04_2065__screen59150394151752">{
"volume": {
"attachments": [ ],
"availability_zone": "az-dc-1",
"bootable": "false",
"consistencygroup_id": null,
"created_at": "2016-05-25T02:38:40.392463",
"description": "create for api test",
"encrypted": false,
"id": "8dd7c486-8e9f-49fe-bceb-26aa7e312b66",
"links": [
{
"href": "https://volume.localdomain.com:8776/v2/5dd0b0056f3d47b6ab4121667d35621a/volumes/8dd7c486-8e9f-49fe-bceb-26aa7e312b66",
"rel": "self"
},
{
"href": "https://volume.localdomain.com:8776/5dd0b0056f3d47b6ab4121667d35621a/volumes/8dd7c486-8e9f-49fe-bceb-26aa7e312b66",
"rel": "bookmark"
}
],
"metadata": {
"volume_owner": "openapi"
},
"name": "openapi_vol01",
"replication_status": "disabled",
"multiattach": false,
"size": 40,
"snapshot_id": null,
"source_volid": null,
"status": "creating",
"updated_at": null,
"user_id": "39f6696ae23740708d0f358a253c2637",
"volume_type": "SATA"
}
}</pre>
<p id="evs_04_2065__p8355436185729">or</p>
<pre class="screen" id="evs_04_2065__screen59558308185754">{
"error": {
"message": "XXXX",
"code": "XXX"
}
}</pre>
<p id="evs_04_2065__p5655715720175">In the preceding example, <strong id="evs_04_2065__b842352706143959">error</strong> indicates a general error, for example, <strong id="evs_04_2065__b842352706144438">badRequest</strong> or <strong id="evs_04_2065__b842352706144454">itemNotFound</strong>. An example is provided as follows:</p>
<pre class="screen" id="evs_04_2065__screen54581143201731">{
"badRequest": {
"message": "XXXX",
"code": "XXX"
}
}</pre>
</li></ul>
</div>
<div class="section" id="evs_04_2065__section63839913"><h4 class="sectiontitle">Status Codes</h4><ul id="evs_04_2065__ul9862716"><li id="evs_04_2065__li21655584">Normal<p id="evs_04_2065__p60682533"><a name="evs_04_2065__li21655584"></a><a name="li21655584"></a>202</p>
</li></ul>
</div>
<div class="section" id="evs_04_2065__section431317151242"><h4 class="sectiontitle">Error Codes</h4><p id="evs_04_2065__evs_04_2013_p783819215242">For details, see <a href="evs_04_0038.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="evs_04_2064.html">EVS Disk</a></div>
</div>
</div>
View Git Blame Copy Permalink