レイヤーに関する情報を照会します。
デバッグ
リクエストヘッダー
この操作では、共通のリクエストヘッダーのみが使用されます。 詳細は、共通パラメータを参照してください。
リクエスト構文
GET /layers HTTP/1.1
リクエストパラメーター
パラメーター | データ型 | 位置 | 必須 | 例 | 説明 |
prefix | String | クエリ | なし | prefix-layer | レイヤーの名前のプレフィックス。 返されるレイヤーの名前には、プレフィックスを含める必要があります。 名前のプレフィックスがaの場合、返されるレイヤーの名前はaで始まる必要があります。 |
startKey | String | クエリ | なし | レイヤー名 | 開始レイヤーの名前。 返されたレイヤーはアルファベット順にソートされ、startKeyパラメーターで指定されたレイヤーを含むレイヤーと後続のレイヤーが返されます。 |
nextToken | String | クエリ | なし | 次のレイヤー名 | より多くの結果を得るために使用されるトークン。 レイヤー数が制限を超えると、nextTokenパラメーターが返されます。 後続の呼び出しにパラメーターを含めて、より多くの結果を取得できます。 最初の呼び出しでこのパラメーターを指定する必要はありません。 |
limit | Integer | クエリ | なし | 20 | 返されるレイヤーの最大数。 デフォルト値は 20 です。 値は100を超えることはできません。 返されるレイヤーの数が指定された数以下です。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
レイヤー | レイヤーの配列 | レイヤーに関する情報。 | |
nextToken | String | 次のレイヤー名 | より多くの結果を得るために使用されるトークン。 説明 このパラメーターが返されない場合、すべてのレイヤーが返されます。 |
例
リクエストの例
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
Common request headers
正常に処理された場合のレスポンス例
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"
}
エラーコード
エラーコードの一覧は、「API エラーセンター」をご参照ください。