---
description: 命名空间和类：tencent.cloud.serverless.functions.Client
---

# create\_layer 方法

## 简要

创建一个新层或已存在层的新版本。

```python
def create_layer(self,
    region_id: str,
    layer_name: str,
    layer_description: str,
    layer_content: LayerContent,
    layer_runtimes: list,
    layer_license: str = None
) -> int
```

## 参数

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

| 参数                 | 类型                                                                                                                           | 必选 | 描述                                                                                                 |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------- | -- | -------------------------------------------------------------------------------------------------- |
| region\_id         | str                                                                                                                          | 是  | <p>创建层的数据中心唯一标识符。</p><p>例如：<code>ap-shanghai</code></p>                                            |
| layer\_name        | str                                                                                                                          | 是  | <p>创建的层的唯一名称。</p><p>例如：<code>default</code></p>                                                    |
| layer\_description | str                                                                                                                          | 是  | <p>创建的层的描述正文。</p><p>例如：<code>default layer</code></p>                                              |
| layer\_content     | [LayerContent](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/class-and-method/layer-content) | 是  | <p>包含创建的层的数据的 LayerContent 实例。</p><p>例如：<code>LayerContent().use_local_zip_archive(...)</code></p> |
| layer\_runtimes    | list                                                                                                                         | 是  | <p>包含创建的层兼容的无服务器云函数运行时名称的列表实例。</p><p>例如：<code>[ FunctionRuntime.Python ]</code></p>                |
| layer\_license     | str                                                                                                                          | 否  | <p>创建的层的许可正文。</p><p>例如：<code>default license</code></p>                                            |

## 返回值

该方法返回可等待操作对象，这将允许您等待层或层版本资源真正地创建完成。返回的可等待对操作对象包含操作结果，其指示新创建的层或层版本的版本编号。

{% content-ref url="../../../other-products/class-and-method/waitable" %}
[waitable](../../../other-products/class-and-method/waitable)
{% endcontent-ref %}

### 兼容性

在 Tencent Cloud SDK for Python 0.1.6 或更低版本中，该方法返回新创建的层或层版本的版本编号。

## 异常

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

#### ValueError

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

#### ActionError

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

## 示例

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

```python
layer_version: int = functions_client.create_layer(
    region_id = 'ap-shanghai',
    layer_name = 'default',
    layer_description = 'default layer',
    layer_content = functions.LayerContent().use_local_zip_archive(
        local_file_path = './layer-data.zip'
    ),
    layer_runtimes = [
        functions.FunctionRuntime.Python,
        functions.FunctionRuntime.Java
    ],
    layer_license = 'default license'
).result
```

## 适用于

#### Tencent Cloud SDK for Python

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