使用PutProvisionConfig為預留執行個體配置定時和指標追蹤Auto Scaling-Function Compute-阿里雲

背景資訊

預留模式通過預留適量函數執行個體來響應函數調用請求，降低冷啟動的發生次數，為時延敏感的線上業務提供更好的服務響應。預留模式配置的固定預留值可能會導致預留函數執行個體利用不充分，您可以通過定時Auto Scaling和指標追蹤Auto Scaling兩種模式解決該問題。具體資訊，請參見預留模式執行個體的自動Auto Scaling。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

要求標頭

該介面無特殊要求標頭，關於公用要求標頭資訊，請參見公用參數。

請求文法

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

請求參數

名稱	類型	位置	是否必選	樣本值	描述
serviceName	String	Path	是	service_name	服務的名稱。
qualifier	String	Path	是	test	服務的版本或別名。
functionName	String	Path	是	function_name	函數的名稱。
	Object	Body	是		函數定義。
target	Long	Body	是	15	預留的目標資源個數。
scheduledActions	Array	Body	否		定時伸縮策略：通過定時伸縮策略您可以更加靈活地配置預留的函數執行個體，在指定時間將預留的函數執行個體量設定成需要的值，使函數執行個體量更好地貼合業務的並發量。
name	String	Body	否	demoScheduler	定時任務的名稱。
startTime	String	Body	否	2020-10-10T10:10:10Z	定時伸縮的起始生效時間。
endTime	String	Body	否	2020-12-10T10:10:10Z	定時伸縮的結束生效時間。
target	Long	Body	否	10	預留的目標資源個數。
scheduleExpression	String	Body	否	cron(0 30 8 * * *)	定時資訊，支援兩種格式。詳細資料，請參見參數說明。
targetTrackingPolicies	Array	Body	否		指標伸縮策略：根據函數執行個體並發利用率的情況每分鐘對預留資源進行一次伸縮。當指標超過追蹤值metricTarget時，開始以積極的策略擴容預留模式的函數執行個體量，以使得指標值恢複到追蹤值metricTarget附近。當指標低於追蹤值metricTarget時，開始以保守的策略縮容預留模式的函數執行個體量，以使得指標值逐漸恢複到追蹤值metricTarget附近。當您在系統中設定了伸縮最大值和最小值時，預留的函數執行個體量會在最大值與最小值之間進行伸縮，超出最大值時將停止擴容，低於最小值時將停止縮容。
name	String	Body	否	demoTargetTracking	定時任務的名稱。
startTime	String	Body	否	2020-10-10T10:10:10Z	指標伸縮的起始生效時間。
endTime	String	Body	否	2020-12-10T10:10:10Z	指標伸縮的結束生效時間。
metricType	String	Body	否	ProvisionedConcurrencyUtilization	追蹤的指標類型。
metricTarget	double	Body	否	0.6	指標的追蹤值。
minCapacity	Long	Body	否	10	縮容的最小值。
maxCapacity	Long	Body	否	100	擴容的最大值。

返回資料

名稱	類型	樣本值	描述
resource	String	19861144****3057#service_name#test#function_name	資源描述。
target	Long	15	預留的目標資源個數。
current	Long	1	實際執行個體數。
scheduledActions	Array		定時伸縮策略：通過定時伸縮策略您可以更加靈活地配置預留的函數執行個體，在指定時間將預留的函數執行個體量設定成需要的值，使函數執行個體量更好地貼合業務的並發量。
name	String	demoScheduler	定時任務的名稱。
startTime	String	2020-10-10T10:10:10Z	定時伸縮的起始生效時間。
endTime	String	2020-12-10T10:10:10Z	定時伸縮的結束生效時間。
target	Long	5	預留的目標資源個數。
scheduleExpression	String	cron(0 30 8 * * *)	定時資訊，支援兩種格式。詳細資料，請參見參數說明。
targetTrackingPolicies	Array		指標伸縮策略：根據函數執行個體並發利用率的情況每分鐘對預留資源進行一次伸縮。當指標超過追蹤值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 
公用要求標頭
{
    "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"
  } ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。