功能介绍
创建函数灰度版本别名。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/fgs/functions/{function_urn}/aliases
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户项目 ID,获取方式请参见获取项目ID。 |
function_urn |
是 |
String |
函数的URN,详细解释见FunctionGraph函数模型的描述。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
要获取的别名名称。 |
version |
是 |
String |
别名对应的版本名称。 |
description |
否 |
String |
别名描述信息。 |
additional_version_weights |
否 |
Map<String,Integer> |
灰度版本信息 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
要获取的别名名称。 |
version |
String |
别名对应的版本名称。 |
description |
String |
别名描述信息。 |
last_modified |
String |
别名最后修改时间。 |
alias_urn |
String |
版本别名唯一标识。 |
additional_version_weights |
Map<String,Integer> |
灰度版本信息 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
请求示例
为函数的v1版本创建别名a1。
POST https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/aliases { "name" : "a1", "version" : "v1" }
响应示例
状态码: 200
ok
{ "name" : "a1", "version" : "latest", "description" : "", "last_modified" : "2019-10-31 11:37:58", "alias_urn" : "urn:fss:{region}:46b6f338fc3445b8846c71dfb1fbxxxx:function:default:xxxxx:!a1" }
状态码: 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 服务内部错误。 |
错误码
请参见错误码。