GetProvisionConfig - Function Compute - Alibaba Cloud Documentation Center

Queries the provisioned configuration of a function.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

GET /2021-04-06/services/{serviceName}/functions/{functionName}/provision-config

Request parameters

Parameter	Type	Required	Description	Example
serviceName	string	Yes	The name of the service.	demoService
qualifier	string	Yes	The name of the alias.	prod
functionName	string	Yes	The name of the function.	demoFunction
X-Fc-Account-Id	string	No	The ID of your Alibaba Cloud account.	188077086902****
X-Fc-Date	string	No	The start time when the function is invoked. Specify the time in the EEE,d MMM yyyy HH:mm:ss GMT format.	Wed, 11 May 2022 09:00:00 GMT
X-Fc-Trace-Id	string	No	The trace ID of the invocation request of Function Compute.	rid281s******

Response parameters

Parameter	Type	Description	Example
headers	object
ETag	string	The ETag value of the provisioned configuration. This value is used to ensure that the modified configuration is consistent with the configuration to be modified.
	object	The provisioned configurations.
resource	string	The description of the resource.	12345#servierName#qualifier#functionName
target	long	The expected number of provisioned instances.	5
current	long	The actual number of provisioned instances.	1
scheduledActions	array	The configurations of scheduled auto scaling.
	ScheduledActions	Details about the scheduled scaling policy. You can use the scheduled scaling policy to flexibly configure provisioned instances. You can specify the number of provisioned instances to the desired value at the scheduled time. This way, the number of provisioned instances can meet the concurrency requirements of your business.	[ { "Name":"action_1", "StartTime":"2020-11-01T10:00:00Z", "EndTime":"2020-11-30T10:00:00Z", "TargetValue":50, "ScheduleExpression":"cron(0 0 20 * * )" }, { "Name":"action_2", "StartTime":"2020-11-01T10:00:00Z", "EndTime":"2020-11-30T10:00:00Z", "TargetValue":10, "ScheduleExpression":"cron(0 0 22 * *)" } ]
targetTrackingPolicies	array	The configurations of metric-based auto scaling.
	TargetTrackingPolicies	The configurations of metric-based auto scaling. Provisioned instances are scaled in or out every minute based on the concurrency utilization of provisioned instances. If the metric value exceeds the value of the metricTarget parameter, the system scales out provisioned instances based on a progressive policy to make the metric value closer to the value of the metricTarget parameter. If the metric value is smaller than the value of the metricTarget parameter, the system scales in provisioned instances based on a conservative policy to make the metric value closer to the value of the metricTarget parameter. After you specify the maximum and minimum numbers of provisioned instances, the system scales in or out provisioned instances within the range from the minimum number to the maximum number. If the number of provisioned instances is beyond the range, the scaling stops.	[ { "Name": "action_1", "StartTime": "2020-11-01T10:00:00Z", "EndTime": "2020-11-30T10:00:00Z", "MetricType": "ProvisionedConcurrencyUtilization", "MetricTarget": 0.6, "MinCapacity": 10, "MaxCapacity": 100 } ]
currentError	string	The error message returned if a provisioned instance fails to be created.	image not found
alwaysAllocateCPU	boolean	Specifies whether to always allocate CPU to a function instance.	true

Examples

Sample success responses

JSONformat

{
  "resource": "12345#servierName#qualifier#functionName",
  "target": 5,
  "current": 1,
  "scheduledActions": [
    {
      "name": "name",
      "startTime": "2020-10-10T10:10:10Z",
      "endTime": "2021-10-10T10:10:10Z",
      "target": 50,
      "scheduleExpression": "cron(0/30 * * * *)"
    }
  ],
  "targetTrackingPolicies": [
    {
      "name": "test_1",
      "startTime": "2020-10-10T10:10:10Z",
      "endTime": "2020-10-10T10:10:10Z",
      "metricType": "CPUUtilization",
      "metricTarget": 0.6,
      "minCapacity": 10,
      "maxCapacity": 100
    }
  ],
  "currentError": "image not found",
  "alwaysAllocateCPU": true
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change time

Summary of changes

Operation

2021-06-30

The input parameters of the API operation change.

Change item	Change content
Input Parameters	The input parameters of the API operation change.
	Added Input Parameters: X-Fc-Account-Id
	Added Input Parameters: X-Fc-Code-Checksum
	Added Input Parameters: X-Fc-Log-Type
	Added Input Parameters: X-Fc-Invocation-Type
	Added Input Parameters: X-Fc-Date
	Added Input Parameters: X-Fc-Trace-Id

2021-06-30

The input parameters of the API operation change.,The response structure of the API operation changes.

Change item	Change content
Input Parameters	The input parameters of the API operation change.
	Added Input Parameters: X-Fc-Account-Id
Output Parameters	The response structure of the API operation changes.

2021-06-30

The input parameters of the API operation change.

Change item	Change content
Input Parameters	The input parameters of the API operation change.
	delete Input Parameters: X-Fc-Account-Id