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

# list\_layers 方法

## 简要

获取已创建的所有层的最新层版本信息。

```python
def list_layers(self,
    region_id: str,
    requirement_context: dict = None
)
```

## 参数

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

| 参数                   | 类型   | 必选 | 描述                                                                                                                                          |
| -------------------- | ---- | -- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| region\_id           | str  | 是  | <p>层的数据中心唯一标识符。</p><p>例如：<code>ap-shanghai</code></p>                                                                                       |
| requirement\_context | dict | 否  | 包含层过滤器上下文的字典实例，其数据类型为 [LayerFilter](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/data-types/layer-filter)。 |

## 返回值

该方法返回一个用于遍历获取符合过滤条件的层信息的生成器实例，生成器实例每次迭代返回包含层信息的字典实例，其数据类型为 [LayerInfo](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/data-types/layer-info)。

{% hint style="info" %}
该方法在内部维护一个缓冲循环，每次使用 Tencent Cloud API 检索并获取 20 条符合条件的层信息。
{% endhint %}

## 异常

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

#### ValueError

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

#### ActionError

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

## 示例

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

```python
for layer_info in function_client.list_layers(
    region_id = 'ap-shanghai'
):
    print(layer_info['name'])
```

## 适用于

#### Tencent Cloud SDK for Python

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