forked from docs/doc-exports
406 lines
31 KiB
HTML
406 lines
31 KiB
HTML
<a name="ListTemplateVersions"></a><a name="ListTemplateVersions"></a>
|
|
|
|
<h1 class="topictitle1">Listing Template Versions</h1>
|
|
<div id="body8662426"><div class="section" id="ListTemplateVersions__section813793104412"><h4 class="sectiontitle">Function</h4><p id="ListTemplateVersions__p1113763113445">ListTemplateVersions</p>
|
|
<p id="ListTemplateVersions__p213723174415">This API lists all template versions in a template.</p>
|
|
<ul id="ListTemplateVersions__ul71371131164411"><li id="ListTemplateVersions__li17137153104413">By default, the template versions are sorted by creation time. The template created latest is displayed on the top.</li><li id="ListTemplateVersions__li8137113184413">Currently, all template versions are returned. Pagination is not supported.</li><li id="ListTemplateVersions__li3137173112441">If there is no template version, an empty list will be returned.</li><li id="ListTemplateVersions__li313814313441">template_id is the unique ID of the template. It is a UUID generated by RFS when a template is created. Template names are unique at one specific time, so you can create a template named HelloWorld and another template with the same name after deleting the first one. For parallel development, team members may want to ensure that they are operating the template they created, not one with the same name created by other members after deleting the previous one. To avoid this mismatch, check the ID, since RFS ensures each template has a unique ID that does not change with updates. If the template_id value differs from the current template ID, 400 is returned.</li><li id="ListTemplateVersions__li11138931154417">If the template does not exist, 404 is returned.</li></ul>
|
|
<p id="ListTemplateVersions__p6138143118443">ListTemplateVersions returns only summaries of template versions. For details, refer to ListTemplateVersionsResponseBody. To obtain the template version, call ShowTemplateVersionContent.</p>
|
|
</div>
|
|
<div class="section" id="ListTemplateVersions__section191389317443"><h4 class="sectiontitle">Debugging</h4><p id="ListTemplateVersions__p11138431134419">You can debug this API through automatic authentication in <a href="https://console.huaweicloud.com/apiexplorer/#/openapi/AOS/doc?api=ListTemplateVersions" target="_blank" rel="noopener noreferrer">API Explorer</a> or use the SDK sample code generated by API Explorer.</p>
|
|
</div>
|
|
<div class="section" id="ListTemplateVersions__section1813853154416"><h4 class="sectiontitle">URI</h4><p id="ListTemplateVersions__p11138431184414">GET /v1/{project_id}/templates/{template_name}/versions</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__table213993119445" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="ListTemplateVersions__row1813913319447"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="ListTemplateVersions__p19140113114411">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="ListTemplateVersions__p8140163115441">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="ListTemplateVersions__p1114063194410">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="ListTemplateVersions__p31401331104411">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row16139131104412"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="ListTemplateVersions__p81405315446">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="ListTemplateVersions__p11141113111441">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="ListTemplateVersions__p101411731144420">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="ListTemplateVersions__p014193164413">Project ID. It can be obtained by calling an API or from the console.</p>
|
|
<p id="ListTemplateVersions__p21412031104418">Minimum: <strong id="ListTemplateVersions__b2141131114419">3</strong></p>
|
|
<p id="ListTemplateVersions__p101415314443">Maximum: <strong id="ListTemplateVersions__b1114111317444">64</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row1413983120445"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="ListTemplateVersions__p81415311449">template_name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="ListTemplateVersions__p514163174417">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="ListTemplateVersions__p814110315445">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="ListTemplateVersions__p4141183118448">Name of the template to be created.</p>
|
|
<p id="ListTemplateVersions__p3141193115444">Minimum: <strong id="ListTemplateVersions__b1514111311442">1</strong></p>
|
|
<p id="ListTemplateVersions__p151411331164412">Maximum: <strong id="ListTemplateVersions__b1814173194419">128</strong></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__table151427319446" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Query Parameters</caption><thead align="left"><tr id="ListTemplateVersions__row4142203134420"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="ListTemplateVersions__p1614283194410">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="ListTemplateVersions__p61421631114417">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="ListTemplateVersions__p2142183144420">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="ListTemplateVersions__p1614212314444">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row4142103110448"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="ListTemplateVersions__p6142143110444">template_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="ListTemplateVersions__p15142231204417">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="ListTemplateVersions__p2142531194410">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="ListTemplateVersions__p11142183164419">ID of a template. If <strong id="ListTemplateVersions__b7142143134419">template_id</strong> exists, the template service checks whether <strong id="ListTemplateVersions__b414263184419">template_id</strong> matches <strong id="ListTemplateVersions__b1714263124415">template_name</strong>. If not, <strong id="ListTemplateVersions__b15142173154414">400</strong> is returned.</p>
|
|
<p id="ListTemplateVersions__p16142103117440">Minimum: <strong id="ListTemplateVersions__b191421531174420">36</strong></p>
|
|
<p id="ListTemplateVersions__p4142143114443">Maximum: <strong id="ListTemplateVersions__b214253118442">36</strong></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="ListTemplateVersions__section10142123112441"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__en-us_topic_0000001757158497_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request header parameters</caption><thead align="left"><tr id="ListTemplateVersions__row16143123104416"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="ListTemplateVersions__p6143173113445">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.2"><p id="ListTemplateVersions__p814313316444">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.3"><p id="ListTemplateVersions__p6143133154410">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.2.5.1.4"><p id="ListTemplateVersions__p12143143114416">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row17143831134413"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="ListTemplateVersions__p2143431194411">Client-Request-Id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="ListTemplateVersions__p171431831104418">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="ListTemplateVersions__p1414373144413">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="ListTemplateVersions__p101432314447">Unique request ID. It is specified by a user and is used to locate a request. UUID is recommended.</p>
|
|
<p id="ListTemplateVersions__p5143103112441">Minimum: <strong id="ListTemplateVersions__b171431431114413">36</strong></p>
|
|
<p id="ListTemplateVersions__p31432319441">Maximum: <strong id="ListTemplateVersions__b114363184420">128</strong></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="ListTemplateVersions__section1414419317442"><h4 class="sectiontitle">Response Parameters</h4><p id="ListTemplateVersions__p9144173194412"><strong id="ListTemplateVersions__b151442031144416">Status code: 200</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__en-us_topic_0000001757158497_response_ListTemplateVersionsResponseBody" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response body parameters</caption><thead align="left"><tr id="ListTemplateVersions__row1414443134415"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.3.2.4.1.1"><p id="ListTemplateVersions__p814493174416">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.3.2.4.1.2"><p id="ListTemplateVersions__p19144193194418">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.3.2.4.1.3"><p id="ListTemplateVersions__p10144143115449">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row1114493114413"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="ListTemplateVersions__p19144631114412">versions</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="ListTemplateVersions__p12144163113442">Array of <a href="#ListTemplateVersions__en-us_topic_0000001757158497_response_TemplateVersion">TemplateVersion</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="ListTemplateVersions__p2144123110449">Template version list.</p>
|
|
<p id="ListTemplateVersions__p16144173154410">Array Length: <strong id="ListTemplateVersions__b61452031164415">0 - 100</strong></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="ListTemplateVersions__en-us_topic_0000001757158497_response_TemplateVersion"></a><a name="en-us_topic_0000001757158497_response_TemplateVersion"></a><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__en-us_topic_0000001757158497_response_TemplateVersion" frame="border" border="1" rules="all"><caption><b>Table 5 </b>TemplateVersion</caption><thead align="left"><tr id="ListTemplateVersions__row1414583114447"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.4.2.4.1.1"><p id="ListTemplateVersions__p914520317441">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.4.2.4.1.2"><p id="ListTemplateVersions__p1414653119447">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.4.2.4.1.3"><p id="ListTemplateVersions__p51461331174418">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row1914514314442"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="ListTemplateVersions__p2146203134414">template_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="ListTemplateVersions__p1014683184417">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="ListTemplateVersions__p20146183115445">Unique template ID. It is randomly generated by the template service.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row1114533115445"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="ListTemplateVersions__p8146831204412">template_name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="ListTemplateVersions__p111462311441">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="ListTemplateVersions__p101462318448">Name of the template to be created.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row414523114446"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="ListTemplateVersions__p19146631124419">version_description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="ListTemplateVersions__p1914663110445">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="ListTemplateVersions__p314723154413">Description of a template version. It can be used by users to identify their own template versions.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row41455311441"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="ListTemplateVersions__p161472319448">create_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="ListTemplateVersions__p191472314443">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="ListTemplateVersions__p4147103124413">Creation time of a template version. The format complies with RFC3339 (YYYY-MM-DDTHH:MM:SSZ), for example, 1970-01-01T00:00:00Z.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row1814553124415"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="ListTemplateVersions__p17147153164412">version_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="ListTemplateVersions__p151471131194415">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="ListTemplateVersions__p17147183119449">Template version ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="ListTemplateVersions__p151471031124417"><strong id="ListTemplateVersions__b201471131104410">Status code: 400</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__en-us_topic_0000001757158497_response_ErrorRsp" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Response body parameters</caption><thead align="left"><tr id="ListTemplateVersions__row114710311444"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.6.2.4.1.1"><p id="ListTemplateVersions__p14148631134420">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.6.2.4.1.2"><p id="ListTemplateVersions__p51486310443">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.6.2.4.1.3"><p id="ListTemplateVersions__p414813154417">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row1514718318447"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.6.2.4.1.1 "><p id="ListTemplateVersions__p1148931154410">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.6.2.4.1.2 "><p id="ListTemplateVersions__p81481331184410">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.6.2.4.1.3 "><p id="ListTemplateVersions__p1114863114417">Error code.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row1914783115441"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.6.2.4.1.1 "><p id="ListTemplateVersions__p1214873144414">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.6.2.4.1.2 "><p id="ListTemplateVersions__p914983114443">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.6.2.4.1.3 "><p id="ListTemplateVersions__p18149203184415">Error message.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="ListTemplateVersions__p614913184416"><strong id="ListTemplateVersions__b614923118441">Status code: 401</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__table181491731114418" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response body parameters</caption><thead align="left"><tr id="ListTemplateVersions__row91492031124413"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.8.2.4.1.1"><p id="ListTemplateVersions__p014953113444">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.8.2.4.1.2"><p id="ListTemplateVersions__p8150163144416">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.8.2.4.1.3"><p id="ListTemplateVersions__p41501631134415">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row4149183114419"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.8.2.4.1.1 "><p id="ListTemplateVersions__p12150203114440">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.8.2.4.1.2 "><p id="ListTemplateVersions__p1315053134410">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.8.2.4.1.3 "><p id="ListTemplateVersions__p1115011316444">Error code.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row1014963184416"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.8.2.4.1.1 "><p id="ListTemplateVersions__p21505313440">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.8.2.4.1.2 "><p id="ListTemplateVersions__p16150143112448">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.8.2.4.1.3 "><p id="ListTemplateVersions__p12150123119443">Error message.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="ListTemplateVersions__p15150431124419"><strong id="ListTemplateVersions__b115063174410">Status code: 403</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__table181507311447" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Response body parameters</caption><thead align="left"><tr id="ListTemplateVersions__row6150731174419"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.10.2.4.1.1"><p id="ListTemplateVersions__p01501031194418">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.10.2.4.1.2"><p id="ListTemplateVersions__p14151163154416">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.10.2.4.1.3"><p id="ListTemplateVersions__p1815120319444">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row51502319449"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.10.2.4.1.1 "><p id="ListTemplateVersions__p1215119319448">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.10.2.4.1.2 "><p id="ListTemplateVersions__p19151831174419">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.10.2.4.1.3 "><p id="ListTemplateVersions__p8151143113444">Error code.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row19150113116448"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.10.2.4.1.1 "><p id="ListTemplateVersions__p16151103174418">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.10.2.4.1.2 "><p id="ListTemplateVersions__p1715116311441">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.10.2.4.1.3 "><p id="ListTemplateVersions__p21517319442">Error message.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="ListTemplateVersions__p17151123115444"><strong id="ListTemplateVersions__b17151123104411">Status code: 404</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__table015113116443" frame="border" border="1" rules="all"><caption><b>Table 9 </b>Response body parameters</caption><thead align="left"><tr id="ListTemplateVersions__row2151183113446"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.12.2.4.1.1"><p id="ListTemplateVersions__p1215110310444">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.12.2.4.1.2"><p id="ListTemplateVersions__p5151183184417">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.12.2.4.1.3"><p id="ListTemplateVersions__p915203120449">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row16151133184414"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.12.2.4.1.1 "><p id="ListTemplateVersions__p1615263117447">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.12.2.4.1.2 "><p id="ListTemplateVersions__p715343164420">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.12.2.4.1.3 "><p id="ListTemplateVersions__p1315353119447">Error code.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row15151203174418"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.12.2.4.1.1 "><p id="ListTemplateVersions__p815313314447">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.12.2.4.1.2 "><p id="ListTemplateVersions__p1153143114415">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.12.2.4.1.3 "><p id="ListTemplateVersions__p2153113144416">Error message.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="ListTemplateVersions__p181534319445"><strong id="ListTemplateVersions__b41534316445">Status code: 429</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__table21533312443" frame="border" border="1" rules="all"><caption><b>Table 10 </b>Response body parameters</caption><thead align="left"><tr id="ListTemplateVersions__row1015303174412"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.14.2.4.1.1"><p id="ListTemplateVersions__p14153173118442">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.14.2.4.1.2"><p id="ListTemplateVersions__p41542313449">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.14.2.4.1.3"><p id="ListTemplateVersions__p1815413319448">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row915310313445"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.14.2.4.1.1 "><p id="ListTemplateVersions__p61541331124416">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.14.2.4.1.2 "><p id="ListTemplateVersions__p11154631144412">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.14.2.4.1.3 "><p id="ListTemplateVersions__p81543312446">Error code.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row6153931134415"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.14.2.4.1.1 "><p id="ListTemplateVersions__p10154231134415">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.14.2.4.1.2 "><p id="ListTemplateVersions__p1615423112447">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.14.2.4.1.3 "><p id="ListTemplateVersions__p13155153174412">Error message.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="ListTemplateVersions__p1315511314448"><strong id="ListTemplateVersions__b41558319444">Status code: 500</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__table10155431164414" frame="border" border="1" rules="all"><caption><b>Table 11 </b>Response body parameters</caption><thead align="left"><tr id="ListTemplateVersions__row91551731174417"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.16.2.4.1.1"><p id="ListTemplateVersions__p111551431184413">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.16.2.4.1.2"><p id="ListTemplateVersions__p1215543116446">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.16.2.4.1.3"><p id="ListTemplateVersions__p161561431144413">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row131559316449"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.16.2.4.1.1 "><p id="ListTemplateVersions__p1915614310442">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.16.2.4.1.2 "><p id="ListTemplateVersions__p11561312441">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.16.2.4.1.3 "><p id="ListTemplateVersions__p131564318444">Error code.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row615516319441"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.16.2.4.1.1 "><p id="ListTemplateVersions__p101561731184418">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.16.2.4.1.2 "><p id="ListTemplateVersions__p191561031104420">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.16.2.4.1.3 "><p id="ListTemplateVersions__p1615623113441">Error message.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="ListTemplateVersions__section1156103144416"><h4 class="sectiontitle">Example Requests</h4><ul id="ListTemplateVersions__ul191561031124418"><li id="ListTemplateVersions__li1815716314446">List all versions of the current template.<pre class="screen" id="ListTemplateVersions__screen41571231164412">GET https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template/versions</pre>
|
|
</li><li id="ListTemplateVersions__li11157153134415">List all versions of the current template and check whether the template ID matches the current template.<pre class="screen" id="ListTemplateVersions__screen81571313447">GET https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template/versions?template_id=1b15e005-bdbb-4bd7-8f9a-a09b6774b4b3</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="ListTemplateVersions__section3157183134417"><h4 class="sectiontitle">Example Responses</h4><p id="ListTemplateVersions__p161579317444"><strong id="ListTemplateVersions__b1315711316447">Status code: 200</strong></p>
|
|
<p id="ListTemplateVersions__p171577315446">Template versions listed.</p>
|
|
<pre class="screen" id="ListTemplateVersions__screen51571031174412">{
|
|
"versions" : [ {
|
|
"template_id" : "69f8d5ea-eaa4-4a3b-a96d-bae9230e97c8",
|
|
"template_name" : "my_first_template",
|
|
"version_description" : "Second version of the current template",
|
|
"create_time" : "2023-05-09T08:01:24Z",
|
|
"version_id" : "V2"
|
|
}, {
|
|
"template_id" : "69f8d5ea-eaa4-4a3b-a96d-bae9230e97c8",
|
|
"template_name" : "my_first_template",
|
|
"version_description" : "First version of the current template",
|
|
"create_time" : "2023-05-09T08:01:23Z",
|
|
"version_id" : "V1"
|
|
} ]
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="ListTemplateVersions__section15158103118443"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ListTemplateVersions__en-us_topic_0000001757158497_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="ListTemplateVersions__row015813194410"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="ListTemplateVersions__p1015919310446">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="ListTemplateVersions__p6159231174410">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="ListTemplateVersions__row615883184417"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ListTemplateVersions__p1115903184416">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ListTemplateVersions__p171591313444">Template versions listed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row715883154413"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ListTemplateVersions__p1415973120444">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ListTemplateVersions__p1526963124416">Invalid request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row9158163117447"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ListTemplateVersions__p1126923164417">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ListTemplateVersions__p1270153184414">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row1815817314442"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ListTemplateVersions__p527018314449">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ListTemplateVersions__p16270103194412">The user does not have the permission to call this API.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row115833134420"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ListTemplateVersions__p15270193115443">404</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ListTemplateVersions__p152701931114420">The template does not exist.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row3158153115448"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ListTemplateVersions__p8270631154419">429</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ListTemplateVersions__p92702316443">Too frequent requests.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="ListTemplateVersions__row17158123114449"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="ListTemplateVersions__p10270203184410">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="ListTemplateVersions__p1027018316448">Internal server error.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="topic_300000003.html">Template Management</a></div>
|
|
</div>
|
|
</div>
|
|
|