yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
main
doc-exports/docs/wafd/api-ref/UpgradeInstance.html
qinweiwei 14cbe51752 wafd API 20260210 version 
Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com>
Co-authored-by: qinweiwei <qinweiwei@huawei.com>
Co-committed-by: qinweiwei <qinweiwei@huawei.com>
2026-04-21 11:31:19 +00:00

451 lines
32 KiB
HTML
Raw Permalink Blame History

<a name="UpgradeInstance"></a><a name="UpgradeInstance"></a>
<h1 class="topictitle1">Upgrading on a Dedicated WAF Instance</h1>
<div id="body1708331107508"><div class="section" id="UpgradeInstance__topic1051000000"><h4 class="sectiontitle">Function</h4><p id="UpgradeInstance__topic1051000002">This API is used to upgrade a dedicated WAF instance when we release a new version.</p>
</div>
<div class="section" id="UpgradeInstance__atuogenerate_1"><h4 class="sectiontitle">URI</h4><p id="UpgradeInstance__topic1051000004">POST /v1/{project_id}/premium-waf/instance/{instance_id}/action</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpgradeInstance__topic1051000005" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="UpgradeInstance__topic1051000013"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="UpgradeInstance__topic1051000015">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="UpgradeInstance__topic1051000017">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="UpgradeInstance__topic1051000019">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="UpgradeInstance__topic1051000021">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpgradeInstance__topic1051000023"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="UpgradeInstance__topic1051000025">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="UpgradeInstance__topic1051000027">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="UpgradeInstance__topic1051000029">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="UpgradeInstance__topic1051000031">Project ID.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000032"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="UpgradeInstance__topic1051000034">instance_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="UpgradeInstance__topic1051000036">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="UpgradeInstance__topic1051000038">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="UpgradeInstance__topic1051000040">ID of the dedicated WAF engine</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="UpgradeInstance__topic1051000041"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpgradeInstance__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="UpgradeInstance__topic1051000050"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="UpgradeInstance__topic1051000052">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="UpgradeInstance__topic1051000054">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="UpgradeInstance__topic1051000056">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="UpgradeInstance__topic1051000058">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpgradeInstance__topic1051000060"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="UpgradeInstance__topic1051000062">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="UpgradeInstance__topic1051000064">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="UpgradeInstance__topic1051000066">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="UpgradeInstance__topic1051000068">Content type. Default value: application/json;charset=utf8</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000069"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="UpgradeInstance__topic1051000071">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="UpgradeInstance__topic1051000073">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="UpgradeInstance__topic1051000075">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="UpgradeInstance__topic1051000077">User token.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpgradeInstance__request_UpgradeInstanceRequestBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameters</caption><thead align="left"><tr id="UpgradeInstance__topic1051000085"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="UpgradeInstance__topic1051000087">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="UpgradeInstance__topic1051000089">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="UpgradeInstance__topic1051000091">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="UpgradeInstance__topic1051000093">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpgradeInstance__topic1051000095"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpgradeInstance__topic1051000097">action</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpgradeInstance__topic1051000099">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpgradeInstance__topic1051000101">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpgradeInstance__topic1051000103">Operation name.</p>
<ul id="UpgradeInstance__topic1051000104"><li id="UpgradeInstance__topic1051000105"><p id="UpgradeInstance__topic1051000106"><a name="UpgradeInstance__topic1051000105"></a><a name="topic1051000105"></a>upgrade: Upgrade the software version of the dedicated WAF engine.</p>
</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="UpgradeInstance__topic1051000107"><h4 class="sectiontitle">Response Parameters</h4><p id="UpgradeInstance__topic1051000109"><strong id="UpgradeInstance__topic1051000110">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpgradeInstance__response_UpgradeInstanceResponseBody" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response body parameters</caption><thead align="left"><tr id="UpgradeInstance__topic1051000117"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.1"><p id="UpgradeInstance__topic1051000119">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.2"><p id="UpgradeInstance__topic1051000121">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.3.2.4.1.3"><p id="UpgradeInstance__topic1051000123">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpgradeInstance__topic1051000125"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000127">id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000129">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000131">ID of the dedicated WAF engine</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000132"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000134">instance_name</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000136">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000138">Name of the dedicated WAF engine.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000139"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000141">instancename</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000143">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000145">Name of the dedicated WAF engine. This parameter is repeated and can be ignored.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000146"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000148">region</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000150">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000152">Region where a dedicated engine is to be created. Its value is EU-DE.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000153"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000155">zone</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000157">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000159">available_zone ID.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000160"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000162">arch</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000164">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000166">CPU architecture</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000167"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000169">cpu_flavor</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000171">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000173">ECS specifications and the dedicated WAF instance specifications. You can view details about the supported specifications on the WAF console.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000174"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000176">vpc_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000178">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000180">ID of the VPC where the dedicated engine is located</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000181"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000183">subnet_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000185">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000187">Subnet ID of the VPC where the dedicated engine is located.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000188"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000190">service_ip</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000192">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000194">Service plane IP address of the dedicated engine</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000195"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000197">service_ipv6</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000199">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000201">IPv6 address of the dedicated WAF instance on the service plane. This parameter is displayed when <strong id="UpgradeInstance__topic1051000202">ipv6_enable</strong> is set to <strong id="UpgradeInstance__topic1051000203">true</strong>.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000204"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000206">security_group_ids</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000208">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000210">Security groups bound to the dedicated engine ECS</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000211"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000213">status</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000215">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000217">Billing status of dedicated WAF engine. The value can be 0, 1, or 2.</p>
<ul id="UpgradeInstance__topic1051000218"><li id="UpgradeInstance__topic1051000219"><p id="UpgradeInstance__topic1051000220"><a name="UpgradeInstance__topic1051000219"></a><a name="topic1051000219"></a>0: The billing is normal.</p>
</li><li id="UpgradeInstance__topic1051000221"><p id="UpgradeInstance__topic1051000222"><a name="UpgradeInstance__topic1051000221"></a><a name="topic1051000221"></a>1: The billing account is frozen. Resources and data will be retained, but the cloud services cannot be used by the account.</p>
</li><li id="UpgradeInstance__topic1051000223"><p id="UpgradeInstance__topic1051000224"><a name="UpgradeInstance__topic1051000223"></a><a name="topic1051000223"></a>2: The billing is terminated. Resources and data will be cleared.</p>
</li></ul>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000225"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000227">run_status</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000229">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000231">Running status of the dedicated engine. The value can be 0 (creating), 1 (running), 2 (deleting), 3 (deleted), 4 (creation failed), 5 (frozen), 6 (abnormal), 7 (updating), or 8 (update failed).</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000232"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000234">access_status</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000236">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000238">Access status of the dedicated engine. The value can be 0 or 1.</p>
<ul id="UpgradeInstance__topic1051000239"><li id="UpgradeInstance__topic1051000240"><p id="UpgradeInstance__topic1051000241"><a name="UpgradeInstance__topic1051000240"></a><a name="topic1051000240"></a>0: the dedicated engine is not connected.</p>
</li><li id="UpgradeInstance__topic1051000242"><p id="UpgradeInstance__topic1051000243"><a name="UpgradeInstance__topic1051000242"></a><a name="topic1051000242"></a>1: the dedicated engine is connected.</p>
</li></ul>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000244"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000246">upgradable</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000248">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000250">Whether the dedicated engine can be upgraded.</p>
<ul id="UpgradeInstance__topic1051000251"><li id="UpgradeInstance__topic1051000252"><p id="UpgradeInstance__topic1051000253"><a name="UpgradeInstance__topic1051000252"></a><a name="topic1051000252"></a>0: the dedicated engine is non-upgradable</p>
</li><li id="UpgradeInstance__topic1051000254"><p id="UpgradeInstance__topic1051000255"><a name="UpgradeInstance__topic1051000254"></a><a name="topic1051000254"></a>1: the dedicated engine is upgradable</p>
</li></ul>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000256"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000258">cloudServiceType</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000260">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000262">Cloud service code. This is a unique code used to distinguish cloud services from each other. You can ignore it.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000263"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000265">resourceType</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000267">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000269">Cloud service resource type. Cloud services are purchased by resource type. You can ignore it.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000270"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000272">resourceSpecCode</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000274">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000276">Resource specifications code. This code is used to identify the resource specifications the dedicated engine uses. You can ignore it.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000277"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000279">specification</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000281">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000283">Dedicated engine ECS specifications, for example, 8 vCPUs | 16 GB. 8vCPUs | 16GB maps to waf.instance.enterprise, and 2vCPUs | 4GB to waf.instance. professional.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000284"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000286">server_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000288">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000290">ID of the ECS hosting the dedicated engine.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000291"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000293">serverId</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000295">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000297">ID of the ECS housing the dedicated engine. This parameter can be ignored because it is the same as <strong id="UpgradeInstance__topic1051000298">server_id</strong>.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000299"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000301">create_time</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000303">Long</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000305">Timestamp when the dedicated WAF engine was created.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000306"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000308">data_volume_size</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000310">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000312">Size of the data disk, in GB.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000313"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpgradeInstance__topic1051000315">res_tenant_type</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpgradeInstance__topic1051000317">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpgradeInstance__topic1051000319">Type of the dedicated WAF instance. If the type is <strong id="UpgradeInstance__topic1051000320">Network Interface</strong>, this field is returned and its value is <strong id="UpgradeInstance__topic1051000321">1</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="UpgradeInstance__topic1051000322"><strong id="UpgradeInstance__topic1051000323">Status code: 400</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpgradeInstance__response_RestErrorResponse" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="UpgradeInstance__topic1051000330"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.5.2.4.1.1"><p id="UpgradeInstance__topic1051000332">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.5.2.4.1.2"><p id="UpgradeInstance__topic1051000334">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.5.2.4.1.3"><p id="UpgradeInstance__topic1051000336">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpgradeInstance__topic1051000338"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="UpgradeInstance__topic1051000340">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.2 "><p id="UpgradeInstance__topic1051000342">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.5.2.4.1.3 "><p id="UpgradeInstance__topic1051000344">Error code</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000345"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="UpgradeInstance__topic1051000347">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.2 "><p id="UpgradeInstance__topic1051000349">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.5.2.4.1.3 "><p id="UpgradeInstance__topic1051000351">Error message</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="UpgradeInstance__topic1051000352"><strong id="UpgradeInstance__topic1051000353">Status code: 401</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpgradeInstance__response_RestErrorResponse_1" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Response body parameters</caption><thead align="left"><tr id="UpgradeInstance__topic1051000360"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.7.2.4.1.1"><p id="UpgradeInstance__topic1051000362">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.7.2.4.1.2"><p id="UpgradeInstance__topic1051000364">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.7.2.4.1.3"><p id="UpgradeInstance__topic1051000366">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpgradeInstance__topic1051000368"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.1 "><p id="UpgradeInstance__topic1051000370">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.2 "><p id="UpgradeInstance__topic1051000372">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.7.2.4.1.3 "><p id="UpgradeInstance__topic1051000374">Error code</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000375"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.1 "><p id="UpgradeInstance__topic1051000377">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.2 "><p id="UpgradeInstance__topic1051000379">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.7.2.4.1.3 "><p id="UpgradeInstance__topic1051000381">Error message</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="UpgradeInstance__topic1051000382"><strong id="UpgradeInstance__topic1051000383">Status code: 500</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpgradeInstance__response_RestErrorResponse_2" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response body parameters</caption><thead align="left"><tr id="UpgradeInstance__topic1051000390"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.9.2.4.1.1"><p id="UpgradeInstance__topic1051000392">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.9.2.4.1.2"><p id="UpgradeInstance__topic1051000394">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.9.2.4.1.3"><p id="UpgradeInstance__topic1051000396">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpgradeInstance__topic1051000398"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.9.2.4.1.1 "><p id="UpgradeInstance__topic1051000400">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.9.2.4.1.2 "><p id="UpgradeInstance__topic1051000402">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.9.2.4.1.3 "><p id="UpgradeInstance__topic1051000404">Error code</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000405"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.9.2.4.1.1 "><p id="UpgradeInstance__topic1051000407">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.9.2.4.1.2 "><p id="UpgradeInstance__topic1051000409">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.9.2.4.1.3 "><p id="UpgradeInstance__topic1051000411">Error message</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="UpgradeInstance__topic1051000412"><h4 class="sectiontitle">Example Requests</h4><pre class="screen" id="UpgradeInstance__topic1051000414">POST https://{endpoint}/v1/{project_id}/premium-waf/instance/{instance_id}/action
{
"action" : "upgrade"
}</pre>
</div>
<div class="section" id="UpgradeInstance__topic1051000415"><h4 class="sectiontitle">Example Responses</h4><p id="UpgradeInstance__topic1051000417"><strong id="UpgradeInstance__topic1051000418">Status code: 200</strong></p>
<p id="UpgradeInstance__topic1051000419">Request succeeded.</p>
<pre class="screen" id="UpgradeInstance__topic1051000420">{
"id" : "0619871acb764d48a112695e8f7cbb10",
"region" : "region-01-7",
"zone" : "region-01-7a",
"specification" : "8vCPUs | 16GB",
"arch" : "x86",
"upgradable" : 0,
"status" : 0,
"serverId" : "477353dc-8687-4bf4-b45b-1d7fee74fa63",
"server_id" : "477353dc-8687-4bf4-b45b-1d7fee74fa63",
"cloudServiceType" : "hws.service.type.waf",
"resourceType" : "hws.resource.type.waf.instance",
"resourceSpecCode" : "waf.instance.enterprise",
"vpc_id" : "13718074-a3f9-408d-82aa-3c41ef55e589",
"subnet_id" : "74d1b5a6-c7eb-4e9a-8372-181212552fcc",
"service_ip" : "192.168.10.68",
"security_group_ids" : [ "34287bdb-7aba-471a-b041-27427f1af76a" ],
"cpu_flavor" : "Si2.2xlarge.2",
"run_status" : 2,
"access_status" : 1,
"instancename" : "0412elb",
"instance_name" : "0412elb",
"create_time" : 1649923548548
}</pre>
</div>
<div class="section" id="UpgradeInstance__topic1051000421"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpgradeInstance__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="UpgradeInstance__topic1051000427"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="UpgradeInstance__topic1051000429">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="UpgradeInstance__topic1051000431">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpgradeInstance__topic1051000433"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpgradeInstance__topic1051000435">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpgradeInstance__topic1051000437">Request succeeded.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000438"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpgradeInstance__topic1051000440">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpgradeInstance__topic1051000442">Request failed.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000443"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpgradeInstance__topic1051000445">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpgradeInstance__topic1051000447">The token does not have required permissions.</p>
</td>
</tr>
<tr id="UpgradeInstance__topic1051000448"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpgradeInstance__topic1051000450">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpgradeInstance__topic1051000452">Internal server error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="UpgradeInstance__topic1051000453"><h4 class="sectiontitle">Error Codes</h4><p id="UpgradeInstance__topic1051000455">See <a href="ErrorCode.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="topic_300000000.html">Dedicated Instance Management</a></div>
</div>
</div>
View Git Blame Copy Permalink