PutProvisionConfig - Function Compute - Alibaba Cloud ドキュメントセンター

プロビジョニングされた構成を設定します。

背景情報

プロビジョニングされたインスタンスを使用して、関数呼び出し要求に応答できます。これにより、コールドスタートの発生が減り、待ち時間に敏感なオンラインサービスの応答速度が向上します。スケジュールされた自動スケーリングまたはメトリック追跡自動スケーリングを実行して、プロビジョニングされたインスタンスをより有効に活用できます。詳細については、「リザーブドインスタンスの自動スケーリング」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。利便性を考慮して、この操作は OpenAPI Explorer で呼び出すことが推奨されます。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみが使用されます。詳細については、「共通パラメーター」をご参照ください。

リクエスト構文

PUT /services/{serviceName.[qualifier]}/functions/{functionName}/provision-config HTTP/1.1

リクエストパラメーター

パラメーター	データ型	位置	必須	例	説明
serviceName	String	パス	あり	service_name	サービスの名前です。
修飾子	String	パス	あり	test	サービスのバージョンまたはエイリアス。
functionName	String	パス	あり	function_name	関数の名前。
	オブジェクト	本文	あり		関数の定義。
ターゲット	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分ごとにスケールインまたはスケールアウトされます。メトリック値がmetricTargetパラメーターの値を超えると、システムはプログレッシブポリシーに基づいてプロビジョニングされたインスタンスをスケールアウトし、メトリック値をmetricTargetパラメーターの値に近づけます。メトリック値がmetricTargetパラメーターの値よりも小さい場合、システムは保守的なポリシーに基づいてプロビジョニングされたインスタンスをスケーリングし、メトリック値をmetricTargetパラメーターの値に近づけます。プロビジョニングされたインスタンスの最大数と最小数を指定した場合、システムはプロビジョニングされたインスタンスを最小数から最大数の範囲内でスケーリングします。プロビジョニングされたインスタンスの数が範囲を超える場合、スケーリングは停止します。
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	スケールアウト用にプロビジョニングされたインスタンスの最大数。

レスポンスパラメーター

パラメーター	データ型	例	説明
resource	String	19861144 **** 3057#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	5	プロビジョニングされたインスタンスの予想数。
scheduleExpression	String	cron(0 30 8 * * *)	スケジュールされたタスクをいつ実行するかを指定するスケジュール式。 2つのフォーマットがサポートされる。詳細については、リザーブドインスタンスの自動スケーリングトピックの「スケジュール済み自動スケーリング」セクションのパラメーター表をご参照ください。
targetTrackingPolicies	配列		メトリック追跡自動スケーリングの設定。プロビジョニングされたインスタンスは、プロビジョニングされたインスタンスの同時使用率に基づいて、1分ごとにスケールインまたはスケールアウトされます。メトリック値がmetricTargetパラメーターの値を超えると、システムはプログレッシブポリシーに基づいてプロビジョニングされたインスタンスをスケールアウトし、メトリック値をmetricTargetパラメーターの値に近づけます。メトリック値がmetricTargetパラメーターの値よりも小さい場合、システムは保守的なポリシーに基づいてプロビジョニングされたインスタンスをスケーリングし、メトリック値をmetricTargetパラメーターの値に近づけます。プロビジョニングされたインスタンスの最大数と最小数を指定した場合、システムはプロビジョニングされたインスタンスを最小数から最大数の範囲内でスケーリングします。プロビジョニングされたインスタンスの数が範囲を超える場合、スケーリングは停止します。
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	スケールアウト用にプロビジョニングされたインスタンスの最大数。

例

リクエストの例

PUT /2016-08-15/services/service_name.test/functions/function_name/provision-config HTTP/1.1 
Common request headers
{
    "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"
        }
    ]
}

正常に処理された場合のレスポンス例

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "current" : "1",
  "resource" : "19861144****3057#service_name#test#function_name",
  "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 エラーセンター」をご参照ください。