Files
doc-exports/docs/modelarts/api-ref/ShowImage.html
2025-07-28 12:24:54 +00:00

293 lines
27 KiB
HTML

<a name="EN-US_TOPIC_0000002340898530"></a><a name="EN-US_TOPIC_0000002340898530"></a>
<h1 class="topictitle1">Obtaining Details of an Image</h1>
<div id="body32001227"><div class="section" id="EN-US_TOPIC_0000002340898530__section725692616812"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000002340898530__p172562261581">Obtain the details of an image.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340898530__section425610261586"><h4 class="sectiontitle">Constraints</h4><p id="EN-US_TOPIC_0000002340898530__p17256102618814">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340898530__section13257182615817"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0000002340898530__p225752612813">GET /v1/{project_id}/images/{id}</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340898530__table025852611814" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002340898530__row112577261786"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="EN-US_TOPIC_0000002340898530__p0258152613817">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="EN-US_TOPIC_0000002340898530__p9258112617810">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="EN-US_TOPIC_0000002340898530__p2025852619816">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="EN-US_TOPIC_0000002340898530__p19259172618813">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340898530__row1525892620811"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002340898530__p202591026785">id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1925911261280">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002340898530__p2259726588">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002340898530__p825917267816">Image ID</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row10258102613816"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000002340898530__p1259102616815">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1326022617814">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000002340898530__p112601526188">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000002340898530__p12604261786">Project ID. For details, see <a href="modelarts_03_0147.html">Obtaining a Project ID and Name</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340898530__section11260326284"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0000002340898530__p1226014263812">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340898530__section1926016262814"><h4 class="sectiontitle">Response Parameters</h4><p id="EN-US_TOPIC_0000002340898530__p62602260817"><strong id="EN-US_TOPIC_0000002340898530__b19260192613813">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340898530__en-us_topic_0000002055322422_response_Image" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response body parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000002340898530__row102611261283"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.5.3.2.4.1.1"><p id="EN-US_TOPIC_0000002340898530__p82631526984">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.5.3.2.4.1.2"><p id="EN-US_TOPIC_0000002340898530__p1026317266814">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.3.2.4.1.3"><p id="EN-US_TOPIC_0000002340898530__p926410267813">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340898530__row17261202613810"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p826482615814">arch</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p122641326586">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p0264142620817">Processor architecture supported by the image. Enums:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul1926412261482"><li id="EN-US_TOPIC_0000002340898530__li12641261182"><p id="EN-US_TOPIC_0000002340898530__p142649269811"><a name="EN-US_TOPIC_0000002340898530__li12641261182"></a><a name="li12641261182"></a><strong id="EN-US_TOPIC_0000002340898530__b42641126586">X86_64</strong>: x86 architecture</p>
</li><li id="EN-US_TOPIC_0000002340898530__li626413261788"><p id="EN-US_TOPIC_0000002340898530__p32648265815"><a name="EN-US_TOPIC_0000002340898530__li626413261788"></a><a name="li626413261788"></a><strong id="EN-US_TOPIC_0000002340898530__b20264102612811">AARCH64</strong>: Arm architecture</p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row82617262817"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p2264112611814">create_at</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p226422614812">Long</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p326513261487">Specifies the time (UTC ms) when the image is created.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row626116261283"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p22653260818">description</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p12265132613818">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p926511263817">Image description with a maximum of 512 characters</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row17262192615813"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p226516260814">dev_services</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p82657261587">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p152652266811">Services supported by the image. Enums:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul426519261480"><li id="EN-US_TOPIC_0000002340898530__li62651026583"><p id="EN-US_TOPIC_0000002340898530__p826562613815"><a name="EN-US_TOPIC_0000002340898530__li62651026583"></a><a name="li62651026583"></a><strong id="EN-US_TOPIC_0000002340898530__b162652267819">NOTEBOOK</strong>: You can access a notebook instance using HTTPS.</p>
</li><li id="EN-US_TOPIC_0000002340898530__li102655261687"><p id="EN-US_TOPIC_0000002340898530__p112666262086"><a name="EN-US_TOPIC_0000002340898530__li102655261687"></a><a name="li102655261687"></a><strong id="EN-US_TOPIC_0000002340898530__b18266826986">SSH</strong>: You can remotely access a notebook instance from a local IDE through SSH.</p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row92629261589"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p1926632614817">id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p62661026983">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p13266112611816">Specifies the image ID of the notebook instance to be created. The image ID is in the Universally Unique Identifier (UUID) format. For details about how to obtain the ID of a preset image, see ListImage.xml.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row526213261682"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p026672610810">name</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p32661726681">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p826613261584">Image name, which contains a maximum of 512 characters, including lowercase letters, digits, hyphens (-), underscores (_), and periods (.)</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row172624263815"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p1426613261984">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p42662261587">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p326613261818">Organization to which the image belongs. You can create and view the organization on the <strong id="EN-US_TOPIC_0000002340898530__b126752620810">Organization Management</strong> page of the SWR console.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row32621026687"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p15267192616810">origin</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1926711262813">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p726712269817">Image source, which defaults to <strong id="EN-US_TOPIC_0000002340898530__b132671426686">CUSTOMIZE</strong>. This parameter is optional. Enums:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul82671626987"><li id="EN-US_TOPIC_0000002340898530__li4267426088"><p id="EN-US_TOPIC_0000002340898530__p1526717265820"><a name="EN-US_TOPIC_0000002340898530__li4267426088"></a><a name="li4267426088"></a><strong id="EN-US_TOPIC_0000002340898530__b126712261382">CUSTOMIZE</strong>: custom image</p>
</li><li id="EN-US_TOPIC_0000002340898530__li8267132620819"><p id="EN-US_TOPIC_0000002340898530__p15267326387"><a name="EN-US_TOPIC_0000002340898530__li8267132620819"></a><a name="li8267132620819"></a><strong id="EN-US_TOPIC_0000002340898530__b826714261582">IMAGE_SAVE</strong>: image saved by a notebook instance</p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row14262626182"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p16267162619819">resource_categories</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p126715261282">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p1126718261585">Flavors supported by the image. Enums:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul226818269816"><li id="EN-US_TOPIC_0000002340898530__li12689261811"><p id="EN-US_TOPIC_0000002340898530__p17268726182"><a name="EN-US_TOPIC_0000002340898530__li12689261811"></a><a name="li12689261811"></a><strong id="EN-US_TOPIC_0000002340898530__b52686261583">CPU</strong></p>
</li><li id="EN-US_TOPIC_0000002340898530__li112681026387"><p id="EN-US_TOPIC_0000002340898530__p1626822610816"><a name="EN-US_TOPIC_0000002340898530__li112681026387"></a><a name="li112681026387"></a><strong id="EN-US_TOPIC_0000002340898530__b11268202611810">GPU</strong></p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row1926210261789"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p426812261989">service_type</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1426832614814">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p7268132616810">Supported image types. Options:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul92686261488"><li id="EN-US_TOPIC_0000002340898530__li02683261083"><p id="EN-US_TOPIC_0000002340898530__p4268142616813"><a name="EN-US_TOPIC_0000002340898530__li02683261083"></a><a name="li02683261083"></a><strong id="EN-US_TOPIC_0000002340898530__b7268426584">COMMON</strong>: common image</p>
</li><li id="EN-US_TOPIC_0000002340898530__li62687261581"><p id="EN-US_TOPIC_0000002340898530__p1026892619818"><a name="EN-US_TOPIC_0000002340898530__li62687261581"></a><a name="li62687261581"></a><strong id="EN-US_TOPIC_0000002340898530__b1426811264811">INFERENCE</strong>: image used for inference</p>
</li><li id="EN-US_TOPIC_0000002340898530__li9268726881"><p id="EN-US_TOPIC_0000002340898530__p4268326381"><a name="EN-US_TOPIC_0000002340898530__li9268726881"></a><a name="li9268726881"></a>TRAIN: image used for training</p>
</li><li id="EN-US_TOPIC_0000002340898530__li826918265812"><p id="EN-US_TOPIC_0000002340898530__p1726914261181"><a name="EN-US_TOPIC_0000002340898530__li826918265812"></a><a name="li826918265812"></a>DEV: image used for development and debugging</p>
</li><li id="EN-US_TOPIC_0000002340898530__li22698267810"><p id="EN-US_TOPIC_0000002340898530__p11269182616819"><a name="EN-US_TOPIC_0000002340898530__li22698267810"></a><a name="li22698267810"></a>UNKNOWN: image whose supported services are not specified</p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row122624261982"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p426919261680">size</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p32692026683">Long</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p3269122613811">Specifies the image size, in KB.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row72625265810"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p3269152615820">status</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1926911261384">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p122693261781">Image status. Options:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul3269926980"><li id="EN-US_TOPIC_0000002340898530__li13269926887"><p id="EN-US_TOPIC_0000002340898530__p7269192613818"><a name="EN-US_TOPIC_0000002340898530__li13269926887"></a><a name="li13269926887"></a><strong id="EN-US_TOPIC_0000002340898530__b17270112612817">INIT</strong>: The image is being initialized.</p>
</li><li id="EN-US_TOPIC_0000002340898530__li4270172616816"><p id="EN-US_TOPIC_0000002340898530__p8270926387"><a name="EN-US_TOPIC_0000002340898530__li4270172616816"></a><a name="li4270172616816"></a><strong id="EN-US_TOPIC_0000002340898530__b1027015261285">CREATING</strong>: The image is being saved. In this case, the notebook instance is unavailable.</p>
</li><li id="EN-US_TOPIC_0000002340898530__li152701826488"><p id="EN-US_TOPIC_0000002340898530__p122706264814"><a name="EN-US_TOPIC_0000002340898530__li152701826488"></a><a name="li152701826488"></a><strong id="EN-US_TOPIC_0000002340898530__b1027015269817">CREATE_FAILED</strong>: Saving the image failed.</p>
</li><li id="EN-US_TOPIC_0000002340898530__li20270226788"><p id="EN-US_TOPIC_0000002340898530__p5270162613811"><a name="EN-US_TOPIC_0000002340898530__li20270226788"></a><a name="li20270226788"></a><strong id="EN-US_TOPIC_0000002340898530__b1227032619814">ERROR</strong>: An error occurs.</p>
</li><li id="EN-US_TOPIC_0000002340898530__li02701326585"><p id="EN-US_TOPIC_0000002340898530__p10270926882"><a name="EN-US_TOPIC_0000002340898530__li02701326585"></a><a name="li02701326585"></a><strong id="EN-US_TOPIC_0000002340898530__b1427082620815">DELETED</strong>: The image has been deleted.</p>
</li><li id="EN-US_TOPIC_0000002340898530__li22701826289"><p id="EN-US_TOPIC_0000002340898530__p7270926083"><a name="EN-US_TOPIC_0000002340898530__li22701826289"></a><a name="li22701826289"></a><strong id="EN-US_TOPIC_0000002340898530__b82706261381">ACTIVE</strong>: The image has been saved, which you can view on the SWR console and use to create notebook instances.</p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row14262326783"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p1927018260812">status_message</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1227042610816">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p127018262811">Build information during image saving</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row326218261386"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p52716267819">support_res_categories</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p927152617815">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p14271326582">Flavors supported by the image. Enums:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul62718269818"><li id="EN-US_TOPIC_0000002340898530__li32711526881"><p id="EN-US_TOPIC_0000002340898530__p1427192617815"><a name="EN-US_TOPIC_0000002340898530__li32711526881"></a><a name="li32711526881"></a><strong id="EN-US_TOPIC_0000002340898530__b172711626486">CPU</strong></p>
</li><li id="EN-US_TOPIC_0000002340898530__li9271126381"><p id="EN-US_TOPIC_0000002340898530__p162711126185"><a name="EN-US_TOPIC_0000002340898530__li9271126381"></a><a name="li9271126381"></a><strong id="EN-US_TOPIC_0000002340898530__b102711926384">GPU</strong></p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row32623263811"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p927116261581">swr_path</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p192717261588">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p1127117261089">SWR image address</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row1262326089"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p5271626681">tag</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p62721026187">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p18272132616812">Image tag</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row14262192617812"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p18272102611817">type</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p9272826389">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p62721726384">Image type. Enums:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul1327252614819"><li id="EN-US_TOPIC_0000002340898530__li927213264816"><p id="EN-US_TOPIC_0000002340898530__p42728263817"><a name="EN-US_TOPIC_0000002340898530__li927213264816"></a><a name="li927213264816"></a><strong id="EN-US_TOPIC_0000002340898530__b1427214267812">BUILD_IN</strong>: built-in system image</p>
</li><li id="EN-US_TOPIC_0000002340898530__li122726261811"><p id="EN-US_TOPIC_0000002340898530__p4272172619816"><a name="EN-US_TOPIC_0000002340898530__li122726261811"></a><a name="li122726261811"></a><strong id="EN-US_TOPIC_0000002340898530__b182722026781">DEDICATED</strong>: image you have saved</p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row6263626586"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p162723261084">update_at</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p132724261488">Long</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p14273152614812">Specifies the time (UTC ms) when the image was last updated.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row202637261081"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p327311261188">visibility</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1127317261818">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p027310261486">Image visibility. Enums:</p>
<ul id="EN-US_TOPIC_0000002340898530__ul8273172617815"><li id="EN-US_TOPIC_0000002340898530__li62731926786"><p id="EN-US_TOPIC_0000002340898530__p927382618817"><a name="EN-US_TOPIC_0000002340898530__li62731926786"></a><a name="li62731926786"></a><strong id="EN-US_TOPIC_0000002340898530__b1627312619811">PRIVATE</strong>: private image</p>
</li><li id="EN-US_TOPIC_0000002340898530__li4273626982"><p id="EN-US_TOPIC_0000002340898530__p142737261811"><a name="EN-US_TOPIC_0000002340898530__li4273626982"></a><a name="li4273626982"></a><strong id="EN-US_TOPIC_0000002340898530__b027382613819">PUBLIC</strong>: All users can perform read-only operations based on the image ID.</p>
</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row12263102615818"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340898530__p72731726589">workspace_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340898530__p142731261787">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340898530__p3273192616817">Workspace ID. If no workspaces are available, the default value is <strong id="EN-US_TOPIC_0000002340898530__b8273726983">0</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340898530__section132741726286"><h4 class="sectiontitle">Example Requests</h4><pre class="screen" id="EN-US_TOPIC_0000002340898530__screen1627417261487">GET https://{endpoint}/v1/{project_id}/images/{id}</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000002340898530__section13274826782"><h4 class="sectiontitle">Example Responses</h4><p id="EN-US_TOPIC_0000002340898530__p10275142615813"><strong id="EN-US_TOPIC_0000002340898530__b827516269814">Status code: 200</strong></p>
<p id="EN-US_TOPIC_0000002340898530__p1227511265810">OK</p>
<pre class="screen" id="EN-US_TOPIC_0000002340898530__screen72751226382">{
"arch" : "x86_64",
"create_at" : 1638234504492,
"description" : "CPU and GPU general algorithm development and training, preconfigured with AI engine PyTorch1.8",
"dev_services" : [ "NOTEBOOK", "SSH" ],
"id" : "278e88d1-5b71-4766-8502-b3ba72e824d9",
"name" : "pytorch1.8-cuda10.2-cudnn7-ubuntu18.04",
"resource_categories" : [ "GPU", "CPU" ],
"service_type" : "COMMON",
"status" : "ACTIVE",
"swr_path" : "swr.xxx.com/atelier/pytorch_1_8:pytorch_1.8.0-cuda_10.2-py_3.7-ubuntu_18.04-x86_64-20220926104358-041ba2e",
"tag" : "pytorch_1.8.0-cuda_10.2-py_3.7-ubuntu_18.04-x86_64-20220926104358-041ba2e",
"type" : "BUILD_IN",
"update_at" : 1638234504492,
"workspace_id" : "0"
}</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000002340898530__section182769261382"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340898530__en-us_topic_0000002055322422_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0000002340898530__row1427614261783"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="EN-US_TOPIC_0000002340898530__p14277426789">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="EN-US_TOPIC_0000002340898530__p6278826788">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340898530__row20276142611818"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002340898530__p32799263816">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002340898530__p202791126689">OK</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row122761426888"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002340898530__p6279226989">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1827982619818">Unauthorized</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row027614264820"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002340898530__p927912610819">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002340898530__p152791126182">Forbidden</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340898530__row17276142619820"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="EN-US_TOPIC_0000002340898530__p1828082611819">404</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="EN-US_TOPIC_0000002340898530__p1328013260816">Not Found</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340898530__section1328011265820"><h4 class="sectiontitle">Error Codes</h4><p id="EN-US_TOPIC_0000002340898530__p162801026582">See <a href="modelarts_03_0095.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="notebook.html">Development Environment Management</a></div>
</div>
</div>