プロビジョニングされた構成を照会します。
背景情報
プロビジョニングモードでは、関数呼び出し要求に応答するインスタンスを予約できます。 これにより、コールドスタートの発生を減らし、オンラインの待ち時間に敏感なサービスの応答を高速化できます。 スケジュールまたはメトリックベースのスケーリングを実行して、プロビジョニングされたインスタンスをより有効に活用できます。 詳細については、「自動スケーリングインスタンスの設定 (プロビジョニング済みインスタンスを含む) 」をご参照ください。
デバッグ
リクエストヘッダー
この操作では、共通のリクエストヘッダーのみが使用されます。 詳細は、共通パラメータを参照してください。
リクエスト構文
GET /services/{serviceName.[qualifier]}/functions/{functionName}/provision-config HTTP/1.1リクエストパラメーター
パラメーター | データ型 | 位置 | 必須 | 例 | 説明 |
serviceName | String | パス | あり | service_name | サービスの名前です。 |
修飾子 | String | パス | あり | test | サービスのバージョンまたはエイリアス。 |
functionName | String | パス | あり | function_name | 関数の名前。 |
オブジェクト | 本文 | あり | 関数の定義。 | ||
ターゲット | Long | 本文 | あり | 1 | プロビジョニングされたインスタンスの数。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
ETag | String | provisionconfig | 変更されたコンフィギュレーションが変更されるコンフィギュレーションと一致するようにするために使用される値。 |
resource | String | 198611443057 ****#service_name#test#function_name | リソースの説明。 |
ターゲット | Long | 15 | プロビジョニングされたインスタンスの数。 |
現在 | Long | 1 | プロビジョニングされたインスタンスの実際の数。 |
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/services/service_name.test/functions/function_name/provision-config HTTP/1.1
Common request headers正常に処理された場合のレスポンス例
JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"resource" : "198611443057****#service_name#test#function_name",
"target" : 15,
"current" : 1,
"scheduledActions" : [ {
"name" : "demoScheduler",
"startTime" : "2020-10-10T10:10:10Z",
"endTime" : "2020-12-10T10:10:10Z",
"target" : 10,
"scheduleExpression" : "cron(0 30 8 * * *)"
} ],
"targetTrackingPolicies" : [ {
"name" : "demoTargetTracking",
"startTime" : "2020-10-10T10:10:10Z",
"endTime" : "2020-12-10T10:10:10Z",
"metricType" : "ProvisionedConcurrencyUtilization",
"metricTarget" : 0.6,
"minCapacity" : 10,
"maxCapacity" : 100
} ]
}エラーコード
エラーコードの一覧は、「API エラーセンター」をご参照ください。