> ## 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.

# Listar balanceadores de carga

> Liste os domínios personalizados da conta e as aplicações de cada um com GET /v2/apps/load-balancers, além do limite de aplicações por domínio do plano.

Agrupa as aplicações da conta pelo domínio personalizado associado. Cada domínio personalizado aparece como um grupo com as aplicações que o atendem; um grupo com duas ou mais aplicações é um balanceador de carga ativo, no qual o tráfego é balanceado entre as aplicações na edge, com failover automático quando uma delas está offline.

Associe o mesmo domínio a várias aplicações com a rota [Configurar domínio personalizado](/pt-br/api-reference/endpoint/apps/network/custom).

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `apps:read`.

Este endpoint lê da mesma lista de projetos em cache usada em outros pontos da API, então ele não chama o provedor de edge e não está sujeito aos limites de taxa de rede por aplicação que restringem [Análise de rede](/pt-br/api-reference/endpoint/apps/network/analytics) e [Erros de rede](/pt-br/api-reference/endpoint/apps/network/errors). Em vez disso, tem limite de 20 requisições a cada 60 segundos por usuário.

`limit` reflete o próprio plano de quem chama (2 no Standard, 5 no Pro, 10 no Enterprise), então verifique-o antes de tentar adicionar outra aplicação a um grupo existente. Associe ou remova aplicações de um domínio com [Configurar domínio personalizado](/pt-br/api-reference/endpoint/apps/network/custom), ou veja todos os hostnames da conta com [Listar domínios](/pt-br/api-reference/endpoint/apps/domains).

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="propriedades" defaultOpen>
    <ResponseField name="limit" type="integer">
      Número máximo de aplicações permitidas em um mesmo domínio para o plano da conta: 2 no Standard, 5 no Pro, 10 no Enterprise.
    </ResponseField>

    <ResponseField name="balancers" type="array">
      Domínios personalizados agrupados por hostname. Array vazio quando nenhuma aplicação possui domínio personalizado.

      <Expandable title="propriedades">
        <ResponseField name="hostname" type="string">
          O domínio personalizado.
        </ResponseField>

        <ResponseField name="apps" type="array">
          Aplicações que atendem este domínio (`id`, `name` e o `cluster` que hospeda cada uma atualmente).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

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

## Relacionados

* CLI: [`squarecloud app load-balancers`](/pt-br/cli-reference/domains#squarecloud-app-load-balancers)
* SDKs: [`api.apps.loadBalancers()`](/pt-br/sdks/js/managing_application) (JavaScript), [`client.apps.load_balancers()`](/pt-br/sdks/py/managing_application) (Python), [`c.Apps.LoadBalancers()`](/pt-br/sdks/go/managing_application) (Go)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.