函数计算3.0和2.0版本差异及兼容性说明

原有的服务和函数配置等保持不变，调用不受影响。例如，原有的函数配置了单实例多并发可以继续使用，但在函数计算3.0中新创建的标准运行时的函数，无法再配置单实例多并发功能。关于兼容原有的服务和函数的规则，请参见兼容原有的服务和函数。

在函数计算3.0中，可以直接创建函数，不需要先创建服务。原服务级别的配置例如角色、日志配置、VPC配置等，直接在函数级别配置。以Go SDK为例，代码如下：

resp, err := client.CreateFunction(
    new(fc.CreateFunctionRequest).
        SetBody(&fc.CreateFunctionInput{
            FunctionName: &funcName,
            Runtime:      tea.String("nodejs12"),
            Handler:      tea.String("index.handler"),
            MemorySize:   tea.Int32(128),
            Role:         tea.String("role-arn"),
            VpcConfig: &fc.VPCConfig{
                VpcId:           tea.String("vpc-id"),
                VSwitchIds:      []*string{tea.String("vsw-id")},
                SecurityGroupId: tea.String("sg-id"),
            },
            Code: new(fc.InputCodeLocation).SetZipFile(fx.GetCodeZipBase64()),
        }))

event := "my event"
resp, err = client.InvokeFunction(&funcName,
    new(fc.InvokeFunctionRequest).SetBody(strings.NewReader(event)))
body, err := ioutil.ReadAll(resp.Body)

在函数级别发布版本和创建别名，以Go SDK为例，代码如下：

resp, err := client.PublishFunctionVersion(&funcName,
    new(fc.PublishFunctionVersionRequest).SetBody(&fc.PublishVersionInput{
        Description: tea.String("version desc"),
    }))

aliasName := "my-alias"
routingConfig := map[string]*float32{
    "2": tea.Float32(float32(0.05)),
}

resp, err := client.CreateAlias(&funcName, new(fc.CreateAliasRequest).
    SetBody(&fc.CreateAliasInput{
        AliasName:               &aliasName,
        VersionId:               tea.String("1"),
        AdditionalVersionWeight: routingConfig,
    }))

在函数计算3.0中，处理事件请求和处理HTTP请求的函数入口统一。以Python为例，代码如下：

def handler(event, context):
    return 'hello fc'

对于HTTP Trigger调用，即通过HTTP Trigger的URL访问的请求或者通过自定义域名访问的请求，函数计算会将HTTP请求转换成event，同时将函数的响应转换成HTTP响应。

请求event示例如下：

{
    "version": "v1",
    "rawPath": "/my/path",
    "httpMethod": "POST",
    "headers": {
        "header1": "value1,value2",
        "header2": "value2"
    },
    "queryParameters": {
        "param1": "value1,value2",
        "param2": "value2"
    },
    "body": "hello from client",
    "isBase64Encoded": false,
    "requestContext": {
        "accountId": "12345678",
        "domainName": "my-domain.com",
        "domainPrefix": "prefix",
        "requestId": "abcd-efgh",
        "time": "2023-09-01T14:17:23+08:00",
        "timeEpoch": 1693549043255,
        "http": {
            "method": "GET",
            "path": "/my/path",
            "protocol": "http",
            "sourceIP": "39.40.41.42",
            "userAgent": "go-sdk/1.0"
        }
    }
}

HTTP响应示例如下：

def handler(event, context):
    return {
        'body': 'hello FC',
        'headers': {
            'my-custom-header': 'foo'
        },
        'statusCode': 400
    }

以上代码将被转换成如下的HTTP响应：

HTTP/1.1 400 Bad Request
Content-Type: text/plain; charset=utf-8
My-Custom-Header: foo
X-Fc-Request-Id: 64e866c9-69902fbc525fd10989e7299c
Date: Fri, 25 Aug 2023 10:18:06 GMT
Content-Length: 8

hello FC

详细的请求和响应格式转换请参考HTTP触发器概述。

在使用函数计算提供的日志、VPC、异步调用目标服务等功能时，函数计算需要访问其他的云服务。例如配置函数日志时，用户需要授权函数计算对指定日志Logstore的写入权限，函数计算才能够将函数日志写入到用户的Logstore。原来这个授权是通过服务角色进行授权，服务角色一方面用于函数计算访问其他的云服务，另一方面也用于函数执行时用户代码访问其他云服务。这样可能会导致服务角色的权限过大的问题。

在函数计算3.0，函数计算支持了服务关联角色，专门用于授权函数计算访问其他的云服务，而用户代码访问其他云服务，则由函数角色来授权，用户可以根据函数的需要，细粒度地控制函数角色的授权。

在用户一次性授权后，在函数计算3.0创建的函数，默认将使用服务关联角色（SLR）。函数不需要配置角色即可使用日志、VPC、异步调用目标服务等功能。

函数计算3.0提供了一套全新的API和控制台操作界面，针对用户原有的服务和函数，也能够兼容。兼容的规则如下：