调用ListLayers接口获取层列表。

请求头

该接口无特殊请求头,关于公共请求头信息,请参见公共参数

请求语法

GET /layers HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
prefix String Query prefix-layer

层名称的前缀。限定返回的资源名称,假设Prefix为a,则返回的资源名必须以a开头。

startKey String Query layer-name

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

nextToken String Query next-layer-name

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

limit Integer Query 20

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

返回数据

名称 类型 示例值 描述
layers Array of Layer

层的列表。

nextToken String next-layer-name

用来返回更多结果。

说明 如果这个值没有返回,则说明没有更多结果。

示例

请求示例

GET /layers?prefix=prefix-layer&startKey=layer-name&nextToken=next-layer-name&limit=20 HTTP/1.1
Host:fc-ram.aliyuncs.com
Content-Type:application/json

公共请求头

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "layers" : [ {
    "layerName" : "prefix_mylayername",
    "version" : 1,
    "description" : "used for test",
    "code" : {
      "repositoryType" : "OSS",
      "location" : "https://xyz.oss-cnxxx.aliyuncs.com/xxx/xxx/xxx"
    },
    "codeSize" : 12345,
    "codeChecksum" : "XYX123",
    "createTime" : "2020-11-11T11:08:00Z",
    "acl" : 0,
    "compatibleRuntime" : [ "python3" ],
    "arn" : "XYZ#prefix_mylayername#1"
  } ],
  "nextToken" : "next-layer-name"
}