doc-exports/docs/fg/api-ref/functiongraph_06_0115.html
Chen, Junjie cb4b0ade33 FG API 20240924 version
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Chen, Junjie <chenjunjie@huawei.com>
Co-committed-by: Chen, Junjie <chenjunjie@huawei.com>
2024-10-28 18:55:02 +00:00

509 lines
36 KiB
HTML

<a name="functiongraph_06_0115"></a><a name="functiongraph_06_0115"></a>
<h1 class="topictitle1">Modifying the Alias of a Function Version</h1>
<div id="body3746153044615"><div class="section" id="functiongraph_06_0115__section874763015467"><h4 class="sectiontitle">Function</h4><p id="functiongraph_06_0115__p1748193019468">This API is used to modify the alias of a function version.</p>
</div>
<div class="section" id="functiongraph_06_0115__section10749113015469"><h4 class="sectiontitle">URI</h4><p id="functiongraph_06_0115__p13749173084612">PUT /v2/{project_id}/fgs/functions/{function_urn}/aliases/{alias_name}</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__table37517308464" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row187501230154615"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="functiongraph_06_0115__p1375117307469">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="functiongraph_06_0115__p4751230184618">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="functiongraph_06_0115__p1752330114616">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="functiongraph_06_0115__p17752173011463">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row1975033024620"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="functiongraph_06_0115__p13752230184616">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="functiongraph_06_0115__p3753630134620">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="functiongraph_06_0115__p2753193044613">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="functiongraph_06_0115__p975373013469">Project ID. For details, see <a href="functiongraph_06_0260.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row1475013014617"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="functiongraph_06_0115__p17754153064612">function_urn</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="functiongraph_06_0115__p67542305463">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="functiongraph_06_0115__p87542301466">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="functiongraph_06_0115__p197551301468">Function URN. For details, see the function model description.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row475093034617"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="functiongraph_06_0115__p8755163024615">alias_name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="functiongraph_06_0115__p127551430174612">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="functiongraph_06_0115__p175613034619">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="functiongraph_06_0115__p97561630184615">Alias to be modified.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="functiongraph_06_0115__section1375603017468"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row16757530154618"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="functiongraph_06_0115__p147581330134620">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="functiongraph_06_0115__p18758130104614">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="functiongraph_06_0115__p87591830184612">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="functiongraph_06_0115__p2759153084618">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row075783012463"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="functiongraph_06_0115__p675983020463">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="functiongraph_06_0115__p376073034619">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="functiongraph_06_0115__p97602301460">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="functiongraph_06_0115__p2761203012463">User token.</p>
<p id="functiongraph_06_0115__p276115301467">It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row19757133014466"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="functiongraph_06_0115__p1776103016461">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="functiongraph_06_0115__p2762183012460">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="functiongraph_06_0115__p276223084616">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="functiongraph_06_0115__p12763143014464">Message body type (format).</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__request_UpdateVersionAliasRequestBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row27647305463"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="functiongraph_06_0115__p57654306468">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="functiongraph_06_0115__p576619307461">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="functiongraph_06_0115__p97665306463">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="functiongraph_06_0115__p107661830194617">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row18764183013467"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="functiongraph_06_0115__p87671530194616">version</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="functiongraph_06_0115__p117671530184612">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="functiongraph_06_0115__p776818304463">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="functiongraph_06_0115__p17768133017465">Version corresponding to the alias.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row18764530104611"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="functiongraph_06_0115__p10768830184617">description</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="functiongraph_06_0115__p15769113074612">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="functiongraph_06_0115__p3769183015466">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="functiongraph_06_0115__p7769430154612">Description of the alias.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row8764133019463"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="functiongraph_06_0115__p10770143017463">additional_version_weights</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="functiongraph_06_0115__p10770930124614">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="functiongraph_06_0115__p9771133034613">Map&lt;String,Integer&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="functiongraph_06_0115__p137711430144615">Dark launch information.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row47641130144611"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="functiongraph_06_0115__p277113011466">additional_version_strategy</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="functiongraph_06_0115__p1377153011468">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="functiongraph_06_0115__p13772430124616">Map&lt;String,<a href="#functiongraph_06_0115__request_VersionStrategy">VersionStrategy</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="functiongraph_06_0115__p147732303460">Traffic shifting by Rule.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="functiongraph_06_0115__request_VersionStrategy"></a><a name="request_VersionStrategy"></a><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__request_VersionStrategy" frame="border" border="1" rules="all"><caption><b>Table 4 </b>VersionStrategy</caption><thead align="left"><tr id="functiongraph_06_0115__row377383054614"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="functiongraph_06_0115__p07741430104614">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="functiongraph_06_0115__p13775173024610">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="functiongraph_06_0115__p1377543014462">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="functiongraph_06_0115__p47751530134611">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row2773133074615"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="functiongraph_06_0115__p17769300468">rules</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="functiongraph_06_0115__p677613064611">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="functiongraph_06_0115__p27771730104618">Array of <a href="#functiongraph_06_0115__request_VersionStrategyRules">VersionStrategyRules</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="functiongraph_06_0115__p1177843074615">Rules.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row177730304463"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="functiongraph_06_0115__p77781430154619">combine_type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="functiongraph_06_0115__p117787304465">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="functiongraph_06_0115__p1777913004614">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="functiongraph_06_0115__p1577983024618">Rule aggregation mode. and: All rules are met. or: Any rule is met.</p>
<p id="functiongraph_06_0115__p1577919308465">Enumeration values:</p>
<ul id="functiongraph_06_0115__ul97791230204611"><li id="functiongraph_06_0115__li3780123014469"><strong id="functiongraph_06_0115__b2780123064618">and</strong></li><li id="functiongraph_06_0115__li67801730194617"><strong id="functiongraph_06_0115__b578053094618">or</strong></li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="functiongraph_06_0115__request_VersionStrategyRules"></a><a name="request_VersionStrategyRules"></a><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__request_VersionStrategyRules" frame="border" border="1" rules="all"><caption><b>Table 5 </b>VersionStrategyRules</caption><thead align="left"><tr id="functiongraph_06_0115__row10781203019464"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.5.2.5.1.1"><p id="functiongraph_06_0115__p13782203044615">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.5.2.5.1.2"><p id="functiongraph_06_0115__p20782153034611">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.5.2.5.1.3"><p id="functiongraph_06_0115__p878283010466">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.5.2.5.1.4"><p id="functiongraph_06_0115__p278323017460">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row278111307469"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.1 "><p id="functiongraph_06_0115__p18783143019468">rule_type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.2 "><p id="functiongraph_06_0115__p9783530194616">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.3 "><p id="functiongraph_06_0115__p378415303461">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.5.2.5.1.4 "><p id="functiongraph_06_0115__p157841530144618">Parameter type.</p>
<p id="functiongraph_06_0115__p1784163010465">Enumeration values:</p>
<ul id="functiongraph_06_0115__ul197841130124619"><li id="functiongraph_06_0115__li1678453011466"><strong id="functiongraph_06_0115__b778543064613">Header</strong></li></ul>
</td>
</tr>
<tr id="functiongraph_06_0115__row127816302469"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.1 "><p id="functiongraph_06_0115__p7785183044617">param</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.2 "><p id="functiongraph_06_0115__p1878533017464">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.3 "><p id="functiongraph_06_0115__p11786153016465">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.5.2.5.1.4 "><p id="functiongraph_06_0115__p1786330194620">Rule parameter name, which can contain only letters, digits, underscores (_), and hyphens (-).</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row20781330184614"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.1 "><p id="functiongraph_06_0115__p20786133010467">op</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.2 "><p id="functiongraph_06_0115__p7787143054616">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.3 "><p id="functiongraph_06_0115__p2787730124614">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.5.2.5.1.4 "><p id="functiongraph_06_0115__p77874300463">Rule matching operator. Currently, only = and in are supported.</p>
<p id="functiongraph_06_0115__p127881830144617">Enumeration values:</p>
<ul id="functiongraph_06_0115__ul77880303467"><li id="functiongraph_06_0115__li67881730154613"><strong id="functiongraph_06_0115__b3788123084618">in</strong></li><li id="functiongraph_06_0115__li278863054611"><strong id="functiongraph_06_0115__b11788183044618">=</strong></li></ul>
</td>
</tr>
<tr id="functiongraph_06_0115__row378117309464"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.1 "><p id="functiongraph_06_0115__p187891301466">value</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.2 "><p id="functiongraph_06_0115__p137891430114612">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.5.2.5.1.3 "><p id="functiongraph_06_0115__p1678912302462">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.5.2.5.1.4 "><p id="functiongraph_06_0115__p279083014610">Rule value. If op is set to in, the value is a multi-value character string separated by commas (,).</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="functiongraph_06_0115__section1579113034615"><h4 class="sectiontitle">Response Parameters</h4><p id="functiongraph_06_0115__p157911630204619"><strong id="functiongraph_06_0115__b1791143018460">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__response_UpdateVersionAliasResponseBody" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Response body parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row579213016468"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.1"><p id="functiongraph_06_0115__p157941730164619">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.2"><p id="functiongraph_06_0115__p97951930104614">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.3.2.4.1.3"><p id="functiongraph_06_0115__p779533044615">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row879213307461"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="functiongraph_06_0115__p279653044619">name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="functiongraph_06_0115__p7796193017462">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="functiongraph_06_0115__p1779623020463">Alias to be queried.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row1579315304467"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="functiongraph_06_0115__p14797430194614">version</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="functiongraph_06_0115__p379717308469">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="functiongraph_06_0115__p1879783074617">Version corresponding to the alias.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row147932303464"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="functiongraph_06_0115__p1479812301467">description</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="functiongraph_06_0115__p9798123018469">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="functiongraph_06_0115__p779883044619">Description of the alias.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row7793330164612"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="functiongraph_06_0115__p1179916303461">last_modified</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="functiongraph_06_0115__p4799113024612">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="functiongraph_06_0115__p108002302464">Time when the alias was last modified.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row57931301466"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="functiongraph_06_0115__p5800163054613">alias_urn</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="functiongraph_06_0115__p980053084612">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="functiongraph_06_0115__p280133014465">URN of the alias.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row5793163015461"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="functiongraph_06_0115__p5801173012461">additional_version_weights</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="functiongraph_06_0115__p15801193010467">Map&lt;String,Integer&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="functiongraph_06_0115__p1880253015464">Dark launch information.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="functiongraph_06_0115__p158021830104620"><strong id="functiongraph_06_0115__b17802123054614">Status code: 400</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__response_ErrorResp" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response body parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row5803123054610"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.4.1.1"><p id="functiongraph_06_0115__p28046307461">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.4.1.2"><p id="functiongraph_06_0115__p1880413074619">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.5.2.4.1.3"><p id="functiongraph_06_0115__p18041130104617">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row5803123034619"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.1 "><p id="functiongraph_06_0115__p2080593019467">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.2 "><p id="functiongraph_06_0115__p180523014469">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.5.2.4.1.3 "><p id="functiongraph_06_0115__p108051130144617">Error code.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row168031130204617"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.1 "><p id="functiongraph_06_0115__p2806930194610">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.2 "><p id="functiongraph_06_0115__p6806123017467">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.5.2.4.1.3 "><p id="functiongraph_06_0115__p198061830144611">Error message.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="functiongraph_06_0115__p178072303461"><strong id="functiongraph_06_0115__b15807123084617">Status code: 401</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__table1580718303469" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Response body parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row68071130184615"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.4.1.1"><p id="functiongraph_06_0115__p1980823011464">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.4.1.2"><p id="functiongraph_06_0115__p1180893014466">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.7.2.4.1.3"><p id="functiongraph_06_0115__p7809113012461">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row58071530174617"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.1 "><p id="functiongraph_06_0115__p1880993020466">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.2 "><p id="functiongraph_06_0115__p1880913017461">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.7.2.4.1.3 "><p id="functiongraph_06_0115__p168101530144618">Error code.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row2807203084617"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.1 "><p id="functiongraph_06_0115__p13810113017462">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.2 "><p id="functiongraph_06_0115__p188112309462">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.7.2.4.1.3 "><p id="functiongraph_06_0115__p98111130104610">Error message.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="functiongraph_06_0115__p1781233012462"><strong id="functiongraph_06_0115__b158121830114612">Status code: 403</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__table17812183019464" frame="border" border="1" rules="all"><caption><b>Table 9 </b>Response body parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row1081218308468"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.4.1.1"><p id="functiongraph_06_0115__p6813133019464">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.4.1.2"><p id="functiongraph_06_0115__p1181313004613">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.9.2.4.1.3"><p id="functiongraph_06_0115__p481413307468">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row3812930124620"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.1 "><p id="functiongraph_06_0115__p98141430104617">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.2 "><p id="functiongraph_06_0115__p6814130154613">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.9.2.4.1.3 "><p id="functiongraph_06_0115__p581513017463">Error code.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row281213308466"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.1 "><p id="functiongraph_06_0115__p481513010463">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.2 "><p id="functiongraph_06_0115__p7815163084616">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.9.2.4.1.3 "><p id="functiongraph_06_0115__p2081683017466">Error message.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="functiongraph_06_0115__p5816113074610"><strong id="functiongraph_06_0115__b1681683054613">Status code: 404</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__table4816730194610" frame="border" border="1" rules="all"><caption><b>Table 10 </b>Response body parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row16817163018468"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.11.2.4.1.1"><p id="functiongraph_06_0115__p9818930124619">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.11.2.4.1.2"><p id="functiongraph_06_0115__p1481943094615">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.11.2.4.1.3"><p id="functiongraph_06_0115__p15819103015466">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row3817133014466"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.1 "><p id="functiongraph_06_0115__p168191630114616">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.2 "><p id="functiongraph_06_0115__p168206309466">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.11.2.4.1.3 "><p id="functiongraph_06_0115__p1082014307463">Error code.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row1081753024618"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.1 "><p id="functiongraph_06_0115__p3820173019462">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.2 "><p id="functiongraph_06_0115__p1782113034618">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.11.2.4.1.3 "><p id="functiongraph_06_0115__p148211030154620">Error message.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="functiongraph_06_0115__p10822183020463"><strong id="functiongraph_06_0115__b4822103034614">Status code: 500</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__table12822830134614" frame="border" border="1" rules="all"><caption><b>Table 11 </b>Response body parameters</caption><thead align="left"><tr id="functiongraph_06_0115__row282383018468"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.13.2.4.1.1"><p id="functiongraph_06_0115__p1382423019461">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.13.2.4.1.2"><p id="functiongraph_06_0115__p68247309466">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.13.2.4.1.3"><p id="functiongraph_06_0115__p15825103074615">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row082314307468"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.13.2.4.1.1 "><p id="functiongraph_06_0115__p108250305469">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.13.2.4.1.2 "><p id="functiongraph_06_0115__p1882573094612">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.13.2.4.1.3 "><p id="functiongraph_06_0115__p2826530114613">Error code.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row148231830104618"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.13.2.4.1.1 "><p id="functiongraph_06_0115__p12826530134613">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.13.2.4.1.2 "><p id="functiongraph_06_0115__p128267301465">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.13.2.4.1.3 "><p id="functiongraph_06_0115__p1982743064610">Error message.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="functiongraph_06_0115__section582713084617"><h4 class="sectiontitle">Example Requests</h4><ul id="functiongraph_06_0115__ul982717302468"><li id="functiongraph_06_0115__li188271730124615">Update the function version of alias {alias_name} to latest, and configure v1 as the additional version with a traffic ratio of 9:1.<pre class="screen" id="functiongraph_06_0115__screen19828123074612">PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/aliases/{alias_name}
{
"version" : "latest",
"description" : "",
"additional_version_weights" : {
"v1" : 10
}
}</pre>
</li><li id="functiongraph_06_0115__li4913831174610">Update the function version of alias {alias_name} to v1, enable Traffic Shifting and set version v2 to shift traffic by Rule.<pre class="screen" id="functiongraph_06_0115__screen091353112466">PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/aliases/{alias_name}
{
"version" : "v1",
"description" : "",
"additional_version_strategy" : {
"v2" : {
"combine_type" : "and",
"rules" : [ {
"rule_type" : "Header",
"param" : "version",
"op" : "=",
"value" : "v1"
} ]
}
}
}</pre>
</li></ul>
</div>
<div class="section" id="functiongraph_06_0115__section09153313467"><h4 class="sectiontitle">Example Responses</h4><p id="functiongraph_06_0115__p9915153114613"><strong id="functiongraph_06_0115__b1091533154614">Status code: 200</strong></p>
<p id="functiongraph_06_0115__p091583144617">ok</p>
<pre class="screen" id="functiongraph_06_0115__screen16915731174617">{
"name" : "dev",
"version" : "latest",
"description" : "",
"last_modified" : "2019-10-31 11:37:58",
"alias_urn" : "urn:fss:xxxxxxxx: 7aad83af3e8d42e99ac194e8419e2c9b:function:default:test:!dev",
"additional_version_weights" : {
"v1" : 10
}
}</pre>
<p id="functiongraph_06_0115__p591633134612"><strong id="functiongraph_06_0115__b1491683184610">Status code: 404</strong></p>
<p id="functiongraph_06_0115__p291723134614">Not found.</p>
<pre class="screen" id="functiongraph_06_0115__screen12917031114613">{
"error_code" : "FSS.1051",
"error_msg" : "Not found the function"
}</pre>
</div>
<div class="section" id="functiongraph_06_0115__section491703114464"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_06_0115__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="functiongraph_06_0115__row483843084610"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="functiongraph_06_0115__p89170314468">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="functiongraph_06_0115__p199176311461">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_06_0115__row16838123018468"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="functiongraph_06_0115__p19181631194613">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="functiongraph_06_0115__p4918631154618">ok</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row188381830174616"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="functiongraph_06_0115__p1491893174612">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="functiongraph_06_0115__p79181331194615">Bad request.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row11838230194611"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="functiongraph_06_0115__p891823184619">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="functiongraph_06_0115__p15918731144614">Unauthorized.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row11838103017465"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="functiongraph_06_0115__p5918931174613">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="functiongraph_06_0115__p189181931204616">Forbidden.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row28381530114614"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="functiongraph_06_0115__p4919331194612">404</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="functiongraph_06_0115__p6919183174618">Not found.</p>
</td>
</tr>
<tr id="functiongraph_06_0115__row118385309467"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="functiongraph_06_0115__p6919193154618">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="functiongraph_06_0115__p10919163113468">Internal server error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="functiongraph_06_0115__section0919531124619"><h4 class="sectiontitle">Error Codes</h4><p id="functiongraph_06_0115__p6919331164612">See <a href="ErrorCode.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="VersionsandAliases.html">Versions and Aliases</a></div>
</div>
</div>