yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
0b3a43371a4bcc99577594de0a685249d676a567
doc-exports/docs/fg/umn/functiongraph_01_1829.html
liusiying01 904c1aad8b FG UMN 20250526 version 
Reviewed-by: Mützel, Andrea <andrea.muetzel@t-systems.com>
Co-authored-by: liusiying01 <liusiying@huawei.com>
Co-committed-by: liusiying01 <liusiying@huawei.com>
2025-10-06 15:14:20 +00:00

78 lines
18 KiB
HTML
Raw Blame History

<a name="functiongraph_01_1829"></a><a name="functiongraph_01_1829"></a>
<h1 class="topictitle1">Configuring Function Aliases</h1>
<div id="body8662426"><div class="section" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_section13938475246"><h4 class="sectiontitle">Overview</h4><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p4167135713405">An alias points to a specific function version. Create an alias and expose it to clients, for example, bind a trigger to the alias instead of the corresponding version. Then your modification to the version for update or rollback will be imperceptible to the clients. An alias can point to up to two versions with different weights for dark launch.</p>
</div>
<div class="section" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_section1571718713911"><h4 class="sectiontitle">Constraints</h4><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p64067107414">You can create up to 10 aliases for a function.</p>
</div>
<div class="section" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_section1889819816259"><h4 class="sectiontitle">Creating an Alias</h4><ol id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_ol5298139181114"><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li729810961112">Log in to the FunctionGraph console. In the navigation pane, choose <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_b267116532314">Functions</strong> &gt; <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_b156711953238">Function List</strong>.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li929839151114">Click the function to be configured to go to the function details page.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li6791813276">On the <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b16908611415">Aliases</strong> tab page, click <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b85077109420">Create Alias</strong>.<div class="fignone" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_fig1487182124314"><span class="figcap"><b>Figure 1 </b>Creating an alias</span><br><span><img id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_image148711322437" src="en-us_image_0000002262516774.png" title="Click to enlarge" class="imgResize"></span></div>
<div class="p" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p1276216211069"><ul id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_ul2889822686"><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li168894225815"><strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b158121530192720">Alias</strong>: Enter an alias.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li1399533018816"><strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b106478322275">Version</strong>: Select a version to be associated with the alias.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li151648402811"><strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1538915300218">Traffic Shifting</strong>: Choose whether to enable traffic shifting. If this function is enabled, you can distribute a specific percentage of traffic to the additional version.<ul id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_ul13379013191511"><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li119005538819"><strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1980613417277">Additional Version</strong>: Select an additional version to be associated. The latest version cannot be used as an additional version.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li229063210148"><strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b522333791511">Shift By</strong>: You can shift requests to the additional version by <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b2046310113199">Percentage</strong> or <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b18724165810184">Rule</strong>.
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_table1379184217182" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Shifting mode</caption><thead align="left"><tr id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_row7801842141820"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.3.4.1.3.2.2.4.2.3.1.1"><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p28054219185">Shift By</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.3.4.1.3.2.2.4.2.3.1.2"><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p880114218182">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_row2080342141818"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.4.1.3.2.2.4.2.3.1.1 "><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p128074241817">Percentage</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.4.1.3.2.2.4.2.3.1.2 "><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p49162391913">Set a weight to shift the corresponding percentage of requests to the additional version. For example, if you set the percentage to 5%, FunctionGraph will forward 5% of requests to the additional version and the remaining to the main version. The weight value must be an integer from 0 to 100.</p>
</td>
</tr>
<tr id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_row78064291819"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.4.1.3.2.2.4.2.3.1.1 "><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p18802423182">Rule</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.4.1.3.2.2.4.2.3.1.2 "><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p121277235439">Available only for HTTP functions or functions with APIG triggers. The following parameters need to be configured:</p>
<ul id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_ul7449132618438"><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li11707133664416"><strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b062110212275">Rule Type</strong>: Select <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b15563125319">All rules met</strong> or <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b7136315193118">Any rule met</strong> to forward requests with specified headers to the additional version.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li14459183112467"><strong id="functiongraph_01_1829__en-us_topic_0000001486742762_b1298120561036">Rules</strong>: Set the header rule conditions. For details, see <a href="#functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_table11953714450">Table 2</a>.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_table11953714450"></a><a name="en-us_topic_0000001486742762_en-us_topic_0000001454100106_table11953714450"></a><table cellpadding="4" cellspacing="0" summary="" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_table11953714450" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Rule list</caption><thead align="left"><tr id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_row3105371459"><th align="left" class="cellrowborder" valign="top" width="27.150000000000002%" id="mcps1.3.3.2.3.4.1.3.2.2.5.2.5.1.1"><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p111073712453">Parameter Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27.150000000000002%" id="mcps1.3.3.2.3.4.1.3.2.2.5.2.5.1.2"><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p181033704512">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.55%" id="mcps1.3.3.2.3.4.1.3.2.2.5.2.5.1.3"><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p36911381956">Condition</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27.150000000000002%" id="mcps1.3.3.2.3.4.1.3.2.2.5.2.5.1.4"><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p5101137114517">Value</p>
</th>
</tr>
</thead>
<tbody><tr id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_row4101737174511"><td class="cellrowborder" valign="top" width="27.150000000000002%" headers="mcps1.3.3.2.3.4.1.3.2.2.5.2.5.1.1 "><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p2010163734519">Header, which is unique by default.</p>
</td>
<td class="cellrowborder" valign="top" width="27.150000000000002%" headers="mcps1.3.3.2.3.4.1.3.2.2.5.2.5.1.2 "><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p510153724516">Header name, which is case-insensitive.</p>
</td>
<td class="cellrowborder" valign="top" width="18.55%" headers="mcps1.3.3.2.3.4.1.3.2.2.5.2.5.1.3 "><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p118371151201015">Options: <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1625711457375">=</strong> and <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b20240240153816">in</strong></p>
</td>
<td class="cellrowborder" valign="top" width="27.150000000000002%" headers="mcps1.3.3.2.3.4.1.3.2.2.5.2.5.1.4 "><p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p210337104519">Header value, which is a character string. If the condition is <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b13463485399">in</strong>, you can set multiple values and separate them with commas (,), indicating that the traffic can be shifted when one of the values is met.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_p121701039151618">For example, if you set <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1320771394616">Alias</strong> to <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b359416154462">alias1</strong>, <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b3616518104617">Version</strong> to <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b656110207465">version1</strong>, <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b96486414467">Additional Version</strong> to <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b15488104664619">version2</strong>, <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1010697144713">Rule Type</strong> to <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b092415247479">All rules met</strong>, <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b83285317478">Header</strong> to <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b14261155516470">aaa</strong>, <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b656145934717">Condition</strong> to <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b3489112124814">=</strong>, and <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b55246243485">Value</strong> to <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1220315280488">123</strong>, the function of <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b177878191322">version2</strong> will be executed for the request with function alias <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b183707905511">alias1</strong> and header parameter <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b82438133314">aaa</strong> with value <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1051581911566">123</strong>. If the request header does not meet the rule conditions, the function of <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b75652039658">version1</strong> will be executed.</p>
</li></ul>
</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li2380178492"><strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1896483619274">Description</strong>: Enter a description for the alias.</li></ul>
</div>
</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li162980915113">Click <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b16389183862715">OK</strong>.</li></ol>
</div>
<div class="section" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_section1029364713373"><h4 class="sectiontitle">Modifying an Alias</h4><ol id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_ol6673155331216"><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li17673165310125">Return to the FunctionGraph console. In the navigation pane, choose <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b1225994919379">Functions</strong> &gt; <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b17260149123711">Function List</strong>.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li76733535123">Click the function to be configured to go to the function details page.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li693640427">On the <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b198007619213">Aliases</strong> tab page of the latest version, select the alias to modify.<div class="fignone" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_fig102191838104312"><span class="figcap"><b>Figure 2 </b>Modifying an alias</span><br><span><img id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_image52201838154320" src="en-us_image_0000002297116837.png" title="Click to enlarge" class="imgResize"></span></div>
</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li2673153181217">Modify the alias information, and click <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b16892114522719">OK</strong>.</li></ol>
</div>
<div class="section" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_section19684193243813"><h4 class="sectiontitle">Deleting an Alias</h4><ol id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_ol18692116144513"><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li1769210654520">Return to the FunctionGraph console. In the navigation pane, choose <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b712116123812">Functions</strong> &gt; <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b61216153816">Function List</strong>.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li14178133234514">Click the function to be configured to go to the function details page.</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li3691105913455">On the <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b993212218318">Aliases</strong> tab page of the latest version, select the alias to delete.<div class="fignone" id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_fig1743418218465"><span class="figcap"><b>Figure 3 </b>Deleting an alias</span><br><span><img id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_image54381821114616" src="en-us_image_0000002262459860.png" title="Click to enlarge" class="imgResize"></span></div>
</li><li id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_li18449134934616">Click <strong id="functiongraph_01_1829__en-us_topic_0000001486742762_en-us_topic_0000001454100106_b10889124314315">OK</strong> to delete the version.</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="functiongraph_01_0300.html">Configuring Functions</a></div>
</div>
</div>
<script language="JavaScript">
<!--
image_size('.imgResize');
var msg_imageMax = "view original image";
var msg_imageClose = "close";
//--></script>
View Git Blame Copy Permalink