Modifying the Alias of a Function Version

Function

This API is used to modify the alias of a function version.

URI

PUT /v2/{project_id}/fgs/functions/{function_urn}/aliases/{alias_name}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
function_urn	Yes	String	Function URN. For details, see the function model description.
alias_name	Yes	String	Alias to be modified.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. 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.
Content-Type	Yes	String	Message body type (format).

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
version	Yes	String	Version corresponding to the alias.
description	No	String	Description of the alias.
additional_version_weights	No	Map<String,Integer>	Dark launch information.
additional_version_strategy	No	Map<String,VersionStrategy>	Traffic shifting by Rule.

**Table 4** VersionStrategy
Parameter	Mandatory	Type	Description
rules	No	Array of VersionStrategyRules objects	Rules.
combine_type	No	String	Rule aggregation mode. and: All rules are met. or: Any rule is met. Enumeration values: and or

**Table 5** VersionStrategyRules
Parameter	Mandatory	Type	Description
rule_type	No	String	Parameter type. Enumeration values: Header
param	No	String	Rule parameter name, which can contain only letters, digits, underscores (_), and hyphens (-).
op	No	String	Rule matching operator. Currently, only = and in are supported. Enumeration values: in =
value	No	String	Rule value. If op is set to in, the value is a multi-value character string separated by commas (,).

Response Parameters

Status code: 200

**Table 6** Response body parameters
Parameter	Type	Description
name	String	Alias to be queried.
version	String	Version corresponding to the alias.
description	String	Description of the alias.
last_modified	String	Time when the alias was last modified.
alias_urn	String	URN of the alias.
additional_version_weights	Map<String,Integer>	Dark launch information.

Status code: 400

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 401

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 403

**Table 9** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 404

**Table 10** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 500

**Table 11** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Requests

Update the function version of alias {alias_name} to latest, and configure v1 as the additional version with a traffic ratio of 9:1.

PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/aliases/{alias_name}

{
  "version" : "latest",
  "description" : "",
  "additional_version_weights" : {
    "v1" : 10
  }
}

Update the function version of alias {alias_name} to v1, enable Traffic Shifting and set version v2 to shift traffic by Rule.

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"
      } ]
    }
  }
}

Example Responses

Status code: 200

{
  "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
  }
}

Status code: 404

Not found.

{
  "error_code" : "FSS.1051",
  "error_msg" : "Not found the function"
}

Status Codes

Status Code	Description
200	ok
400	Bad request.
401	Unauthorized.
403	Forbidden.
404	Not found.
500	Internal server error.

Error Codes

See Error Codes.

Parent topic: Versions and Aliases

Previous topic: Querying the Alias of a Function Version

Next topic: Querying the Versions of a Function

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.