调用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"
}