forked from docs/doc-exports
Hasko, Vladimir
354bef10dd
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>
362 lines
25 KiB
HTML
362 lines
25 KiB
HTML
<a name="rts_03_0021"></a><a name="rts_03_0021"></a>
|
|
|
|
<h1 class="topictitle1">Creating a Stack</h1>
|
|
<div id="body1511161465560"><div class="section" id="rts_03_0021__en-us_topic_0057973121_section35971064"><h4 class="sectiontitle">Function</h4><p id="rts_03_0021__en-us_topic_0057973121_p13372169">This API is used to create a stack. Heat verifies a request body and parses the template. After that, Heat invokes the API of the target component based on resource dependencies to create a resource.</p>
|
|
</div>
|
|
<div class="section" id="rts_03_0021__en-us_topic_0057973121_section55304127"><h4 class="sectiontitle">URI</h4><p id="rts_03_0021__p76479013312">POST /v1/{project_id}/stacks</p>
|
|
<p id="rts_03_0021__p18757529192618">For details about the parameters, see <a href="#rts_03_0021__table1759528275">Table 1</a>.</p>
|
|
|
|
<div class="tablenoborder"><a name="rts_03_0021__table1759528275"></a><a name="table1759528275"></a><table cellpadding="4" cellspacing="0" summary="" id="rts_03_0021__table1759528275" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="rts_03_0021__row26011272716"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.4.2.5.1.1"><p id="rts_03_0021__p43085863"><strong id="rts_03_0021__b866332313557">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.4.2.5.1.2"><p id="rts_03_0021__p12821133562718"><strong id="rts_03_0021__b572942705517">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.4.2.5.1.3"><p id="rts_03_0021__p294000"><strong id="rts_03_0021__b290022835514">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.4.2.5.1.4"><p id="rts_03_0021__p23814038"><strong id="rts_03_0021__b1042131095612">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rts_03_0021__row10601725277"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.4.2.5.1.1 "><p id="rts_03_0021__p14468758">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.4.2.5.1.2 "><p id="rts_03_0021__p1581811351277">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.4.2.5.1.3 "><p id="rts_03_0021__p31118786">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.4.2.5.1.4 "><p id="rts_03_0021__p37593705">Specifies the project ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="rts_03_0021__en-us_topic_0057973121_section27975100"><h4 class="sectiontitle">Request Parameter</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rts_03_0021__en-us_topic_0057973121_table66651251" frame="border" border="1" rules="all"><thead align="left"><tr id="rts_03_0021__en-us_topic_0057973121_row6890438"><th align="left" class="cellrowborder" valign="top" width="14.000000000000002%" id="mcps1.3.3.2.1.6.1.1"><p id="rts_03_0021__en-us_topic_0057973121_p21254616"><strong id="rts_03_0021__b19783623205610">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.2.1.6.1.2"><p id="rts_03_0021__p14932214133918"><strong id="rts_03_0021__b1955010276567">In</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.2.1.6.1.3"><p id="rts_03_0021__en-us_topic_0057973121_p43902359"><strong id="rts_03_0021__b1499813017561">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.2.1.6.1.4"><p id="rts_03_0021__en-us_topic_0057973121_p66430186"><strong id="rts_03_0021__b595213155613">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="43%" id="mcps1.3.3.2.1.6.1.5"><p id="rts_03_0021__en-us_topic_0057973121_p12135994"><strong id="rts_03_0021__b11431183655615">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rts_03_0021__en-us_topic_0057973121_row43491438"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.1.6.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p33145583">stack_name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.6.1.2 "><p id="rts_03_0021__p192324314345">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p437668">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p35451125">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.1.6.1.5 "><p id="rts_03_0021__en-us_topic_0057973121_p52968908">Specifies the stack name.</p>
|
|
<ul id="rts_03_0021__ul45291469124"><li id="rts_03_0021__li1852911617120">The value can contain only uppercase letters, lowercase letters, digits, hyphens (-), periods (.), and underscores (_).</li><li id="rts_03_0021__li2147659191213">The value must start with an uppercase letter or a lowercase letter.</li><li id="rts_03_0021__li10293495134">The value can contain 1 to 255 characters.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__en-us_topic_0057973121_row6958124"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.1.6.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p26737156">template</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.6.1.2 "><p id="rts_03_0021__p1123143193418">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p18226004">Json</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p67020229">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.1.6.1.5 "><p id="rts_03_0021__p2684529103115">Specifies the template. The template uses the YAML syntax for content orchestration.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__en-us_topic_0057973121_row2494326"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.1.6.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p713839">template_url</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.6.1.2 "><p id="rts_03_0021__p1223144318346">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p57820997">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p65609144115231">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.1.6.1.5 "><p id="rts_03_0021__en-us_topic_0057973121_p52989151">Specifies the template URL. You cannot select a template using the URL temporarily.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__en-us_topic_0057973121_row7140313"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.1.6.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p41494485">environment</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.6.1.2 "><p id="rts_03_0021__p1523443163412">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p5610121">Json</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p51766686">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.1.6.1.5 "><p id="rts_03_0021__en-us_topic_0057973121_p32352060">Specifies the environment information for creating a stack. </p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__en-us_topic_0057973121_row22733085"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.1.6.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p29440602">files</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.6.1.2 "><p id="rts_03_0021__p15231432346">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p35878580">Json</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p20483858">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.1.6.1.5 "><p id="rts_03_0021__en-us_topic_0057973121_p48579805">Specifies the files referenced in the environment. </p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__en-us_topic_0057973121_row34565062"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.1.6.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p48306655">parameters</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.6.1.2 "><p id="rts_03_0021__p172313432345">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p20524952">Json</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p51908377">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.1.6.1.5 "><p id="rts_03_0021__en-us_topic_0057973121_p43829003">Specifies parameter information of the stack.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__en-us_topic_0057973121_row58916709"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.1.6.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p7524163">timeout_mins</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.6.1.2 "><p id="rts_03_0021__p192384318341">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p5477477">Int</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p41022516">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.1.6.1.5 "><p id="rts_03_0021__en-us_topic_0057973121_p34489495">Specifies the timeout duration.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__en-us_topic_0057973121_row41970004"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.1.6.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p44127153">disable_rollback</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.2.1.6.1.2 "><p id="rts_03_0021__p623743163416">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p17529622">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.2.1.6.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p10613292">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.1.6.1.5 "><p id="rts_03_0021__en-us_topic_0057973121_p54370330">Specifies whether to perform a rollback when stack creation fails.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="rts_03_0021__p511116563299"><strong id="rts_03_0021__b81509177410">environment</strong> structure information</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rts_03_0021__table25216525290" frame="border" border="1" rules="all"><thead align="left"><tr id="rts_03_0021__row7522852162919"><th align="left" class="cellrowborder" valign="top" width="18.23182318231823%" id="mcps1.3.3.4.1.6.1.1"><p id="rts_03_0021__p193675374306"><strong id="rts_03_0021__b1734912215412">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12.271227122712272%" id="mcps1.3.3.4.1.6.1.2"><p id="rts_03_0021__p9370113711305"><strong id="rts_03_0021__b23265261742">In</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.181618161816182%" id="mcps1.3.3.4.1.6.1.3"><p id="rts_03_0021__p1337414375304"><strong id="rts_03_0021__b84235270615453">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.42174217421742%" id="mcps1.3.3.4.1.6.1.4"><p id="rts_03_0021__p53772037203013"><strong id="rts_03_0021__b1730113301248">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="35.8935893589359%" id="mcps1.3.3.4.1.6.1.5"><p id="rts_03_0021__p8379173713302"><strong id="rts_03_0021__b158881434346">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rts_03_0021__row1752245262915"><td class="cellrowborder" valign="top" width="18.23182318231823%" headers="mcps1.3.3.4.1.6.1.1 "><p id="rts_03_0021__p1224425913011">parameters</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.271227122712272%" headers="mcps1.3.3.4.1.6.1.2 "><p id="rts_03_0021__p124585920302">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.181618161816182%" headers="mcps1.3.3.4.1.6.1.3 "><p id="rts_03_0021__p1245459183017">Json</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.42174217421742%" headers="mcps1.3.3.4.1.6.1.4 "><p id="rts_03_0021__p1424585920308">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="35.8935893589359%" headers="mcps1.3.3.4.1.6.1.5 "><p id="rts_03_0021__p8245195918304">Specifies the parameters and their values.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__row45221052142919"><td class="cellrowborder" valign="top" width="18.23182318231823%" headers="mcps1.3.3.4.1.6.1.1 "><p id="rts_03_0021__p1524512597307">parameters_defaults</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.271227122712272%" headers="mcps1.3.3.4.1.6.1.2 "><p id="rts_03_0021__p32454595300">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.181618161816182%" headers="mcps1.3.3.4.1.6.1.3 "><p id="rts_03_0021__p8245105963010">Json</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.42174217421742%" headers="mcps1.3.3.4.1.6.1.4 "><p id="rts_03_0021__p72451659163011">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="35.8935893589359%" headers="mcps1.3.3.4.1.6.1.5 "><p id="rts_03_0021__p02451059153015">Specifies the parameters and their default values.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__row0522175217296"><td class="cellrowborder" valign="top" width="18.23182318231823%" headers="mcps1.3.3.4.1.6.1.1 "><p id="rts_03_0021__p7714116153118">resource_registry</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.271227122712272%" headers="mcps1.3.3.4.1.6.1.2 "><p id="rts_03_0021__p77141964318">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.181618161816182%" headers="mcps1.3.3.4.1.6.1.3 "><p id="rts_03_0021__p1671419653110">Json</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.42174217421742%" headers="mcps1.3.3.4.1.6.1.4 "><p id="rts_03_0021__p87141762313">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="35.8935893589359%" headers="mcps1.3.3.4.1.6.1.5 "><p id="rts_03_0021__p14714461315">Specifies the custom resource information.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="rts_03_0021__en-us_topic_0057973121_section50449312"><h4 class="sectiontitle">Response Parameter</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rts_03_0021__table999210913192" frame="border" border="1" rules="all"><thead align="left"><tr id="rts_03_0021__row29979919195"><th align="left" class="cellrowborder" valign="top" width="18.3%" id="mcps1.3.4.2.1.5.1.1"><p id="rts_03_0021__p17493122142817"><strong id="rts_03_0021__b24725868162658">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.719999999999999%" id="mcps1.3.4.2.1.5.1.2"><p id="rts_03_0021__p1887419221879"><strong id="rts_03_0021__b37315868">In</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.98%" id="mcps1.3.4.2.1.5.1.3"><p id="rts_03_0021__p16493922112813"><strong id="rts_03_0021__b33311119165">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.2.1.5.1.4"><p id="rts_03_0021__p1549342213284"><strong id="rts_03_0021__b153228227611">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rts_03_0021__row57151015196"><td class="cellrowborder" valign="top" width="18.3%" headers="mcps1.3.4.2.1.5.1.1 "><p id="rts_03_0021__p5810107190">stack</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.719999999999999%" headers="mcps1.3.4.2.1.5.1.2 "><p id="rts_03_0021__p153612459398">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.98%" headers="mcps1.3.4.2.1.5.1.3 "><p id="rts_03_0021__p3101310141920">Dict</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.1.5.1.4 "><p id="rts_03_0021__p813141001915">Specifies the stack object.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="rts_03_0021__p18976511121914"><strong id="rts_03_0021__b540514320614">stack</strong> structure information</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rts_03_0021__en-us_topic_0057973121_table41920649" frame="border" border="1" rules="all"><thead align="left"><tr id="rts_03_0021__en-us_topic_0057973121_row56500278"><th align="left" class="cellrowborder" valign="top" width="16.28%" id="mcps1.3.4.4.1.5.1.1"><p id="rts_03_0021__p393155220405"><strong id="rts_03_0021__b6834646561">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.120000000000001%" id="mcps1.3.4.4.1.5.1.2"><p id="rts_03_0021__p593355215405"><strong id="rts_03_0021__b157161251568">In</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.6%" id="mcps1.3.4.4.1.5.1.3"><p id="rts_03_0021__p11937155264012"><strong id="rts_03_0021__b50175516610">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.4.1.5.1.4"><p id="rts_03_0021__p1494315210407"><strong id="rts_03_0021__b492317581261">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rts_03_0021__en-us_topic_0057973121_row12576876"><td class="cellrowborder" valign="top" width="16.28%" headers="mcps1.3.4.4.1.5.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p12094018">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.120000000000001%" headers="mcps1.3.4.4.1.5.1.2 "><p id="rts_03_0021__p155318616402">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.6%" headers="mcps1.3.4.4.1.5.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p40091438">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.1.5.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p40287329">Specifies the stack UUID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__en-us_topic_0057973121_row27041649"><td class="cellrowborder" valign="top" width="16.28%" headers="mcps1.3.4.4.1.5.1.1 "><p id="rts_03_0021__en-us_topic_0057973121_p42889935">links</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.120000000000001%" headers="mcps1.3.4.4.1.5.1.2 "><p id="rts_03_0021__p2536614013">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.6%" headers="mcps1.3.4.4.1.5.1.3 "><p id="rts_03_0021__en-us_topic_0057973121_p51532677">List <dict></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.1.5.1.4 "><p id="rts_03_0021__en-us_topic_0057973121_p11440155">Specifies the stack URL list.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="rts_03_0021__en-us_topic_0057973121_section51390628"><h4 class="sectiontitle">Request Example</h4><pre class="screen" id="rts_03_0021__en-us_topic_0057973122_screen139860121145">POST /v1/95d02433133a4c0a87ba6967474a2ad3/stacks
|
|
{
|
|
"files": {},
|
|
"disable_rollback": true,
|
|
"parameters": {
|
|
"flavor": "m1.heat"
|
|
},
|
|
"environment": {
|
|
"parameters": {
|
|
"flavor": "m1.heat"
|
|
},
|
|
"parameter_defaults": {
|
|
"flavor": "m1.heat"
|
|
},
|
|
"resource_registry": {
|
|
"OS::Networking::FloatingIP": "OS::Nova::FloatingIP"
|
|
}
|
|
},
|
|
"stack_name": "teststack",
|
|
"template": {
|
|
"heat_template_version": "2013-05-23",
|
|
"description": "Simple template to test heat commands",
|
|
"parameters": {
|
|
"flavor": {
|
|
"default": "m1.tiny",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"resources": {
|
|
"hello_world": {
|
|
"type": "OS::Nova::Server",
|
|
"properties": {
|
|
"key_name": "heat_key",
|
|
"flavor": {
|
|
"get_param": "flavor"
|
|
},
|
|
"image": "40be8d1a-3eb9-40de-8abd-43237517384f",
|
|
"user_data": "#!/bin/bash -xv\necho \"hello world\" &gt; /root/hello-world.txt\n"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"timeout_mins": 60
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="rts_03_0021__en-us_topic_0057973121_section59862473"><h4 class="sectiontitle">Response Example</h4><pre class="screen" id="rts_03_0021__en-us_topic_0057973121_screen917793211224">{
|
|
"stack": {
|
|
"id": "c89c4bb3-96cb-4a55-aafa-076a7939a306",
|
|
"links": [
|
|
{
|
|
"href": "http://x.x.x.x:8004/v1/95d02433133a4c0a87ba6967474a2ad3/stacks/HeatStack/c89c4bb3-96cb-4a55-aafa-076a7939a306",
|
|
"rel": "self"
|
|
}
|
|
]
|
|
}
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="rts_03_0021__en-us_topic_0057973121_section1891353"><h4 class="sectiontitle">Return Code</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rts_03_0021__en-us_topic_0057973117_table40445519194057" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Normal return code</caption><thead align="left"><tr id="rts_03_0021__en-us_topic_0057973117_row42419326194057"><th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.7.2.2.4.1.1"><p id="rts_03_0021__en-us_topic_0057973117_p13413377194057"><strong id="rts_03_0021__b952465016317">Return Code</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="26%" id="mcps1.3.7.2.2.4.1.2"><p id="rts_03_0021__en-us_topic_0057973117_p12741761194057"><strong id="rts_03_0021__en-us_topic_0057973140_b84235270615814_1">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="51%" id="mcps1.3.7.2.2.4.1.3"><p id="rts_03_0021__en-us_topic_0057973117_p25449701194057"><strong id="rts_03_0021__en-us_topic_0057973140_b842352706193020">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rts_03_0021__en-us_topic_0057973117_row48159894194057"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.7.2.2.4.1.1 "><p id="rts_03_0021__en-us_topic_0057973117_p8637307194057">201</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.2.2.4.1.2 "><p id="rts_03_0021__en-us_topic_0057973117_p28533244194057">Created</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51%" headers="mcps1.3.7.2.2.4.1.3 "><p id="rts_03_0021__en-us_topic_0057973117_p29491459194057">The resource has been created and is ready for use.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="rts_03_0021__table19512103414" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Error return code</caption><thead align="left"><tr id="rts_03_0021__row16955110342"><th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.7.3.2.4.1.1"><p id="rts_03_0021__p129561510144"><strong id="rts_03_0021__b107291410588">Return Code</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="26%" id="mcps1.3.7.3.2.4.1.2"><p id="rts_03_0021__p4959810444"><strong id="rts_03_0021__b2065991605">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="51%" id="mcps1.3.7.3.2.4.1.3"><p id="rts_03_0021__p9959161020418"><strong id="rts_03_0021__b957735195">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="rts_03_0021__row179609103411"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.7.3.2.4.1.1 "><p id="rts_03_0021__p896118101840">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.2 "><p id="rts_03_0021__p1296211015416">Bad Request</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51%" headers="mcps1.3.7.3.2.4.1.3 "><p id="rts_03_0021__p9963110146">The server failed to process the request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__row181330274199"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.7.3.2.4.1.1 "><p id="rts_03_0021__p18134027201912">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.2 "><p id="rts_03_0021__p1713419274191">Unauthorized</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51%" headers="mcps1.3.7.3.2.4.1.3 "><p id="rts_03_0021__p11134162718196">Authorization failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="rts_03_0021__row16531631121913"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.7.3.2.4.1.1 "><p id="rts_03_0021__p156541031121913">409</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.2 "><p id="rts_03_0021__p12654183112194">Conflict</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51%" headers="mcps1.3.7.3.2.4.1.3 "><p id="rts_03_0021__p1253585513244">The request could not be processed due to a conflict.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rts_03_0019.html">Stack Management</a></div>
|
|
</div>
|
|
</div>
|
|
|