調用GetProvisionConfig介面擷取預留配置。
背景資訊
預留模式通過預留適量函數執行個體來響應函數調用請求,降低冷啟動的發生次數,為時延敏感的線上業務提供更好的服務響應。預留模式配置的固定預留值可能會導致預留函數執行個體利用不充分,您可以通過定時Auto Scaling和指標追蹤Auto Scaling兩種模式解決該問題。具體資訊,請參見彈性管理(含預留模式)。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
要求標頭
該介面無特殊要求標頭,關於公用要求標頭資訊,請參見公用參數。
請求文法
GET /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 | 是 | 1 | 預留的目標資源個數。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| ETag | String | provisionconfig | 確保實際更改的配置和期望更改的配置是一致的。 |
| resource | String | 198611443057****#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 | 10 | 預留的目標資源個數。 |
| scheduleExpression | String | cron(0 30 8 * * *) | 定時資訊,支援兩種格式。具體資訊,請參見參數說明。 |
| targetTrackingPolicies | Array | 指標伸縮策略:根據函數執行個體並發利用率的情況每分鐘對預留資源進行一次伸縮。
當您在系統中設定了伸縮最大值和最小值時,預留的函數執行個體量會在最大值與最小值之間進行伸縮,超出最大值時將停止擴容,低於最小值時將停止縮容。 |
|
| 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
公用要求標頭
正常返回樣本
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
} ]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。