Help Center/ FunctionGraph/ API Reference/ APIs/ Asynchronous Execution Notification/ Querying Asynchronous Execution Notification Settings of a Function Version

Updated on 2024-03-14 GMT+08:00

View PDF

Querying Asynchronous Execution Notification Settings of a Function Version

Function

This API is used to query the asynchronous invocation setting of a function version.

URI

GET /v2/{project_id}/fgs/functions/{function_urn}/async-invoke-config

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
function_urn	Yes	String	Function URN. For details, see the function model description.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.
Content-Type	Yes	String	Message body type (format).

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
func_urn	String	Function URN. Minimum: 1 Maximum: 269
max_async_event_age_in_seconds	Integer	Maximum validity period of a message. Value range: 1–86,400. Unit: second.
max_async_retry_attempts	Integer	Maximum number of retry attempts to be made if asynchronous invocation fails. Default value: 3. Value range: 0–8.
destination_config	FuncAsyncDestinationConfig object	Asynchronous invocation target.
created_time	String	Time when asynchronous execution notification was configured.
last_modified	String	Time when the asynchronous execution notification settings were last modified.
enable_async_status_log	Boolean	Whether to enable asynchronous invocation status persistence.

**Table 4** FuncAsyncDestinationConfig
Parameter	Type	Description
on_success	FuncDestinationConfig object	Target to be invoked when a function is successfully executed.
on_failure	FuncDestinationConfig object	Target to be invoked when a function fails to be executed due to a system error or an internal error.

**Table 5** FuncDestinationConfig
Parameter	Type	Description
destination	String	Object type. OBS SMN DIS FunctionGraph Enumeration values: OBS SMN DIS FunctionGraph
param	String	Parameters (in JSON format) corresponding to the target service. OBS: Parameters related to the bucket name, object directory prefix, and object expiration time are included. The object expiration time ranges from 0 to 365 days. If the value is 0, the object will not expire. SMN: The topic_urn parameter is included. DIS: The stream_name parameter is included. FunctionGraph: The func_urn parameter is included.

Status code: 404

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Requests

Query the asynchronous execution notification settings of a function version.

GET /v2/{project_id}/fgs/functions/{function_urn}/async-invoke-config

Example Responses

Status code: 200

{
  "func_urn" : "urn:fss:xxxxxxxxx:7aad83af3e8d42e99ac194xxxxxxxxxx:function:default:test:latest",
  "max_async_event_age_in_seconds" : 60,
  "max_async_retry_attempts" : 1,
  "destination_config" : {
    "on_success" : {
      "destination" : "FunctionGraph",
      "param" : "{\"func_urn\":\"urn:fss:{region}:5691ba790e2b46ceb38316xxxxxxxxxx:function:default:testPython:latest\"}"
    },
    "on_failure" : {
      "destination" : "FunctionGraph",
      "param" : "{\"func_urn\":\"urn:fss:{region}:5691ba790e2b46ceb38316xxxxxxxxxx:function:default:testPython:latest\"}"
    }
  },
  "created_time" : "2021-03-04T14:50:02+08:00",
  "last_modified" : "2021-03-04 14:50:02"
}