全部產品
Search
文件中心

Function Compute:ListProvisionConfigs

更新時間:Aug 20, 2025

調用ListProvisionConfigs介面擷取預留配置列表。

背景資訊

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

調試

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

要求標頭

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

請求文法

GET /provision-configs HTTP/1.1

請求參數

名稱 類型 位置 是否必選 樣本值 描述
limit Long Query 20

限定此次返回資源的數量。如果不設定,預設返回20,最大不能超過100。返回結果可以小於指定的數量,但不能多於指定的數量。

nextToken String Query next_service

用來返回更多結果。第一次查詢不需要提供該參數,後續查詢的Token從返回結果中擷取。

serviceName String Query service_name

服務的名稱。

qualifier String Query test

服務的版本或別名。

返回資料

名稱 類型 樣本值 描述
nextToken String next_service

用來返回更多的查詢結果。如果這個值沒有返回,則說明沒有更多結果。

provisionConfigs Array

配置列表。

resource String 19861144****3057#service_name#test#function_name

資源的描述。

target Long 15

預留的目標資源個數。

current Long 15

實際資源的個數。

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

指標伸縮策略:根據函數執行個體並發利用率的情況每分鐘對預留資源進行一次伸縮。

  • 當指標超過追蹤值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

擴容的最大值。

樣本

請求樣本

GET /2016-08-15/provision-configs HTTP/1.1 
公用要求標頭

正常返回樣本

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"
        ]
      }
    }
  ]
}

錯誤碼

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