# 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


---

# 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/list-layers.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.