云函数 Python

一、功能特性

Tencentserverless SDK 的功能特性可分为以下几点：

·高性能，低时延的进行函数调用。

·填写必须的参数后，即可快速进行函数间的调用（SDK 会默认获取环境变量中的参数，例如 region，SecretId 等）。

·支持内网域名的访问。

·支持 keepalive 能力。

·支持跨地域函数调用。

·支持 Python 原生调用方式。

注意：函数间调用 SDK 仅适用于事件函数，Web 函数可通过在函数代码中请求 Web 函数对应路径的方式发起调用。

二、示例

1. 在云端创建一个被调用的 Python 云函数，地域为广州，命名为 “FuncInvoked”。函数内容如下：

# -*- coding: utf8 -*-def main_handler(event, context): if 'key1' in event.keys(): print("value1 = " + event['key1']) if 'key2' in event.keys(): print("value2 = " + event['key2']) return "Hello World from the function being invoked" #return

2. 在云端创建调用的 Python 云函数，地域为成都，命名为 “PythonInvokeTest”。可通过以下两种方式，结合你的实际情况编辑 PythonInvokeTest 函数。

·方式 1：如果你不需要频繁的调用函数，可使用如下示例代码：

from tencentserverless import scf from tencentserverless.scf import Clientfrom tencentserverless.exception import TencentServerlessSDKExceptionfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKExceptiondef main_handler(event, context): print("prepare to invoke a function!") try: data = scf.invoke('FuncInvoked',region="ap-guangzhou",data={"a": "b"}) print (data) except TencentServerlessSDKException as e: print (e) except TencentCloudSDKException as e: print (e) except Exception as e: print (e) return "Already invoked a function!" # return

输出结果如下：

"Already invoked a function!"

·方式 2：如果你需要频繁调用函数，可选择通过 Client 的方式连接并触发。可使用如下示例代码：

# -*- coding: utf8 -*-from tencentserverless import scf from tencentserverless.scf import Clientfrom tencentserverless.exception import TencentServerlessSDKExceptionfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKExceptiondef main_handler(event, context): #scf = Client(region="ap-guangzhou") # 使用该方法进行 Client 连接，请在函数配置中启用“运行角色”功能，并选择具有调用函数权限的运行角色。 scf = Client(secret_id="AKIxxxxxxxxxxxxxxxxxxxxxxggB4Sa",secret_key="3vZzxxxxxxxxxxxaeTC",region="ap-guangzhou",token="")# 使用该方法进行 Client 连接，请将 secret_id 和 secret_key 替换为你的 secret_id 和 secret_key，该组密钥需要包含调用函数的权限。 print("prepare to invoke a function!") try: data = scf.invoke('FuncInvoked',data={"a": "b"}) # data = scf.FuncInvoked(data={"a": "b"}) #使用Python原生调用方式，需要首先通过Client进行初始化 print (data) except TencentServerlessSDKException as e: print (e) except TencentCloudSDKException as e: print (e) except Exception as e: print (e) return "Already invoked a function!" # return

输出结果如下：

"Already invoked a function!"

注意：secret_id 及 secret_key：指云 API 的密钥 ID 和密钥 Key。你可以通过登录 访问管理控制台，选择云 API 密钥 > API 密钥管理，获取相关密钥或创建相关密钥。

三、开发准备

·开发环境
已安装 Python2.7 或者 Python3.6。

·运行环境
已安装 tencentserverless SDK，支持 Windows、Linux 和 Mac 操作系统。

注意：本地调用云端函数须进行以上开发准备，推荐函数在本地开发完成后上传到云端，使用云端函数互调进行调试。

四、通过 pip 安装（推荐）

执行以下命令，安装 tencentserverless Python SDK。

pip install tencentserverless

五、通过源码包安装

前往 Github 代码托管地址下载最新源码包，待源码包解压后依次执行以下命令进行安装。

cd tencent-serverless-python-masterpython setup.py install

六、配置 tencentserverless Python SDK

执行以下命令，升级 tencentserverless Python SDK。

pip install tencentserverless -U

执行以下命令，查看 tencentserverless Python SDK 信息。

pip show tencentserverless

七、示例

1. 在云端创建一个被调用的 Python 云函数，地域为广州，命名为 “FuncInvoked”。函数内容如下：

# -*- coding: utf8 -*-def main_handler(event, context): if 'key1' in event.keys(): print("value1 = " + event['key1']) if 'key2' in event.keys(): print("value2 = " + event['key2']) return "Hello World from the function being invoked" #return

2. 创建完毕后，在本地创建一个名为 PythonInvokeTest.py 的文件。内容如下：

# -*- coding: utf8 -*-from tencentserverless import scf from tencentserverless.scf import Clientfrom tencentserverless.exception import TencentServerlessSDKExceptionfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKExceptiondef main_handler(event, context): print("prepare to invoke a function!") scf = Client(secret_id="AKIxxxxxxxxxxxxxxxxxxxxxxggB4Sa",secret_key="3vZzxxxxxxxxxxxaeTC",region="ap-guangzhou",token="")# 替换为你的 secret_id 和 secret_key try: data = scf.invoke('FuncInvoked',data={"a":"b"}) # data = scf.FuncInvoked(data={"a":"b"}) print (data) except TencentServerlessSDKException as e: print (e) except TencentCloudSDKException as e: print (e) except Exception as e: print (e) return "Already invoked a function!" # returnmain_handler("","")

进入 PythonInvokeTest.py 所在文件目录，执行以下命令，查看结果。

python PythonInvokeTest.py

输出结果如下：

prepare to invoke a function!"Hello World form the function being invoked"

八、API Reference

·Client（类）

·invoke （方法）

·TencentserverlessSDKException （类）

九、Client

方法：

·__init__

参数信息：

·invoke

参数信息：

十、invoke

调用函数，暂时只支持同步调用。

参数信息：

十一、TencentserverlessSDKException

属性：

·[code]

·[message]

·[request_id]

·[response]

·[stack_trace]

方法及描述：