# list\_namespaces 方法

## 简要

获取给定数据中心已创建的命名空间基本信息。

```python
def list_namespaces(self,
    region_id: str
)
```

## 参数

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

| 参数         | 类型  | 必选 | 描述                   |
| ---------- | --- | -- | -------------------- |
| region\_id | str | 是  | 获取的命名空间所在数据中心的唯一标识符。 |

## 返回值

该方法返回一个用于遍历获取命名空间基本信息的生成器实例，生成器实例每次迭代返回包含命名空间基本信息的字典实例，其数据类型为 [NamespaceInfo](https://smallso.gitbook.io/tencent-cloud-sdk/python-docs/serverless-functions/data-types/namespace-info)。

{% hint style="info" %}
该方法在内部维护一个缓冲循环，每次使用 Tencent Cloud API 检索并获取 20 条符合条件的无服务器云函数运行结果。
{% endhint %}

## 异常

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

#### ValueError

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

#### ActionError

Tencent Cloud API 错误。例如访问凭据无效、给定命名空间不存在等均会引发该异常。

## 示例

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

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

## 适用于

#### Tencent Cloud SDK for Python

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