文档首页> 函数工作流 FunctionGraph> CLI命令参考> 函数调用
更新时间：2023-06-25 GMT+08:00
查看PDF

函数调用

调用函数首先需要获取函数的urn，如图1所示。

图1 获取函数URN

同步调用

执行同步调用示例命令，参数说明请参见表1。

hcloud FunctionGraph InvokeFunction --cli-region="ap-southeast-1" --X-Cff-Log-Type="tail" --X-CFF-Request-Version="v1" --function_urn="urn:fss:cn-east-3:******:function:default:hcloud-invoke:latest" --project_id="******" --key="value"
表1 参数说明

参数

是否必须

描述

--cli-region

是

调用函数所在region。

--function_urn

是

函数的URN（Uniform Resource Name），唯一标识函数。

--project_id

是

租户Project ID。

--X-Cff-Log-Type

否

tail（header里面返回函数执行后的4K日志），或者为空（不返回日志）。

X-CFF-Request-Version

否

返回体格式：取值v0，v1。

  • v0：默认返回文本格式。
  • v1：默认返回json格式，sdk需要使用此值。

Body

是

通过--key="value"方式指定请求体，其对应的json结构：{ "key":"value"}。

输出结果如图2所示，输出的响应参数请参见表2。

图2 输出结果
表2 响应参数

参数

参数类型

描述

request_id

String

请求ID

result

String

函数执行结果

log

String

函数执行返回日志

status

Integer

函数执行返回状态

error_code

String

错误码

异步调用

执行异步调用示例命令，参数说明请参见表3。

hcloud FunctionGraph AsyncInvokeFunction --cli-region="cn-east-3" --function_urn="urn:fss:cn-east-3:******:function:default:hcloud-invoke:latest" --project_id="******" --key="value"
表3 参数说明

参数

是否必须

描述

--cli-region

是

调用函数所在region。

--function_urn

是

函数的URN（Uniform Resource Name），唯一标识函数。

--project_id

是

租户Project ID。

请求体

是

通过--key="value"方式指定请求体，其对应的json结构：{ "key":"value"}。

输出结果如图3所示，输出的响应参数请参见表2。

图3 输出结果
表4 响应参数说明

参数

参数类型

描述

request_id

String

请求ID