> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 列出负载均衡器

> 列出账户的自定义域名负载均衡器。速率限制为每 60 秒 20 次请求。

按绑定的自定义域名对账户的应用进行分组。每个自定义域名都会作为一个分组出现，包含服务于该域名的应用；包含两个或更多应用的分组即为一个活跃的负载均衡器，流量会在边缘于这些应用之间进行均衡，并在某个应用离线时自动进行故障转移。

使用 [设置自定义域名](/zh/api-reference/endpoint/apps/network/custom) 路由将同一域名绑定到多个应用。

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  你账户的 API 密钥。你可以在[账户设置](https://squarecloud.app/zh/account/security)中找到它。
</ParamField>

### 响应

<ResponseField name="status" type="string">
  指示调用是否成功。成功时为 `success`，否则为 `error`。
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="properties" defaultOpen>
    <ResponseField name="limit" type="integer">
      该账户套餐允许在一个域名上绑定的最大应用数量：Standard 为 2，Pro 为 5，Enterprise 为 10。
    </ResponseField>

    <ResponseField name="balancers" type="array">
      按主机名分组的自定义域名。当没有任何应用拥有自定义域名时为空数组。

      <Expandable title="properties">
        <ResponseField name="hostname" type="string">
          自定义域名。
        </ResponseField>

        <ResponseField name="apps" type="array">
          服务于此域名的应用（`id`、`name`，以及当前托管每个应用的 `cluster`）。
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "limit": 2,
      "balancers": [
        {
          "hostname": "example.com",
          "apps": [
            { "id": "abc123def456abc123def456", "name": "web-1", "cluster": "suki-cluster" },
            { "id": "def456abc123def456abc123", "name": "web-2", "cluster": "nasa-cluster" }
          ]
        }
      ]
    }
  }
  ```
</ResponseExample>