函数计算是天翼云提供的一项事件驱动的全托管计算服务。通过函数计算,开发者们不再需要购买、配置和维护基础设施,只需要实现业务函数代码并上传。函数计算会以弹性的、可靠的方式运行代码,且用户只需要按照资源使用量进行按需计费。

函数计算是天翼云提供的一项事件驱动的全托管计算服务。通过函数计算,开发者们不再需要购买、配置和维护基础设施,只需要实现业务函数代码并上传。函数计算会以弹性的、可靠的方式运行代码,且用户只需要按照资源使用量进行按需计费。

工作流程 为了顺利使用函数计算服务，您需要按照以下步骤操作： 1. 开通服务：首先，您需要注册天翼云账号并按照指引开通函数计算服务，具体步骤请参考新手入门。 2. 编写应用：开发者使用合适的编程语言编写函数应用，天翼云函数计算支持的开发语言参考代码开发概述。 3. 上传应用：将开发完成的应用上传至函数计算平台，以便进行部署和后续的执行。 4. 触发执行：函数可以通过事件触发执行。函数计算能够根据请求量自动进行扩缩容，这一过程对用户完全透明。 5. 计费结算：费用将根据函数的实际执行时长和资源使用量进行结算，更多计费信息请参考计费概述。 使用方式 您可以通过函数计算控制台 提供的Web界面，通过控制台可以方便地访问和管理函数计算的各项功能。有关如何快速创建函数的详细步骤和指引，请参考新手入门。 多语言支持 当前支持Python、Java、Go、Node.JS、PHP、C等。 产品计费 关于函数计算 的计费详情，请参见计费概述。

本文主要介绍函数计算的产品计费FAQ。 如何释放函数计算实例或者停止函数计算服务？ 当您需要停止函数计算服务时，您可以直接删除函数。具体请参考函数删除。 账号欠费了不想继续使用函数计算服务，如何退订服务？ 如您不需要再使用函数计算，可以直接删除函数，删除所有函数后将不再进行计费，无需退订服务。 函数已经没有任何请求了，为什么仍然在扣费？ 检查您是否使用了预留模式的实例。若您使用了预留模式下，函数执行时长的计量是从函数计算系统启动预留函数实例开始，到您主动释放为止。因此，如您无需再使用，请及时删除预留模式的实例。另外，您还需要排查一下账号下面是否存在其他云产品的实例导致扣费。

函数计算接收异步调用请求后，将请求持久化后会立即返回响应，无需等待请求执行完成。如需要保留执行失败且超过最大重试次数被丢弃的请求，或通知下游异步调用结果，可以通过配置结果回调功能实现。配置异步目标服务后，异步调用请求执行完成，函数计算根据执行结果自动回调对应的服务。 功能原理 结果回调流程如下图所示。 适用场景 保存丢弃的事件供后续使用 当异步请求执行失败，并且按照指定的策略重试后仍然失败，函数计算将丢弃该请求。如果配置了失败目标，函数计算将自动把失败请求的上下文信息推送到另一个函数，执行自定义的错误处理逻辑。 自动通知下游服务执行结果 请求执行成功后，如果配置了成功目标，函数计算系统会自动将成功请求的上下文信息推送到下游目标服务。 支持的异步调用目标服务 当为函数配置了异步调用目标，并且异步调用后的结果符合条件时，函数计算会将请求上下文和数据推送至对应服务。可以针对不同函数、别名和版本配置不同的目标服务。目前支持的异步调用目标服务只有函数计算。 异步调用目标服务的配置说明如下： 异步调用目标的事件内容 函数计算作为函数异步调用目标时，事件内容示例如下。 bash { "timestamp": 1660120276975, "requestContext": { "requestId": "xxx", "host": "xxx.fchuadong1.ctyun.cn", "uri": "/abc/def", "approximateInvokeCount": 3 }, "requestPayload": "", "responseContext": { "statusCode": 200, }, "responsePayload": "" } 参数 说明 timestamp 调用时间戳。 requestContext 请求上下文。 requestContext.requestId 异步调用的请求ID。 requestContext.host 异步执行的函数域名。 requestContext.uri 异步执行的函数uri。 requestContext.approximateInvokeCount 异步调用的执行次数。当该值大于1时，说明函数计算对您的函数进行了重试。 requestPayload 请求函数的原始负载。 responseContext 返回上下文。 responseContext.statusCode 调用函数的返回码。 responsePayload 执行函数返回的原始负载。 避免循环调用 当您在配置异步执行目标时，请务必保证不要出现循环调用的情况。例如，您为函数A配置了成功调用时的异步目标为函数B，为函数B配置了成功调用时的异步目标为函数A。当您异步触发函数A并且执行成功后，则可能出现A到B，再到A的循环调用的情况。

在使用函数计算提供的日志、VPC、异步调用目标服务等功能时，函数计算需要访问其他的云服务。例如配置函数日志时，用户需要授权函数计算对指定日志的Logstore的写入权限，才能够将函数日志写入Logstore。函数计算支持服务内联委托，用户授权后，创建的函数默认将使用服务内联委托，函数不需要配置委托即可使用日志、VPC、异步调用目标服务等功能。而用户代码逻辑如果需要访问其他云服务，或需要更细粒度的授权，可以选择使用函数委托来授权。 功能原理 函数计算根据函数配置的委托，通过AssumeUserID获取一个临时密钥（STS Token）。然后通过环境变量将临时密钥传递给您的函数。此临时密钥包含了您所配置的权限的所有资源，您可以在函数代码中使用其访问其他天翼云服务。 临时密钥的有效期为36小时，且不支持修改。函数的最大执行时间为24小时，因此，执行函数过程中，临时密钥不会过期。

如何开通函数计算？ 进入天翼云函数计算产品首页，点击【服务开通】根据页面指引进行开通即可；更多详情请参考新手入门。 如何停止函数计算服务？ 当您需要停止函数计算服务时，您可以直接删除函数；具体请参考删除函数。 账号欠费了不想继续使用函数计算服务，如何退订服务？ 如您不需要再使用函数计算，可以直接删除函数，删除所有函数后将不再进行计费，无需退订服务。 函数已经没有任何请求了，为什么仍然在扣费？ 检查您是否使用了预留模式的实例。若您使用了预留模式下，函数执行时长的计量是从函数计算系统启动预留函数实例开始，到您主动释放为止。因此，如您无需再使用，请及时删除预留模式的实例。另外，您还需要排查一下账号下面是否存在其他云产品的实例导致扣费。

AI推理 函数计算在AI推理服务的部署和运维方面提供了显著的优势。 1. 高效运维少干预：函数计算允许AI工程师聚焦于AI模型训练和算法优化，当模型准备完毕时，将其包装成业务函数，即可以利用函数计算的底层基础设施进行AI运算和推理，显著提升开发效率。 2. 弹性高可用：借助函数计算，AI推理能够依据实时请求量动态调整资源，实现毫秒级的快速扩容。这意味着即使面对突发的高并发场景，也能迅速调度成千上万个CPU核心，确保计算资源始终充足，消除算力瓶颈。 3. 稳定高可靠性：函数计算提供了稳定的高可靠性保障，通过多版本管理机制，支持模型的灰度发布，便于执行算法的A/B测试，有效降低了新模型上线的风险。 视频转码 函数计算与函数工作流相结合，为构建Serverless视频处理系统提供了强大的支持，相比传统方案在工程效率、成本和性能等方面都更有优势。 1. 灵活转码：用户可以根据需求完全自定义视频转码函数，实现无缝支持自定义逻辑和特定的转码需求，从而满足多样化的视频处理要求。 2. 高效的并行处理能力：函数计算可以根据视频文件的数量和处理需求自动进行毫秒级的弹性伸缩，实现多个视频文件的同时并行处理，大幅提高视频处理的效率。 3. 成本效益显著：函数计算提供的按需计费模式使得用户只需为实际使用的计算资源付费，这种灵活的计量方式在不同的应用场景下都能带来显著的成本优势。 4. 快速且低成本的迁移：对于已经在虚拟机上部署的基于FFmpeg的视频处理服务，可以直接将相关命令移植到函数计算中，实现服务的快速迁移，迁移成本较低。

本节主要介绍函数计算主要专有名词的基本定义,方便用户更好地理解和使用函数计算。 概览 分类 名称 通用概念 函数、运行时、版本、别名、层、触发器、自定义域名 实例相关 弹性实例、按量模式、预留模式、冷启动 函数调用 同步调用、异步调用 计费相关 按量付费、资源包 函数 函数是函数计算资源调度和运行的最小单位。一般来说，函数包括函数代码和函数配置。函数的相关操作，请参考函数创建、函数配置。 运行时 运行时即特定语言业务函数代码运行依赖的操作系统和编程语言运行环境的总和。函数计算支持丰富的运行时，更多详情，请参考代码开发概述。 版本 版本可以简单理解为函数的快照，除了latest版本，其他版本是不可变的。版本包括函数代码与函数配置，但不包括触发器。更多信息，请参考版本管理。 别名 别名可以理解为指向特定函数版本的指针。别名可以携带业务含义，比数字编码的版本号对业务更友好，可以借此轻松实现发布和回滚。别名也可以指向多个版本以实现灰度发布。更多信息，请参考别名管理。

函数名称 语法 说明 arbitrary函数 arbitrary(x) 返回x中任意一个非空的值。 avg函数 avg(x) 计算x中的算术平均值。 count函数 count()/count()/count(1)count(x) 统计所有的日志条数。统计x中值不为NULL的日志条数。 max函数 max(x) 查询x中的最大值。 maxby函数 maxby(x, y) 查询y为最大值时对应的x值。 min函数 min(x) 查询x中最小值。 minby函数 minby(x, y) 查询y为最小值时对应的x值。 sum函数 sum(x) 计算x的总和。 skewness函数 skewness(x) 计算x的偏度。 kurtosis函数 kurtosis(x) 计算x的峰度。 countif函数 countif(expr) 统计满足指定条件的日志条数。 bitand函数 bitand(x) 返回x中所有值按位与运算的结果。 bitor函数 bitor(x) 返回x中所有值按位或运算的结果。

函数名称 语法 说明 arbitrary函数 arbitrary(x) 返回x中任意一个非空的值。 avg函数 avg(x) 计算x中的算术平均值。 count函数 count()/count()/count(1)count(x) 统计所有的日志条数。统计x中值不为NULL的日志条数。 max函数 max(x) 查询x中的最大值。 maxby函数 maxby(x, y) 查询y为最大值时对应的x值。 min函数 min(x) 查询x中最小值。 minby函数 minby(x, y) 查询y为最小值时对应的x值。 sum函数 sum(x) 计算x的总和。 skewness函数 skewness(x) 计算x的偏度。 kurtosis函数 kurtosis(x) 计算x的峰度。 countif函数 countif(expr) 统计满足指定条件的日志条数。 bitand函数 bitand(x) 返回x中所有值按位与运算的结果。 bitor函数 bitor(x) 返回x中所有值按位或运算的结果。

配置日志 函数计算支持与日志服务进行集成，函数配置日志后，函数计算会自动收集日志，并把日志投递到指定的日志库。您可以在函数计算控制台查看单请求日志、实例日志、函数日志，也可以在日志服务控制台利用日志分析能力对日志进行自定义检索。 背景信息 云日志服务是天翼云提供的日志数据的一站式服务。通过云日志服务存储函数日志，需要在函数中配置日志项目和日志库，函数日志会打印到配置的日志库中。 计费说明 函数计算不会为配置日志功能收取额外的费用，日志投递到日志服务，日志服务会收取相关费用。更多信息，请参见云日志计费概述。 配置日志功能 前提条件 函数计算 创建函数 可选：天翼云日志服务 创建日志项目和日志库 操作步骤 1. 登录函数计算控制台，在左侧导航栏，单击函数。 2. 然后在函数页面，单击目标函数。 3. 在函数详情页面，选择配置 > 日志 ，单击编辑 ，在日志 面板设置以下配置项，然后单击部署 。 配置项 是否必填 说明 日志功能 是 是否启用日志服务，取值说明如下：启用 ：启用后，函数计算会将日志导入到您的日志项目。您可以在函数计算控制台、日志服务控制台查询与检索日志，追踪并定位问题。禁用：不启用日志功能，无法持久化函数日志，无法对问题进行追踪和定位。 配置方式 是 选择自动配置 或自定义配置 。如果选择自定义配置 ，日志项目 和日志库必填。 日志项目 是 指定存储函数调用日志的目标日志项目。 日志库 是 指定存储函数调用日志的目标日志库。 日志分割规则 否 函数计算将按日志分割规则进行切分，切分成多个日志段，并逐条写入日志服务。配置说明如下：默认 ：启用后，将按照日期格式(yyyyMMdd)分割长日志内容，具体来说，如果您的日志中包含多个以特定日期格式（例如 “20240910”）开头的行，当前日期以及下一个日期前的所有内容将作为一条独立日志写入云日志。自定义：选中自定义后，需要配置容器标准输出和文件日志，采集策略：增量/全量：函数计算将按日志分割规则进行切分，切分成多个日志段，并逐条写入日志服务。切割模式支持当行全文，多行全文，json 模式 说明 如果您在创建函数时启用日志功能，函数计算控制台会自动创建以ctyunfcfunction开头的日志项目和该日志项目下的默认日志库functionlog。该日志项目每个地域仅创建一个，不会重复创建，如系统查询到该地域下曾经自动创建过日志项目，将直接使用。 如果您在创建函数时未启用日志功能，更新函数时需要手动选择自定义日志项目和日志库。 控制台会自动启用日志分割规则，并创建查询日志需要的全部索引。

本文将简单介绍如何开通函数计算服务以及快速创建幷测试执行函数。 前提条件 已注册天翼云账号，并完成实名认证 账号可正常使用，未欠费停服 操作步骤 开通函数计算 1. 进入天翼云官网函数计算产品页，点击【开通服务】。 2. 进入函数计算服务开通页面，按页面引导开通函数计算，开通成功后点击进入控制台。 说明 若显示余额不足，请充值至保持余额在100元以上。 3. 若未创建内联委托，点击创建 ，进入函数计算控制台。 创建函数 1. 依次点击 函数 创建函数 ，如图所示。 2. 进入创建函数页面，选择或填写相关数据，如图所示。 字段 用法 校验规则 创建函数的方式 标准运行时：使用内置的运行时和默认的接口定义程序，适用于demo演示或者比较简单的业务场景。自定义运行时：选择某个流行的框架如Flask、SpringBoot等部署函数，适用于Web应用等业务场景。容器镜像：选择某个容器镜像部署函数，适用于应用迁移或者AI模型、GPU应用等业务场景。 函数名称 函数名称是函数的唯一标识，同一个租户，同一个region，函数名称必须保证唯一性。 长度在1~40个字符。只能包含字母、数字、下划线和中划线。只能字母开头。 请求处理程序类型 当选择标准运行时时才有处理事件请求：定义了函数的处理程序是响应某个事件event，具体可以参考示例程序的源码。处理Http请求：定义了函数的处理程序是响应Http请求，具体可以参考示例程序的源码。 运行环境 函数的运行环境或运行时，下拉可以根据实际需求，选择Python, Go, Java, NodeJs等多种运行环境。 代码上传方式 有以下选择：1. 选择示例代码：主要做演示用，使用内置的代码进行函数部署，可以通过阅读源码了解如何写一个简单的函数。2. 通过zip包上传代码：可以参考示例代码的规范写好函数业务代码，把业务代码整个打包为.zip后上传。 更多参数详情见操作指南函数创建。

在函数计算中,资源调度与运行以函数为单位进行,不同函数之间相互独立,互不影响。如果您希望根据函数计算定义的接口来编写程序,可以选择创建标准运行时函数。 创建函数 前提条件 具备已通过实名认证的天翼云账号 已开通函数计算服务 操作步骤 1. 登录函数计算控制台，在左侧导航栏，单击函数，进入函数列表页面。 2. 在函数列表页中，点击创建函数按钮，进入函数创建页面。 3. 在函数创建页面，选择创建函数的方式，并配置以下配置项，然后单击确定。以下操作以使用标准运行时创建函数为例。 基本设置 配置项 说明 函数名称 设置函数名称 请求处理程序类型 请求处理程序类型包括以下两种。 1. 处理事件请求 ：通过定时器、调用API/SDK或其他天翼云服务的触发器来触发函数执行。 2. 处理 HTTP 请求 ：用于处理 HTTP 请求或WebSocket 请求的函数。如果您的使用场景是Web场景，建议您使用自定义运行时进行创建。 企业项目 支持将本次创建的函数上报到用户的企业项目中。若不配置该项，则默认上报到"default"企业项目。 函数代码 配置项 说明 示例 运行环境 选择您熟悉的开发语言，目前支持Python、Java、Go、Node.js、Php、.Net。 Python3.10 代码上传方式 选择代码上传到函数计算的方式。可以选择示例代码或通过 zip 包上传代码。 使用示例代码 示例代码 选择示例代码。 选择内置 python3.10 运行时event 高级配置 配置项 说明 示例 vCPU规格 为函数配置运行vCPU规格。 0.5 核 内存规格 为函数配置运行的内存规格。 512 MB 临时硬盘大小 根据您的业务情况，选择临时存储文件的硬盘大小。 512 MB 实例并发度 支持一个实例同时并发执行多个请求，这个值用来配置单个函数实例可以同时处理多少个请求。 1 执行超时时间 设置函数执行的超时时间。 64 请求处理程序 设置请求处理程序，函数计算的运行时会加载并调用您的请求处理程序处理请求。 index.handler 时区 选择函数的时区。 UTC 函数角色 选择根据函数所在服务配置的角色。 CTyunDefaultRole 允许访问VPC 是否允许函数访问VPC内资源。 否 允许函数默认网卡访问公网 是否允许函数可以通过默认网卡访问公网。关闭后，当前服务中的函数将无法通过函数计算的默认网卡访问公网。 否 说明 vCPU大小（单位为核）与内存大小（单位为GB）的比例必须设置在1:1到1:4之间。 环境变量 设置函数运行环境中的环境变量。可以使用 json 或表单的形式编辑。

可信云服务可以通过IAM委托的方式访问其他云服务的资源。可信实体为天翼云服务的IAM委托，包括普通云服务委托和云服务关联委托。本文介绍函数计算的服务内联委托。 什么是服务内联委托 在某些场景下，函数计算为了完成自身的某个功能，需要获取其他云服务的访问权限，因此，函数计算创建了与云服务内联委托，即服务内联委托CtyunServiceDelegateRoleForFC。函数计算支持CtyunServiceDelegateRoleForFC和FaaS函数的绑定，实现最小授权范围内授予函数访问其他云服务的权限。 使用函数计算时，系统提供的服务内联委托及其包含的系统权限策略如下： 服务内联委托：CtyunServiceDelegateRoleForFC 系统权限策略：CtyunServiceInlineDelegateRolePolicyForFC CtyunServiceDelegateRoleForFC 服务内联委托CtyunServiceDelegateRoleForFC可以获取访函数列表、函数详情、创建函数、删除函数、更新函数以及调用函数的权限。 服务内联委托CtyunServiceDelegateRoleForFC被授予权限策略CtyunServiceInlineDelegateRolePolicyForFC，该权限策略的内容如下。 json { "Version": "1", "Statement": [ { "Action": [ "cf:inst:CreateFunction", "cf:inst:UpdateFunction", "cf:inst:ListFunction", "cf:inst:GetFunction", "cf:inst:InvokeFunction", "cf:inst:DeleteFunction" ], "Resource": "", "Effect": "Allow" } ] } 以下是使用函数计算时，需要创建和使用服务内联委托的场景： 为函数计算配置专有网络VPC、交换机或弹性网卡等，提升数据安全性，实现VPC内的网络互通。 访问容器镜像仓库拉取镜像创建容器镜像函数，能够利用容器镜像资源灵活部署函数。 配置消息队列或事件总线等消息服务的访问权限，使用函数计算监听消息源的事件。当有新的消息或事件产生时，可以直接触发函数执行，实现事件驱动的计算模型。 配置日志服务相关权限，允许自动收集函数执行日志，便于日志的搜索、分析和可视化展示，帮助用户快速定位问题。

本文介绍在函数计算中使用C语言编写函数的运行环境信息。 C运行时 函数计算目前支持的C运行环境如下： 版本 操作系统 架构 .NET Core 8.0 Debian 10 x8664 函数计算为C运行时提供Serverless.Cf依赖库，定义了函数上下文Context对象等信息。

管理任务 函数开启异步任务模式 1. 登录函数计算控制台，在左侧导航栏，单击函数。 2. 在顶部菜单栏，选择地域，然后在函数页面，单击目标函数。 3. 在函数详情页面，选择配置 页签，然后在左侧选择异步配置。 4. 在异步配置页面的异步配置 区域，单击编辑，然后在异步配置 面板，任务模式 选择开启 后单击部署。 启动或停止任务 1. 登录函数计算控制台，在左侧导航栏，单击函数。 2. 在顶部菜单栏，选择地域，然后在函数页面，单击目标函数。 3. 在函数详情页面，选择任务 页签，单击提交任务 ，在弹出的对话框，选择任务ID生成方式和任务执行时间，然后单击确定。 4. 可以在下方任务列表查看任务状态、任务ID、执行时长等。 事件触发 可以通过创建支持异步调用的触发器来触发异步任务，比如日志触发器、对象存储触发器等。 任务防重复提交 为了避免任务重复执行，函数计算支持为每次提交的任务设定全局唯一的任务ID。 函数计算提供任务ID这一任务概念，该ID全局唯一。函数计算会对重复提交的任务进行校验，当有相同任务ID进入系统时，该次请求将认为是重复提交而被拒绝。

函数计算权限管理通过天翼云的访问控制IAM实现。使用访问控制IAM可以让您避免与其他用户共享云账号密钥，即AccessKey（包含AccessKey ID和AccessKey Secret），按需为IAM用户分配最小权限。本文介绍函数计算的权限策略，包括系统策略、自定义策略及自定义策略示例。 策略类型 在访问控制中，权限策略是用语法和结构描述的一组权限的集合，可以精确地描述被授权的Resource（资源集）、Action（操作集）以及授权条件。函数计算包含以下权限策略： 系统策略：统一由天翼云创建，您只能使用不能修改，策略的版本更新由天翼云维护。 自定义策略：您可以自主创建、更新和删除，策略的版本更新由您自己维护。 系统策略 当您首次使用IAM用户登录函数计算控制台时，不仅需要通过天翼云账号给您的IAM用户添加访问函数计算的系统权限策略，也需要给IAM用户添加访问其他云服务的系统权限策略。成功授权后，您的IAM用户才可以正常访问函数计算服务及其他云产品服务。 系统策略包含以下类型： 权限策略名称 描述 CtyunFCReadOnlyAccess 表示允许对函数计算所有的资源进行读操作。 CtyunFCInvocationAccess 表示允许对所有函数的资源进行执行操作。 CtyunFCFullAccess 表示允许对所有函数计算资源进行所有执行操作。 自定义策略 除了函数计算默认提供的系统策略外，您也可以通过自定义策略进行更细粒度的权限管理。 Action Resource 描述 cf:inst:ListFunctions ctrn:cf:{region}:{uid}:functions/ 函数列表 cf:inst:GetFunction ctrn:cf:{region}:{uid}:functions/{functionName} 查询函数 cf:inst:CreateFunction ctrn:cf:{region}:{uid}:functions/{functionName} 创建函数 cf:inst:DeleteFunction ctrn:cf:{region}:{uid}:functions/{functionName} 删除函数 cf:inst:UpdateFunction ctrn:cf:{region}:{uid}:functions/{functionName} 更新函数 cf:inst:InvokeFunction ctrn:cf:{region}:{uid}:functions/{functionName} 调用函数 您可以通过以上自定义的权限策略设置具有调用华东1（杭州）地域下demo函数的权限，具体策略如下所示： json { "Version": "1", "Statement": [ { "Action": [ "fc:InvokeFunction" ], "Resource": "ctrn:cf:{region}:{uid}:functions/demo", "Effect": "Allow" } ] }

补充说明 预留模式下，只要实例未释放，系统都会为其分配资源以保证后台任务正常运行；因此都会进行计费 详细的实例模式，请参考 实例类型及使用模式 计费周期 函数计算平台以每小时为计费周期，每小时计算用户资源用量，推送至费用中心结算费用并生成账单，稍后自动从账户余额中扣除实际消费金额。 欠费说明 系统会在每个计费周期后的一段时间对按需计费资源进行扣费。当您的帐户欠费时，将无法使用函数计算。具体请参考欠费说明 退订说明 如果您不再需要使用函数计算服务，直接删除函数和应用即可释放/销毁函数实例，无需额外退订函数计算服务。

您可以通过事件规则过滤事件，将事件路由到函数计算。本文以自定义事件为例介绍将事件路由到函数计算的前提条件、操作步骤和结果验证。 前提条件 开通事件总线EventBridge并委托授权。 创建自定义总线。 开通函数计算、创建函数。 操作步骤 1. 登录事件总线EventBridge控制台，在左侧导航栏，单击事件总线。 2. 选择目标总线，点击事件源 按钮，点击添加事件源按钮，创建一个自定义事件源；填写事件源名，事件提供方可选择自定义应用。 3. 在左侧导航栏，单击事件规则 ，然后单击添加事件规则。 4. 在创建规则页面，完成以下操作。 1. 在配置基本信息 配置向导页面中，在名称 文本框输入规则名称，在描述文本框输入规则的描述，然后单击下一步。 2. 在配置事件模式配置向导页面中，在事件模式内容代码框输入事件模式，此处可选择匹配全部事件，然后单击下一步。如需了解更多信息，请参见事件模式。 3. 配置事件目标，函数计算目标参数描述如参数说明所示，然后单击创建，如图1所示。 图1 创建事件规则时选择服务类型为函数计算 参数说明 参数 说明 示例 函数 选择函数。 funxxx 函数版本与别名 支持指定函数版本或指定函数别名： 如果您选择指定版本，需要选择函数的具体版本。 如果您选择指定别名，需要选择函数的具体别名。 LATEST 执行方式 选择执行函数的方式：同步或异步。 同步 事件 选择调用到函数的事件内容，更多请参考事件内容转换。 完整事件

函数计算提供了一个统一的执行环境，使得您的函数能够无缝地访问和集成各种云服务和其他资源。 无论是天翼云提供的服务如消息服务、对象存储服务、数据库服务，还是您自建的服务，甚至是调用其他函数计算实例，这些操作在函数内部执行时，与您在本地环境中的操作体验是一致的。 要实现这些服务的访问，您需要确保您的函数代码中包含了必要的依赖库。这些依赖库应当与您的函数代码一起被打包，并上传至函数计算平台。一旦部署完成，您的函数就可以在执行时调用这些依赖库，从而与外部服务进行交互。

本文主要对HCL中常见的函数进行总结并通过样例说明其用法。 HCL支持丰富的内置函数，用于处理字符串、数值计算、加密、类型转换等操作，您可以通过函数名称进行调用，其语法如下： ( , ...) 本文主要对HCL中常见的函数进行总结并通过样例说明其用法。您可以通过Terraform 官方文档 查看完整的函数支持列表。 字符串函数 函数名称 函数描述 样例 运行结果 format 字符串格式化 format("Hello, %s!", "cloud") Hello, cloud! lower 将字符串中的字母转换为小写 lower("HELLO") hello upper 将字符串中的字母转换为大写 upper("hello") HELLO join 使用自定义字符将列表拼接成字符串 join(", ", ["One", "Two", "Three"]) One, Two, Three split 根据分隔符拆分字符串 split(", ", "One, Two, Three") ["One", "Two", "Three"] substr 通过偏移量和长度从给定的字符串中提取一个子串 substr("hello world!", 1, 4) ello replace 把字符串中的str1替换成str2 replace("hello, cloud!", "h", "H") Hello, cloud! 数值计算函数 函数名称 函数描述 样例 运行结果 abs 计算绝对值 abs(12.4) 12.4 max 计算最大值 max(12, 54, 6) max([12, 54, 6]...) 54 54 min 计算最小值 min(12, 54, 6) min([12, 54, 6]...) 6 6 log 计算对数 log(16, 2) 4 power 计算x的y次幂 power(3, 2) 9

本文介绍使用函数计算作为Transform时的背景信息、注意事项及操作步骤。 背景信息 当Transform选择天翼云函数计算时，您可以通过编写函数代码对事件进行更复杂、更加定制化的处理。整体流程如图所示。 1. 源端（Source）拉取事件后，事件会进入Filter阶段。 2. Filter阶段会事件进行判断，决定是否过滤该事件。经过Filter过滤的事件会进入Transform阶段。 3. Transform会对Filter过滤的事件进一步处理，依次调用函数进行处理。 4. Transform调用完函数之后，会将函数返回的内容推送给目标端（Sink）。 前提条件 事件总线EventBridge 开通事件总线EventBridge并委托授权。 函数计算 开通函数计算。 已创建对应函数。 操作步骤 1. 登录事件总线EventBridge控制台。 2. 在左侧导航栏，单击事件流。 3. 在事件流页面，单击创建事件流。 4. 在创建事件流页面，完成以下操作。 1. 在Source（源）配置向导，选择数据提供方及其资源信息，然后单击下一步。更多事件源信息参考事件流事件源。 2. 在Filtering（过滤）配置向导，在事件模式内容代码框输入事件模式，然后单击下一步。 3. 在Transform（转换）配置向导 ，设置事件转换规则，设置选择天翼云服务 为函数计算。 4. 在Sink（目标）配置向导，设置事件目标。更多事件目标信息参考事件流事件目标。 配置方式 参数 说明 绑定现有函数 函数 选择的服务中的函数。 绑定现有函数 版本和别名 选择服务的版本或别名。 5. 创建事件流后，会有30秒~60秒的延迟时间，您可以在事件流页面的状态栏查看启动进度。

函数计算目前提供了标准弹性实例（CPU算力），该实例支持按需模式和预留实例模式。在按需模式下，费用根据函数实例实际运行的时长来计算，而预留实例模式则是从实例启动并准备好执行任务的那一刻起开始计费，直至实例被释放，这种模式有助于减少因冷启动而产生的影响。本文将详细介绍实例的运行模式、计费机制以及可用的实例规格等相关信息。 实例类型 弹性实例（CPU实例）：是函数计算提供的一种标准计算资源，适合处理流量突增和CPU密集计算的场景。 实例模式 弹性实例提供了两种实例模式：按需模式和预留实例模式，下面分别介绍这两种实例模式。 按需模式 基本概念 按需模式是一种由函数计算平台自动管理实例的创建和销毁的模式。平台将依据函数调用的频率自动调整实例的数量，即在请求量上升时自动新增实例，而在请求量下降时自动删除实例。这一过程是完全基于请求自动触发的。当一个实例在一段较短的时间（通常是几分钟）内没有接到任何请求时，它会被系统自动缩容。 注意 在首次执行函数调用时，可能会遇到实例的冷启动过程。 计费方式 在按需模式中，计费开始于函数调用发起、函数实例自动创建并启动任务的时刻，终止于函数实例自动销毁的时刻。在这种模式下，一个实例可以依次处理单一请求，或者同时处理多个并发请求，这取决于设置的实例并发度。有关产品定价和计费详细信息，请参考函数计算计费说明计费概述。 说明 在按需模式下，没有函数调用时不会产生任何费用，只有在函数实际执行调用并启动函数实例时，才会根据使用情况进行计费。

功能 功能描述 监控指标 您可以在函数计算控制台查看资源概览和监控指标，包括地域、服务和函数级别的详细指标信息。 函数指标 函数计算允许用户访问函数级别的监控指标，可以监控函数调用量、函数执行耗时、函数请求错误数、预留实例数等指标。

本文介绍函数计算Node.js运行环境的错误处理相关内容。 抛出异常 如下示例我们在函数中抛出了一个异常。函数计算会捕获到抛出的异常，并生成包含错误信息、类型和堆栈信息的JSON格式数据： exports.handler function(event, context, callback) { throw new Error('trouble now'); }; 调用函数时，会收到如下响应（示例中仅列出了部分堆栈信息）： { "errorMessage": "trouble now", "errorType": "Error", "stackTrace": [ "Error: trouble now", " at handler (file:///code/index.mjs:2:9)", ... ] } 异常退出 如下示例我们在函数中进行异常退出。函数计算会返回一个通用的错误信息： exports.handler function(event, context, callback) { process.exit(1); }; 调用函数时，会收到如下响应： EOF

函数名称 语法 说明 currentdate函数 currentdate() 返回当前日期。同curdate函数。 curdate函数 curdate() 返回当前日期。同currentdate函数。 currenttimestamp函数 currenttimestamp() 返回当前时间。同now函数 toDateTime函数 toDateTime(expr, tz) 将日期和时间表达式转换为datetime类型。 now函数 now() 返回当前时间。同currenttimestamp currenttimezone函数 currenttimezone() 返回当前时区。 date函数 date(expr) 返回日期和时间表达式中的日期部分。 dateformat函数 dateformat(x, format) 将datetime类型的日期和时间表达式转化为指定格式的日期和时间表达式。 tostartofinterval函数 tostartofinterval(x, INTERVAL n interval) 返回指定时间间隔的开始时间 fromunixtime函数 fromunixtime(x) 将UNIX时间戳转化为datetime类型的日期和时间表达式。 unixtimestamp函数 unixtimestamp(x) 将日期和时间表达式转化成UNIX时间戳。 day函数 day(x) 提取日期和时间表达式中的天数，按月计算。同dayofmonth函数。 dayofmonth函数 dayofmonth(x) 提取日期和时间表达式中的天数，按月计算。同day函数。 dayofweek函数 dayofweek(x) 返回日期和时间表达式的周索引。同weekday函数。 weekday函数 weekday(x) 返回日期和时间表达式的周索引。同dayofweek函数。 dayofyear函数 dayofyear(x) 提取日期和时间表达式中的天数，按年计算。 tohour函数 tohour(x) 提取时间表达式的24小时制（023）小时数。同hour函数。 minute函数 minute(x) 提取日期和时间表达式中的分钟数。 month函数 month(x) 提取日期和时间表达式中的月份。 quarter函数 quarter(x) 计算目标日期所属的季度。 hour函数 hour(x) 提取日期和时间表达式中的小时数，按24小时制计算。同tohour函数。 second函数 second(x) 提取日期和时间表达式中的秒数。 week函数 week(x) 计算目标日期是在一年中的第几周。同weekofyear函数。 weekofyear函数 weekofyear(x) 计算目标日期是在一年中的第几周。同week函数。 year函数 year(x) 提取目标日期中的年份。 datetrunc函数 datetrunc(unit, x) 根据指定的时间单位截断日期和时间表达式，并按照毫秒、秒、分钟，小时、日、月或年对齐。 dateadd函数 dateadd(x, INTERVAL n interval) 在x上加上N个时间单位（interval）。同adddate函数。 adddate函数 adddate(x, INTERVAL n interval) 在x上加上N天。同dateadd函数。 converttz函数 converttz(x, tz) 将指定日期时间表达式从一个时区转换为另一个时区，并返回新的日期时间表达式 datesub函数 datesub(date, INTERVAL n interval) 在x上减去N个时间单位（interval）。同subdate函数。 subdate函数 subdate(date, INTERVAL n interval) 在x上减去N个时间单位（interval）。同datesub函数。 localtime函数 localtime() 返回本地时间。同localtimestamp函数。 localtimestamp函数 localtimestamp() 返回本地日期和时间。同localtime函数。 makedate函数 makedate(year, month, day)makedate(x, dayofyear) 根据参数生成日期。 monthname函数 monthname(x) 将日期时间表达式转换为月份名称。

函数名称 语法 说明 currentdate函数 currentdate() 返回当前日期。同curdate函数。 curdate函数 curdate() 返回当前日期。同currentdate函数。 currenttimestamp函数 currenttimestamp() 返回当前时间。同now函数 toDateTime函数 toDateTime(expr, tz) 将日期和时间表达式转换为datetime类型。 now函数 now() 返回当前时间。同currenttimestamp currenttimezone函数 currenttimezone() 返回当前时区。 date函数 date(expr) 返回日期和时间表达式中的日期部分。 dateformat函数 dateformat(x, format) 将datetime类型的日期和时间表达式转化为指定格式的日期和时间表达式。 tostartofinterval函数 tostartofinterval(x, INTERVAL n interval) 返回指定时间间隔的开始时间 fromunixtime函数 fromunixtime(x) 将UNIX时间戳转化为datetime类型的日期和时间表达式。 unixtimestamp函数 unixtimestamp(x) 将日期和时间表达式转化成UNIX时间戳。 day函数 day(x) 提取日期和时间表达式中的天数，按月计算。同dayofmonth函数。 dayofmonth函数 dayofmonth(x) 提取日期和时间表达式中的天数，按月计算。同day函数。 dayofweek函数 dayofweek(x) 返回日期和时间表达式的周索引。同weekday函数。 weekday函数 weekday(x) 返回日期和时间表达式的周索引。同dayofweek函数。 dayofyear函数 dayofyear(x) 提取日期和时间表达式中的天数，按年计算。 tohour函数 tohour(x) 提取时间表达式的24小时制（023）小时数。同hour函数。 minute函数 minute(x) 提取日期和时间表达式中的分钟数。 month函数 month(x) 提取日期和时间表达式中的月份。 quarter函数 quarter(x) 计算目标日期所属的季度。 hour函数 hour(x) 提取日期和时间表达式中的小时数，按24小时制计算。同tohour函数。 second函数 second(x) 提取日期和时间表达式中的秒数。 week函数 week(x) 计算目标日期是在一年中的第几周。同weekofyear函数。 weekofyear函数 weekofyear(x) 计算目标日期是在一年中的第几周。同week函数。 year函数 year(x) 提取目标日期中的年份。 datetrunc函数 datetrunc(unit, x) 根据指定的时间单位截断日期和时间表达式，并按照毫秒、秒、分钟，小时、日、月或年对齐。 dateadd函数 dateadd(x, INTERVAL n interval) 在x上加上N个时间单位（interval）。同adddate函数。 adddate函数 adddate(x, INTERVAL n interval) 在x上加上N天。同dateadd函数。 converttz函数 converttz(x, tz) 将指定日期时间表达式从一个时区转换为另一个时区，并返回新的日期时间表达式 datesub函数 datesub(date, INTERVAL n interval) 在x上减去N个时间单位（interval）。同subdate函数。 subdate函数 subdate(date, INTERVAL n interval) 在x上减去N个时间单位（interval）。同datesub函数。 localtime函数 localtime() 返回本地时间。同localtimestamp函数。 localtimestamp函数 localtimestamp() 返回本地日期和时间。同localtime函数。 makedate函数 makedate(year, month, day)makedate(x, dayofyear) 根据参数生成日期。 monthname函数 monthname(x) 将日期时间表达式转换为月份名称。

本文介绍重试机制以及如何在函数计算控制台配置重试策略。 当函数异步调用执行失败后，函数计算自动进行错误重试。 重试机制 对于常见错误，默认重试3次，可以根据异步调用配置中设置的最大重试次数重试。 配置重试策略 函数计算支持自定义重试次数和消息最大存活时长。 1. 登录函数计算控制台，在左侧导航栏，单击函数。 2. 在顶部菜单栏，选择地域，然后在函数列表页面，单击目标函数。 3. 在函数配置页面，选择配置页签。 4. 在左侧导航栏，选择异步配置 页签，然后在异步配置 区域，单击编辑。 5. 在异步配置 面板，设置以下配置项，然后单击确定。 配置项 解释说明 最大重试次数 用于配置异步调用流程中的消息最大重试次数，取值范围[0,8]。函数计算在默认情况下，对异步触发失败的消息进行3次重试，您可以根据业务需求减少或增加对异步调用的重试。 消息最大存活时长 用于配置异步调用流程中的消息最大存活时长，取值范围[1,2592000]，单位为秒。该时长从触发异步调用时开始计算，到该消息出队准备进行处理为止。如果超过配置的消息最大存活时长，该条消息将被丢弃。 说明 消息最大存活时长默认值为1天。

您可以在函数计算控制台查询函数计算资源概览指标以及资源所在地域、函数维度和实例维度的监控指标详情。具体的监控指标通过指定MetricName参数实现。本文介绍函数计算各类监控指标对应的MetricName参数的取值和含义。 资源概览指标 您可以登录函数计算控制台，在概览 页面的资源使用统计区域，查看资源概览指标的情况。 资源概览指标是您对所有地域或某指定地域内，函数计算整体资源使用情况和网络流量的监控度量。包含的指标项如下表所示，所有指标按一天或一个月粒度统计求和。 指标类型 指标名称 单位 描述 概览 调用次数（Invocations） 次 调用函数的总请求次数。 概览 vCPU使用量（vCPU Usage） vCPU秒 在调用函数时，函数占用的vCPU资源，即函数的vCPU规格×函数执行时间。 概览 内存使用量（MemoryUsage） GB秒 在调用函数时，函数占用的内存资源，即函数内存规格×函数执行时间。 概览 磁盘使用量（DiskUsage） GB秒 在调用函数时，函数占用的磁盘资源，即函数磁盘规格×函数执行时间。 概览 公网出流量（InternetOut） GB 在调用函数时，函数执行在统计时间内的总公网出流量。 概览 GPU使用量（GPU Usage） GB秒 在调用函数时，函数占用的GPU实例资源，即函数GPU规格×函数执行时间。 vCPU使用量 活跃vCPU使用量（Active vCPU Usage） vCPU秒 在调用函数时，函数活跃实例占用的vCPU资源，即函数的vCPU规格×函数执行时间。 vCPU使用量 闲置vCPU使用量（Idle vCPU Usage） vCPU秒 在调用函数时，函数闲置实例占用的vCPU资源，即函数的vCPU规格×实例闲置时间。 GPU使用量 活跃GPU使用量（Active GPU Usage） GB秒 在调用函数时，函数活跃实例占用的GPU实例资源，即函数GPU规格×函数执行时间。 GPU使用量 闲置GPU使用量（Idle GPU Usage） GB秒 在调用函数时，函数闲置实例占用的GPU实例资源，即函数GPU规格×实例闲置时间。

函数计算公共请求头 自定义容器从函数计算中接收到的公共请求头如下表所示。 说明 事件函数和HTTP函数均包含公共请求头Headers。 Header 描述 xfcrequestid Request ID，用于标识一次请求，便于日志追踪，通常是唯一的 xfcreqcosttime 请求耗时 xfcreqarrivetime 请求到达时间 函数计算环境变量 如果您需要访问天翼云其他服务，可以在函数配置 >权限，选择相关的角色，该角色的临时AK，SK会放在环境变量 KEY 描述 FCCTYUNACCESSKEY 如果函数配置了权限，选择的角色的临时AK会放在该环境变量 FCCTYUNSECRETKEY 如果函数配置了权限，选择的角色的临时SK会放在该环境变量 函数日志格式 建议您在创建函数时启用日志功能，自定义运行时函数中所有打印到标准输出（Stdout）的日志会自动收集到您指定的日志服务中。

计费统计粒度 函数计算服务各类型实例运行时长的计费计量粒度如下： 实例类型 按量实例模式 预留实例模式 弹性实例 计费统计粒度为 1 毫秒 计费统计粒度为 10 秒，不足 10 秒的按 10 秒计量； 例如一个预留实例运行时长为 13 秒，则按照 20 秒计量计费 GPU实例 计费统计粒度为 1 秒，不足 1 秒的按 1 秒计量； 例如一个GPU按量实例模式运行时长为 9.5 秒则按照 10 秒计量计费 计费统计粒度为 10 秒，不足 10 秒的按 10 秒计量； 例如一个预留实例运行时长为 13 秒，则按照 20 秒计量计费 实例模式说明 函数计算提供了按量和预留两种实例使用模式，两种模式的执行时长统计方式不同。更多信息详见 实例类型及使用模式。 按量模式：系统自动为函数分配和释放实例，函数执行时长的计量从请求执行函数开始，到请求执行完毕结束。 预留模式：函数实例由您自行分配、释放和管理，函数执行时长的计量从函数计算系统启动预留函数实例开始，到您主动释放为止。 出账周期 函数计算服务用量按小时结算，费用账单出账时间通常在当前计费周期结束后 1 小时左右，具体以费用中心实际出账时间为准。 资源用量费用会自动从您的账户扣款，您可以前往 费用中心 查看账单明细。