调用ListAliases接口获取别名列表。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

GET /services/{serviceName}/aliases 

请求参数

名称 类型 位置 是否必选 示例值 描述
serviceName String Path service_name

服务的名称。

limit Integer Query 20

限定此次返回资源的数量。如果不设定,默认返回20,最大不能超过100。返回结果可以小于指定的数量,但不能多于指定的数量。

nextToken String Query nextService

用来返回更多结果。第一次查询不需要提供这个参数,后续查询的Token从返回结果中获取。

prefix String Query prefix_text

限定返回的资源名称,名称必须以Prefix作为前缀,例如Prefix是a,则返回的资源名均是以a开始的。

startKey String Query nextService

设定结果从startKey之后(包括startKey)按字母排序的第一个开始返回。

返回数据

名称 类型 示例值 描述
aliases Array

别名的列表。

additionalVersionWeight Map

别名指向的灰度版本以及灰度权重。

  • 灰度版本只在调用函数时生效。
  • 由版本号和对应的权重组成,例如,2:0.05表明调用函数时,版本2为灰度版本,切5%的流量到灰度版本,95%的流量默认到主版本。
Float 1

流量权重,取值范围[0,1]。

aliasName String alias_test

别名的名称。

createdTime String 2020-04-21T09:08:44Z

别名的创建时间。

description String test_description

别名的描述。

lastModifiedTime String 2020-04-21T09:08:44Z

别名上一次被更新的时间。

serviceName String service_name

服务的名称。

versionId String 2

别名指向的版本。

nextToken String nextService

用来返回更多的查询结果。如果这个值没有返回,则说明没有更多结果。

示例

请求示例

GET /2016-08-15/services/service_name/aliases HTTP/1.1
公共请求头

正常返回示例

JSON 格式

HTTP/1.1 200 OK
公共响应头
{
  "aliases": [
    {
      "aliasName": "alias_test",
      "versionId": "2",
      "description":"test_description ",
      "additionalVersionWeight": {},
      "createdTime": "2020-04-21T09:08:44Z",
      "lastModifiedTime": "2020-04-21T09:08:44Z"
    },
    {
      "aliasName": "alias_test",
      "versionId": "2",
      "description":"test_description",
     "additionalVersionWeight": null,
      "createdTime": "2020-07-27T06:37:29Z",
      "lastModifiedTime": "2020-07-27T06:37:29Z"
    }
  ]
}