調用ListLayers介面擷取層列表。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
要求標頭
該介面無特殊要求標頭,關於公用要求標頭資訊,請參見公用參數。
請求文法
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"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。