指导

借助 Tencent Cloud SDK for Python，您可以以面向对象编程的方式使用 Tencent Cloud 产品。

目前，Tencent Cloud SDK for Python 支持以同步或异步的编程方式集成到应用程序中使用，异步编程方式可以编写性能更好的应用程序。下面我们将通过多个连续的代码片段逐步向您演示如何在 Python 应用程序中集成并使用 Tencent Cloud SDK for Python。

无服务器云函数

我们以 Tencent Cloud 产品 无服务器云函数 为例。

假定我们在数据中心 ap-shanghai 拥有一个名为 default 的命名空间，该命名空间中拥有一个名为 hello 的函数。现在我们尝试使用 Tencent Cloud SDK for Python 调用该函数并获得返回值。

导入模块

首先我们需要导入 Tencent Cloud SDK for Python 的相关软件包和模块：

from tencent.cloud.core import errors
from tencent.cloud.auth import credentials
from tencent.cloud.serverless import functions

访问凭据

接着我们需要实例化一个访问凭据，以便于 Tencent Cloud 可以确信您有权访问相关资源并执行操作：

access_credentials = credentials.Credentials(
    secret_id = 'AKIDF3sMOAU1pOgkmrKHchX6TZQ1Mo1C5qa7',
    secret_key = 'b4JL8fwxkIgsKMXGi39yYt0ECxZw4wZf'
)

上文示例代码中给定的参数 secret_id 和 secret_key 为演示凭据，您需要转到 Tencent Cloud 控制台 创建并获取适用于您账户的凭据。

产品客户端

然后我们需要实例化一个 无服务器云函数 产品的抽象产品客户端，以便于我们通过面向对象编程的方式与 无服务云函数 产品交互：

function_client: functions.Client = functions.Client(
    access_credentials = access_credentials
)

参数 credentials_context 要求您提供一个有效的访问凭据，它是可选的。

如果您在 无服务器云函数 产品所创建的函数中使用 Tencent Cloud SDK for Python 且该参数被忽略或设置为 None，Tencent Cloud SDK for Python 将尝试查找并使用环境凭据。

调用函数

最后我们将尝试调用无服务器云函数并获取返回值：

return_value: str = function_client.easy_invoke(
    region_id = 'ap-shanghai',  # Unique identifier of the data center
    namespace_name = 'default', # Name of the namespace
    function_name = 'hello'     # Name of the Cloud Function
)

在以上示例代码中，局部变量 return_value 将拥有无服务器云函数 hello 的实际返回值。

请注意，如果给定的无服务器云函数运行时出错，方法 easy_invoke 将引发 InvokeError 异常，该异常类型在 tencent.cloud.serverless.functions.errors 模块中定义。

如果您正在寻找在无服务器云函数间相互调用的方法，使用 Tencent Cloud SDK for Python 提供的托管式产品客户端或许是一个不错的选择：

return_value: str = functions.invoke('hello')

此时 Tencent Cloud SDK for Python 将代您管理访问凭据和产品客户端，函数 functions.invoke 在内部将调用托管产品客户端实例的 easy_invoke 方法。

参阅 Quick-Start 源代码以获取完整的无服务器云函数产品 Python 示例代码。

其他 Tencent Cloud 产品

对于 Tencent Cloud SDK for Python 未提供抽象产品客户端的 Tencent Cloud 产品，依然可以使用通用客户端直接访问 Tencent Cloud API 并获得结果。

我们以 Tencent Cloud 产品 云服务器 为例。假定我们需要检索数据中心 ap-shanghai 目前正在运营的所有可用区 ID 列表：

导入模块

首先我们需要导入 Tencent Cloud SDK for Python 的相关软件包和模块：

from tencent.cloud.core import errors
from tencent.cloud.core import client
from tencent.cloud.auth import credentials

访问凭据

接着我们需要实例化一个访问凭据，以便于 Tencent Cloud 可以确信您有权访问相关资源并执行操作：

access_credentials = credentials.Credentials(
    secret_id = 'AKIDF3sMOAU1pOgkmrKHchX6TZQ1Mo1C5qa7',
    secret_key = 'b4JL8fwxkIgsKMXGi39yYt0ECxZw4wZf'
)

上文示例代码中给定的参数 secret_id 和 secret_key 为演示凭据，您需要转到 Tencent Cloud 控制台 创建并获取适用于您账户的凭据。

通用客户端

然后我们需要实例化一个通用客户端，以便于我们使用面向对象编程的方式与 云服务器 产品所提供的 Tencent Cloud API 进行交互：

virtual_machine_client: client.UniversalClient = client.UniversalClient(
    product_id = 'cvm',     # Unique identifier of the product
    access_credentials = access_credentials    # Access credentials
)

使用 Tencent Cloud API

最后我们尝试使用 云服务器 产品提供的 Tencent Cloud API - DescribeZones 检索数据中心园区正在运营的所有可用区 ID 列表：

action_result: dict = virtual_machine_client.action(
    region_id = 'ap-shanghai',      # Unique identifier of the data center
    action_id = 'DescribeZones',    # Unique identifier of the Tencent Cloud API
    action_version = '2017-03-12'   # Version name of the Tencent Cloud API
)

请注意，如果给定 Tencent Cloud API 发生错误或对应操作执行失败，方法 action 将引发 ActionError 异常；如果给定 Tencent Cloud API 返回结果不符合预期协定，方法 action 将引发 ActionResultError 异常。这些异常类型在模块 tencent.cloud.core.errors 中定义。

打印数据中心正在运营的所有可用区 ID：

for zone_info in action_result['ZoneSet']:
    print(zone_info['Zone'])

API 文档

在上文中我们通过多个连续的代码片段逐步向您演示 Tencent Cloud SDK for Python 的基本用法。如果您需要获取相关产品客户端或通用客户端的其他用法，请参阅我们的技术文档。

概述

通常情况下，我们会选择最简单、直观的在应用程序源代码中硬编码访问凭据信息，这种方式并不便于访问凭据的管理和定期轮换，也不利于组织复杂的应用程序项目源代码。我们将该方式称之为默认访问凭据类型，其源代码形态通常为：

access_credentials: credentials.Credentials = credentials.Credentials(
    secret_id = 'AKIDF3sMOAU1pOgkmrKHchX6TZQ1Mo1C5qa7',
    secret_key = 'b4JL8fwxkIgsKMXGi39yYt0ECxZw4wZf'
)

在下文中我们将向您介绍 Tencent Cloud SDK for Python 中所支持的其他访问凭据类型，您可以根据应用程序需求选择最佳的实践方式。

种类

环境凭据

环境凭据是指在特定应用程序运行环境中由环境变量所存储的访问凭据信息，Tencent Cloud SDK for Python 支持自动查找并使用有效的环境凭据作为客户端的访问凭据。

环境凭据类型由命名空间和模块 tencent.cloud.auth.credentials 中类 EnvironmentalCredentials 代表，该类的签名如下：

class EnvironmentalCredentials(Credentials)

继承：tencent.cloud.auth.credentials.Credentials 类

当您选择并使用环境凭据时，Tencent Cloud SDK for Python 将尝试在当前运行环境的环境变量中查找默认名为 TENCENTCLOUD_SECRETID 和 TENCENTCLOUD_SECRETKEY 的环境变量值，对应访问凭据的 Secret ID 和 Secret Key 字段。

在下文中我们将通过 Python 代码片段向您演示如何使用环境凭据实例化无服务器云函数产品客户端：

from tencent.cloud.auth import credentials

function_client: functions.Client = functions.Client(
    access_credentials = credentials.EnvironmentalCredentials()
)

如果运行环境中存储访问凭据的环境变量名称与默认查找的环境变量名称不同，您可以手动指定：

from tencent.cloud.auth import credentials

function_client: functions.Client = functions.Client(
    access_credentials = credentials.EnvironmentalCredentials(
        variable_name_of_secret_id = 'MY_SECRETID',
        variable_name_of_secret_key = 'MY_SECRETKEY'
    )
)

现在 Tencent Cloud SDK for Python 将尝试在当前运行环境的环境变量中查找名为 MY_SECRETID 和 MY_SECRETKEY 的环境变量值。

环境凭据支持隐式使用，这意味着若当前应用程序的运行环境符合环境凭据的所有默认行为，您将无需明确指定使用环境凭据：

function_client: functions.Client = functions.Client()

文件凭据

没错，Tencent Cloud SDK for Python 不但支持环境凭据，也支持文件凭据。顾名思义，文件凭据是指将有效的访问凭据信息以 JSON 序列化文本的形式存储在文件上，Tencent Cloud SDK for Python 支持自动查找并使用有效的文件凭据作为客户端的访问凭据。

环境凭据类型由命名空间和模块 tencent.cloud.auth.credentials 中类 FileCredentials 代表，该类的签名如下：

class FileCredentials(Credentials)

继承：tencent.cloud.auth.credentials.Credentials 类

当您选择并使用文件凭据时，Tencent Cloud SDK for Python 将尝试在当前运行目录下查找名为 secret.json 的 JSON 序列化文本文件，其文件内容形态如下：

{
    "secretId": "AKIDF3sMOAU1pOgkmrKHchX6TZQ1Mo1C5qa7",
    "secretKey": "b4JL8fwxkIgsKMXGi39yYt0ECxZw4wZf"
}

其中，JSON 属性 secretId 和 secretKey 分别对应访问凭据的 Secret ID 和 Secret Key 字段。

在下文中我们将通过 Python 代码片段向您演示如何使用文件凭据实例化无服务器云函数产品客户端：

from tencent.cloud.auth import credentials

function_client: functions.Client = functions.Client(
    access_credentials = credentials.FileCredentials('./secret.json')
)

请注意，文件凭据类型与环境凭据类型的实例化默认参数值不同，文件凭据类型实例化时必须明确指定包含访问凭据的 JSON 序列化文本文件的路径。

与环境凭据相同，文件凭据也支持隐式使用，这意味着若当前应用程序的文件环境符合文件凭据的所有默认行为，您将无需明确指定使用环境凭据，Tencent Cloud SDK for Python 将尝试在应用程序当前工作目录下查找名为 secret.json 的 JSON 序列化文本文件：

function_client: functions.Client = functions.Client()

优先级

在上文中我们向您介绍了 Tencent Cloud SDK for Python 最新版本目前已支持的访问凭据类型，如果您决定隐式使用访问凭据类型，Tencent Cloud SDK for Python 将自动根据以下优先级查找：

1. 默认凭据

2. 文件凭据

3. 环境凭据

查找规则为若前一项访问凭据类型已找到，则终止其他类型的访问凭据查找。例如当前应用程序运行环境中同时满足文件凭据和环境凭据，根据访问凭据类型优先级，文件凭据将优先被使用。

建议

根据您的应用场景，Tencent Cloud SDK for Python 建议您选择的访问凭据类型如下：

概述

与传统数据库资源不同，无服务器数据库是一款按需分配资源的数据库产品。无服务器数据库将根据您的请求量、实际存储数据大小来自动分配资源，无需关注底层计算和存储资源，开箱即用，仅需为实际使用的资源量付费。无服务器数据库有哪些优势？

在本文中我们将向您详细介绍，如何使用 Tencent Cloud SDK for Python 提供的无服务器数据库产品客户端以面向对象编程的方式快速创建并管理一个或多个无服务器数据库实例。

指导

在下文中，我们将通过几个连续的步骤向您演示：

创建数据库

导入模块

在创建无服务器数据库资源前，我们需要导入 Tencent Cloud SDK for Python 相关命名空间和模块：

from tencent.cloud.serverless import database

请注意，这需要您的运行环境已安装 tencent-cloud-sdk-serverless-database 组件包，通常情况下该组件包包括在最新的 Tencent Cloud SDK 中。

创建客户端

接着，我们需要创建一个无服务器数据库产品客户端，这将允许我们访问无服务器数据库产品：

client = database.fetch_client()

在上文示例代码中，我们使用 fetch_client 函数获得一个与当前超线程相关的无服务器数据库产品客户端实例。因便捷性和安全性原因，该函数仅支持使用环境凭据和文件凭据：

创建数据库

现在，我们需要在 ap-shanghai-2 数据中心可用区创建一个名为 default 的无服务器数据库实例：

instance_info: dict = client.create_instance(
    region_id = 'ap-shanghai',
    zone_id = 'ap-shanghai-2',
    instance_name = 'default',
    instance_configure = {
        'database': {
            'version': '10.4',
            'charset': database.DatabaseCharset.UTF8
        },
        'vpc': {
            'id': 'vpc-f7qfb64q',
            'subnet_id': 'subnet-aieh8myj'
        }
    }
)

在上文示例代码中，我们创建的无服务器数据库配置如下：

参数 instance_configure 的数据类型为 InstanceConfigure，该数据类型包含所创建的无服务器数据库实例配置信息。

打印唯一标识符

最后，我们打印输出所创建的无服务器数据库实例的唯一标识符：

print(instance_info['id'])

与无服务器数据库实例名称不同，无服务器数据库实例唯一标识符是不可重复的。

列出数据库

借助 Tencent Cloud SDK for Python 所提供的无服务器数据库产品客户端，我们可以非常方便地列出给定数据中心园区内已创建的无服务器数据库实例的详细信息：

for info in client.list_instances('ap-shanghai'):
    print(info)

变量 info 的数据类型为 InstanceInfo，其包含一个无服务器数据库实例的详细信息。

访问数据库

有时候我们的业务或工作负载可能因开发调试等原因，需要通过公网访问无服务器数据库实例。默认设置下无服务器数据库实例不允许通过公网访问，但我们可以轻松改变这一设置：

client.set_instance_extranet(
    region_id = 'ap-shanghai',
    instance_id = instance_info['id']，
    instance_extranet = True
)

在上文示例代码中，参数 instance_extranet 代表给定无服务器数据库实例是否允许通过公网访问，如果该参数被忽略，默认为 True。

设置成功后，您需要通过调用实例方法 list_instances 检索公网访问地址。

删除数据库

一个无服务器数据库实例已不再使用？没关系，我们可以利用 Tencent Cloud SDK for Python 所提供的无服务器数据库产品客户端将其快速删除（销毁）：

client.delete_instance(
    region_id = 'ap-shanghai',
    instance_id = instance_info['id']
)

之后，被删除的无服务器数据库实例资源将在短时间内销毁回收。

什么是 Tencent Cloud SDK？

Tencent Cloud SDK 是面向开发者提供的一套可用于访问 Tencent Cloud API 的 SDK。

借助 Tencent Cloud SDK，您可以以面向对象编程的方式快速、安全地访问 Tencent Cloud API 并将其集成到您的应用程序，而无需关注实现细节。

适用的开发语言

目前 Tencent Cloud SDK 面向以下语言提供开放源代码实现。

Python

还有其他问题？

没关系，您仍然可以从 常见问题 页面寻求问题解答。

如果您的问题未在常见问题页面中列出，您可以通过以下即时通讯平台寻求技术支持。

Tencent QQ

您可以手动检索群组号码 537539545 或导航到 https://jq.qq.com/?_wv=1027&k=57elf7z 加入群组。

Telegram

您可以导航到 https://t.me/tencent_cloud_serverless 加入群组，这通常适用于非中国大陆用户。

法律信息

本网站上包含的商标、Tencent Cloud 和腾讯云字样均由 Tencent Cloud. 所有，版权所有者的联系方式是 https://cloud.tencent.com/act/event/connect-service。

概述

谈论到定时调用无服务器云函数时，或许我们首先想到的是利用无服务器云函数的定时触发器功能来实现。当我们需要在大量不确定个数的指定时间调用无服务器云函数时定时触发器将不能为我们提供便利，因为无服务器云函数的触发器个数受触发器配额限制。

通过借助 Tencent Cloud SDK for Python 的无服务器云函数定时调用机制，我们可以快速在本机运行环境中实现在在多个指定时间调用指定的无服务器云函数并获得运行结果，这也称之为按时间计划调用。

在下文中我们将通过一个简单的应用场景向您进一步介绍并演示如何利用 Tencent Cloud SDK for Python 实现对指定无服务器云函数的本机定时调用。

场景

设定

假定我们在数据中心 ap-shanghai 的命名空间 default 拥有一个已创建就绪的无服务器云函数 hello，其无服务器云函数的配置为：

要求

在该场景中我们要求无服务器云函数 hello 实现发起一个 HTTP 请求到 https://libget.com/hello 并获得响应正文（Body）作为无服务器云函数的返回值。

此外，在本地运行环境创建一个 Python 脚本并实现计划在本机时间的 10 秒后、20 秒后和 30 秒后调用无服务器云函数 hello 并获得无服务器云函数的实际返回值。

指导

在下文中，我们将通过几个步骤向您演示编写符合当前场景要求的代码示例：

编写无服务器云函数

首先，我们需要根据本场景要求编写无服务器云函数 hello 的源代码。

导入模块

为便于发起 HTTP GET 请求，我们采用 Python HTTP 库 requests 实现。

import requests

入口函数

接着，我们需要为无服务器云函数 hello 编写入口函数。

def main(
    event: dict,
    context: dict
) -> str:
    return requests.get('https://libget.com/hello').text

在上文示例代码中，我们导入依赖模块 requests 并使用 requests.get 函数向 https://libget.com/hello 发起 HTTP GET 请求并将响应正文（Body）作为无服务器云函数 hello 的返回值。

编写本地脚本

然后，我们需要根据本场景要求编写一个 Python 脚本并实现计划定时调用无服务器云函数 hello。

导入模块

首先我们需要在无服务器云函数 hello 中导入 Tencent Cloud SDK for Python 相关命名空间和模块：

import time

from tencent.cloud.auth import credentials
from tencent.cloud.serverless import functions

回调函数

为便于获取计划定时调用的无服务器云函数运行结果，我们需要定义一个调用完成后的回调函数。当指定无服务器云函数在指定时间调用并运行完成后，Tencent Cloud SDK for Python 将调用指定回调函数。

def completed_callback(
    function_schedule: functions.FunctionSchedule
):
    # Check if serverless cloud function is called and run successfully
    if not function_schedule.is_successful:
        # Throws an exception thrown by the task
        raise function_schedule.exception   

    # Print the actual return value of the serverless cloud function
    print('info: ' + str(function_schedule.return_value))

入口函数

接着，我们需要为 Python 脚本编写入口函数代码。

def main():
    # Instantiate a serverless cloud function product client
    function_client: functions.Client = functions.Client(
        # Instantiate an access credential
        access_credentials = credentials.Credentials(
            secret_id = 'AKIDF3sMOAU1pOgkmrKHchX6TZQ1Mo1C5qa7',
            secret_key = 'b4JL8fwxkIgsKMXGi39yYt0ECxZw4wZf'
        )
    )

    # Get the current native UNIX timestamp value
    current_unix_timestamp: int = int(time.time())

    # Loop 3 times to create a scheduled invoke task
    for loop_count in range(3):
        function_client.schedule_invoke(
            region_id = 'ap-shanghai',
            namespace_name = 'default',
            function_name = 'hello',
            invoke_timestamp = current_unix_timestamp + ((loop_count + 1) * 10),
            invoked_callback = completed_callback   
        )

    # Run all scheduled tasks until completion
    function_client.run_schedule()

在上文示例代码中我们首先实例化一个无服务器云函数产品客户端和访问凭据，接着获取当前本机 UNIX 时间戳，然后循环 3 次并分别创建相对于前一步获取的本机 UNIX 时间戳的 10 秒、20 秒和 30 秒定时无服务器云函数调用任务，最后运行已创建的所有定时调用任务并等待完成。

值得注意的是上文中示例代码以同步编程方式使用 Tencent Cloud SDK for Python，对于异步编程方式将无需调用无服务器云函数产品客户端实例的 run_schedule 方法，所有已创建的定时调用任务将被 Tencent Cloud SDK for Python 自动调度运行。

运行

最后，我们运行本场景中所创建并编写的本地 Python 脚本，如果一切正常将打印输出：

info: hello libget!
info: hello libget!
info: hello libget!

概述

这是由 Tencent Cloud SDK for Python 的无服务器云函数产品客户端所提供的高级特性，如果您未曾阅读如何选择一个无服务器云函数并获得与之关联的 Python 原生函数的实践文档，请先阅读：

在上篇实践文档中我们得知 Tencent Cloud SDK for Python 的无服务器云函数产品客户端的实例方法 select_function 可以选择一个无服务器云函数并获得与之相关联的 Python 原生函数，通过对 Python 原生函数的调用即为对关联无服务器云函数的调用，从而屏蔽 RPC 感知。

遗憾的是，我们无法控制所获得与无服务器云函数关联的 Python 原生函数的签名和形态，且不能将其集成为类方法或类实例方法。与此同时，我们或许还需要在全局范围内维护一个 Python 原生函数实例。

不过无需担心，Tencent Cloud SDK for Python 的无服务器云函数产品客户端提供了另一种高级特性用于解决上述问题，我们将其称之为绑定到无服务器云函数。

与关联到无服务器云函数的高级特性不同，绑定到无服务器云函数特性使用 Python 高级特性装饰器实现，这意味着开发者可以以更简洁、美观的代码快速集成该特性。什么是 Python 装饰器？

没有理解？没关系，在下文中我们将通过几个简单的应用场景向您进一步说明如何使用绑定到无服务器云函数特性组成您的应用程序代码逻辑。

指导

在下文中我们将列举几段连续的示例代码并向您介绍 Tencent Cloud SDK for Python 的无服务器云函数产品客户端所提供的绑定到无服务器云函数特性的工作流程，我们仍然以无服务器云函数 addend 为例：

导入模块

首先我们需要在应用程序中导入所依赖的 Tencent Cloud SDK for Python 相关命名空间和模块：

from tencent.cloud.auth import credentials
from tencent.cloud.serverless import functions

产品客户端

然后我们需要在应用程序源代码的适合层级实例化一个或多个无服务器云函数产品客户端和访问凭据，在下文中我们将选择 Python 模块全局变量作为适合层级：

function_client: functions.Client = functions.Client(
    access_credentials = credentials.Credentials(
        secret_id = 'AKIDF3sMOAU1pOgkmrKHchX6TZQ1Mo1C5qa7',
        secret_key = 'b4JL8fwxkIgsKMXGi39yYt0ECxZw4wZf'
    )
)

在上文示例代码中，我们所实例化的无服务器云函数产品客户端由 Python 模块全局变量 function_client 存储。

绑定 Python 函数

Python 原生函数可能是我们将应用程序与无服务器云函数相集成的多数选择。

投射函数

我们首先为无服务器云函数 addend 编写在 Python 原生函数的投射：

def addend(
    value1: int,
    value2: int
) -> int:
    raise NotImplementedError

在上文示例代码中，Python 原生函数 addend 将引发 NotImplementedError 异常，该异常指示当前函数逻辑未实现。

绑定函数

接下来我们需要做的是，为无服务器云函数 addend 的 Python 原生投射函数套用一层装饰器：

@function_client.bind_function(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'addend'
)
def addend(
    value1: int,
    value2: int
) -> int:
    raise NotImplementedError

上文示例代码中是 Python 原生投射函数 addend 套用 Python 装饰器后的形态。

运行函数

最后，我们尝试调用在上文示例代码中定义的 Python 原生函数 addend 并获得运行结果：

def main():
    addition_result: int = addend(10, 20)
    print('info: addition result: ' + str(addition_result))

如果一切正常，我们将得到打印输出：

info: addition result: 30

绑定的无服务器云函数 addend 运行事件为：

{
    "value1": 10,
    "value2": 20
}

绑定 Python 类方法

有时或许我们希望使用 Python 类方法或类实例方法与无服务器云函数相集成。

定义实例类

首先我们需要编写一个可实例化的类以演示如何将类方法或类实例方法绑定到无服务器云函数：

class Addition:

    def __init__(self,
        value1: int,
        value2: int
    ):
        self.value1: int = value1
        self.value2: int = value2
    
    def get_result(self) -> int:
        raise NotImplementedError

在上文示例代码中，我们定义了符号名为 Addition 的实例类。该类拥有一个实例方法 get_result 用于计算类属性 value1 和 value2 的相加值。

绑定方法

接着，我们需要将实例类 Addition 的实例方法 get_result 绑定到无服务器云函数 addend 以实现加法运算功能。套用装饰器后的实例类形态如下：

class Addition:

    def __init__(self,
        value1: int,
        value2: int
    ):
        self.value1: int = value1
        self.value2: int = value2
    
    @function_client.bind_function(
        region_id = 'ap-shanghai',
        namespace_name = 'default',
        function_name = 'addend',
        include_attributes = [
            'value1',
            'value2'
        ]
    )
    def get_result(self) -> int:
        raise NotImplementedError

在上文示例代码中我们额外使用了一个在绑定 Python 函数时未使用也不受支持的装饰器参数 include_attributes。该参数允许提供一个列表实例，列表实例的成员为需要从当前所绑定类方法或类实例方法的类实例或静态类中所额外包含的公开属性名称。

被装饰器参数 include_attributes 包含的类公开属性名和值将作为绑定的无服务器云函数运行时事件的字段名称和值，被绑定的类方法或类实例方法的参数也将包括在其中，这与是否使用并设置装饰器参数 include_attributes 的值无关。

运行方法

最后，我们尝试实例化一个 Addition 类并调用其实例方法 get_result 获得加法运算结果：

def main():
    addition_result: int = Addition(10, 20).get_result()
    print('info: addition result: ' + str(addition_result))

如果一切正常，我们将得到打印输出：

info: addition result: 30

绑定的无服务器云函数 addend 运行事件为：

{
    "value1": 10,
    "value2": 20
}

探究

或许您已经注意到，使用 Tencent Cloud SDK for Python 的无服务器云函数产品客户端所提供的绑定到无服务器云函数高级特性时，调用被绑定的函数、类方法或类实例方法支持顺序参数和关键字参数，与 Python 原生函数、类方法或类实例方法的参数传递规则一致。

这是因为 Tencent Cloud SDK for Python 在实现过程中使用 Python 反射（自省）高级特性实现对被绑定可调用对象的参数名称的检查。

概述

通常情况下，我们可能需要在一个无服务器云函数中依赖另一个或多个无服务器云函数。通过在无服务器云函数中集成并使用 Tencent Cloud SDK for Python，无服务器云函数间调用将非常易于实现。

在下文中我们将通过一个简单的应用场景向您进一步介绍并演示如何使用 Tencent Cloud SDK for Python 快速实现在无服务器云函数之间相互调用。

场景

设定

假定我们在数据中心 ap-shanghai 的命名空间 default 中拥有 2 个已创建就绪的无服务器云函数，其名称分别是 hello 和 addend。这些无服务器云函数的配置如下：

要求

在该场景中，我们要求在无服务器云函数 hello 中以友好且可供人类直接阅读的字符串返回一次加法运算的结果，其加法运算过程要求在无服务器云函数 addend 中实现。

指导

在下文中，我们将通过几个步骤向您演示编写符合当前场景要求的代码示例：

编写 addend 函数

首先，我们需要先编写无服务器云函数 hello 的依赖函数 addend 的函数源代码：

def main(
    event: dict,
    context: dict
) -> int:
    try:
        return event['value1'] + event['value2']
    except KeyError as error:
        raise ValueError('event missing field: ' + str(error))

在无服务器云函数 addend 中，我们尝试获取当前函数调用事件中的字段 value1 和 value2 的值，并将字段 value1 和 value2 的值相加后返回，期望相加值类型为整形。

编写 hello 函数

接着，我们需要编写依赖无服务器云函数 addend 的主函数 hello 的函数源代码：

导入模块

首先我们需要在无服务器云函数 hello 中导入 Tencent Cloud SDK for Python 相关命名空间和模块：

from tencent.cloud.serverless import functions

入口函数

接着我们需要为无服务器云函数 hello 编写入口函数。

在入口函数中我们将尝试使用 Tencent Cloud SDK for Python 所提供的无服务器云函数间调用功能调用无服务器云函数 addend 完成一次加法运算并获取结果：

def main(
    event: dict,
    context: dict
) -> str:
    try:
        result: int = functions.invoke('addend', function_event = {
            'value1': 10,
            'value2': 20    
        })
        
        return 'addend result: ' + str(result)
    except functions.errors.InvokeError as error:
        return 'invoke addend function error: ' + str(error)

在无服务器云函数 hello 中，我们尝试使用 Tencent Cloud SDK for Python 函数间调用功能调用无服务器云函数 addend 计算数值 10 和 20 的相加结果并以人类易读的描述性字符串返回。

如果无服务器云函数 addend 运行出错，则返回错误原因的描述性字符串。

运行

现在我们尝试运行无服务器云函数 hello，如果一切正常其运行结果为：

"addend result: 30"

探究

在上文的演示代码中我们导入 Tencent Cloud SDK for Python 的无服务器云函数产品软件包，使用 functions.invoke 函数完成无服务器云函数之间相互调用的工作。

您或许已经注意到，无服务器云函数间调用的方式不需要您维护一个访问凭据和无服务器云函数产品客户端实例，这是因为 Tencent Cloud SDK for Python 的无服务器云函数间调用机制已代您维护一个有效的临时访问凭据和产品客户端实例。

当您初次使用 functions.invoke 或 functions.invoke_async 函数时，Tencent Cloud SDK for Python 会尝试在内部实例化一个无服务器云函数产品客户端并搜寻采用非持久环境凭据。

当无服务器云函数已配置具有有效访问权限的 运行角色 时，其函数在运行代码之前将自动申请并获得一个非持久性的临时访问凭据并将其存储在当前运行环境的环境变量中，这就是环境凭据的由来。

并且，函数 functions.invoke 或 functions.invoke_async 在内部将依赖无服务器云函数产品客户端的 easy_invoke 实例方法，其具有与依赖方法相同的行为和返回值。

因此，无服务器云函数间调用机制并非真正地脱离无服务器云函数产品客户端，只是 Tencent Cloud SDK for Python 为开发者提供更佳便利的封装调用机制。

前提

阅读 Tencent Cloud SDK for Python 技术文档之前，强烈建议您先阅读入门文档。

异步

Tencent Cloud SDK for Python 建立在全异步 API 支持的基础之上，这意味着所有 API 均以异步编程方式编写。不过，我们仍为同步编程方式提供兼容 API 支持，这些适用于同步编程方式的兼容 API 将在内部调用其适用于异步编程方式的 API 版本。

例如我们在无服务器云函数产品客户端中使用的方法 easy_invoke，其具有适用于同步和异步编程方式共 2 个 API 版本，其方法符号名分别为：

• 同步编程方式：easy_invoke

• 异步编程方式：easy_invoke_async

在 API 文档中我们将以便于理解的同步编程方式向您介绍和演示，其适用于异步编程方式的 API 版本在行为和参数定义上与适用于同步编程方式的 API 版本一致。

建议

Tencent Cloud SDK for Python 面向开发者提供低级 API 和高级 API。除非必要或拥有 API 文档的兼容性承诺，否则您应该始终使用高级 API 编写应用程序。

低级 API 通常是 Tencent Cloud SDK for Python 为面向内部高级 API 实现提供的底层 API 实现，低级 API 签名和行为可能会因 Tencent Cloud SDK for Python 的版本更新而改变甚至废止、删除，这将导致依赖低级 API 的应用程序无法在集成更高版本的 Tencent Cloud SDK for Python 时正确工作。

例如高级 API 方法 tencent.cloud.core.client.UniversalClient.action 在内部调用低级 API 方法 tencent.cloud.core.client.BaseClient._request_action_async 以实现对 Tencent Cloud API 的调用并获得结果。

Tencent Cloud 产品

目前 Tencent Cloud SDK for Python 面向以下 Tencent Cloud 产品提供抽象的产品客户端：

无服务器云函数

其他 Tencent Cloud 产品

您需要集成并使用的 Tencent Cloud 产品未列出？没关系，您仍然可以使用 Tencent Cloud SDK for Python 提供的通用客户端直接快速、安全地访问 Tencent Cloud API 并获得结果，Tencent Cloud SDK for Python 将代您管理 Tencent Cloud API 身份验证和签名、底层互联网通信和请求与响应解析等实现细节：

简要

调用给定无服务器云函数并获得无服务器云函数的实际返回值。

def easy_invoke(self,
    region_id: str,
    namespace_name: str,
    function_name: str,
    function_event: dict = None,
    function_version: str = None,
    function_async: bool = False
) -> object

参数

该方法的参数和参数描述如下：

返回值

该方法返回值取决于参数 function_async 的值。如果该参数设置为 False，该方法返回给定无服务器云函数调用结果中的实际返回值；如果该参数设置为 True，该方法返回用于标识给定无服务器云函数调用的唯一标识符（Request ID）字符串。

请注意，如果以异步编程方式使用该方法，且参数 function_async 被设置为 True，该方法将返回代表给定无服务器云函数未来实际返回值的 FunctionResultFuture 类实例。

返回的 FunctionResultFuture 实例支持使用 await 关键字等待给定无服务器云函数本次调用的实际返回值。

异常

该方法可能会主动引发以下异常：

ValueError

参数值或类型不符合预期。

InvokeError

给定无服务器云函数在调用过程中遇到错误，这通常是由于无服务器云函数所运行的代码存在异常。

ActionError

Tencent Cloud API 错误。例如访问凭据无效、给定无服务器云函数不存在等均会引发该异常。

示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

return_value: int = function_client.easy_invoke(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'addend',
    function_event = {
        'value1': 10,
        'value2': 20
    },
    function_version = '1',
    function_async = False
)

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.1

简要

调用给定无服务器云函数的指定例程，并获取例程的实际返回值。

def routine_invoke(self,
    region_id: str,
    namespace_name: str,
    function_name: str,
    routine_name: str,
    routine_parameter: dict = None,
    function_version: str = None,
    function_async: bool = False
) -> object

参数

该方法的参数和参数描述如下：

返回值

该方法返回给定无服务器云函数的指定例程调用的实际返回值。返回值视参数的值不同而异，详情请参阅方法 easy_invoke 的返回值描述。

异常

该方法可能会主动引发以下异常：

ValueError

参数值或类型不符合预期。

InvokeError

给定无服务器云函数在调用过程中遇到错误，这通常是由于无服务器云函数所运行的代码存在异常。

ActionError

Tencent Cloud API 错误。例如访问凭据无效、给定无服务器云函数不存在等均会引发该异常。

示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

return_value: int = function_client.routine_invoke(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'arithmetic',
    routine_name = 'addend',
    routine_parameter = {
        'value1': 10,
        'value2': 20
    }
)

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.5

概述

这是由 Tencent Cloud SDK for Python 的无服务器云函数产品客户端所提供的高级特性，如果您未曾阅读如何将一个无服务器云函数绑定到 Python 原生同步或异步函数的实践文档，请先阅读：

在上一篇最佳实践中我们得知借助 Tencent Cloud SDK for Python 可以快速实现将一个或多个 Python 原生的同步或异步函数绑定到指定的无服务器云函数，进而以完全 Python 原生调用的形态组织代码以屏蔽或减少开发者对无服务器云函数调用时的 RPC 流程感知。

遗憾的是，该高级特性仅适用于无服务器云函数调用方，而被调用的无服务器云函数依旧需要以传统事件处理的方式组织一个或多个功能的代码实现。当我们在一个无服务器云函数中提供的相关功能较多时，开发者还需要在无服务器云函数执行方法中实现事件解析和派发。

因此，Tencent Cloud SDK for Python 通过提供另外一种高级特性以解决这些问题，我们将其称之为适用于无服务器云函数集成调用的例程派发框架，简称无服务器云函数例程。

与绑定到无服务器云函数的高级特性相同，无服务器云函数例程特性也使用 Python 高级特性装饰器实现，这意味着开发者可以以更简洁、美观的代码快速集成该特性。什么是 Python 装饰器？

没有理解？没关系，在下文中我们将通过几个简单的应用场景向您进一步说明如何使用无服务器云函数例程特性组成您的应用程序代码逻辑。

指导

在下文中我们将列举几段连续的示例代码并向您介绍 Tencent Cloud SDK for Python 所提供的无服务器云函数例程特性的工作流程。

假定我们需要在一个无服务器云函数中实现对加法和减法的算术运算：

无服务器云函数

创建函数

首先我们需要创建一个名为 arithmetic 的无服务器云函数：

编写代码

然后，我们需要为无服务器云函数 arithmetic 编写代码。与以往不同，我们将使用 Tencent Cloud SDK for Python 提供的无服务器云函数例程特性和框架。首先我们需要导入使用的命名空间和模块：

from tencent.cloud.serverless import functions

接着我们需要调用 use_routine_dispatcher 函数为当前无服务器云函数启用例程派发器框架：

dispatcher = functions.use_routine_dispatcher()

在上述代码中，我们得到一个被称之为例程派发器类型的实例并由变量 dispatcher 存储。例程派发器实际上是一个可解析无服务器云函数例程调用协议的路由，每一个例程派发器实例将管理一个或多个已注册的无服务器云函数例程。没有理解？没关系，让我们继续向下阅读。

然后我们需要编写 2 个例程，分别是 addend 和 subtract，分别对应加法和减法的算术运算：

@dispatcher.routine
def addend(
    value1: int,
    value2: int
) -> int:
    return value1 + value2

@dispatcher.routine
def subtract(
    value1: int,
    value2: int
) -> int:
    return value1 - value2

或许您已经注意到，无服务器云函数例程实际上是一个套用例程派发装饰器的一个 Python 原生函数，在上述代码中我们仅需要为 Python 原生函数使用 @dispatcher.routine 装饰器即可将其注册为可调用的无服务器云函数例程。

到此，无服务器云函数 arithmetic 的代码已完成编写。

本地函数

编写代码

在上文中我们已经创建名为 arithmetic 的无服务器云函数，并分别实现适用于加法和减法算术运算的无服务器云函数例程，现在让我们在一个本地函数中调用它们：

首先，我们需要导入所依赖的命名空间和模块：

from tencent.cloud.serverless import functions

接着，我们需要在本地函数的 Python 模块全局获取一个无服务器云函数产品客户端实例：

function_client = functions.fetch_client()

然后，我们需要为无服务器云函数的 addend 和 subtract 分别创建 2 个 Python 原生函数，并将他们分别绑定到对应的无服务器云函数例程：

@function_client.bind_routine('ap-shanghai', 'default', 'arithmetic')
def addend(
    value1: int,
    value2: int
) -> int:
    raise NotImplementedError

@function_client.bind_routine('ap-shanghai', 'default', 'arithmetic')
def subtract(
    value1: int,
    value2: int
) -> int:
    raise NotImplementedError

是的，对无服务器云函数例程的绑定与对无服务器云函数的绑定非常相似。

我们仅需要定义 2 个与无服务器云函数例程签名完全一致的 Python 原生函数，然后为其分别套用 @function_client.bind_routine 装饰器即可。现在对 Python 原生函数 addend 和 subtract 的调用等同于对无服务器云函数 arithmetic 的例程 addend 和 subtract 的调用。

值得注意的是，我们将这些与无服务器云函数例程签名相同的 Python 函数称之为 Python 原生扮演函数。

当然，如果您不希望在应用程序中为每一个无服务器云函数例程编写对应的 Python 原生函数，您可以选择由 Tencent Cloud SDK for Python 代您创建一个与指定无服务器云函数例程相关联的 Python 原生函数：

addend = function_client.seletc_routine('ap-shanghai', 'default',
    'arithmetic', 'addend')
    
subtract = function_client.seletc_routine('ap-shanghai', 'default',
    'arithmetic', 'subtract')

现在，变量 addend 和 subtract 为可调用的 Python 原生函数对象。

调用例程

最后，我们尝试在本地函数中调用无服务器云函数 arithmetic 的例程 addend 和 subtract，并打印输出加法和减法算术运算的结果：

print(addend(10, 20))
print(subtract(30, 20))

请注意，如果您使用方法 seletc_routine 创建无服务器云函数例程的 Python 原生扮演函数，您需要完全使用关键字参数调用，否则 Tencent Cloud SDK for Python 无法确定每个参数对应的位置：

print(addend(
    value1 = 10,
    value2 = 20
))

print(subtract(
    value1 = 30,
    value2 = 20
))

如果您希望在调用无服务器云函数例程时获得 RPC 流程感知，您可以使用方法 routine_invoke ：

打印输出

如果一切正常，您将会在终端看到如下输出：

30
10

简要

将给定无服务器云函数绑定在另一个 Python 原生函数、类方法或类实例方法上。之后对被绑定可调用对象的调用将被重定向为对给定无服务器云函数的调用。

def bind_function(self,
    region_id: str,
    namespace_name: str,
    function_name: str,
    function_version: str = None,
    function_async: bool = False,
    include_attributes: list = None
) -> object

参数

该方法的参数和参数描述如下：

返回值

该方法返回装饰器处理器函数实例。

被绑定可调用对象被调用时将在内部调用方法 easy_invoke 实现对给定无服务器云函数的调用，其被绑定可调用对象的返回值与方法 easy_invoke 的返回值一致。

异常

该方法预期行为不会主动引发任何异常。

示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

@function_client.bind_function(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'addend',
    function_version = '1',
    function_async = False,
    include_attributes = None
)
def addend(
    value1: int,
    value2: int
) -> int:
    raise NotImplementedError

return_value: int = addend(
    value1 = 10,
    value2 = 20
)

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.1

简要

将给定无服务器云函数的指定例程绑定在另一个 Python 原生同步或异步函数上。之后对被绑定的 Python 原生同步或异步函数的调用将被重定向为对给定无服务器云函数例程的调用。

def bind_routine(self,
    region_id: str,
    namespace_name: str,
    function_name: str,
    function_version: str = None,
    function_async: bool = False,
    routine_name: str = None
) -> object

参数

该方法的参数和参数描述如下：

返回值

该方法返回装饰器处理器函数实例。

被绑定的 Python 原生函数被调用时将在内部调用方法 routine_invoke 实现对给定无服务器云函数的调用，其被绑定的 Python 原生函数的返回值与方法 routine_invoke 的返回值一致。

异常

该方法预期行为不会主动引发任何异常。

示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

@function_client.bind_routine(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'arithmetic'
)
def addend(
    value1: int,
    value2: int
) -> int:
    raise NotImplementedError

return_value: int = addend(
    value1 = 10,
    value2 = 20
)

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.5

简要

计划在给定本机 UNIX 时间戳调用给定无服务器云函数。

def schedule_invoke(self,
    region_id: str,
    namespace_name: str,
    function_name: str,
    function_event: dict = None,
    function_version: str = None,
    function_async: bool = False,
    invoke_timestamp: int = None,
    invoked_callback: object = None
) -> FunctionSchedule

参数

该方法的参数和参数描述如下：

返回值

该方法返回代表给定无服务器云函数计划调用任务的 FunctionSchedule 类实例。如果参数 invoked_callback 被设置为有效的函数实例，其函数实例回调时将传入该方法的返回值。

异常

该方法可能会主动引发以下异常：

ValueError

参数值或类型不符合预期。

示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

import time

def schedule_callback(
    schedule_task: functions.FunctionSchedule
):
    if not schedule_task.is_successful:
        raise schedule_task.exception
    
    print(schedule_task.return_value)
    print(schedule_task.result)

schedule_task = function_client.schedule_invoke(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'addend',
    function_event = {
        'value1': 10,
        'value2': 20
    },
    function_version = '1',
    function_async = False,
    invoke_timestamp = int(time.time()) + 5,
    invoked_callback = schedule_callback
)

# schedule_task.cancel()    # Cancel schedule

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.1

简要

选择一个无服务器云函数并返回给定无服务器云函数的 Python 原生函数实例。对该函数实例的调用等同于对给定无服务器云函数的调用，其关键字参数将作为给定无服务器云函数的事件。

def select_function(self,
    region_id: str,
    namespace_name: str,
    function_name: str,
    function_version: str = None,
    function_async: bool = False
) -> function

参数

该方法的参数和参数描述如下：

返回值

该方法返回给定无服务器云函数的 Python 原生函数实例。

返回的函数实例将在内部调用方法 easy_invoke 实现对给定无服务器云函数的调用，其函数实例的返回值与方法 easy_invoke 的返回值一致。

异常

该方法预期行为不会主动引发任何异常。

示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

addend = function_client.select_function(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'addend',
    function_version = '1',
    function_async = False
)

return_value: int = addend(
    value1 = 10,
    value2 = 20
)

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.1

简要

调用给定无服务器云函数并获得无服务器云函数的运行结果。

def create_function(self,
    region_id: str,
    namespace_name: str,
    function_name: str,
    function_description: str,
    function_code: FunctionCode,
    function_runtime: str = 'Python3',
    function_type: str = None,
    function_configure: dict = None
)

参数

该方法的参数和参数描述如下：

返回值

该方法返回可等待操作对象，这将允许您等待无服务器云函数资源真正地创建完成。

兼容性

在 Tencent Cloud SDK for Python 0.1.6 或更低版本中，该方法没有返回值。

异常

该方法可能会主动引发以下异常：

ValueError

参数值或类型不符合预期。

ActionError

Tencent Cloud API 错误。例如访问凭据无效、给定无服务器云函数不存在等均会引发该异常。

示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

function_client.create_function(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'addend',
    function_description = 'Addition function'，
    function_code = functions.FunctionCode().use_object_storage_bucket(
        region_id = 'ap-shanghai-1',
        bucket_id = 'scf-code',
        object_name = 'source.zip'
    ),
    function_runtime = functions.FunctionRuntime.Python,
    function_type = functions.FunctionType.Event,
    function_configure = {
        'handler': 'index.main',
        'memory_size': 128,
        'time_out': 3
    }
)

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.6

简要

选择一个给定无服务器云函数的指定例程并返回给定无服务器云函数例程的 Python 原生函数实例。对该函数实例的调用等同于对给定无服务器云函数例程的调用，其关键字参数将作为给定无服务器云函数例程的关键字参数。

def select_routine(self,
    region_id: str,
    namespace_name: str,
    function_name: str,
    routine_name: str,
    function_version: str = None,
    function_async: bool = False
)

参数

该方法的参数和参数描述如下：

返回值

该方法返回给定无服务器云函数例程的 Python 原生函数实例。

返回的函数实例将在内部调用方法 routine_invoke 实现对给定无服务器云函数例程的调用，其函数实例的返回值与方法 routine_invoke 的返回值一致。

异常

该方法预期行为不会主动引发任何异常。

示例

下面我们将通过一段 Python 代码向您演示如何使用该方法：

addend = function_client.select_routine(
    region_id = 'ap-shanghai',
    namespace_name = 'default',
    function_name = 'arithmetic',
    routine_name = 'addend'
)

return_value: int = addend(
    value1 = 10,
    value2 = 20
)

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.5

简要

代表无服务器云函数产品客户端的类。利用该类，您可以以同步或异步面向对象编程的方式快速、安全地与无服务器云函数产品交互。

class Client(client.AbstractClient)

继承：tencent.cloud.serverless.functions.client.AbstractClient 类

兼容性

从产品软件包 tencent-cloud-sdk-serverless-functions 的 0.1.3 版本开始，无服务器云函数产品客户端类型将不再继承自 BaseClient，而是 UniversalClient。

• tencent.cloud.serverless.functions.Client 类

  • tencent.cloud.serverless.functions.client.AbstractClient 类

    • tencent.cloud.core.client.UniversalClient 类

      • tencent.cloud.core.client.BaseClient 类

构造

该类仅支持构造类实例后使用，构造实例方法继承自父类，其构造实例方法签名如下：

def __init__(self,
    access_credentials: credentials.Credentials = None,
    access_proxies: proxies.Proxies = None
)

构造实例方法参数和参数描述如下：

兼容性

请注意，对于 Tencent Cloud SDK for Python 0.1.3 或更低版本，参数名称为：

值得注意的是，旧版本除参数名称不同外，与新版本中的参数数据类型和行为是一致的。

属性

该类型的实例包含可被公开访问的属性有：

兼容性

该类型部分可被公开访问的属性可能需要最新的 Tencent Cloud SDK for Python 版本：

示例

在下文中我们将向您演示如何构造一个无服务器云函数产品客户端类实例：

from tencent.cloud.auth import credentials
from tencent.cloud.serverless import functions

# Please replace with your access credentials

access_credentials = credentials.Credentials(
    secret_id = 'AKIDF3sMOAU1pOgkmrKHchX6TZQ1Mo1C5qa7',
    secret_key = 'b4JL8fwxkIgsKMXGi39yYt0ECxZw4wZf'
)

function_client: functions.Client = functions.Client(
    access_credentials = access_credentials,
    access_proxies = None
)

适用于

Tencent Cloud SDK for Python

产品软件包：tencent-cloud-sdk-serverless-functions >= 0.1.3

Tencent Cloud SDK for Python 是面向 Python 推出的 Tencent Cloud SDK 开放源代码实现。

借助 Tencent Cloud SDK for Python，您可以以面向对象编程的方式快速访问 Tencent Cloud API 并将其集成到您的应用程序，而无需关注实现细节。

Features Tencent Cloud SDK for Python 支持全异步编程方式。