forked from docs/doc-exports
Zaoxu, Li
c236478734
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com> Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com> Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
431 lines
43 KiB
HTML
431 lines
43 KiB
HTML
<a name="EN-US_TOPIC_0133188204"></a><a name="EN-US_TOPIC_0133188204"></a>
|
|
|
|
<h1 class="topictitle1">Importing an Image File Quickly</h1>
|
|
<div id="body1537962346204"><div class="section" id="EN-US_TOPIC_0133188204__section1194520316464"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0133188204__p664534215521">This API is used to quickly create a private image from an oversized external image file that has uploaded to the OBS bucket. Currently, only ZVHD2 and RAW image files are supported, and the size of an image file cannot exceed 1 TB.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p109629473523">The fast image creation function is only available for image files in RAW or ZVHD2 format. For other formats of image files that are smaller than 128 GB, you are advised to import these files with the common method.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p117122034194714">The API is an asynchronous one. If it is successfully called, the cloud service system receives the request. However, you need to use the asynchronous job query API to query the image creation status. For details, see <a href="en-us_topic_0022473688.html">Querying the Status of an Asynchronous Job</a>.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0133188204__section244817584484"><h4 class="sectiontitle">Constraints</h4><div class="p" id="EN-US_TOPIC_0133188204__p888910949">Before importing image files, ensure that the file format is RAW or ZVHD2 and the following have been done:<ul id="EN-US_TOPIC_0133188204__ul19902104893118"><li id="EN-US_TOPIC_0133188204__li290218480317">RAW image files have been optimized, and bitmap files have been generated.</li><li id="EN-US_TOPIC_0133188204__li129021348103117">ZVHD2 image files have been optimized as required.</li></ul>
|
|
</div>
|
|
<div class="note" id="EN-US_TOPIC_0133188204__note197617242018"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0133188204__p19310557497">For how to convert image file formats and generate a bitmap file, see section "Quickly Importing an Image File" in the <em id="EN-US_TOPIC_0133188204__i84235269785921">Image Management Service User Guide</em>.</p>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0133188204__section1594513117469"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0133188204__p10430195510476">POST /v2/cloudimages/quickimport/action</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0133188204__section1394517316467"><h4 class="sectiontitle">Request</h4><ul id="EN-US_TOPIC_0133188204__ul163050328461"><li id="EN-US_TOPIC_0133188204__li630573254612">Parameters in the request body when an image file is used to create a system disk image
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0133188204__table1996117311464" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0133188204__row230533204615"><th align="left" class="cellrowborder" valign="top" width="23.23232323232323%" id="mcps1.3.4.2.1.1.1.5.1.1"><p id="EN-US_TOPIC_0133188204__p13051332144610">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.16161616161616%" id="mcps1.3.4.2.1.1.1.5.1.2"><p id="EN-US_TOPIC_0133188204__p1630520329462">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.2020202020202%" id="mcps1.3.4.2.1.1.1.5.1.3"><p id="EN-US_TOPIC_0133188204__p5305332184616">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40.4040404040404%" id="mcps1.3.4.2.1.1.1.5.1.4"><p id="EN-US_TOPIC_0133188204__p73056327467">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0133188204__row430593218463"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p330543210463">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p1630553264617">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p3305932144610">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p1551018218225">Specifies the image name.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p630510326467">For detailed description, see <a href="en-us_topic_0020091562.html">Image Attributes</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row130503284613"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p73051932154620">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p1430513324463">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p6305732154618">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p16554109232">Provides supplementary information about the image.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p14983181319239">For detailed description, see <a href="en-us_topic_0020091562.html">Image Attributes</a>.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p1230533224616">The value contains a maximum of 1024 characters and consists of only letters and digits. Carriage returns and angle brackets (< >) are not allowed. This parameter is left blank by default.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row143051632144610"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p18305432174611">os_version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p123051332104613">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p14305183244611">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p5305203217468">Specifies the OS version.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p430583213464">This parameter is valid if an external image file uploaded to the OBS bucket is used to create an image. For its value, see <a href="en-us_topic_0031617666.html">Values of Related Parameters</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row93058325464"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p103058329463">image_url</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p630533211465">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p1630593294615">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p1230517327465">Specifies the URL of the external image file in the OBS bucket.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p03051832114620">This parameter is mandatory if an external image file in the OBS bucket is used to create an image. The format is <em id="EN-US_TOPIC_0133188204__i84235269710218">OBS bucket name</em>:<em id="EN-US_TOPIC_0133188204__i84235269710226">Image file name</em>.</p>
|
|
<div class="note" id="EN-US_TOPIC_0133188204__note683161117572"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0133188204__p1983121111571">The storage class of the OBS bucket must be <strong id="EN-US_TOPIC_0133188204__b19684172820416">Standard</strong>.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row730573215467"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p1430593274613">min_disk</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p4305193224619">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p2305632134614">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p143051632104617">Specifies the minimum size (GB) of the system disk.</p>
|
|
<ul id="EN-US_TOPIC_0133188204__ul2568215149"><li id="EN-US_TOPIC_0133188204__li35615217144">This parameter is mandatory if an external image file in the OBS bucket is used to create an image.</li><li id="EN-US_TOPIC_0133188204__li135614291410">The value ranges from 1 to 1024 and must be greater than the size of the selected image file.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row16305113220466"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p1730583214460">tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p1230510329468">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p13058328463">Array of strings</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p10305732164620">Lists the image tags. This parameter is left blank by default.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p3106162222815">Set either <strong id="EN-US_TOPIC_0133188204__b68022071419">tags</strong> or <strong id="EN-US_TOPIC_0133188204__b17807204145">image_tags</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row1259121152812"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p21354848113521">image_tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p29922489113521">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p56528150113521">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p58098807113521">Lists the image tags. This parameter is left blank by default.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p19190125113278">Set either <strong id="EN-US_TOPIC_0133188204__b64491227181417">tags</strong> or <strong id="EN-US_TOPIC_0133188204__b5450172718146">image_tags</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row1330510320467"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p12305193254612">type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p430514323464">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p13305183212463">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p14305832164616">Specifies the image type. The parameter value is ECS/BMS for system disk images. The default value is <strong id="EN-US_TOPIC_0133188204__b842352706161934">ECS</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row108754514344"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p172919315292">enterprise_project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p172915311293">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p182911231172912">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p10305182217584">Specifies the enterprise project that the image belongs to.</p>
|
|
<ul id="EN-US_TOPIC_0133188204__ul76914342313"><li id="EN-US_TOPIC_0133188204__li06911382318">If the value is <strong id="EN-US_TOPIC_0133188204__b842352706111949">0</strong> or left blank, the image belongs to the default enterprise project.</li><li id="EN-US_TOPIC_0133188204__li186911342317">If the value is a UUID, the image belongs to the enterprise project corresponding to the UUID.<p id="EN-US_TOPIC_0133188204__p13705743174014"><a name="EN-US_TOPIC_0133188204__li186911342317"></a><a name="li186911342317"></a>For more information about enterprise projects and how to obtain enterprise project IDs, see <em id="EN-US_TOPIC_0133188204__i119223321415">Enterprise Management User Guide</em>.</p>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row134361944974"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.1.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p1531631810">architecture</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.1.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p35316311810">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.1.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p15318311813">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.1.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p1710991214517">Specifies the image architecture type. Available values include:</p>
|
|
<ul id="EN-US_TOPIC_0133188204__ul12299918656"><li id="EN-US_TOPIC_0133188204__li10299818454">x86</li><li id="EN-US_TOPIC_0133188204__li1439817211559">arm</li></ul>
|
|
<p id="EN-US_TOPIC_0133188204__p186813286510">The default value is <strong id="EN-US_TOPIC_0133188204__b1460217264193">x86</strong>.</p>
|
|
<div class="note" id="EN-US_TOPIC_0133188204__note4599194110418"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0133188204__p892691311810">If the image architecture is ARM, the boot mode is automatically changed to UEFI.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0133188204__li93051332124619">Parameters description when an image file uploaded to the OBS bucket is used to create an image
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0133188204__table399233124619" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0133188204__row163059328462"><th align="left" class="cellrowborder" valign="top" width="23.23232323232323%" id="mcps1.3.4.2.2.1.1.5.1.1"><p id="EN-US_TOPIC_0133188204__p13058328466">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.16161616161616%" id="mcps1.3.4.2.2.1.1.5.1.2"><p id="EN-US_TOPIC_0133188204__p130523214617">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.2020202020202%" id="mcps1.3.4.2.2.1.1.5.1.3"><p id="EN-US_TOPIC_0133188204__p8305103212461">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40.4040404040404%" id="mcps1.3.4.2.2.1.1.5.1.4"><p id="EN-US_TOPIC_0133188204__p1830563214461">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0133188204__row83058326463"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p3305173214616">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p53052032114616">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p630543214610">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p3305203234614">Specifies the image name. For detailed description, see <a href="en-us_topic_0020091562.html">Image Attributes</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row73051332174618"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p1230503213462">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p1230513211468">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p18305532154612">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p1630515328463">Provides supplementary information about the image. For detailed description, see <a href="en-us_topic_0020091562.html">Image Attributes</a>. The value contains a maximum of 1024 characters and consists of only letters and digits. Carriage returns and angle brackets (< >) are not allowed. This parameter is left blank by default.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row830510326469"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p113057324467">os_type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p1130553284618">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p143052324463">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p183051732184612">Specifies the OS version.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p1230518329464">When a data disk image created, the value can be <strong id="EN-US_TOPIC_0133188204__b18956127175">Linux</strong> or <strong id="EN-US_TOPIC_0133188204__b159510128177">Windows</strong>. The default is <strong id="EN-US_TOPIC_0133188204__b2096512141713">Linux</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row1330519329465"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p630533264610">image_url</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p1130553244617">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p14305123218469">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p1830573213469">Specifies the URL of the external image file in the OBS bucket.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p73051322460">This parameter is mandatory if an external image file in the OBS bucket is used to create an image. The format is <em id="EN-US_TOPIC_0133188204__i84235269710445">OBS bucket name</em>:<em id="EN-US_TOPIC_0133188204__i84235269710449">Image file name</em>.</p>
|
|
<div class="note" id="EN-US_TOPIC_0133188204__note736211389571"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0133188204__p03621438175719">The storage class of the OBS bucket must be <strong id="EN-US_TOPIC_0133188204__b1856839419">Standard</strong>.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row73059326469"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p2030533214463">min_disk</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p19305123212467">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p193051332114620">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p130513264618">Specifies the minimum size of the system disk in the unit of GB.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p15305173217466">This parameter is mandatory if an external image file in the OBS bucket is used to create an image. The value ranges from 1 to 1024. </p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row430516321463"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p130523212468">tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p830512325469">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p1430514322463">Array of strings</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p1830518323464">Lists the image tags. This parameter is left blank by default.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p1879112459285">Set either <strong id="EN-US_TOPIC_0133188204__b8662228161411">tags</strong> or <strong id="EN-US_TOPIC_0133188204__b5663328171414">image_tags</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row1874183652819"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p182233972817">image_tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p52233962817">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p72273910288">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p622153910286">Lists the image tags. This parameter is left blank by default.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p1222113913288">Set either <strong id="EN-US_TOPIC_0133188204__b21235334146">tags</strong> or <strong id="EN-US_TOPIC_0133188204__b17123833111414">image_tags</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row173051332174611"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p630519326463">type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p1430523210469">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p13305132164618">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p830513320465">Specifies the image type. The parameter value is DataImage for data disk images.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p91871248144310"></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row12938171493518"><td class="cellrowborder" valign="top" width="23.23232323232323%" headers="mcps1.3.4.2.2.1.1.5.1.1 "><p id="EN-US_TOPIC_0133188204__p1144371873517">enterprise_project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16161616161616%" headers="mcps1.3.4.2.2.1.1.5.1.2 "><p id="EN-US_TOPIC_0133188204__p9443718163514">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.2020202020202%" headers="mcps1.3.4.2.2.1.1.5.1.3 "><p id="EN-US_TOPIC_0133188204__p154430186356">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.4040404040404%" headers="mcps1.3.4.2.2.1.1.5.1.4 "><p id="EN-US_TOPIC_0133188204__p13443141833517">Specifies the enterprise project that the image belongs to.</p>
|
|
<ul id="EN-US_TOPIC_0133188204__ul444316189359"><li id="EN-US_TOPIC_0133188204__en-us_topic_0133188204_li06911382318">If the value is <strong id="EN-US_TOPIC_0133188204__b1707166804">0</strong> or left blank, the image belongs to the default enterprise project.</li><li id="EN-US_TOPIC_0133188204__en-us_topic_0133188204_li186911342317">If the value is a UUID, the image belongs to the enterprise project corresponding to the UUID.<p id="EN-US_TOPIC_0133188204__p18739132816434"><a name="EN-US_TOPIC_0133188204__en-us_topic_0133188204_li186911342317"></a><a name="en-us_topic_0133188204_li186911342317"></a>For more information about enterprise projects and how to obtain enterprise project IDs, see <em id="EN-US_TOPIC_0133188204__i5214636131415">Enterprise Management User Guide</em>.</p>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0133188204__section8454108133715"><h4 class="sectiontitle">Example Request</h4><ul id="EN-US_TOPIC_0133188204__ul234415106561"><li id="EN-US_TOPIC_0133188204__li165471377567">Creating a system disk image with parameter <strong id="EN-US_TOPIC_0133188204__b208016304617">tags</strong> using a file in an OBS bucket (file address in the bucket: ims-image:centos70.zvhd2)<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0133188204__screen14532171917547"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
|
|
<span class="normal"> 2</span>
|
|
<span class="normal"> 3</span>
|
|
<span class="normal"> 4</span>
|
|
<span class="normal"> 5</span>
|
|
<span class="normal"> 6</span>
|
|
<span class="normal"> 7</span>
|
|
<span class="normal"> 8</span>
|
|
<span class="normal"> 9</span>
|
|
<span class="normal">10</span>
|
|
<span class="normal">11</span>
|
|
<span class="normal">12</span>
|
|
<span class="normal">13</span>
|
|
<span class="normal">14</span>
|
|
<span class="normal">15</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">POST</span><span class="w"> </span><span class="n">https</span><span class="p">:</span><span class="c1">//{Endpoint}/v2/cloudimages/quickimport/action</span>
|
|
<span class="p">{</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"name"</span><span class="p">:</span><span class="w"> </span><span class="s">"ims_test_file"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"description"</span><span class="p">:</span><span class="w"> </span><span class="s">"Create an image using a file in the OBS bucket."</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"image_url"</span><span class="p">:</span><span class="w"> </span><span class="s">"ims-image:centos70.zvhd2"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"os_version"</span><span class="p">:</span><span class="w"> </span><span class="s">"CentOS 7.0 64bit"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"min_disk"</span><span class="p">:</span><span class="w"> </span><span class="mi">40</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"type"</span><span class="p">:</span><span class="w"> </span><span class="s">"ECS"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"tags"</span><span class="p">:</span>
|
|
<span class="w"> </span><span class="o">[</span>
|
|
<span class="w"> </span><span class="s">"aaa.111"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"bbb.333"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"ccc.444"</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="o">]</span>
|
|
<span class="p">}</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0133188204__li466014810018">Creating a system disk image with parameter <strong id="EN-US_TOPIC_0133188204__b19364415873">image_tags</strong> using a file in an OBS bucket (file address in the bucket: ims-image:centos70.zvhd2)<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0133188204__screen1987594417544"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
|
|
<span class="normal"> 2</span>
|
|
<span class="normal"> 3</span>
|
|
<span class="normal"> 4</span>
|
|
<span class="normal"> 5</span>
|
|
<span class="normal"> 6</span>
|
|
<span class="normal"> 7</span>
|
|
<span class="normal"> 8</span>
|
|
<span class="normal"> 9</span>
|
|
<span class="normal">10</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">POST</span><span class="w"> </span><span class="n">https</span><span class="p">:</span><span class="c1">//{Endpoint}/v2/cloudimages/quickimport/action</span>
|
|
<span class="p">{</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"name"</span><span class="p">:</span><span class="w"> </span><span class="s">"ims_test_file"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"description"</span><span class="p">:</span><span class="w"> </span><span class="s">"Create an image using a file in the OBS bucket."</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"image_url"</span><span class="p">:</span><span class="w"> </span><span class="s">"ims-image:centos70.zvhd2"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"os_version"</span><span class="p">:</span><span class="w"> </span><span class="s">"CentOS 7.0 64bit"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"min_disk"</span><span class="p">:</span><span class="w"> </span><span class="mi">40</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"type"</span><span class="p">:</span><span class="w"> </span><span class="s">"ECS"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"image_tags"</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="p">{</span><span class="s">"key"</span><span class="p">:</span><span class="s">"key2"</span><span class="p">,</span><span class="s">"value"</span><span class="p">:</span><span class="s">"value2"</span><span class="p">},{</span><span class="s">"key"</span><span class="p">:</span><span class="s">"key1"</span><span class="p">,</span><span class="s">"value"</span><span class="p">:</span><span class="s">"value1"</span><span class="p">}</span><span class="o">]</span><span class="w"> </span>
|
|
<span class="p">}</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0133188204__li784473116569">Creating a data disk image with parameter <strong id="EN-US_TOPIC_0133188204__b11892230179">tags</strong> using a file in an OBS bucket (file address in the bucket: ims-image:centos70.zvhd2)<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0133188204__screen39315535418"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
|
|
<span class="normal"> 2</span>
|
|
<span class="normal"> 3</span>
|
|
<span class="normal"> 4</span>
|
|
<span class="normal"> 5</span>
|
|
<span class="normal"> 6</span>
|
|
<span class="normal"> 7</span>
|
|
<span class="normal"> 8</span>
|
|
<span class="normal"> 9</span>
|
|
<span class="normal">10</span>
|
|
<span class="normal">11</span>
|
|
<span class="normal">12</span>
|
|
<span class="normal">13</span>
|
|
<span class="normal">14</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">POST</span><span class="w"> </span><span class="n">https</span><span class="p">:</span><span class="c1">//{Endpoint}/v2/cloudimages/quickimport/action</span>
|
|
<span class="p">{</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"name"</span><span class="p">:</span><span class="w"> </span><span class="s">"ims_test_file"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"description"</span><span class="p">:</span><span class="w"> </span><span class="s">"Create an image using a file in the OBS bucket."</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"image_url"</span><span class="p">:</span><span class="w"> </span><span class="s">"ims-image:centos70.zvhd2"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"os_type"</span><span class="p">:</span><span class="w"> </span><span class="s">"Linux"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"min_disk"</span><span class="p">:</span><span class="w"> </span><span class="mi">40</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"type"</span><span class="p">:</span><span class="w"> </span><span class="s">"DataImage"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"tags"</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"aaa.111"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"bbb.333"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"ccc.444"</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="o">]</span>
|
|
<span class="p">}</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0133188204__li54649219219">Creating a data disk image with parameter <strong id="EN-US_TOPIC_0133188204__b33721242376">image_tags</strong> using a file in an OBS bucket (file address in the bucket: ims-image:centos70.zvhd2)<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0133188204__screen20772172105516"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
|
|
<span class="normal"> 2</span>
|
|
<span class="normal"> 3</span>
|
|
<span class="normal"> 4</span>
|
|
<span class="normal"> 5</span>
|
|
<span class="normal"> 6</span>
|
|
<span class="normal"> 7</span>
|
|
<span class="normal"> 8</span>
|
|
<span class="normal"> 9</span>
|
|
<span class="normal">10</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">POST</span><span class="w"> </span><span class="n">https</span><span class="p">:</span><span class="c1">//{Endpoint}/v2/cloudimages/quickimport/action</span>
|
|
<span class="p">{</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"name"</span><span class="p">:</span><span class="w"> </span><span class="s">"ims_test_file"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"description"</span><span class="p">:</span><span class="w"> </span><span class="s">"Create an image using a file in the OBS bucket."</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"image_url"</span><span class="p">:</span><span class="w"> </span><span class="s">"ims-image:centos70.zvhd2"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"os_type"</span><span class="p">:</span><span class="w"> </span><span class="s">"Linux"</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"min_disk"</span><span class="p">:</span><span class="w"> </span><span class="mi">40</span><span class="p">,</span><span class="w"> </span>
|
|
<span class="w"> </span><span class="s">"type"</span><span class="p">:</span><span class="w"> </span><span class="s">"DataImage"</span><span class="p">,</span>
|
|
<span class="w"> </span><span class="s">"image_tags"</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="p">{</span><span class="s">"key"</span><span class="p">:</span><span class="s">"key2"</span><span class="p">,</span><span class="s">"value"</span><span class="p">:</span><span class="s">"value2"</span><span class="p">},{</span><span class="s">"key"</span><span class="p">:</span><span class="s">"key1"</span><span class="p">,</span><span class="s">"value"</span><span class="p">:</span><span class="s">"value1"</span><span class="p">}</span><span class="o">]</span>
|
|
<span class="p">}</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0133188204__section639632154617"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0133188204__ul930573274617"><li id="EN-US_TOPIC_0133188204__li630543215463">Response parameters
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0133188204__table139163294618" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0133188204__row103054322469"><th align="left" class="cellrowborder" valign="top" width="23.68%" id="mcps1.3.6.2.1.1.1.4.1.1"><p id="EN-US_TOPIC_0133188204__p43051732184618">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.74%" id="mcps1.3.6.2.1.1.1.4.1.2"><p id="EN-US_TOPIC_0133188204__p113051332184618">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.58%" id="mcps1.3.6.2.1.1.1.4.1.3"><p id="EN-US_TOPIC_0133188204__p23051732124619">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0133188204__row83051832144620"><td class="cellrowborder" valign="top" width="23.68%" headers="mcps1.3.6.2.1.1.1.4.1.1 "><p id="EN-US_TOPIC_0133188204__p730511328463">job_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.74%" headers="mcps1.3.6.2.1.1.1.4.1.2 "><p id="EN-US_TOPIC_0133188204__p15305163211465">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.58%" headers="mcps1.3.6.2.1.1.1.4.1.3 "><p id="EN-US_TOPIC_0133188204__p130583216466">Specifies the asynchronous job ID.</p>
|
|
<p id="EN-US_TOPIC_0133188204__p19968122117312">For details, see <a href="en-us_topic_0022473688.html">Querying the Status of an Asynchronous Job</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0133188204__li193051132174613">Example response<pre class="codeblock" id="EN-US_TOPIC_0133188204__codeblock1130513321464">STATUS CODE 200</pre>
|
|
<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0133188204__screen875016102508"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
|
|
<span class="normal">2</span>
|
|
<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><span class="p">{</span>
|
|
<span class="w"> </span><span class="s">"job_id"</span><span class="p">:</span><span class="w"> </span><span class="s">"8a12fc664fb4daa3014fb4e581380005"</span>
|
|
<span class="p">}</span>
|
|
</pre></div></td></tr></table></div>
|
|
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0133188204__section539103214611"><h4 class="sectiontitle">Returned Values</h4><ul id="EN-US_TOPIC_0133188204__ul133052032144613"><li id="EN-US_TOPIC_0133188204__li5305432134614">Normal<p id="EN-US_TOPIC_0133188204__p43051032164615"><a name="EN-US_TOPIC_0133188204__li5305432134614"></a><a name="li5305432134614"></a>200</p>
|
|
</li><li id="EN-US_TOPIC_0133188204__li1305103212463">Abnormal
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0133188204__table53911327463" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0133188204__row11305143214468"><th align="left" class="cellrowborder" valign="top" width="46.46%" id="mcps1.3.7.2.2.1.1.3.1.1"><p id="EN-US_TOPIC_0133188204__p63051132164612">Return Value</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53.54%" id="mcps1.3.7.2.2.1.1.3.1.2"><p id="EN-US_TOPIC_0133188204__p133051932194617">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0133188204__row11305133204615"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.7.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0133188204__p13305143220466">400 Bad Request</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.7.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0133188204__p17305203244617">Request error. For details about the returned error code, see <a href="en-us_topic_0022473689.html">Error Codes</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row1130593211466"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.7.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0133188204__p16305183274616">401 Unauthorized</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.7.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0133188204__p19305532164619">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row43051832104610"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.7.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0133188204__p113057325469">403 Forbidden</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.7.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0133188204__p12305153214469">You do not have the rights to perform the operation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row23051532194620"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.7.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0133188204__p1230553210462">404 Not Found</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.7.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0133188204__p9305432184614">The requested resource was not found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row1305132104618"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.7.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0133188204__p183056324469">500 Internal Server Error</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.7.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0133188204__p730533294620">Internal service error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0133188204__row1730513326464"><td class="cellrowborder" valign="top" width="46.46%" headers="mcps1.3.7.2.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0133188204__p6305153284615">503 Service Unavailable</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.54%" headers="mcps1.3.7.2.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0133188204__p6305133284616">The service is unavailable.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0135460761.html">Image</a></div>
|
|
</div>
|
|
</div>
|
|
|