云函数

触发云函数

接口地址

POST https://cloud.minapp.com/userve/v1.3/cloud-function/:cloud-function-name/job/

其中 :cloud-function-name 是云函数的名字。

请求参数说明

Content-Type: Content-Type: application/json

参数类型必填说明
dataObject传递给云函数的参数,如果没有需要提供一个空对象
syncBool是否等待返回函数执行结果,默认为 true。同步与异步云函数有不同的超时时间,同步云函数为 5 秒,而异步云函数为 5 分钟(300 秒)

返回参数说明

sync 为 true 时:

参数类型说明
codeNumbercode 为 0 时表示成功执行云函数,否则为执行云函数失败
data由云函数返回的数据类型决定函数通过 callback 返回的数据
errorObject返回的错误信息,成功则返回空对象

sync 为 false 时:

参数类型说明
statusString默认为 'ok'

获取某云函数的任务记录

接口地址

GET https://cloud.minapp.com/userve/v1.3/cloud-function/:cloud-function-name/job/

其中 :cloud-function-name 是云函数的名字。

参数说明

参数类型必填说明
sourceString云函数任务来源,可选值:sdk, open_api, cloud_function, flex_schema, wechat_pay_success, alipay_pay_success, qpay_success, baidu_pay_success, timer, file_operation, user_dash, incoming_webhook, wechat_message, user_activity
statusString云函数任务状态,可选值:waiting, executing, fulfilled, schedule_failed, execution_rejected, deadline_exceeded, execution_failed
service_typeString云函数同步类型,可选值:time_sensitive, batch

返回参数

参数类型说明
idInteger任务 ID
created_atFloat创建时间
finished_atFloat完成时间
mem_usageInteger内存用量
service_typeString可能的值:time_sensitive, batch
sourceString任务来源
statusString任务状态
user_log_urlString日志地址

返回示例

  1. {
  2. "meta": {
  3. "limit": 20,
  4. "next": "/userve/v1.3/cloud-function/test/job/?limit=20&offset=20",
  5. "offset": 0,
  6. "previous": null,
  7. "total_count": 1525
  8. },
  9. "objects": [
  10. {
  11. "created_at": 1537505171.419368,
  12. "finished_at": 1537505171.605735,
  13. "id": 779734,
  14. "mem_usage": 78336000,
  15. "service_type": "batch",
  16. "source": "flex_schema",
  17. "started_at": 1537505171.5807,
  18. "status": "fulfilled",
  19. "user_log_url": "https://hydrogen-faas-logs.s3.cn-north-1.amazonaws.com.cn/ticket_778289.log?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=86400&X-Amz-Security-Token=FQoDYXdzEP3%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDM50xRDK8JETeulNLiK%2FA08zFCZM8zvsnb6VG81mDV0onfgVwXhAjUi6p3Y250g9GiVeWVs%2FpI6S9d0S6mD9xPjmkWw9ven%2BkRVME2xAbzfgio8%2BUbQkrOgvnFx%2BziHj0DGGvMEZYnoT6ui4QD8y8YQaJd7oWH%2B0hdIUGdE%2BFTSiZzSicuVgdr6WLkxipnuujV2yS9%2ByrXK4A0g1HaUifZVnD3K2Bz1AiHrr9abaFSFoWzyzhGYGcyp7TM4iodW%2FTI5CkPFj2f%2BNvCOSCBWWWOsY%2FUyaAdCFZFqXJoJ6uuXFZ5yl7xd5W28egT5Jgfeq%2FG5j9xp9OVu8sAlnPre8WoSpspHt8R%2BRMDPr6klJE3yxXIxRODlt4nHAA30wcwunO09x8zoK54pgrveIWNlIRYeSSMG%2FGAzYXNq%2FxXjcpQOa3ekyirC%2Bj0n45dBZY4oS8c3au32WjoLjD2gnPAZsvBg1gR2wcUxs3PFi30ochY9VAxXQyXeqcy1Jw0LXQnBLT6Uw9pVV8%2BikrK13EBUiIAow1FEeKJ3xjng7mrPz60pEDYZcymJ0Uj4VkNBXMQwPHBfsfChxsLWYXaQ3EitWD3GhBaim65Tz%2FoZHU6TPRijP5ZHdBQ%3D%3D&X-Amz-Date=20180921T044620Z&X-Amz-Signature=f5d74870d8b52cbb490fae4d81fc486b09da1e026bf9571c172b4d8d29c84a66&X-Amz-Credential=ASIAQUWH6XTCOEBVBVFG%2F20180921%2Fcn-north-1%2Fs3%2Faws4_request&X-Amz-SignedHeaders=host"
  20. },
  21. ...
  22. ]
  23. }

状态码说明

200: 成功。

400: 参数错误。

新建云函数

接口地址

POST https://cloud.minapp.com/userve/v1.3/cloud-function/

请求参数说明

参数类型必填说明
nameString云函数名,不能为空字符串
function_codeString云函数代码,不能为空字符串
remarkString备注

返回参数说明

参数类型说明
audit_statusString可能的值: approved, rejected, waiting
created_byString创建者昵称
function_codeString云函数代码
idInteger云函数 ID
nameString云函数名
plan_circleString套餐类型
remarkString备注
updated_atInteger最近一次更新时间
updated_byString更新者昵称
created_atInteger创建时间

状态码说明

201: 创建成功。

400: 参数不合法:云函数名或代码为字段为空。

获取当前小程序的所有云函数

接口地址

GET https://cloud.minapp.com/userve/v1.3/cloud-function/

返回参数说明

参数类型说明
audit_statusString可能的值: approved, rejected, waiting
created_byString创建者昵称
function_codeString云函数代码
idInteger云函数 ID
nameString云函数名
plan_circleString套餐类型
remarkString备注
updated_atInteger最近一次更新时间
updated_byString更新者昵称
created_atInteger创建时间

返回示例

  1. {
  2. "meta": {
  3. "limit": 20,
  4. "next": null,
  5. "offset": 0,
  6. "previous": null,
  7. "total_count": 2
  8. },
  9. "objects": [
  10. {
  11. "audit_status": "approved",
  12. "created_at": 1537924886,
  13. "created_by": "somebody",
  14. "function_code": "exports.main = function functionName(event, callback) {\n callback(null, \"hello world\")\n}",
  15. "id": 1121,
  16. "name": "come_from_open_API_v1.3",
  17. "plan_circle": "P_FREE",
  18. "remark": "你好,云函数",
  19. "updated_at": 1537924886,
  20. "updated_by": ""
  21. },
  22. {
  23. "audit_status": "approved",
  24. "created_at": 1537704269,
  25. "created_by": "somebody",
  26. "function_code": "exports.main = function functionName(event, callback) {\n callback(null, \"hello world\")\n}",
  27. "id": 1102,
  28. "name": "测试",
  29. "plan_circle": "P_FREE",
  30. "remark": "你好,云函数",
  31. "updated_at": 1537704426,
  32. "updated_by": "somebody"
  33. },
  34. ]
  35. }

状态码说明

200: 成功。

获取云函数详细信息

接口地址

GET https://cloud.minapp.com/userve/v1.3/cloud-function/:cloud-function-name/

其中 :cloud-function-name 为云函数的名字。

返回参数说明

参数类型说明
audit_statusString可能的值: approved, rejected, waiting
created_byString创建者昵称
function_codeString云函数代码
idInteger云函数 ID
nameString云函数名
plan_circleString套餐类型
remarkString备注
updated_atInteger最近一次更新时间
updated_byString更新者昵称
created_atInteger创建时间

返回示例

  1. {
  2. "audit_status": "approved",
  3. "created_at": 1535903214,
  4. "created_by": "somebody",
  5. "function_code": "exports.main = function functionName(event, callback) {\n callback(null, \"hello world\") fot debug\n}",
  6. "id": 847,
  7. "name": "test",
  8. "plan_circle": "P_FREE",
  9. "remark": "",
  10. "updated_at": 1537516164,
  11. "updated_by": "somebody"
  12. }

状态码说明

200: 成功。

404: 云函数不存在。

修改云函数

接口地址

PATCH https://cloud.minapp.com/userve/v1.3/cloud-function/:cloud-function-name/

其中 :cloud-function-name 为云函数名字。

请求参数说明

参数类型必填说明
nameString云函数名,不能为空字符串
function_codeString云函数代码,不能为空字符串
plan_circleString套餐类型,可能的值:P_FREE(128 MB 内存), P_PERSONAL(256 MB 内存)
remarkString备注

返回参数说明

参数类型说明
audit_statusString可能的值: approved, rejected, waiting
created_byString创建者昵称
function_codeString云函数代码
idInteger云函数 ID
nameString云函数名
plan_circleString套餐类型,可能的值:P_FREE(128 MB 内存), P_PERSONAL(256 MB 内存)
remarkString备注
updated_atInteger最近一次更新时间
updated_byString更新者昵称
created_atInteger创建时间

返回示例

  1. {
  2. "audit_status": "approved",
  3. "created_at": 1535903214,
  4. "created_by": "somebody",
  5. "function_code": "exports.main = function functionName(event, callback) {\n callback(null, \"hello world\")\n}",
  6. "id": 847,
  7. "name": "modify_from_open_api",
  8. "plan_circle": "P_FREE",
  9. "remark": "",
  10. "updated_at": 1537710962,
  11. "updated_by": "somebody"
  12. }

状态码说明

202: 修改成功。

400: 参数不合法:云函数名或代码为空。

删除一个云函数

接口地址

DELETE https://cloud.minapp.com/userve/v1.3/cloud-function/:cloud-function-name/

其中 :cloud-function-name 是云函数的名字。

状态码说明

204: 删除成功。

404: 没有找到对应的云函数。