yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity

Initial import of IMS DEV

Browse Source 
Reviewed-by: Kucerak, Kristian <kristian.kucerak@t-systems.com>
Co-authored-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-committed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
This commit is contained in:
Hasko, Vladimir
2022-09-20 07:04:29 +00:00
committed by zuul
parent 93f80b6dd5
commit 3621d07131
52 changed files with 3077 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

0
docs/ims/dev/.placeholder
View File

262
docs/ims/dev/ALL_META.TXT.json Normal file
View File

File diff suppressed because it is too large Load Diff

236
docs/ims/dev/CLASS.TXT.json Normal file
View File

File diff suppressed because it is too large Load Diff

3
docs/ims/dev/PARAMETERS.txt Normal file
View File

@ -0,0 +1,3 @@
version=""
language="en-us"
type=""

74
docs/ims/dev/en-us_topic_0109822367.html Normal file
View File

@ -0,0 +1,74 @@
<a name="EN-US_TOPIC_0109822367"></a><a name="EN-US_TOPIC_0109822367"></a>
<h1 class="topictitle1">Updating Image Information</h1>
<div id="body4139237"><div class="section" id="EN-US_TOPIC_0109822367__section663215"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822367__p375753944016">Image attributes can be modified to update image information.</p>
<div class="note" id="EN-US_TOPIC_0109822367__note46484253165"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0109822367__ul16617163214165"><li id="EN-US_TOPIC_0109822367__li66405588">Only the name and description of private images can be changed.</li><li id="EN-US_TOPIC_0109822367__li9147183901514">The token obtained from Identity and Access Management (IAM) is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</li></ul>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822367__section53720453"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822367__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822367__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822367__ul1840113419200"><li id="EN-US_TOPIC_0109822367__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822367__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0109822367__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822367__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822367__li21736599">IMS API used to update image information (Native OpenStack API)<p id="EN-US_TOPIC_0109822367__p179232412319"><a name="EN-US_TOPIC_0109822367__li21736599"></a><a name="li21736599"></a>URI format: PATCH https://<em id="EN-US_TOPIC_0109822367__i11810560137">IMS endpoint</em>/v2/images/<em id="EN-US_TOPIC_0109822367__i15825618138">Image ID</em></p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822367__section13722030"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822367__ol10336113224014"><li id="EN-US_TOPIC_0109822367__li1837051910476">Obtain the token.</li><li class="MsoNormal" id="EN-US_TOPIC_0109822367__li185241623104417">Send <strong id="EN-US_TOPIC_0109822367__b15398459181416">PATCH https://</strong><em id="EN-US_TOPIC_0109822367__i36811136101412">IMS endpoint</em><strong id="EN-US_TOPIC_0109822367__b1979115017142">/v2/cloudimages/</strong><em id="EN-US_TOPIC_0109822367__i77941645131416">Image ID</em>.</li><li class="MsoNormal" id="EN-US_TOPIC_0109822367__li12524623104415">Specify the following parameters in the request body:
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0109822367__table5563313" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0109822367__row1943767711030"><th align="left" class="cellrowborder" valign="top" width="16.78%" id="mcps1.3.3.2.3.1.1.5.1.1"><p id="EN-US_TOPIC_0109822367__p3094801411030"><strong id="EN-US_TOPIC_0109822367__b842352706184931">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.12%" id="mcps1.3.3.2.3.1.1.5.1.2"><p id="EN-US_TOPIC_0109822367__p2376120711030">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.1%" id="mcps1.3.3.2.3.1.1.5.1.3"><p id="EN-US_TOPIC_0109822367__p4560964911030">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45%" id="mcps1.3.3.2.3.1.1.5.1.4"><p id="EN-US_TOPIC_0109822367__p339411611030">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0109822367__row648795911030"><td class="cellrowborder" valign="top" width="16.78%" headers="mcps1.3.3.2.3.1.1.5.1.1 "><p id="EN-US_TOPIC_0109822367__p5576264211030">op</p>
</td>
<td class="cellrowborder" valign="top" width="19.12%" headers="mcps1.3.3.2.3.1.1.5.1.2 "><p id="EN-US_TOPIC_0109822367__p2048015811030">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.1%" headers="mcps1.3.3.2.3.1.1.5.1.3 "><p id="EN-US_TOPIC_0109822367__p4828009811030">String</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.3.1.1.5.1.4 "><p id="EN-US_TOPIC_0109822367__p1837389511030">Specifies the operation. The value can be <strong id="EN-US_TOPIC_0109822367__b1893911244154">add</strong>, <strong id="EN-US_TOPIC_0109822367__b129391824161519">replace</strong>, or <strong id="EN-US_TOPIC_0109822367__b16940132421512">remove</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0109822367__row3114733311030"><td class="cellrowborder" valign="top" width="16.78%" headers="mcps1.3.3.2.3.1.1.5.1.1 "><p id="EN-US_TOPIC_0109822367__p3990607811030">path</p>
</td>
<td class="cellrowborder" valign="top" width="19.12%" headers="mcps1.3.3.2.3.1.1.5.1.2 "><p id="EN-US_TOPIC_0109822367__p1116689111030">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.1%" headers="mcps1.3.3.2.3.1.1.5.1.3 "><p id="EN-US_TOPIC_0109822367__p3210299711030">String</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.3.1.1.5.1.4 "><p id="EN-US_TOPIC_0109822367__p6308567716410">Specifies the name of the attribute to be modified. A slash (/) needs to be added in front of it.</p>
<p id="EN-US_TOPIC_0109822367__p219111881645">You can modify the following attributes:</p>
<ul id="EN-US_TOPIC_0109822367__ul3977269316441"><li id="EN-US_TOPIC_0109822367__li689349916441"><strong id="EN-US_TOPIC_0109822367__b144393801620">name</strong>: image name</li><li id="EN-US_TOPIC_0109822367__li37931456147"><strong id="EN-US_TOPIC_0109822367__b055122216167">__description</strong>: image description</li><li id="EN-US_TOPIC_0109822367__li4942518121410"><strong id="EN-US_TOPIC_0109822367__b151261930181819">__support_xen</strong>: Xen is supported.</li><li id="EN-US_TOPIC_0109822367__li2778132131414"><strong id="EN-US_TOPIC_0109822367__b430293101817">__support_largememory</strong>: Ultra-large memory is supported.</li><li id="EN-US_TOPIC_0109822367__li15386524151419"><strong id="EN-US_TOPIC_0109822367__b0934173516182">__support_diskintensive</strong>: Intensive storage is supported.</li><li id="EN-US_TOPIC_0109822367__li885917266147"><strong id="EN-US_TOPIC_0109822367__b7275144110187">__support_highperformance</strong>: High-performance computing (HPC) is supported.</li><li id="EN-US_TOPIC_0109822367__li6451162941418"><strong id="EN-US_TOPIC_0109822367__b1646510461187">__support_xen_gpu_type</strong>: GPU-accelerated ECSs that use Xen for virtualization are supported.</li><li id="EN-US_TOPIC_0109822367__li6398168416441"><strong id="EN-US_TOPIC_0109822367__b20910145132013">__support_xen_hana</strong>: HANA ECSs that use Xen for virtualization are supported.</li><li id="EN-US_TOPIC_0109822367__li745121014613"><strong id="EN-US_TOPIC_0109822367__b889841152018">min_ram</strong>: minimum memory</li><li id="EN-US_TOPIC_0109822367__li4141727760"><strong id="EN-US_TOPIC_0109822367__b1662674517209">hw_vif_multiqueue_enabled</strong>: The NIC multi-queue feature is supported.</li><li id="EN-US_TOPIC_0109822367__li11576142233116"><strong id="EN-US_TOPIC_0109822367__b184532411406">hw_firmware_type</strong>: boot mode. The value can be <strong id="EN-US_TOPIC_0109822367__b1845112484018">bios</strong> or <strong id="EN-US_TOPIC_0109822367__b2461324194017">uefi</strong>.</li></ul>
<p id="EN-US_TOPIC_0109822367__p5020595511030">You can add or delete extended attributes.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0109822367__row4920041511030"><td class="cellrowborder" valign="top" width="16.78%" headers="mcps1.3.3.2.3.1.1.5.1.1 "><p id="EN-US_TOPIC_0109822367__p2581070311030">value</p>
</td>
<td class="cellrowborder" valign="top" width="19.12%" headers="mcps1.3.3.2.3.1.1.5.1.2 "><p id="EN-US_TOPIC_0109822367__p1029221611030">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="19.1%" headers="mcps1.3.3.2.3.1.1.5.1.3 "><p id="EN-US_TOPIC_0109822367__p4031814520459">Determined by the attribute value</p>
</td>
<td class="cellrowborder" valign="top" width="45%" headers="mcps1.3.3.2.3.1.1.5.1.4 "><p id="EN-US_TOPIC_0109822367__p1571272211030">Specifies the new value of the attribute.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p class="MsoNormal" id="EN-US_TOPIC_0109822367__p13898779">Example request:</p>
<pre class="screen" id="EN-US_TOPIC_0109822367__screen18741151104517">[
{
"op": "replace",
"path": "/name",
"value": "ims_test"
}
]</pre>
</li><li class="MsoNormal" id="EN-US_TOPIC_0109822367__li7839453174511">Refer to "Updating Image Information" in the <em id="EN-US_TOPIC_0109822367__i1778834808184440">Image Management Service API Reference</em> for details about the request response parameters.<p id="EN-US_TOPIC_0109822367__p7849203403113">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

22
docs/ims/dev/en-us_topic_0109822368.html Normal file
View File

@ -0,0 +1,22 @@
<a name="EN-US_TOPIC_0109822368"></a><a name="EN-US_TOPIC_0109822368"></a>
<h1 class="topictitle1">Deleting an Image</h1>
<div id="body6606141"><div class="section" id="EN-US_TOPIC_0109822368__section4544348"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822368__p2582252465">A private image can be deleted if it is no longer needed.</p>
<div class="note" id="EN-US_TOPIC_0109822368__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0109822368__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822368__section32547936"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822368__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822368__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822368__ul1840113419200"><li id="EN-US_TOPIC_0109822368__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822368__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0109822368__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822368__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822368__li38945471">IMS API used to delete an image (Native OpenStack API)<p id="EN-US_TOPIC_0109822368__p1160141020392"><a name="EN-US_TOPIC_0109822368__li38945471"></a><a name="li38945471"></a>URI format: DELETE https://<em id="EN-US_TOPIC_0109822368__i77091425172312">IMS endpoint</em>/v2/images/<em id="EN-US_TOPIC_0109822368__i37091825122319">Image ID</em></p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822368__section24495972"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822368__ol163172032204610"><li id="EN-US_TOPIC_0109822368__li1837051910476">Obtain the token.</li><li class="msonormal" id="EN-US_TOPIC_0109822368__li1227855811466">Send <strong id="EN-US_TOPIC_0109822368__b08965113255">DELETE https://</strong><em id="EN-US_TOPIC_0109822368__i1811958152312">IMS endpoint</em><strong id="EN-US_TOPIC_0109822368__b16136195122517">/v2/images/</strong><em id="EN-US_TOPIC_0109822368__i15518464247">Image ID</em>.</li><li class="msonormal" id="EN-US_TOPIC_0109822368__li927865810468">Add <strong id="EN-US_TOPIC_0109822368__b84235270615255">X-Auth-Token</strong> to the request header.</li><li class="msonormal" id="EN-US_TOPIC_0109822368__li1727805811465">Check the status code. If the request is successful, <strong id="EN-US_TOPIC_0109822368__b842352706171255">204</strong> is returned.<p id="EN-US_TOPIC_0109822368__p13688656203119">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

30
docs/ims/dev/en-us_topic_0109822369.html Normal file
View File

@ -0,0 +1,30 @@
<a name="EN-US_TOPIC_0109822369"></a><a name="EN-US_TOPIC_0109822369"></a>
<h1 class="topictitle1">Exporting an Image</h1>
<div id="body55493126"><div class="section" id="EN-US_TOPIC_0109822369__section54806415"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822369__p15305721142">If you need to use a private image in a storage device or on other platforms, you can export the image.</p>
<p id="EN-US_TOPIC_0109822369__p103051821416">All available private images can be exported to an OBS bucket in a specific format. After you have exported an image, you can download it from the OBS bucket to the specified storage device.</p>
<p id="EN-US_TOPIC_0109822369__p17305721848">Images exported in different formats may vary in size. You will be charged for the space used to store these images.</p>
<div class="note" id="EN-US_TOPIC_0109822369__note1568074818297"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0109822369__ul724132118342"><li id="EN-US_TOPIC_0109822369__li14244213349">The storage class of the OBS bucket must be <strong id="EN-US_TOPIC_0109822369__b84235270695634">Standard</strong>.</li><li id="EN-US_TOPIC_0109822369__li9147183901514">The token obtained from Identity and Access Management (IAM) is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</li></ul>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822369__section10134624"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822369__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822369__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822369__ul1840113419200"><li id="EN-US_TOPIC_0109822369__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822369__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0109822369__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822369__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822369__li51316583">IMS API used to export an image<p id="EN-US_TOPIC_0109822369__p587584773910"><a name="EN-US_TOPIC_0109822369__li51316583"></a><a name="li51316583"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822369__i16143131922613">IMS endpoint</em>/v1/cloudimages/<em id="EN-US_TOPIC_0109822369__i161307124273">Image ID</em>/file</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822369__section24102752"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822369__ol18137125365016"><li id="EN-US_TOPIC_0109822369__li1837051910476">Obtain the token.</li><li class="msonormal" id="EN-US_TOPIC_0109822369__li2356162325111">Send <strong id="EN-US_TOPIC_0109822369__b12538102216284">POST https://</strong><em id="EN-US_TOPIC_0109822369__i281521812287">IMS endpoint</em><strong id="EN-US_TOPIC_0109822369__b1141618262282">/v1/cloudimages/</strong><em id="EN-US_TOPIC_0109822369__i834761514103348">Image ID</em><strong id="EN-US_TOPIC_0109822369__b188677664210340">/file</strong>.</li><li class="msonormal" id="EN-US_TOPIC_0109822369__li3356192315118">Add <strong id="EN-US_TOPIC_0109822369__b84235270615255">X-Auth-Token</strong> to the request header.</li><li class="msonormal" id="EN-US_TOPIC_0109822369__li173561623105116">Specify the following parameters in the request body:<pre class="screen" id="EN-US_TOPIC_0109822369__screen754824465215">{
"bucket_url":"ims-image:centos7_5.qcow2", //URL of the target file in the format of &lt;Bucket name&gt;:&lt;File name&gt; (mandatory, string)
"file_format":"qcow2" //File format, which can be qcow2, vhd, zvhd, or vmdk (mandatory, string)
}</pre>
<p class="msonormal" id="EN-US_TOPIC_0109822369__p356234915712">If the request is successful, a job ID is returned.</p>
</li><li id="EN-US_TOPIC_0109822369__li514842411357">Query job details using the job ID by referring to <a href="en-us_topic_0109822371.html">Querying Job Details</a>.<p id="EN-US_TOPIC_0109822369__p411722533511">If the job status is <strong id="EN-US_TOPIC_0109822369__b8423527061586">SUCCESS</strong>, the private image is successfully created.</p>
<p id="EN-US_TOPIC_0109822369__p19843953175711">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

29
docs/ims/dev/en-us_topic_0109822370.html Normal file
View File

@ -0,0 +1,29 @@
<a name="EN-US_TOPIC_0109822370"></a><a name="EN-US_TOPIC_0109822370"></a>
<h1 class="topictitle1">Replicating an Images Within a Region</h1>
<div id="body3758325"><div class="section" id="EN-US_TOPIC_0109822370__section21602115"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822370__p198331939145317">A private image can be copied within a region as another one. The API used is an extension API. When replicating an image, you can change the image attributes to meet the requirements of different scenarios.</p>
<div class="note" id="EN-US_TOPIC_0109822370__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0109822370__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822370__section4940914"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822370__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822370__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822370__ul1840113419200"><li id="EN-US_TOPIC_0109822370__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822370__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0109822370__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822370__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822370__li971443012400">IMS API used to copy an image within a region<p id="EN-US_TOPIC_0109822370__p196531432154010"><a name="EN-US_TOPIC_0109822370__li971443012400"></a><a name="li971443012400"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822370__i515952213343">IMS endpoint</em>/v1/cloudimages/<em id="EN-US_TOPIC_0109822370__i8159172213342">Image ID</em>/copy</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822370__section44468229"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822370__ol1889584595318"><li id="EN-US_TOPIC_0109822370__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0109822370__li1639781265417">Send <strong id="EN-US_TOPIC_0109822370__b762834153511">POST https://</strong><em id="EN-US_TOPIC_0109822370__i6526621183514">IMS endpoint</em>/v1/cloudimages/<em id="EN-US_TOPIC_0109822370__i1190623653511">Image ID</em><strong id="EN-US_TOPIC_0109822370__b17385174493510">/copy</strong>.</li><li class="msonormal" id="EN-US_TOPIC_0109822370__li1839791217543">Add <strong id="EN-US_TOPIC_0109822370__b84235270615255">X-Auth-Token</strong> to the request header.</li><li class="msonormal" id="EN-US_TOPIC_0109822370__li163971612185410">Specify the following parameters in the request body:<pre class="screen" id="EN-US_TOPIC_0109822370__screen1688714170555">{
"name": "ims_encrypted_copy3", //Image name (mandatory, string)
"description": "test copy", //Image description (optional, string)
"cmk_id": "bd66288c-9081-460a-8227-4cbd0c814cb4" //Encryption key (optional, string)
}</pre>
<p class="msonormal" id="EN-US_TOPIC_0109822370__p16929557185717">If the request is successful, a job ID is returned.</p>
</li><li id="EN-US_TOPIC_0109822370__li514842411357">Query job details using the job ID by referring to <a href="en-us_topic_0109822371.html">Querying Job Details</a>.<p id="EN-US_TOPIC_0109822370__p411722533511">If the job status is <strong id="EN-US_TOPIC_0109822370__b8423527061586">SUCCESS</strong>, the image is successfully replicated.</p>
<p id="EN-US_TOPIC_0109822370__p12436959135710">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

21
docs/ims/dev/en-us_topic_0109822371.html Normal file
View File

@ -0,0 +1,21 @@
<a name="EN-US_TOPIC_0109822371"></a><a name="EN-US_TOPIC_0109822371"></a>
<h1 class="topictitle1">Querying Job Details</h1>
<div id="body46031676"><div class="section" id="EN-US_TOPIC_0109822371__section48854323"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822371__p48581817143">After a request is successfully received, a job id is returned. You can run the job to query the execution status. This part describes how to use a job ID to query job details.</p>
<div class="note" id="EN-US_TOPIC_0109822371__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0109822371__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822371__section64886077"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822371__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822371__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822371__ul1840113419200"><li id="EN-US_TOPIC_0109822371__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822371__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0109822371__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822371__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822371__li46707930">IMS API used to query an asynchronous job<p id="EN-US_TOPIC_0109822371__p14513103914219"><a name="EN-US_TOPIC_0109822371__li46707930"></a><a name="li46707930"></a>URI format: GET https://<em id="EN-US_TOPIC_0109822371__i8301154181618">IMS endpoint</em>/v1/<em id="EN-US_TOPIC_0109822371__i0181227141718">Project ID</em>/jobs/<em id="EN-US_TOPIC_0109822371__i1778416104170">Job ID</em></p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822371__section47103787"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822371__ol41981212104717"><li id="EN-US_TOPIC_0109822371__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0109822371__li17198512194712">Send <strong id="EN-US_TOPIC_0109822371__b14589103019186">GET https://</strong><em id="EN-US_TOPIC_0109822371__i3731911191818">IMS endpoint</em><strong id="EN-US_TOPIC_0109822371__b10582733141814">/v1/</strong><em id="EN-US_TOPIC_0109822371__i1860021851817">Project ID</em><strong id="EN-US_TOPIC_0109822371__b34724379186">/jobs/</strong><em id="EN-US_TOPIC_0109822371__i662811265185">Job ID</em>.</li><li class="msonormal" id="EN-US_TOPIC_0109822371__li519861264716">Add <strong id="EN-US_TOPIC_0109822371__b84235270615255">X-Auth-Token</strong> to the request header.</li><li class="msonormal" id="EN-US_TOPIC_0109822371__li5198131254714">Check the job details after the request is successfully processed. For details about the parameters, see "Asynchronous Job Query" in <em id="EN-US_TOPIC_0109822371__i84235269795048">Image Management Service API Reference</em>.</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

15
docs/ims/dev/en-us_topic_0109822372.html Normal file
View File

@ -0,0 +1,15 @@
<a name="EN-US_TOPIC_0109822372"></a><a name="EN-US_TOPIC_0109822372"></a>
<h1 class="topictitle1">Appendix</h1>
<div id="body16365997"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="en-us_topic_0124290300.html">Status Codes</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110943799.html">Error Codes</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0139609146.html">Change History</a></strong><br>
</li>
</ul>
</div>

8
docs/ims/dev/en-us_topic_0109822377.html Normal file
View File

@ -0,0 +1,8 @@
<a name="EN-US_TOPIC_0109822377"></a><a name="EN-US_TOPIC_0109822377"></a>
<h1 class="topictitle1">Overview</h1>
<div id="body27509893"><p class="MsoNormal" id="EN-US_TOPIC_0109822377__p55186683">This document describes how to make calls to APIs designed for Image Management Service (IMS).</p>
<div class="note" id="EN-US_TOPIC_0109822377__note44222521746"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0109822377__p1442214521841">For how to call APIs, see the <em id="EN-US_TOPIC_0109822377__i842352697155647">Image Management Service API Reference</em>.</p>
</div></div>
</div>

16
docs/ims/dev/en-us_topic_0109822378.html Normal file
View File

@ -0,0 +1,16 @@
<a name="EN-US_TOPIC_0109822378"></a><a name="EN-US_TOPIC_0109822378"></a>
<h1 class="topictitle1">Product Introduction</h1>
<div id="body5987649"><div class="section" id="EN-US_TOPIC_0109822378__section20836375"><h4 class="sectiontitle">Image Management Service</h4><p id="EN-US_TOPIC_0109822378__p1452820300104">An image is a server or disk template that contains an operating system (OS) or service data and necessary software, such as database software. IMS provides public, private, and shared images.</p>
<p class="MsoNormal" id="EN-US_TOPIC_0109822378__p15237557">Image Management Service (IMS) allows you to manage the entire lifecycle of your images. You can create ECSs or BMSs from public, private, or shared images. You can also create a private image from a cloud server or an external image file to make it easier to migrate workloads to the cloud or on the cloud.</p>
</div>
<div class="section" id="EN-US_TOPIC_0109822378__section10024794"><h4 class="sectiontitle">Basic Concepts</h4><p id="EN-US_TOPIC_0109822378__p3734687433"><strong id="EN-US_TOPIC_0109822378__b62168346016">Public image</strong></p>
<p id="EN-US_TOPIC_0109822378__p43856003">A public image is a standard OS image provided by the cloud platform and is visible to all users. It consists of an OS and pre-installed public applications. You can deploy personal applications as needed.</p>
<p id="EN-US_TOPIC_0109822378__p43537368"><strong id="EN-US_TOPIC_0109822378__b44257391901">Private image</strong></p>
<p id="EN-US_TOPIC_0109822378__p36865885">A private image is an image available only to the image owner. It contains an OS, pre-installed public applications, and the image owner's private applications. Using a private image to create servers removes the need to configure multiple servers repeatedly.</p>
<p id="EN-US_TOPIC_0109822378__p59159709"><strong id="EN-US_TOPIC_0109822378__b92196514020">External image file</strong></p>
<p id="EN-US_TOPIC_0109822378__p27207106">An external image file is a template that can be used to create ECSs or BMSs. The template provides information required to create the servers, including the OS and pre-installed applications.</p>
</div>
</div>
<div></div>

35
docs/ims/dev/en-us_topic_0109822381.html Normal file
View File

@ -0,0 +1,35 @@
<a name="EN-US_TOPIC_0109822381"></a><a name="EN-US_TOPIC_0109822381"></a>
<h1 class="topictitle1">Creating an Image Using an ECS</h1>
<div id="body23462052"><div class="section" id="EN-US_TOPIC_0109822381__section10781336"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822381__p7923645314">A Windows or Linux ECS can be used to create a private image.</p>
<div class="note" id="EN-US_TOPIC_0109822381__note44222521746"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0109822381__ul550713253156"><li id="EN-US_TOPIC_0109822381__li3714320">Before creating the image, ensure that the ECS is stopped.</li><li id="EN-US_TOPIC_0109822381__li850719256151">The token obtained from Identity and Access Management (IAM) is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</li></ul>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822381__section872994"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822381__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822381__b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822381__ul15147458"><li id="EN-US_TOPIC_0109822381__li2109397">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822381__p1833933634"><a name="EN-US_TOPIC_0109822381__li2109397"></a><a name="li2109397"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822381__i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822381__li18984577">IMS API used to create an image<p id="EN-US_TOPIC_0109822381__p327712359248"><a name="EN-US_TOPIC_0109822381__li18984577"></a><a name="li18984577"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822381__i4702192218436">IMS endpoint</em>/v2/cloudimages/action</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822381__section7856948"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822381__ol61355793"><li id="EN-US_TOPIC_0109822381__li1837051910476">Obtain the token.</li><li class="msonormal" id="EN-US_TOPIC_0109822381__li8863205171315">Send <strong id="EN-US_TOPIC_0109822381__b1823914109442">POST https://</strong><em id="EN-US_TOPIC_0109822381__i46825420446">IMS endpoint</em><strong id="EN-US_TOPIC_0109822381__b56499143448">/v2/cloudimages/action</strong>.</li><li class="msonormal" id="EN-US_TOPIC_0109822381__li108635517130">Add <strong id="EN-US_TOPIC_0109822381__b84235270615255">X-Auth-Token</strong> to the request header.</li><li class="msonormal" id="EN-US_TOPIC_0109822381__li1586314581311">Specify the following parameters in the request body:<pre class="screen" id="EN-US_TOPIC_0109822381__screen1324171612164">{
"name": "ims_test", //Image name (mandatory, string)
"description": "Image creation from an ECS", //Image description (optional, string)
"instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", //ECS ID (mandatory, string)
"tags": [
"aaa.111",
"bbb.333",
"ccc.444"
] //Image tag list (optional, array of objects)
} </pre>
<p id="EN-US_TOPIC_0109822381__p146904541437"></p>
<ul id="EN-US_TOPIC_0109822381__ul18271195810316"><li id="EN-US_TOPIC_0109822381__li172708581238">If the request is successful, a job ID is returned.</li><li id="EN-US_TOPIC_0109822381__li7597170542">If the request fails, an error code and error details are returned. For details, see <a href="en-us_topic_0110943799.html">Error Codes</a>.</li></ul>
</li></ol><ol start="5" id="EN-US_TOPIC_0109822381__ol31495913310"><li id="EN-US_TOPIC_0109822381__li514842411357">Query job details using the job ID by referring to <a href="en-us_topic_0109822371.html">Querying Job Details</a>.<p id="EN-US_TOPIC_0109822381__p411722533511">If the job status is <strong id="EN-US_TOPIC_0109822381__b8423527061586">SUCCESS</strong>, the private image is successfully created.</p>
<p id="EN-US_TOPIC_0109822381__p1126722819573">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li><li id="EN-US_TOPIC_0109822381__li17483254347">Obtain the image ID from the job body and query, delete, and export the private image using the image ID.</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

40
docs/ims/dev/en-us_topic_0109822382.html Normal file
View File

@ -0,0 +1,40 @@
<a name="EN-US_TOPIC_0109822382"></a><a name="EN-US_TOPIC_0109822382"></a>
<h1 class="topictitle1">Creating an Image Using an External Image File</h1>
<div id="body48597379"><div class="section" id="EN-US_TOPIC_0109822382__en-us_topic_0040879985-chtext"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822382__p12792132515163">An external image file can also be used to create a private image.</p>
<div class="note" id="EN-US_TOPIC_0109822382__note177773191273"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0109822382__ul8147739131519"><li id="EN-US_TOPIC_0109822382__li5902812171111">The API used here is the same as the one for creating a private image from an ECS except for the parameters in the request body.</li><li id="EN-US_TOPIC_0109822382__li9147183901514">The token obtained from Identity and Access Management (IAM) is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</li></ul>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822382__section31142810"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822382__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822382__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822382__ul45489722"><li id="EN-US_TOPIC_0109822382__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822382__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0109822382__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822382__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822382__li60788841">IMS API used to create a data disk image using an external image file<p id="EN-US_TOPIC_0109822382__p198241728192711"><a name="EN-US_TOPIC_0109822382__li60788841"></a><a name="li60788841"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822382__i175004419487">IMS endpoint</em>/v1/cloudimages/dataimages/action</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822382__section11849838"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822382__ol115221350172119"><li id="EN-US_TOPIC_0109822382__li1837051910476">Obtain the token.</li><li class="msonormal" id="EN-US_TOPIC_0109822382__li89531824112417">Send <strong id="EN-US_TOPIC_0109822382__b014619718498">POST https://</strong><em id="EN-US_TOPIC_0109822382__i11460714497">IMS endpoint</em><strong id="EN-US_TOPIC_0109822382__b1114611719499">/v2/cloudimages/action</strong>.</li><li class="msonormal" id="EN-US_TOPIC_0109822382__li159534241246">Add <strong id="EN-US_TOPIC_0109822382__b84235270615255">X-Auth-Token</strong> to the request header.</li><li class="msonormal" id="EN-US_TOPIC_0109822382__li4953192411241">Specify the following parameters in the request body:<pre class="screen" id="EN-US_TOPIC_0109822382__screen1701742142517">{
"name": "ims_test_file", //Image name (mandatory, string)
"description": "Image creation using an image file uploaded to the OBS bucket", //Image description (optional, string)
"image_url": "ims-image:centos70.qcow2", //Image file address (mandatory, string)
"os_version": "CentOS 7.0 64bit", //OS version (optional, string)
"is_config_init":true, //Initialized or not (optional, boolean)
"min_disk": 40, //Minimum system disk space (mandatory, integer)
"is_config":true, //Whether to enable automatic configuration (optional, boolean)
"tags": [
"aaa.111",
"bbb.333",
"ccc.444"
] //Image tag list (optional, array of objects)
}</pre>
<div class="note" id="EN-US_TOPIC_0109822382__note18680101520526"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0109822382__p168081595220">For how to obtain the address of the image file in the OBS bucket, see "Operations on Buckets" in the <em id="EN-US_TOPIC_0109822382__i842352697161828">Object Storage Service API Reference</em>.</p>
</div></div>
<ul id="EN-US_TOPIC_0109822382__ul1080665150"><li id="EN-US_TOPIC_0109822382__li38061951558">If the request is successful, a job ID is returned.</li><li id="EN-US_TOPIC_0109822382__li145964817518">If the request fails, an error code and error details are returned. For details, see <a href="en-us_topic_0110943799.html">Error Codes</a>.</li></ul>
</li><li id="EN-US_TOPIC_0109822382__li514842411357">Query job details using the job ID by referring to <a href="en-us_topic_0109822371.html">Querying Job Details</a>.<p id="EN-US_TOPIC_0109822382__p411722533511">If the job status is <strong id="EN-US_TOPIC_0109822382__b8423527061586">SUCCESS</strong>, the private image is successfully created.</p>
<p id="EN-US_TOPIC_0109822382__p562815375571">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li><li id="EN-US_TOPIC_0109822382__li17483254347">Obtain the image ID from the job body. You can query for image details based on the image ID. For details, see <a href="en-us_topic_0109822404.html">Queries Details About an Image</a>.</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

29
docs/ims/dev/en-us_topic_0109822403.html Normal file
View File

@ -0,0 +1,29 @@
<a name="EN-US_TOPIC_0109822403"></a><a name="EN-US_TOPIC_0109822403"></a>
<h1 class="topictitle1">Querying an Images List</h1>
<div id="body44121179"><div class="section" id="EN-US_TOPIC_0109822403__section5997995"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822403__p3484145322518">Images can be created using search criteria.</p>
<div class="note" id="EN-US_TOPIC_0109822403__note44222521746"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0109822403__ul106941553121512"><li id="EN-US_TOPIC_0109822403__li33716531">You can type question marks (?) and ampersands (&amp;) at the end of the URI to define multiple search criteria. For details, see the example request.</li><li id="EN-US_TOPIC_0109822403__li9147183901514">The token obtained from Identity and Access Management (IAM) is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</li></ul>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822403__section16075620"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822403__p616415594193">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822403__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822403__ul1840113419200"><li id="EN-US_TOPIC_0109822403__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822403__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0109822403__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822403__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822403__li40994058">IMS API used to query the image list<p id="EN-US_TOPIC_0109822403__p62932010202910"><a name="EN-US_TOPIC_0109822403__li40994058"></a><a name="li40994058"></a>URI format: GET https://<em id="EN-US_TOPIC_0109822403__i161571852155419">IMS endpoint</em>/v2/cloudimages</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822403__section10462857"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822403__ol134841326152613"><li id="EN-US_TOPIC_0109822403__li1837051910476">Obtain the token.</li><li class="msonormal" id="EN-US_TOPIC_0109822403__li7546155813263">Send <strong id="EN-US_TOPIC_0109822403__b777533114554">GET https://</strong><em id="EN-US_TOPIC_0109822403__i276717276557">IMS endpoint</em><strong id="EN-US_TOPIC_0109822403__b53941435145516">/v2/cloudimages</strong>.</li><li class="msonormal" id="EN-US_TOPIC_0109822403__li2546758122614">Add <strong id="EN-US_TOPIC_0109822403__b84235270615255">X-Auth-Token</strong> to the request header.</li><li class="msonormal" id="EN-US_TOPIC_0109822403__li15546135822613">Type question marks (?) and ampersands (&amp;) at the end of the URI to define multiple search criteria, for example, https://<em id="EN-US_TOPIC_0109822403__i795621835712">IMS endpoint</em>/v2/cloudimages?__imagetype=gold&amp;sort_key=name&amp;limit=1.</li><li class="msonormal" id="EN-US_TOPIC_0109822403__li95461583263">Refer to "Querying Images" in the <strong id="EN-US_TOPIC_0109822403__b1788838614183927">Image Management Service API Reference</strong> for parameter descriptions and response details.<p id="EN-US_TOPIC_0109822403__p127871624103016">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0109822403__section33791047111111"><h4 class="sectiontitle">Common Query Methods</h4><ul id="EN-US_TOPIC_0109822403__ul1643114418195"><li id="EN-US_TOPIC_0109822403__li18431204121918">Public images<p id="EN-US_TOPIC_0109822403__p9431134161911"><a name="EN-US_TOPIC_0109822403__li18431204121918"></a><a name="li18431204121918"></a>GET /v2/images?__imagetype=gold&amp;visibility=public&amp;protected=true</p>
</li><li id="EN-US_TOPIC_0109822403__li1143117421919">Private images<p id="EN-US_TOPIC_0109822403__p543113410193"><a name="EN-US_TOPIC_0109822403__li1143117421919"></a><a name="li1143117421919"></a>GET /v2/images?owner={project_id}</p>
</li><li id="EN-US_TOPIC_0109822403__li194316413195">Available shared images<p id="EN-US_TOPIC_0109822403__p18431445195"><a name="EN-US_TOPIC_0109822403__li194316413195"></a><a name="li194316413195"></a>GET /v2/images?member_status=accepted&amp;visibility=shared&amp;__imagetype=shared</p>
</li><li id="EN-US_TOPIC_0109822403__li174314491910">Rejected images<p id="EN-US_TOPIC_0109822403__p74311547198"><a name="EN-US_TOPIC_0109822403__li174314491910"></a><a name="li174314491910"></a>GET /v2/images?member_status=rejected&amp;visibility=shared&amp;__imagetype=shared</p>
</li><li id="EN-US_TOPIC_0109822403__li743194191913">Unaccepted images<p id="EN-US_TOPIC_0109822403__p19431245196"><a name="EN-US_TOPIC_0109822403__li743194191913"></a><a name="li743194191913"></a>GET /v2/images?member_status=pending&amp;visibility=shared&amp;__imagetype=shared</p>
</li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

23
docs/ims/dev/en-us_topic_0109822404.html Normal file
View File

@ -0,0 +1,23 @@
<a name="EN-US_TOPIC_0109822404"></a><a name="EN-US_TOPIC_0109822404"></a>
<h1 class="topictitle1">Queries Details About an Image</h1>
<div id="body30066318"><div class="section" id="EN-US_TOPIC_0109822404__section29247490"><h4 class="sectiontitle">Scenario</h4><p id="EN-US_TOPIC_0109822404__p1811773673820">Details about a private or public image can be queried.</p>
<div class="note" id="EN-US_TOPIC_0109822404__note3850899166"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0109822404__p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0109822404__section20236457"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0109822404__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0109822404__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0109822404__ul1840113419200"><li id="EN-US_TOPIC_0109822404__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0109822404__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0109822404__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0109822404__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0109822404__li59230505">IMS API used to query image details (Native OpenStack API)<p id="EN-US_TOPIC_0109822404__p1353604793016"><a name="EN-US_TOPIC_0109822404__li59230505"></a><a name="li59230505"></a>URI format: GET https://<em id="EN-US_TOPIC_0109822404__i17682131714510">IMS endpoint</em>/v2/images/<em id="EN-US_TOPIC_0109822404__i153793361757">Image ID</em></p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0109822404__section47910391"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0109822404__ol1897794143816"><li id="EN-US_TOPIC_0109822404__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0109822404__li11801239392">Send <strong id="EN-US_TOPIC_0109822404__b13671133413619">GET https://</strong><em id="EN-US_TOPIC_0109822404__i0779014066">IMS endpoint</em><strong id="EN-US_TOPIC_0109822404__b980919390613">/v2/images/</strong><em id="EN-US_TOPIC_0109822404__i199142312617">Image ID</em>.</li><li class="msonormal" id="EN-US_TOPIC_0109822404__li11180123143915">Add <strong id="EN-US_TOPIC_0109822404__b84235270615255">X-Auth-Token</strong> to the request header.<p class="msonormal" id="EN-US_TOPIC_0109822404__p9248124021917">An example request is as follows: https://<em id="EN-US_TOPIC_0109822404__i25732078715">IMS endpoint</em>/v2/images/33ad552d-1149-471c-8190-ff6776174a00.</p>
</li><li class="msonormal" id="EN-US_TOPIC_0109822404__li111803343910">Refer to "Querying Image Details (Native OpenStack API)" in <em id="EN-US_TOPIC_0109822404__i54213259810">Image Management Service API Reference</em> for parameter descriptions and response details.<p id="EN-US_TOPIC_0109822404__p82771181316">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

7
docs/ims/dev/en-us_topic_0110299138.html Normal file
View File

@ -0,0 +1,7 @@
<a name="EN-US_TOPIC_0110299138"></a><a name="EN-US_TOPIC_0110299138"></a>
<h1 class="topictitle1">Before You Start</h1>
<div id="body1525694469786"><p id="EN-US_TOPIC_0110299138__p186352918017">You need to learn how to call the APIs before you start.</p>
<p id="EN-US_TOPIC_0110299138__p8060118">For details about how to call REST APIs, see <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328001.html?tag=API Documents" target="_blank" rel="noopener noreferrer">API Usage Guidelines</a>.</p>
</div>

29
docs/ims/dev/en-us_topic_0110300591.html Normal file
View File

@ -0,0 +1,29 @@
<a name="EN-US_TOPIC_0110300591"></a><a name="EN-US_TOPIC_0110300591"></a>
<h1 class="topictitle1">Sharing an Image</h1>
<div id="body8662426"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="en-us_topic_0110300592.html">Adding an Image Member</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110300593.html">Updating the Image Sharing Status</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110300594.html">Querying Details About an Image Member</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110300595.html">Querying Tenants</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110300596.html">Deleting an Image Member</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110300597.html">Adding Image Members</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110300598.html">Updating the Image Sharing Status in Batches</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110300599.html">Deleting Image Members</a></strong><br>
</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0219492328.html">Common Scenarios</a></div>
</div>
</div>

33
docs/ims/dev/en-us_topic_0110300592.html Normal file
View File

@ -0,0 +1,33 @@
<a name="EN-US_TOPIC_0110300592"></a><a name="EN-US_TOPIC_0110300592"></a>
<h1 class="topictitle1">Adding an Image Member</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_section30752875"><h4 class="sectiontitle">Scenario</h4><p class="MsoNormal" id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_p37736673">A private image can be shared with other tenants. When sharing an image, you need add a project ID of the tenant with whom you are going to share the image.</p>
<div class="note" id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_note4085744"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_ul36771698"><li id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_li62509834">Currently, images can be shared only within the same region.</li><li id="EN-US_TOPIC_0110300592__li9147183901514">The token obtained from Identity and Access Management (IAM) is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</li></ul>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_section8340425"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0110300592__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0110300592__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0110300592__ul1840113419200"><li id="EN-US_TOPIC_0110300592__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0110300592__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0110300592__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300592__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_li59224828">IMS API used to add an image member (Native OpenStack API)<p id="EN-US_TOPIC_0110300592__p945919354610"><a name="EN-US_TOPIC_0110300592__en-us_topic_0110299938_li59224828"></a><a name="en-us_topic_0110299938_li59224828"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300592__i1711066104918">IMS endpoint</em>/v2/images/<em id="EN-US_TOPIC_0110300592__i14110164499">Image ID</em>/members</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_section7954964"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_ol32481801"><li id="EN-US_TOPIC_0110300592__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_li10736577">Send <strong id="EN-US_TOPIC_0110300592__b134248322501">POST https://</strong><em id="EN-US_TOPIC_0110300592__i42507312509">IMS endpoint</em><strong id="EN-US_TOPIC_0110300592__b1930002985014">/v2/images/</strong><em id="EN-US_TOPIC_0110300592__i384417201507">Image ID</em><strong id="EN-US_TOPIC_0110300592__b13410525165014">/members</strong>.</li><li id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_li29520332">Add <strong id="EN-US_TOPIC_0110300592__b84235270615255">X-Auth-Token</strong> to the request header.</li><li id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_li64356400">Specify the following parameters in the request body:<pre class="screen" id="EN-US_TOPIC_0110300592__screen1639164019160">{
"member": "edc89b490d7d4392898e19b2deb34797" //Member ID (that is, project ID of the image recipient)
}</pre>
</li><li id="EN-US_TOPIC_0110300592__en-us_topic_0110299938_li60482217">Check the response parameters.<pre class="screen" id="EN-US_TOPIC_0110300592__screen1282785071618">{
"status": "pending", //Image is being shared
"created_at": "2016-09-01T02:05:14Z", //Time when the image is shared
"updated_at": "2016-09-01T02:05:14Z", //Time when the image is updated
"image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", //Image ID
"member_id": "edc89b490d7d4392898e19b2deb34797" //Member ID (that is, project ID of the image recipient)
"schema": "/v2/schemas/member" //Image sharing schema
}</pre>
<p id="EN-US_TOPIC_0110300592__p17617162163611">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0110300591.html">Sharing an Image</a></div>
</div>
</div>

33
docs/ims/dev/en-us_topic_0110300593.html Normal file
View File

@ -0,0 +1,33 @@
<a name="EN-US_TOPIC_0110300593"></a><a name="EN-US_TOPIC_0110300593"></a>
<h1 class="topictitle1">Updating the Image Sharing Status</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_section13251620"><h4 class="sectiontitle">Scenario</h4><p class="MsoNormal" id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_p49639248">The status of a shared image can be updated after the tenant accepts or rejects the image.</p>
<div class="note" id="EN-US_TOPIC_0110300593__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0110300593__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_section52155720"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0110300593__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0110300593__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0110300593__ul1840113419200"><li id="EN-US_TOPIC_0110300593__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0110300593__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0110300593__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300593__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_li45123001">IMS API used to update the image sharing status (Native OpenStack API)<p id="EN-US_TOPIC_0110300593__p690704244611"><a name="EN-US_TOPIC_0110300593__en-us_topic_0110299939_li45123001"></a><a name="en-us_topic_0110299939_li45123001"></a>URI format: PUT https://<em id="EN-US_TOPIC_0110300593__i1375972285416">IMS endpoint</em>/v2/images/<em id="EN-US_TOPIC_0110300593__i276018223541">Image ID</em>/members/<em id="EN-US_TOPIC_0110300593__i20300350165410">Member ID</em></p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_section66748299"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_ol31084503"><li id="EN-US_TOPIC_0110300593__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_li51228725">Send <strong id="EN-US_TOPIC_0110300593__b842352706162610">PUT https://</strong><em id="EN-US_TOPIC_0110300593__i842352697162616">IMS endpoint</em><strong id="EN-US_TOPIC_0110300593__b842352706162621">/v2/images/</strong><em id="EN-US_TOPIC_0110300593__i842352697162648">Image ID</em><strong id="EN-US_TOPIC_0110300593__b1269673461162643">/members/</strong><em id="EN-US_TOPIC_0110300593__i842352697162629">Member ID</em>. <em id="EN-US_TOPIC_0110300593__i842352697162714">Member ID</em> indicates the project ID of the image recipient.</li><li id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_li58405349">Add <strong id="EN-US_TOPIC_0110300593__b84235270615255">X-Auth-Token</strong> to the request header.</li><li id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_li55886094">Specify the following parameters in the request body:<pre class="screen" id="EN-US_TOPIC_0110300593__screen15328184114189">{
"status": "accepted" //<strong id="EN-US_TOPIC_0110300593__b842352706164822">accepted</strong> indicates that the shared image will be accepted.
}</pre>
</li><li id="EN-US_TOPIC_0110300593__en-us_topic_0110299939_li52942405">Check the response parameters.<pre class="screen" id="EN-US_TOPIC_0110300593__screen18984175161815">{
"status": "accepted", //Sharing status (<strong id="EN-US_TOPIC_0110300593__b2001791239165011">accepted</strong> indicates that the shared image will be accepted.)
"created_at": "2016-09-01T02:05:14Z", //Time when the image is shared
"updated_at": "2016-09-01T02:37:11Z", //Time when the image is updated
"image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", //Image ID
"member_id": "edc89b490d7d4392898e19b2deb34797" //Member ID (that is, project ID of the image recipient)
"schema": "/v2/schemas/member" //Image sharing schema
}</pre>
<p id="EN-US_TOPIC_0110300593__p104514441366">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0110300591.html">Sharing an Image</a></div>
</div>
</div>

30
docs/ims/dev/en-us_topic_0110300594.html Normal file
View File

@ -0,0 +1,30 @@
<a name="EN-US_TOPIC_0110300594"></a><a name="EN-US_TOPIC_0110300594"></a>
<h1 class="topictitle1">Querying Details About an Image Member</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_section29135036"><h4 class="sectiontitle">Scenario</h4><p class="MsoNormal" id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_p19372405">Details about a tenant with whom you have shared images can be queried.</p>
<div class="note" id="EN-US_TOPIC_0110300594__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0110300594__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_section60888739"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0110300594__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0110300594__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0110300594__ul1840113419200"><li id="EN-US_TOPIC_0110300594__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0110300594__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0110300594__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300594__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_li43556055">IMS API used to query details about an image member (Native OpenStack API)<p id="EN-US_TOPIC_0110300594__p651112574719"><a name="EN-US_TOPIC_0110300594__en-us_topic_0110299940_li43556055"></a><a name="en-us_topic_0110299940_li43556055"></a>URI format: GET https://<em id="EN-US_TOPIC_0110300594__i2043712288113">IMS endpoint</em>/v2/images/<em id="EN-US_TOPIC_0110300594__i84384281918">Image ID</em>/members/<em id="EN-US_TOPIC_0110300594__i174388282116">Member ID</em></p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_section11127745"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_ol38379555"><li id="EN-US_TOPIC_0110300594__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_li43938279">Send <strong id="EN-US_TOPIC_0110300594__b842352706163157">GET https://</strong><em id="EN-US_TOPIC_0110300594__i84235269716322">IMS endpoint</em><strong id="EN-US_TOPIC_0110300594__b84235270616329">/v2/images/</strong><em id="EN-US_TOPIC_0110300594__i928543420163218">Image ID</em><strong id="EN-US_TOPIC_0110300594__b842352706163227">/members/</strong><em id="EN-US_TOPIC_0110300594__i842352697163231">Member ID</em>. <em id="EN-US_TOPIC_0110300594__i84235269716330">Member ID</em> indicates the project ID of the image recipient.</li><li id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_li59900193">Add <strong id="EN-US_TOPIC_0110300594__b84235270615255">X-Auth-Token</strong> to the request header.</li><li id="EN-US_TOPIC_0110300594__en-us_topic_0110299940_li2230829">Check the response parameters.<pre class="screen" id="EN-US_TOPIC_0110300594__screen5688104616197">{
"status": "accepted", //Sharing status (<strong id="EN-US_TOPIC_0110300594__b76873467216">accepted</strong> indicates that the shared image will be accepted.)
"created_at": "2016-09-01T02:05:14Z", //Time when the image is shared
"updated_at": "2016-09-01T02:37:11Z", //Time when the image is updated
"image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", //Image ID
"member_id": "edc89b490d7d4392898e19b2deb34797" //Member ID (that is, project ID of the image recipient)
"schema": "/v2/schemas/member" //Image sharing schema
}</pre>
<p id="EN-US_TOPIC_0110300594__p10445182563713">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0110300591.html">Sharing an Image</a></div>
</div>
</div>

30
docs/ims/dev/en-us_topic_0110300595.html Normal file
View File

@ -0,0 +1,30 @@
<a name="EN-US_TOPIC_0110300595"></a><a name="EN-US_TOPIC_0110300595"></a>
<h1 class="topictitle1">Querying Tenants</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_section16689200"><h4 class="sectiontitle">Scenario</h4><p class="MsoNormal" id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_p17300225">Tenants with whom you have shared an image can be filtered using search criteria and displayed in a list.</p>
<div class="note" id="EN-US_TOPIC_0110300595__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0110300595__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_section15985080"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0110300595__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0110300595__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0110300595__ul1840113419200"><li id="EN-US_TOPIC_0110300595__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0110300595__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0110300595__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300595__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_li35559222">IMS API used to query image members (Native OpenStack API)<p id="EN-US_TOPIC_0110300595__p141574355489"><a name="EN-US_TOPIC_0110300595__en-us_topic_0110299941_li35559222"></a><a name="en-us_topic_0110299941_li35559222"></a>URI format: GET https://<em id="EN-US_TOPIC_0110300595__i139991716542">IMS endpoint</em>/v2/images/<em id="EN-US_TOPIC_0110300595__i10317344">Image ID</em>/members</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_section9647994"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_ol61724767"><li id="EN-US_TOPIC_0110300595__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_li57311924">Send <strong id="EN-US_TOPIC_0110300595__b202761056945">GET https://</strong><em id="EN-US_TOPIC_0110300595__i1031564919411">IMS endpoint</em><strong id="EN-US_TOPIC_0110300595__b898616521748">/v2/images/</strong><em id="EN-US_TOPIC_0110300595__i842352697172926">Image ID</em><strong id="EN-US_TOPIC_0110300595__b1034289154172917">/members/</strong>.</li><li id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_li46045275">Add <strong id="EN-US_TOPIC_0110300595__b84235270615255">X-Auth-Token</strong> to the request header.</li><li id="EN-US_TOPIC_0110300595__en-us_topic_0110299941_li11754296">Check the response parameters.<pre class="screen" id="EN-US_TOPIC_0110300595__screen730511578205">{
"status": "accepted", //Sharing status (<strong id="EN-US_TOPIC_0110300595__b15848173117512">accepted</strong> indicates that the shared image will be accepted.)
"created_at": "2016-09-01T02:05:14Z", //Time when the image is shared
"updated_at": "2016-09-01T02:37:11Z", //Time when the image is updated
"image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", //Image ID
"member_id": "edc89b490d7d4392898e19b2deb34797" //Member ID (that is, project ID of the image recipient)
"schema": "/v2/schemas/member" //Image sharing schema
}</pre>
<p id="EN-US_TOPIC_0110300595__p103872115382">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0110300591.html">Sharing an Image</a></div>
</div>
</div>

23
docs/ims/dev/en-us_topic_0110300596.html Normal file
View File

@ -0,0 +1,23 @@
<a name="EN-US_TOPIC_0110300596"></a><a name="EN-US_TOPIC_0110300596"></a>
<h1 class="topictitle1">Deleting an Image Member</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0110300596__en-us_topic_0110299943_section18301082"><h4 class="sectiontitle">Scenario</h4><p class="MsoNormal" id="EN-US_TOPIC_0110300596__en-us_topic_0110299943_p61347601">Image sharing can be stopped if you do not want to share your images any more.</p>
<div class="note" id="EN-US_TOPIC_0110300596__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0110300596__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0110300596__en-us_topic_0110299943_section30492010"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0110300596__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0110300596__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0110300596__ul1840113419200"><li id="EN-US_TOPIC_0110300596__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0110300596__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0110300596__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300596__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0110300596__en-us_topic_0110299943_li27869743">IMS API used to delete an image member (Native OpenStack API)<p id="EN-US_TOPIC_0110300596__p49864255114"><a name="EN-US_TOPIC_0110300596__en-us_topic_0110299943_li27869743"></a><a name="en-us_topic_0110299943_li27869743"></a>URI format: DELETE https://<em id="EN-US_TOPIC_0110300596__i1982732218615">IMS endpoint</em>/v2/images/<em id="EN-US_TOPIC_0110300596__i1382810229619">Image ID</em>/members/<em id="EN-US_TOPIC_0110300596__i1482872211615">Member ID</em></p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0110300596__en-us_topic_0110299943_section5992637"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0110300596__en-us_topic_0110299943_ol42856673"><li id="EN-US_TOPIC_0110300596__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0110300596__en-us_topic_0110299943_li60176744">Send <strong id="EN-US_TOPIC_0110300596__b134601332565">DELETE https://</strong><em id="EN-US_TOPIC_0110300596__i2460632763">IMS endpoint</em><strong id="EN-US_TOPIC_0110300596__b1246053216611">/v2/images/</strong><em id="EN-US_TOPIC_0110300596__i17460193217614">Image ID</em><strong id="EN-US_TOPIC_0110300596__b44615322614">/members/</strong><em id="EN-US_TOPIC_0110300596__i44611132364">Member ID</em>. <em id="EN-US_TOPIC_0110300596__i164611328619">Member ID</em> indicates the project ID of the image recipient.</li><li id="EN-US_TOPIC_0110300596__li1329510246315">Add <strong id="EN-US_TOPIC_0110300596__b84235270615255">X-Auth-Token</strong> to the request header.<p id="EN-US_TOPIC_0110300596__p23341256310">If the request is successful, status code 204 is returned.</p>
<p id="EN-US_TOPIC_0110300596__p19540153313813">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0110300591.html">Sharing an Image</a></div>
</div>
</div>

34
docs/ims/dev/en-us_topic_0110300597.html Normal file
View File

@ -0,0 +1,34 @@
<a name="EN-US_TOPIC_0110300597"></a><a name="EN-US_TOPIC_0110300597"></a>
<h1 class="topictitle1">Adding Image Members</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_section47188597"><h4 class="sectiontitle">Scenario</h4><p class="MsoNormal" id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_p60892825">An image can be shared with multiple tenants. The API used add tenants is an extension API.</p>
<div class="note" id="EN-US_TOPIC_0110300597__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0110300597__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_section22044193"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0110300597__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0110300597__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0110300597__ul1840113419200"><li id="EN-US_TOPIC_0110300597__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0110300597__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0110300597__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300597__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_li4742722">IMS API used to add image members<p id="EN-US_TOPIC_0110300597__p108151126537"><a name="EN-US_TOPIC_0110300597__en-us_topic_0110299944_li4742722"></a><a name="en-us_topic_0110299944_li4742722"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300597__i18339431593">IMS endpoint</em>/v1/cloudimages/members</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_section64180012"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_ol48616240"><li id="EN-US_TOPIC_0110300597__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_li29687198">Send <strong id="EN-US_TOPIC_0110300597__b164763571196">POST https://</strong><em id="EN-US_TOPIC_0110300597__i14641115218915">IMS endpoint</em><strong id="EN-US_TOPIC_0110300597__b98831206104">/v1/cloudimages/members</strong>.</li><li id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_li65858198">Add <strong id="EN-US_TOPIC_0110300597__b84235270615255">X-Auth-Token</strong> to the request header.</li><li id="EN-US_TOPIC_0110300597__en-us_topic_0110299944_li55852871">Configure the request parameters. (The values are examples only.)<pre class="screen" id="EN-US_TOPIC_0110300597__screen1290135316223">{
"images": [
"d164b5df-1bc3-4c3f-893e-3e471fd16e64",
"0b680482-acaa-4045-b14c-9a8c7dfe9c70"
], //Image IDs (mandatory, list&lt;string&gt;)
"projects": [
"9c61004714024f9586705d090530f9fa",
"edc89b490d7d4392898e19b2deb34797"
], //Project IDs (mandatory, list&lt;string&gt;)
}</pre>
<p id="EN-US_TOPIC_0110300597__p11433121819584">If the request is successful, a job ID is returned.</p>
</li><li id="EN-US_TOPIC_0110300597__li514842411357">Query job details using the job ID by referring to <a href="en-us_topic_0109822371.html">Querying Job Details</a>.<p id="EN-US_TOPIC_0110300597__p411722533511">If the job status is <strong id="EN-US_TOPIC_0110300597__b8423527061586">SUCCESS</strong>, the private image is successfully created.</p>
<p id="EN-US_TOPIC_0110300597__p2120102015816">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0110300591.html">Sharing an Image</a></div>
</div>
</div>

32
docs/ims/dev/en-us_topic_0110300598.html Normal file
View File

@ -0,0 +1,32 @@
<a name="EN-US_TOPIC_0110300598"></a><a name="EN-US_TOPIC_0110300598"></a>
<h1 class="topictitle1">Updating the Image Sharing Status in Batches</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_section65045669"><h4 class="sectiontitle">Scenario</h4><p class="MsoNormal" id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_p26965262">The image sharing status can be updated in batches after a tenant accepts or rejects multiple shared images. The API used is an extension API.</p>
<div class="note" id="EN-US_TOPIC_0110300598__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0110300598__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_section48540109"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0110300598__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0110300598__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0110300598__ul1840113419200"><li id="EN-US_TOPIC_0110300598__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0110300598__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0110300598__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300598__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_li64754634">IMS API used to update the image sharing status in batches<p id="EN-US_TOPIC_0110300598__p18994441155517"><a name="EN-US_TOPIC_0110300598__en-us_topic_0110299945_li64754634"></a><a name="en-us_topic_0110299945_li64754634"></a>URI format: PUT https://<em id="EN-US_TOPIC_0110300598__i1706164201117">IMS endpoint</em>/v1/cloudimages/members</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_section34207804"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_ol10634019"><li id="EN-US_TOPIC_0110300598__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_li43129175">Send <strong id="EN-US_TOPIC_0110300598__b5545201091210">PUT https://</strong><em id="EN-US_TOPIC_0110300598__i12744155931118">IMS endpoint</em><strong id="EN-US_TOPIC_0110300598__b13945111371210">/v1/cloudimages/members</strong>.</li><li id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_li52618256">Add <strong id="EN-US_TOPIC_0110300598__b84235270615255">X-Auth-Token</strong> to the request header.</li><li id="EN-US_TOPIC_0110300598__en-us_topic_0110299945_li3802258">Configure the request parameters. (The values are examples only.)<pre class="screen" id="EN-US_TOPIC_0110300598__screen1145614516236">{
"images": [
"d164b5df-1bc3-4c3f-893e-3e471fd16e64",
"0b680482-acaa-4045-b14c-9a8c7dfe9c70"
], //Image IDs (mandatory, list&lt;string&gt;)
"project_id": "edc89b490d7d4392898e19b2deb34797", //Project IDs (mandatory, string)
"status": "accepted" //Image sharing status: <strong id="EN-US_TOPIC_0110300598__b842352706185655">accepted</strong> indicates that shared images will be accepted. (mandatory, string)
}</pre>
<p id="EN-US_TOPIC_0110300598__p1432212256584">If the request is successful, a job ID is returned.</p>
</li><li id="EN-US_TOPIC_0110300598__li514842411357">Query job details using the job ID by referring to <a href="en-us_topic_0109822371.html">Querying Job Details</a>.<p id="EN-US_TOPIC_0110300598__p411722533511">If the job status is <strong id="EN-US_TOPIC_0110300598__b8423527061586">SUCCESS</strong>, the private image is successfully created.</p>
<p id="EN-US_TOPIC_0110300598__p96422825818">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0110300591.html">Sharing an Image</a></div>
</div>
</div>

34
docs/ims/dev/en-us_topic_0110300599.html Normal file
View File

@ -0,0 +1,34 @@
<a name="EN-US_TOPIC_0110300599"></a><a name="EN-US_TOPIC_0110300599"></a>
<h1 class="topictitle1">Deleting Image Members</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_section52964449"><h4 class="sectiontitle">Scenario</h4><p class="MsoNormal" id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_p17531178">Image sharing with multiple tenants can be stopped at the same time.</p>
<div class="note" id="EN-US_TOPIC_0110300599__note021013252910"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0110300599__en-us_topic_0109822404_p88501497167">The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_section6918001"><h4 class="sectiontitle">Involved APIs</h4><p class="litext" id="EN-US_TOPIC_0110300599__p23385131">If you use a token for authentication, you must obtain the token and add <strong id="EN-US_TOPIC_0110300599__en-us_topic_0109822381_b842352706134841">X-Auth-Token</strong> to the request header of the IMS API when making an API call.</p>
<ul id="EN-US_TOPIC_0110300599__ul1840113419200"><li id="EN-US_TOPIC_0110300599__li6754315">IAM API used to obtain the token<p id="EN-US_TOPIC_0110300599__en-us_topic_0109822381_p1833933634"><a name="EN-US_TOPIC_0110300599__li6754315"></a><a name="li6754315"></a>URI format: POST https://<em id="EN-US_TOPIC_0110300599__en-us_topic_0109822381_i15500165112426">IAM endpoint</em>/v3/auth/tokens</p>
</li><li id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_li29365919">IMS API used to delete image members<p id="EN-US_TOPIC_0110300599__p25803160145010"><a name="EN-US_TOPIC_0110300599__en-us_topic_0110299946_li29365919"></a><a name="en-us_topic_0110299946_li29365919"></a>URI format: DELETE https://<em id="EN-US_TOPIC_0110300599__i118342388156">IMS endpoint</em>/v1/cloudimages/members</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_section62262011"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_ol29829272"><li id="EN-US_TOPIC_0110300599__li1837051910476">Obtain the token.</li><li id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_li24500989">Send <strong id="EN-US_TOPIC_0110300599__b253312596158">DELETE https://</strong><em id="EN-US_TOPIC_0110300599__i1899105491517">IMS endpoint</em><strong id="EN-US_TOPIC_0110300599__b389312131618">/v1/cloudimages/members</strong>.</li><li id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_li19182316">Add <strong id="EN-US_TOPIC_0110300599__b84235270615255">X-Auth-Token</strong> to the request header.</li><li id="EN-US_TOPIC_0110300599__en-us_topic_0110299946_li38423121">Configure the request parameters. (The values are examples only.)<pre class="screen" id="EN-US_TOPIC_0110300599__screen320013414307">{
"images": [
"d164b5df-1bc3-4c3f-893e-3e471fd16e64",
"0b680482-acaa-4045-b14c-9a8c7dfe9c70"
], //Image IDs (mandatory, list&lt;string&gt;)
"projects": [
"9c61004714024f9586705d090530f9fa",
"edc89b490d7d4392898e19b2deb34797"
], //Project IDs (mandatory, list&lt;string&gt;)
}</pre>
<p id="EN-US_TOPIC_0110300599__p17480327105813">If the request is successful, a job ID is returned.</p>
</li><li id="EN-US_TOPIC_0110300599__li514842411357">Query job details using the job ID by referring to <a href="en-us_topic_0109822371.html">Querying Job Details</a>.<p id="EN-US_TOPIC_0110300599__p411722533511">If the job status is <strong id="EN-US_TOPIC_0110300599__b8423527061586">SUCCESS</strong>, the private image is successfully created.</p>
<p id="EN-US_TOPIC_0110300599__p1960622885819">For details about status codes for request exceptions, see <a href="en-us_topic_0124290300.html">Status Codes</a>.</p>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0110300591.html">Sharing an Image</a></div>
</div>
</div>

1761
docs/ims/dev/en-us_topic_0110943799.html Normal file
View File

File diff suppressed because it is too large Load Diff

121
docs/ims/dev/en-us_topic_0124290300.html Normal file
View File

File diff suppressed because it is too large Load Diff

31
docs/ims/dev/en-us_topic_0139609146.html Normal file
View File

@ -0,0 +1,31 @@
<a name="EN-US_TOPIC_0139609146"></a><a name="EN-US_TOPIC_0139609146"></a>
<h1 class="topictitle1">Change History</h1>
<div id="body1541659006645">
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0139609146__table45252044115657" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0139609146__row14336062115657"><th align="left" class="cellrowborder" valign="top" width="29.32%" id="mcps1.3.1.1.3.1.1"><p id="EN-US_TOPIC_0139609146__p1901683510285"><strong id="EN-US_TOPIC_0139609146__b842352706162855">Released On</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70.67999999999999%" id="mcps1.3.1.1.3.1.2"><p id="EN-US_TOPIC_0139609146__p20370378115657"><strong id="EN-US_TOPIC_0139609146__b41397434154816">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0139609146__row115313185447"><td class="cellrowborder" valign="top" width="29.32%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0139609146__p35325183442">2021-08-16</p>
</td>
<td class="cellrowborder" valign="top" width="70.67999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0139609146__p7532201844417">This issue is the second official release.</p>
<ul id="EN-US_TOPIC_0139609146__ul201844114415"><li id="EN-US_TOPIC_0139609146__li160164418441">Deleted content related to Marketplace.</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0139609146__row461418105320"><td class="cellrowborder" valign="top" width="29.32%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0139609146__p1099083412530">2018-11-08</p>
</td>
<td class="cellrowborder" valign="top" width="70.67999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0139609146__p129909347535">This issue is the first official release.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0109822372.html">Appendix</a></div>
</div>
</div>

29
docs/ims/dev/en-us_topic_0219492328.html Normal file
View File

@ -0,0 +1,29 @@
<a name="EN-US_TOPIC_0219492328"></a><a name="EN-US_TOPIC_0219492328"></a>
<h1 class="topictitle1">Common Scenarios</h1>
<div id="body1578922033366"></div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="en-us_topic_0109822381.html">Creating an Image Using an ECS</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0109822382.html">Creating an Image Using an External Image File</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0109822403.html">Querying an Images List</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0109822404.html">Queries Details About an Image</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0109822367.html">Updating Image Information</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0109822368.html">Deleting an Image</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0109822369.html">Exporting an Image</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0109822370.html">Replicating an Images Within a Region</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0110300591.html">Sharing an Image</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0109822371.html">Querying Job Details</a></strong><br>
</li>
</ul>
</div>

1
docs/ims/dev/public_sys-resources/ExpandCollapse.js Normal file
View File

@ -0,0 +1 @@
var expandClassName="dropdownexpand";var collapseClassName="dropdowncollapse";var collapseTableClassName="dropdowncollapsetable";var href="";function ExpandorCollapseNode(a){a=a.parentNode;if(a.className==expandClassName){a.className=collapseClassName}else{a.className=expandClassName}}function ExpandorCollapseTableNode(a){a=a.parentNode;if(a.className==expandClassName){a.className=collapseTableClassName}else{a.className=expandClassName}}function ExpandorCollapseAllNodes(g,h,c){var a=g.getAttribute("title");var b=g.parentNode;if(a=="collapse"){g.setAttribute("title","expand");g.className="dropdownAllButtonexpand";g.innerHTML=h}else{g.setAttribute("title","collapse");g.className="dropdownAllButtoncollapse";g.innerHTML=c}var f=b.getElementsByTagName("*");for(var d=0;d<f.length;d++){var e=f[d];if(e.className.indexOf(expandClassName)!=-1||e.className.indexOf(collapseClassName)!=-1||e.className.indexOf(collapseTableClassName)!=-1){if(a=="collapse"){if(e.tagName.toLowerCase()=="table"){e.className=collapseTableClassName}else{e.className=collapseClassName}}else{e.className=expandClassName}}}}function ExpandForHref(f){if(null==f||"#"==f||"###"==f){return}var a=null;try{a=document.getElementById(f)}catch(d){}if(null==a||a.length==0){return}try{var b=a.parentNode;while(b!=null&&b.tagName!="body"){if(b.className==collapseClassName){b.className=expandClassName}b=b.parentNode}}catch(c){}}window.onload=function(){var b=document.getElementsByTagName("div");for(var c=0;c<b.length;c++){var j=b[c];if(j.className.indexOf(expandClassName)!=-1){j.className=collapseClassName}}var d=document.getElementsByTagName("a");try{for(var c=0;c<d.length;c++){var f=d[c];var h=f.getAttribute("href");if(h!=""&&h!=null){href=h;f.addEventListener("click",showHasConref,false)}}}catch(g){}};function showHasConref(){try{if(href!=null&&href!="#"&&href.lastIndexOf("#")>-1){ExpandForHref(href.substring(href.lastIndexOf("#")+1))}}catch(a){}};

BIN
docs/ims/dev/public_sys-resources/caution_3.0-en-us.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.7 KiB

1
docs/ims/dev/public_sys-resources/commonltr.css Normal file
View File

File diff suppressed because one or more lines are too long

1
docs/ims/dev/public_sys-resources/commonltr_print.css Normal file
View File

File diff suppressed because one or more lines are too long

2
docs/ims/dev/public_sys-resources/commonrtl.css Normal file
View File

@ -0,0 +1,2 @@
.msgph{font-family:Courier New}.unresolved{background-color:#87ceeb}.noTemplate{background-color:#ff0}.base{background-color:#fff}/*! Add space for top level topics */.nested0,.p{margin-top:1em}/*! div with class=p is used for paragraphs that contain blocks, to keep the XHTML valid *//*! Default of italics to set apart figure captions */.figcap,.italic,.var{font-style:italic}.figdesc{font-style:normal}/*! Use @frame to create frames on figures */.figborder{padding-left:3px;padding-right:3px;margin-top:1em;border:2px solid Silver}.figsides{margin-top:1em;padding-left:3px;padding-right:3px;border-left:2px solid Silver;border-right:2px solid Silver}.figtop{border-top:2px solid Silver;margin-top:1em}.figbottom{border-bottom:2px solid Silver}.figtopbot{border-top:2px solid Silver;border-bottom:2px solid Silver;margin-top:1em}/*! Most link groups are created with <div>. Ensure they have space before and after. */.ullinks,ul.simple{list-style-type:none}.attention,.danger,.ddexpand,.dlexpand,.example,.fastpath,.important,.liexpand,.linklist,.note,.notice,.olchildlink,.relconcepts,.relinfo,.relref,.reltasks,.remember,.restriction,.section,.sliexpand,.stepexpand,.substepexpand,.tip,.ulchildlink,.warning{margin-top:1em;margin-bottom:1em}.linklistwithchild,.sublinklist{margin-top:1em;margin-right:1.5em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-right:20px}/*! Set heading sizes, getting smaller for deeper nesting */.topictitle1{font-size:1.34em;margin-top:0;margin-bottom:.1em}.topictitle2,.topictitle3,.topictitle4,.topictitle5,.topictitle6,.sectiontitle{font-size:1.17em}.topictitle2{margin-top:1pc;margin-bottom:.45em}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-weight:700}.topictitle4{margin-top:.83em;font-weight:700}.topictitle5{font-weight:700}.topictitle6{font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:0;color:#000;font-weight:700}/*! All note formats have the same default presentation */.attentiontitle,.bold,.cautiontitle,.dangertitle,.dlterm,.fastpathtitle,.firstcol,.importanttitle,.notelisttitle,.notetitle,.noticetitle,.parmname,.remembertitle,.restrictiontitle,.tiptitle,.uicontrol,.warningtitle{font-weight:700}.caution{font-weight:700;margin-bottom:1em}/*! Simple lists do not get a bullet *//*! Used on the first column of a table, when rowheader="firstcol" is used *//*! Various basic phrase styles */.boldItalic{font-weight:700;font-style:italic}.shortcut,.underlined{text-decoration:underline}/*! 2008-10-27 keyword采用跟随上下文的样式
*//*! Default of bold for definition list terms *//*! Use CSS to expand lists with @compact="no" */.dltermexpand{font-weight:700;margin-top:1em}[compact="yes"]>li{margin-top:0}[compact="no"]>li{margin-top:.53em}/*! Align images based on @align on topic/image */div.imageleft,.text-align-left{text-align:left}div.imagecenter,.text-align-center{text-align:center}div.imageright,.text-align-right{text-align:right}div.imagejustify,.text-align-justify{text-align:justify}.cellrowborder{border-right:0;border-top:0;border-left:1px solid;border-bottom:1px solid}.row-nocellborder{border-left:hidden;border-right:0;border-top:0;border-bottom:1px solid}.cell-norowborder{border-top:0;border-bottom:hidden;border-right:0;border-left:1px solid}.nocellnorowborder{border:0;border-left:hidden;border-bottom:hidden}pre.codeblock,pre.screen{padding:5px;border:outset;background-color:#ccc;margin-top:2px;margin-bottom:2px;white-space:pre}

BIN
docs/ims/dev/public_sys-resources/danger_3.0-en-us.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.7 KiB

BIN
docs/ims/dev/public_sys-resources/delta.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 836 B

BIN
docs/ims/dev/public_sys-resources/deltaend.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 834 B

BIN
docs/ims/dev/public_sys-resources/icon-arrowdn.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 68 B

BIN
docs/ims/dev/public_sys-resources/icon-arrowrt.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 70 B

BIN
docs/ims/dev/public_sys-resources/icon-caution.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
docs/ims/dev/public_sys-resources/icon-danger.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
docs/ims/dev/public_sys-resources/icon-huawei.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.7 KiB

BIN
docs/ims/dev/public_sys-resources/icon-note.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 983 B

BIN
docs/ims/dev/public_sys-resources/icon-notice.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 962 B

BIN
docs/ims/dev/public_sys-resources/icon-tip.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 879 B

BIN
docs/ims/dev/public_sys-resources/icon-warning.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
docs/ims/dev/public_sys-resources/note_3.0-en-us.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
docs/ims/dev/public_sys-resources/notice_3.0-en-us.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.6 KiB

1
docs/ims/dev/public_sys-resources/popup.js Normal file
View File

@ -0,0 +1 @@
var i=0;var dhtmlgoodies_tooltipFlag=false;var dhtmlgoodies_tooltip="";var dhtmlgoodies_tooltipShadow="";var dhtmlgoodies_shadowSize=3;var dhtmlgoodies_tooltipMaxWidth=500;var dhtmlgoodies_tooltipMinWidth=100;var dhtmlgoodies_iframe=false;var timeId;var clickFlag=false;var tooltip_is_msie=(navigator.userAgent.indexOf("MSIE")>=0&&navigator.userAgent.indexOf("opera")==-1&&document.all)?true:false;var xPos;var yPos;window.document.onmousemove=function(a){a=a||window.event;if(a.pageX){xPos=a.pageX;yPos=a.pageY}else{if(document.body!=null){xPos=a.clientX+document.body.scrollLeft-document.body.clientLeft;yPos=a.clientY+document.body.scrollTop-document.body.clientTop}}};function showTooltip(tooltipTxt){if(document.body==null){return}if(i==0){return}clickFlag=true;var text=eval("jsonData."+tooltipTxt);var bodyWidth=Math.max(document.body.clientWidth,document.documentElement.clientWidth)-20;if(!dhtmlgoodies_tooltipFlag){dhtmlgoodies_tooltip=document.createElement("DIV");dhtmlgoodies_tooltip.id="dhtmlgoodies_tooltip";dhtmlgoodies_tooltipShadow=document.createElement("DIV");dhtmlgoodies_tooltipShadow.id="dhtmlgoodies_tooltipShadow";document.body.appendChild(dhtmlgoodies_tooltip);document.body.appendChild(dhtmlgoodies_tooltipShadow);if(tooltip_is_msie){dhtmlgoodies_iframe=document.createElement("IFRAME");dhtmlgoodies_iframe.frameborder="5";dhtmlgoodies_iframe.style.backgroundColor="#FFFFFF";dhtmlgoodies_iframe.src="#";dhtmlgoodies_iframe.style.zIndex=100;dhtmlgoodies_iframe.style.position="absolute";document.body.appendChild(dhtmlgoodies_iframe)}}dhtmlgoodies_tooltip.style.display="block";dhtmlgoodies_tooltipShadow.style.display="block";if(tooltip_is_msie){dhtmlgoodies_iframe.style.display="block"}var st=Math.max(document.body.scrollTop,document.documentElement.scrollTop);if(navigator.userAgent.toLowerCase().indexOf("safari")>=0){st=0}var leftPos=xPos+10;dhtmlgoodies_tooltip.style.width=null;dhtmlgoodies_tooltip.innerHTML=text;dhtmlgoodies_tooltip.style.left=leftPos+"px";if(tooltip_is_msie){dhtmlgoodies_tooltip.style.top=yPos+20+st+"px"}else{dhtmlgoodies_tooltip.style.top=yPos+20+"px"}dhtmlgoodies_tooltipShadow.style.left=leftPos+dhtmlgoodies_shadowSize+"px";if(tooltip_is_msie){dhtmlgoodies_tooltipShadow.style.top=yPos+20+st+dhtmlgoodies_shadowSize+"px"}else{dhtmlgoodies_tooltipShadow.style.top=yPos+20+dhtmlgoodies_shadowSize+"px"}if(dhtmlgoodies_tooltip.offsetWidth>dhtmlgoodies_tooltipMaxWidth){dhtmlgoodies_tooltip.style.width=dhtmlgoodies_tooltipMaxWidth+"px"}var tooltipWidth=dhtmlgoodies_tooltip.offsetWidth;if(tooltipWidth<dhtmlgoodies_tooltipMinWidth){tooltipWidth=dhtmlgoodies_tooltipMinWidth}dhtmlgoodies_tooltip.style.width=tooltipWidth+"px";dhtmlgoodies_tooltipShadow.style.width=dhtmlgoodies_tooltip.offsetWidth+"px";dhtmlgoodies_tooltipShadow.style.height=dhtmlgoodies_tooltip.offsetHeight+"px";if((leftPos+tooltipWidth)>bodyWidth){dhtmlgoodies_tooltip.style.left=(dhtmlgoodies_tooltipShadow.style.left.replace("px","")-((leftPos+tooltipWidth)-bodyWidth))+"px";dhtmlgoodies_tooltipShadow.style.left=(dhtmlgoodies_tooltipShadow.style.left.replace("px","")-((leftPos+tooltipWidth)-bodyWidth)+dhtmlgoodies_shadowSize)+"px"}if(tooltip_is_msie){dhtmlgoodies_iframe.style.left=dhtmlgoodies_tooltip.style.left;dhtmlgoodies_iframe.style.top=dhtmlgoodies_tooltip.style.top;dhtmlgoodies_iframe.style.width=dhtmlgoodies_tooltip.offsetWidth+"px";dhtmlgoodies_iframe.style.height=dhtmlgoodies_tooltip.offsetHeight+"px"}}function hideTooltip(){i=0;clickFlag=false;if(dhtmlgoodies_tooltip!=null&&dhtmlgoodies_tooltip.style!=null){dhtmlgoodies_tooltip.style.display="none";dhtmlgoodies_tooltipShadow.style.display="none";if(tooltip_is_msie){dhtmlgoodies_iframe.style.display="none"}}if(timeId!=null&&timeId!=""){clearTimeout(timeId)}}function showText(a){i=1;timeId=setTimeout(function(){showTooltip(a)},500)}function showText2(a){if(!clickFlag){i=1;showTooltip(a);i=0;if(timeId!=null&&timeId!=""){clearTimeout(timeId)}}}function anchorScroll(b){var d=document.getElementsByName(b);if(d!=null&&d.length>0){var c=d[0];var a=c.getBoundingClientRect().left+(document.body.scrollLeft||(document.documentElement&&document.documentElement.scrollLeft));var e=c.getBoundingClientRect().top+(document.body.scrollTop||(document.documentElement&&document.documentElement.scrollTop));window.scrollTo(a,e-30)}};

Some files were not shown because too many files have changed in this diff Show More