プロビジョニングされた設定を照会します。
背景情報
プロビジョニングされたインスタンスを使用して、関数呼び出し要求に応答できます。 これにより、コールドスタートの発生が減り、待ち時間に敏感なオンラインサービスの応答速度が向上します。 スケジュールされた自動スケーリングまたはメトリック追跡自動スケーリングを実行して、プロビジョニングされたインスタンスをより有効に活用できます。 詳細については、「リザーブドインスタンスの自動スケーリング」をご参照ください。
デバッグ
リクエストヘッダー
この操作では、共通のリクエストヘッダーのみが使用されます。 詳細については、「共通パラメーター」をご参照ください。
リクエスト構文
GET /provision-configs HTTP/1.1リクエストパラメーター
パラメーター | データ型 | 位置 | 必須 | 例 | 説明 |
limit | Long | クエリ | なし | 20 | 返されるリソースの最大数。 デフォルト値は 20 です。 最大値：100。 返されるリソースの数が指定された数以下です。 |
nextToken | String | クエリ | なし | next_service | より多くの結果を得るために使用されるトークン。 リソース数が制限を超えると、nextTokenパラメーターが返されます。 このパラメーターを後続の呼び出しに含めて、より多くの結果を取得します。 最初の呼び出しでこのパラメーターを指定する必要はありません。 |
serviceName | String | クエリ | なし | service_name | サービスの名前です。 |
修飾子 | String | クエリ | なし | test | サービスのバージョンまたはエイリアス。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
nextToken | String | next_service | より多くの結果を得るために使用されるトークン。 このパラメーターが返されない場合、すべての結果が返されます。 |
provisionConfigs | 配列 | 設定。 | |
resource | String | 19861144 **** 3057#service_name#test#function_name | リソースの説明。 |
ターゲット | Long | 15 | プロビジョニングされたインスタンスの予想数。 |
現在 | Long | 15 | プロビジョニングされたインスタンスの実際の数。 |
scheduledActions | 配列 | スケジュールされた自動スケーリングの設定。 スケジュールされた自動スケーリングを実行して、プロビジョニング済みインスタンスを柔軟に設定できます。 プロビジョニングされたインスタンスの数を、指定した時間に指定した値に自動的に調整するように設定できます。 これにより、プロビジョニングされたインスタンスの数は、ビジネスの同時実行性を満たすことができます。 | |
name | String | demoScheduler | スケジュールされたタスクの名前。 |
startTime | String | 2020-10-10T10:10:10Z | スケジュールされた自動スケーリングの設定が有効になる時刻。 |
endTime | String | 2020-12-10T10:10:10Z | スケジュールされた自動スケーリングの設定が期限切れになる時刻。 |
ターゲット | Long | 10 | プロビジョニングされたインスタンスの予想数。 |
scheduleExpression | String | cron(0 30 8 * * *) | スケジュールされたタスクをいつ実行するかを指定するスケジュール式。 2つのフォーマットがサポートされる。 詳細については、リザーブドインスタンスの自動スケーリングトピックの「スケジュール済み自動スケーリング」セクションのパラメーター表をご参照ください。 |
targetTrackingPolicies | 配列 | メトリック追跡自動スケーリングの設定。 プロビジョニングされたインスタンスは、プロビジョニングされたインスタンスの同時使用率に基づいて、1分ごとにスケールインまたはスケールアウトされます。
プロビジョニングされたインスタンスの最大数と最小数を指定した場合、システムはプロビジョニングされたインスタンスを最小数から最大数の範囲内でスケーリングします。 プロビジョニングされたインスタンスの数が範囲を超える場合、スケーリングは停止します。 | |
name | String | demoTargetTracking | スケジュールされたタスクの名前。 |
startTime | String | 2020-10-10T10:10:10Z | メトリック追跡自動スケーリングの設定が有効になり始めた時刻。 |
endTime | String | 2020-12-10T10:10:10Z | メトリック追跡自動スケーリングの設定が期限切れになる時刻。 |
metricType | String | ProvisionedConcurrencyUtilization | 追跡するメトリックのタイプ。 |
metricTarget | double | 0.6 | メトリックの期待値。 |
minCapacity | Long | 10 | スケールイン用にプロビジョニングされたインスタンスの最小数。 |
maxCapacity | Long | 100 | スケールアウト用にプロビジョニングされたインスタンスの最大数。 |
例
リクエストの例
GET /2016-08-15/provision-configs HTTP/1.1
Common request headers正常に処理された場合のレスポンス例
JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"provisionConfigs": [
{
"resource": "19861144****3057#service_name#test#function_name",
"current": 15
"scheduledActions": [
{
"endTime": "2020-12-10T10:10:10Z",
"name": "demoScheduler",
"scheduleExpression": "cron(0 30 8 * * *)",
"startTime": "2020-10-10T10:10:10Z",
"target": 5
}
],
"target": 15,
"targetTrackingPolicies": [
{
"endTime": "2020-12-10T10:10:10Z",
"maxCapacity": 100,
"metricTarget": 0.6,
"metricType": "ProvisionedConcurrencyUtilization",
"minCapacity": 10,
"name": "demoScheduler",
"startTime": "2020-10-10T10:10:10Z"
]
}
}
]
}エラーコード
エラーコードの一覧は、「API エラーセンター」をご参照ください。