# invoke 方法

## 简要

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

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

## 参数

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

| 参数                | 类型   | 必选 | 描述                                                                           |
| ----------------- | ---- | -- | ---------------------------------------------------------------------------- |
| 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> |

## 返回值

返回包含给定无服务器云函数运行结果的字典实例，其数据类型为 [FunctionResult](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/data-types/function-result)。

## 异常

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

#### ValueError

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

#### InvokeError

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

#### ActionError

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

#### ActionResultError

Tencent Cloud API 返回结果是非预期的，该异常通常情况下不会引发。

## 示例

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

```python
return_result: str = function_client.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/invoke.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.