# easy\_invoke 方法

## 简要

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

```python
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
```

## 参数

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

| 参数                | 类型   | 必选 | 描述                                                                           |
| ----------------- | ---- | -- | ---------------------------------------------------------------------------- |
| region\_id        | str  | 是  | 调用的无服务器云函数所在数据中心的唯一标识符。                                                      |
| namespace\_name   | str  | 是  | 调用的无服务器云函数所在命名空间的名称。                                                         |
| function\_name    | str  | 是  | 调用的无服务器云函数名称。                                                                |
| function\_event   | dict | 否  | <p>调用的无服务器云函数事件。</p><p>如果该参数被忽略或设置为 <code>None</code>，默认传递空事件。</p>           |
| function\_version | str  | 否  | <p>调用的无服务器云函数版本名称。</p><p>如果该参数被忽略或设置为 <code>None</code>，默认调用最新版本。</p>        |
| function\_async   | bool | 否  | <p>调用的无服务器云函数是否以异步的方式运行。</p><p>如果该参数被忽略或设置为 <code>None</code>，默认以同步方式运行。</p> |

## 返回值

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

{% hint style="info" %}
实际返回值：指给定给定无服务器云函数所运行代码的真实返回值。该方法将尝试推断给定无服务器云函数运行结果中返回值的数据类型，例如给定无服务器云函数返回整形数值，该方法将返回使用 Python 原生数据类型解析包装的 Int 值。
{% endhint %}

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

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

## 异常

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

#### ValueError

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

#### InvokeError

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

#### ActionError

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

## 示例

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

```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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/class-and-method/client/easy-invoke-method.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.