调用 CreateAlias 接口创建别名。

请求方式

POST /services/{serviceName}/aliases

请求参数

位置 名称 类型 是否必选 示例值 描述
Header host string $account-id.$region.fc.aliyuncs.com 服务地址 Endpoint
Path serviceName string service 服务名称
Body aliasName string alias 别名名称
Body versionId string 2 版本号
Body description string 别名测试 别名描述
Body additionalVersionWeight map 2:0.05 灰度发布的版本,以及对应的流量权重。

返回参数

名称 类型 示例值 描述
createdTime string 2016-08-15T15:00:00.000+0000 创建时间
lastModifiedTime string 2016-08-15T17:00:00.000+0000 最近一次修改的时间
aliasName string alias 别名名称
versionId string 2 版本号
description string 别名测试 别名描述
additionalVersionWeight map 2:0.05 灰度发布的版本,以及对应的流量权重

示例

请求示例

POST /2016-08-15/services/FunDemo/aliases HTTP/1.1
accept: */*
accept-encoding: gzip, deflate
authorization: FC LTAIPLtP0uxM***:vgSInipZBHk9LkUO3vppsDcksRyk1***
content-length: 88
content-type: application/json
date: Thu, 23 Apr 2020 06:32:43 GMT
host: 1986114430***.cn-shanghai.fc.aliyuncs.com
Connection: keep-alive
{"aliasName": "test", "versionId": "1", "description": "别名测试!"}

返回示例

HTTP/1.1 200 OK
Access-Control-Expose-Headers: Date,x-fc-request-id,x-fc-error-type,x-fc-code-checksum,x-fc-invocation-duration,x-fc-max-memory-usage,x-fc-log-result,x-fc-invocation-code-version
Content-Type: application/json; charset=utf-8
Etag: 664bb4188f0ace28cf5ace85**
X-Fc-Request-Id: 06a5d452-c8f5-43c7-855a-15b3**
Date: Thu, 23 Apr 2020 06:32:43 GMT
Content-Length: 178
Connection: keep-alive
{"aliasName":"test","versionId":"1","description":"别名测试!","additionalVersionWeight":null,"createdTime":"2020-04-23T06:32:43Z","lastModifiedTime":"2020-04-23T06:32:43Z"}

错误码

HttpCode 错误码 错误信息 描述
404 ServiceNotFound service '%s' does not exist 该服务不存在
404 VersionNotFound version '%d' of service '%s' does not exist 该版本在指定服务中不存在
409 AliasAlreadyExists alias '%s' of service '%s' already exists 该别名在指定服务中已存在
500 InternalServerError an internal error has occurred. Please retry 服务器内部错误