文档首页/函数工作流 FunctionGraph/API参考/API/函数版本别名/修改函数版本别名信息
更新时间：2024-05-09 GMT+08:00
在线调试
CLI示例
查看PDF
分享

修改函数版本别名信息

功能介绍

修改函数版本别名信息。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目 ID，获取方式请参见获取项目ID。

function_urn

是

String

函数的URN，详细解释见FunctionGraph函数模型的描述。

alias_name

是

String

要更新的别名名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

Content-Type

是

String

消息体的类型（格式）

表3 请求Body参数

参数

是否必选

参数类型

描述

version

是

String

别名对应的版本名称。

description

否

String

别名描述信息。

additional_version_weights

否

Map<String,Integer>

灰度版本信息

additional_version_strategy

否

Map<String,VersionStrategy>

指定规则灰度策略信息

表4 VersionStrategy

参数

是否必选

参数类型

描述

rules

否

Array of VersionStrategyRules objects

规则列表

combine_type

否

String

所有规则聚合方式。and：所有规则都满足，or：满足其中一个

枚举值：

  • and
  • or
表5 VersionStrategyRules

参数

是否必选

参数类型

描述

rule_type

否

String

参数类型。

枚举值：

  • Header

param

否

String

规则参数名, 只支持大小写字母，数字，下划线，中划线。

op

否

String

规则匹配操作符，目前仅需支持 =或者in。

枚举值：

  • in
  • =

value

否

String

规则值，如果op为in，则为逗号分隔的多值字符串

响应参数

状态码： 200

表6 响应Body参数

参数

参数类型

描述

name

String

要获取的别名名称。

version

String

别名对应的版本名称。

description

String

别名描述信息。

last_modified

String

别名最后修改时间。

alias_urn

String

版本别名唯一标识。

additional_version_weights

Map<String,Integer>

灰度版本信息

状态码： 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 401

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 403

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 404

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 500

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

  • 更新函数别名{alias_name}绑定的函数版本为latest，且配置v1为灰度版本，流量比例为9:1。 
    PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/aliases/{alias_name}

{
  "version" : "latest",
  "description" : "",
  "additional_version_weights" : {
    "v1" : 10
  }
}
  • 更新函数别名{alias_name}绑定的函数版本为v1，且开启灰度版本，将v2版本设置为指定规则灰度。 
    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"
      } ]
    }
  }
}

响应示例

状态码： 200

ok

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

状态码： 404

Not Found 找不到资源。

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

状态码

状态码

描述

200

ok

400

Bad Request 请求错误。

401

Unauthorized 鉴权失败。

403

Forbidden 没有操作权限。

404

Not Found 找不到资源。

500

Internal Server Error 服务内部错误。

错误码

请参见错误码。

父主题：函数版本别名