Modifying the Metadata of a Function¶

Function¶

This API is used to modify the metadata of a function.

URI¶

PUT /v2/{project_id}/fgs/functions/{function_urn}/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).

**Table 3** Request body parameters¶
Parameter	Mandatory	Type	Description
func_name	Yes	String	Function name.
runtime	Yes	String	Environment in which a FunctionGraph function is executed. Options: Python 2.7 Python 3.6 Python 3.9 Go 1.8 Go 1.x Java 8 Java 11 Node.js 6.10 Node.js 8.10 Node.js 10.16 Node.js 12.13 Node.js 14.18 C# (.NET Core 2.0) C# (.NET Core 2.1) C# (.NET Core 3.1) Custom PHP 7.3 HTTP Enumeration values: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http
timeout	Yes	Integer	Maximum duration the function can be executed. Value range: 3s-259,200s.
handler	Yes	String	Handler of a function in the format of "xx.xx". It must contain a period (.). For example, for Node.js function myfunction.handler, the file name is myfunction.js, and the handler function is handler.
memory_size	Yes	Integer	Memory consumed by a function. Unit: MB. The value can be 128, 256, 512, 768, 1024, 1280, 1536, 1792, 2048, 2560, 3072, 3584 or 4096. The value ranges from 128 to 4096.
user_data	No	String	Name/Value information defined for the function. These are parameters used in a function. For example, if a function needs to access a host, define Host={host_ip}. You can define a maximum of 20 such parameters, and their total length cannot exceed 4 KB.
encrypted_user_data	No	String	User-defined name/value to be encrypted.
xrole	No	String	Agency used by the function. You need to create an agency on the IAM console. This field is mandatory when a function needs to access other services. After specifying a function execution agency, you can use the context method in the function handler to obtain a token, an AK, and an SK for accessing other cloud services. No agency is required if FunctionGraph does not access any cloud services.
app_xrole	No	String	Execution agency. You can optimize performance by configuring a separate agency for function execution, otherwise, the same agency is used for both execution and configuration.
description	No	String	Function description.
func_vpc	No	FuncVpc object	VPC configuration. An agency with VPC permissions must be configured for the function.
mount_config	No	MountConfig object	Mounting configuration.
strategy_config	No	StrategyConfig object	Function policy configuration.
custom_image	No	CustomImage object	Container image.
extend_config	No	String	Extended configuration.
initializer_handler	No	String	Initializer of the function in the format of "xx.xx". It must contain a period (.). This parameter is mandatory when the initialization function is configured. For example, for Node.js function myfunction.initializer, the file name is myfunction.js, and the initialization function is initializer.
initializer_timeout	No	Integer	Maximum duration the function can be initialized. Value range: 1s-300s. This parameter is mandatory when the initialization function is configured.
pre_stop_handler	No	String	The pre-stop handler of a function. The value must contain a period (.) in the format of xx.xx. For example, for Node.js function myfunction.pre_stop_handler, the file name is myfunction.js, and the initialization function is pre_stop_handler.
pre_stop_timeout	No	Integer	Maximum duration the function can be initialized. Value range: 1s-90s.
ephemeral_storage	No	Integer	Ephemeral storage. By default, the /tmp directory of each function is 512 MB. You can increase the size to 10,240 MB (10 GB) if necessary. Enumeration values: 512 10240
enterprise_project_id	No	String	Enterprise project ID. This parameter is mandatory if you create a function as an enterprise user.
log_config	No	FuncLogConfig object	Function log configuration.
network_controller	No	NetworkControlConfig object	Network configuration.
is_stateful_function	No	Boolean	Whether stateful functions are supported. If they are supported, set this parameter to true. This parameter is supported in FunctionGraph v2.
enable_dynamic_memory	No	Boolean	Whether to enable dynamic memory allocation.
enable_auth_in_header	No	Boolean	Whether to allow authentication information in the request header.
domain_names	No	String	Private domain name.
restore_hook_handler	No	String	Restore Hook entry point for snapshot-based cold start in the format "xx.xx". The period (.) must be included. For example, com.xxx.demo.Test.restoreHook.
restore_hook_timeout	No	Integer	Restore Hook timeout of snapshot-based cold start. Range: 1s to 300s.
heartbeat_handler	No	String	Entry of the heartbeat function in the format of "xx.xx". It must contain a period (.).This parameter can be configured only in Java. The heartbeat function entry must be in the same file as your function handler. This parameter is mandatory when the heartbeat function is enabled.
enable_class_isolation	No	Boolean	Indicates whether to enable class isolation. This parameter can be configured only in Java. Enable to dump logs to Kafka and improve class loading efficiency. However, this may cause compatibility issues.

**Table 4** FuncVpc¶
Parameter	Mandatory	Type	Description
domain_id	No	String	Domain name ID.
namespace	No	String	Project ID.
vpc_name	No	String	VPC name.
vpc_id	Yes	String	VPC ID.
subnet_name	No	String	Subnet name.
subnet_id	Yes	String	Subnet ID.
cidr	No	String	Subnet mask.
gateway	No	String	Gateway.
security_groups	No	Array of strings	Security group.

**Table 5** MountConfig¶
Parameter	Mandatory	Type	Description
mount_user	Yes	MountUser object	User information.
func_mounts	Yes	Array of FuncMount objects	Mounted resources.

**Table 6** MountUser¶
Parameter	Mandatory	Type	Description
user_id	Yes	String	User ID, a non-0 integer from -1 to 65534.
user_group_id	Yes	String	User group ID, a non-0 integer from -1 to 65534.

**Table 7** FuncMount¶
Parameter	Mandatory	Type	Description
mount_type	Yes	String	Mount type. The value can be sfs, sfsTurbo, or ecs. This parameter is mandatory when func_mounts is not empty.
mount_resource	Yes	String	ID of the mounted resource (cloud service ID). This parameter is mandatory when func_mounts is not empty.
mount_share_path	No	String	Remote mount path. For example, 192.168.0.12:/data. This parameter is mandatory if mount_type is set to ecs.
local_mount_path	Yes	String	Function access path. This parameter is mandatory when func_mounts is not empty.

**Table 8** StrategyConfig¶
Parameter	Mandatory	Type	Description
concurrency	Yes	Integer	Maximum number of instances for a single function. For v1, the value can be 0 or -1; for v2, it ranges from -1 to 1000. -1: The function has unlimited instances. 0: The function is disabled.
concurrent_num	Yes	Integer	Number of concurrent requests per instance. This parameter is supported only by v2. The value ranges from 1 to 1,000.

**Table 9** CustomImage¶
Parameter	Mandatory	Type	Description
enabled	No	Boolean	Whether to enable this feature.
image	No	String	Image address.
command	No	String	Command for starting a container image.
args	No	String	Command line parameter for starting a container image.
working_dir	No	String	Working directory of an image container.
uid	No	String	User ID of an image container.
gid	No	String	User group ID of an image container.

**Table 10** FuncLogConfig¶
Parameter	Mandatory	Type	Description
group_name	No	String	Name of the log group bound to the function.
group_id	No	String	ID of the log group bound to the function.
stream_name	No	String	Name of the log stream bound to the function.
stream_id	No	String	ID of the log stream bound to the function.

**Table 11** NetworkControlConfig¶
Parameter	Mandatory	Type	Description
disable_public_network	No	Boolean	Disable public access.
trigger_access_vpcs	No	Array of VpcConfig objects	VPC access restriction.

**Table 12** VpcConfig¶
Parameter	Mandatory	Type	Description
vpc_name	No	String	VPC name.
vpc_id	No	String	VPC ID.

Response Parameters¶

Status code: 200

**Table 13** Response body parameters¶
Parameter	Type	Description
func_id	String	Function ID, which uniquely identifies a function.
resource_id	String	Function resource ID.
func_urn	String	Function URN.
func_name	String	Function name.
domain_id	String	Domain ID.
namespace	String	Project ID.
project_name	String	Project name.
package	String	Group to which the function belongs. This field is defined to group functions.
runtime	String	Environment for executing a function. Options: Python2.7 Python 3.6 Python 3.9 Go 1.8 Go 1.x Java 8 Java 11 Node.js 6.10 Node.js 8.10 Node.js 10.16 Node.js 12.13 Node.js 14.18 C# (.NET Core 2.0) C# (.NET Core 2.1) C# (.NET Core 3.1) Custom PHP 7.3 HTTP Custom image-based functions Enumeration values: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http Custom Image
timeout	Integer	Maximum duration the function can be executed. Value range: 3s-259,200s.
handler	String	Handler of a function in the format of "xx.xx". It must contain a period (.). For example, for Node.js function myfunction.handler, the file name is myfunction.js, and the handler function is handler.
memory_size	Integer	Memory consumed by a function. Unit: MB. The value can be 128, 256, 512, 768, 1024, 1280, 1536, 1792, 2048, 2560, 3072, 3584 or 4096. The value ranges from 128 to 4096.
cpu	Integer	CPU resources of a function. Unit: millicore (1 core = 1000 millicores). The value of this field is proportional to that of MemorySize. By default, 100 CPU millicores are required for 128 MB memory.
code_type	String	Function code type. Options: inline: inline code zip: ZIP file obs: function code stored in an OBS bucket jar: JAR file, mainly for Java functions Custom-Image-Swr: The function code comes from the SWR custom image. Enumeration values: inline zip obs jar Custom-Image-Swr
code_url	String	If code_type is set to obs, enter the OBS URL of the function code package. If code_type is not set to obs, leave this parameter blank.
code_filename	String	Name of a function file. This parameter is mandatory only when code_type is set to jar or zip.
code_size	Long	Code size in bytes.
user_data	String	Name/Value information defined for the function. These are parameters used in a function. For example, if a function needs to access a host, define Host={host_ip}. You can define a maximum of 20 such parameters, and their total length cannot exceed 4 KB.
encrypted_user_data	String	User-defined name/value to be encrypted.
digest	String	SHA512 hash value of function code, which is used to determine whether the function has changed.
version	String	Function version, which is automatically generated by the system. The version name is in the format of "vYYYYMMDD-HHMMSS" (v+year/month/day-hour/minute/second).
image_name	String	Internal identifier of a function version.
xrole	String	Agency used by the function. You need to create an agency on the IAM console. This field is mandatory when a function needs to access other services. After specifying a function execution agency, you can use the context method in the function handler to obtain a token, an AK, and an SK for accessing other cloud services. No agency is required if FunctionGraph does not access any cloud services.
app_xrole	String	Execution agency. You can optimize performance by configuring a separate agency for function execution, otherwise, the same agency is used for both execution and configuration.
description	String	Function description.
last_modified	String	Time when the function was last updated.
ephemeral_storage	Integer	Ephemeral storage. By default, the /tmp directory of each function is 512 MB. You can increase the size to 10,240 MB (10 GB) if necessary. Enumeration values: 512 10240
func_vpc	FuncVpc object	VPC configuration. An agency with VPC permissions must be configured for the function.
mount_config	MountConfig object	Mounting configuration.
strategy_config	StrategyConfig object	Function policy configuration.
dependencies	Array of Dependency objects	Dependency packages.
initializer_handler	String	Initializer of the function in the format of "xx.xx". It must contain a period (.). This parameter is mandatory when the initialization function is configured. For example, for Node.js function myfunction.initializer, the file name is myfunction.js, and the initialization function is initializer.
initializer_timeout	Integer	Maximum duration the function can be initialized. Value range: 1s-300s. This parameter is mandatory when the initialization function is configured.
pre_stop_handler	String	The pre-stop handler of a function. The value must contain a period (.) in the format of xx.xx. For example, for Node.js function myfunction.pre_stop_handler, the file name is myfunction.js, and the initialization function is pre_stop_handler.
pre_stop_timeout	Integer	Maximum duration the function can be initialized. Value range: 1s-90s.
enterprise_project_id	String	Enterprise project ID. This parameter is mandatory if you create a function as an enterprise user.
long_time	Boolean	Whether to allow a long timeout.
log_group_id	String	Log group ID.
log_stream_id	String	Log stream ID.
type	String	v2 indicates an official version, and v1 indicates a deprecated version. Enumeration values: v1 v2
enable_cloud_debug	String	Whether to enable cloud debugging to adapt to the CloudDebug scenario. (discarded)
enable_dynamic_memory	Boolean	Whether to enable dynamic memory allocation.
enable_auth_in_header	Boolean	Whether to add authentication information to request header for custom image-based functions.
is_stateful_function	Boolean	Whether stateful functions are supported. This parameter is supported in FunctionGraph v2.
domain_names	String	Private domain name configured for resolution.
custom_image	CustomImage object	Container image.
is_return_stream	Boolean	Whether to return stream data. (discarded)

**Table 14** FuncVpc¶
Parameter	Type	Description
domain_id	String	Domain name ID.
namespace	String	Project ID.
vpc_name	String	VPC name.
vpc_id	String	VPC ID.
subnet_name	String	Subnet name.
subnet_id	String	Subnet ID.
cidr	String	Subnet mask.
gateway	String	Gateway.
security_groups	Array of strings	Security group.

**Table 15** MountConfig¶
Parameter	Type	Description
mount_user	MountUser object	User information.
func_mounts	Array of FuncMount objects	Mounted resources.

**Table 16** MountUser¶
Parameter	Type	Description
user_id	String	User ID, a non-0 integer from -1 to 65534.
user_group_id	String	User group ID, a non-0 integer from -1 to 65534.

**Table 17** FuncMount¶
Parameter	Type	Description
mount_type	String	Mount type. The value can be sfs, sfsTurbo, or ecs. This parameter is mandatory when func_mounts is not empty.
mount_resource	String	ID of the mounted resource (cloud service ID). This parameter is mandatory when func_mounts is not empty.
mount_share_path	String	Remote mount path. For example, 192.168.0.12:/data. This parameter is mandatory if mount_type is set to ecs.
local_mount_path	String	Function access path. This parameter is mandatory when func_mounts is not empty.

**Table 18** StrategyConfig¶
Parameter	Type	Description
concurrency	Integer	Maximum number of instances for a single function. For v1, the value can be 0 or -1; for v2, it ranges from -1 to 1000. -1: The function has unlimited instances. 0: The function is disabled.
concurrent_num	Integer	Number of concurrent requests per instance. This parameter is supported only by v2. The value ranges from 1 to 1,000.

**Table 19** Dependency¶
Parameter	Type	Description
id	String	Dependency version ID.
owner	String	Domain ID of the dependency owner.
link	String	URL of the dependency on OBS.
runtime	String	Environment for executing a function. Options: Python2.7 Python 3.6 Python 3.9 Go 1.8 Go 1.x Java 8 Java 11 Node.js 6.10 Node.js 8.10 Node.js 10.16 Node.js 12.13 Node.js 14.18 C# (.NET Core 2.0) C# (.NET Core 2.1) C# (.NET Core 3.1) Custom PHP 7.3 HTTP Custom image-based functions Enumeration values: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http Custom Image
etag	String	MD5 value of a dependency.
size	Long	Dependency size.
name	String	Dependence name.
description	String	Dependency description.
file_name	String	File name of a dependency package (ZIP).
version	Long	Dependency version ID.
dep_id	String	Dependency ID.
last_modified	String	Time when the function was last updated.

**Table 20** CustomImage¶
Parameter	Type	Description
enabled	Boolean	Whether to enable this feature.
image	String	Image address.
command	String	Command for starting a container image.
args	String	Command line parameter for starting a container image.
working_dir	String	Working directory of an image container.
uid	String	User ID of an image container.
gid	String	User group ID of an image container.

Status code: 400

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

Status code: 401

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

Status code: 403

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

Status code: 404

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

Status code: 500

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

Example Requests¶

Modify the configuration of Node.js function fgsTest to change the memory to 768 MB and timeout to 40s. Add environment variable host and mount a disk.

PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/config

{
  "func_name" : "fgsTest",
  "handler" : "index.handler",
  "memory_size" : 768,
  "user_data" : "{\"host\":\"192.168.0.1\"}",
  "runtime" : "Node.js6.10",
  "mount_config" : {
    "mount_user" : {
      "user_id" : -1,
      "user_group_id" : -1
    },
    "func_mounts" : [ {
      "mount_resource" : "268xxx-d3xx-4cxx-98xx-d1dbxxx",
      "local_mount_path" : "/mnt",
      "mount_type" : "sfsTurbo"
    } ]
  },
  "timeout" : 40
}

Modify the GPU configuration of a custom runtime function to change the GPU memory to 1 GB and memory size to 4 GB.

PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/config

{
  "func_name" : "test_GPU",
  "handler" : "bootstrap",
  "memory_size" : 4096,
  "runtime" : "Custom",
  "timeout" : 40,
  "gpu_memory" : 1024
}

Modify the configuration of the custom image-based function.

{
  "func_name": "test_function",
  "handler": "-",
  "memory_size": 128,
  "runtime": "Custom Image",
  "timeout": 3,
  "xrole": "xxx",
  "custom_image": {
      "enabled": true,
      "image": "swr.xxx.example.com/xxx/xxx:xxx",
      "working_dir": "/"
  }
}

Example Responses¶

Status code: 200

{
  "func_id" : "0d075978-5a54-4ee1-8e24-ff5bd070xxxx",
  "resource_id" : "0d075978-5a54-4ee1-8e24-ff5bd070xxxx:test",
  "func_urn" : "urn:fss:xxxxxxxx:7aad83af3e8d42e99ac194e8419e2c9b:function:default:test",
  "func_name" : "test",
  "domain_id" : "14ee2e3501124efcbca7998baa24xxxx",
  "namespace" : "46b6f338fc3445b8846c71dfb1fbxxxx",
  "project_name" : "xxxxxx",
  "package" : "default",
  "runtime" : "Node.js6.10",
  "timeout" : 3,
  "handler" : "fssExampleCsharp2.1::fssExampleCsharp21.Program::MyFunc",
  "memory_size" : 128,
  "cpu" : 300,
  "code_type" : "inline",
  "code_filename" : "index.js",
  "code_size" : 272,
  "user_data" : "{\"host\":\"192.168.0.1\"}",
  "mount_config" : {
    "mount_user" : {
      "user_id" : -1,
      "user_group_id" : -1
    },
    "func_mounts" : [ {
      "mount_resource" : "268xxx-d3xx-4cxx-98xx-d1dbxxx",
      "local_mount_path" : "/mnt",
      "mount_type" : "sfsTurbo"
    } ]
  },
  "digest" : "faa825575c45437cddd4e369bea69893bcbe195d478178462ad90984fe72993f3f59d15f41c5373f807f3e05fb9af322c55dabeb16565c386e402413458e6068",
  "version" : "latest",
  "ephemeral_storage" : 512,
  "image_name" : "latest-191025153727@zehht",
  "last_modified" : "2019-10-25 15:37:27",
  "strategy_config" : {
    "concurrency" : 0
  }
}

Status Codes¶

Status Code	Description
200	OK
400	Bad request.
401	Unauthorized.
403	Forbidden.
404	Not found.
500	Internal server error.

Error Codes¶

See Error Codes.

last updated: 2024-11-13 14:32 UTC - commit: b76006b7a8a959522accffb756d2ecb3b9ebe5d2