Go函数开发指南

函数定义

建议使用Go 1.x版本。

函数有明确的接口定义，如下所示：

func Handler (payload []byte, ctx context.RuntimeContext)

• 入口函数名（Handler）：入口函数名称，需和函数执行入口处用户自定义的入口函数名称一致（首字母必须大写）。
• 执行事件体（payload）： 函数执行界面由用户输入的执行事件参数， 格式为JSON对象。
• 上下文环境（ctx ）：Runtime提供的函数执行上下文，其接口定义在SDK接口说明。

SDK接口

• Context接口

  Context类中提供了许多上下文方法供用户使用，SDK下载地址见表1。其声明和功能如表1所示。

  表1 Context类上下文方法说明

  方法名	方法说明
  GetRequestID() string	获取请求ID。
  GetRemainingTimeInMilliSeconds()	获取函数剩余运行时间。
  GetAccessKey() string	获取用户委托的AccessKey（有效期24小时），使用该方法需要给函数配置委托。 说明： 当前函数工作流已停止维护Runtime SDK 中getAccessKey接口，您将无法使用getAccessKey获取临时AK。
  GetSecretKey() string	获取用户委托的SecretKey（有效期24小时），使用该方法需要给函数配置委托。 说明： 当前函数工作流已停止维护Runtime SDK 中getSecretKey接口，您将无法使用getSecretKey获取临时SK。
  getSecurityAccessKey()	获取用户委托的SecurityAccessKey（有效期24小时），使用该方法需要给函数配置委托。
  getSecuritySecretKey()	获取用户委托的SecuritySecretKey（有效期24小时），使用该方法需要给函数配置委托。
  getSecurityToken()	获取用户委托的SecurityToken（有效期24小时），使用该方法需要给函数配置委托。
  GetUserData(key string) string	通过key获取用户通过环境变量传入的值。
  GetFunctionName() string	获取函数名称。
  GetRunningTimeInSeconds() int	获取函数超时时间。
  GetVersion() string	获取函数的版本。
  GetMemorySize() int	分配的内存。
  GetCPUNumber() int	获取函数占用的CPU资源。
  GetProjectID() string	获取projectID。
  GetPackage() string	获取函数组。
  GetToken() string	获取用户委托的token（有效期24小时），使用该方法需要给函数配置委托。
  GetLogger() context.RuntimeLogger	获取context提供的logger方法（默认会输出时间、请求ID等信息）。

  

  GetToken()、GetAccessKey()和GetSecretKey()方法返回的内容包含敏感信息，请谨慎使用，避免造成用户敏感信息的泄露。

执行结果

执行结果由3部分组成：函数返回、执行摘要和日志。

{
    "errorMessage": "", 
    "errorType":"", 
}