---
title: "GET | Listar todas as políticas de acesso de um grupo de usuários"
slug: "api-v2-get-list-user-group-access-policies"
updated: 2026-11-06T18:57:02Z
published: 2026-11-06T18:57:02Z
canonical: "docs.senhasegura.io/api-v2-get-list-user-group-access-policies"
---

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

# GET | Listar todas as políticas de acesso de um grupo de usuários

## Descrição

Liste as políticas de acesso vinculadas a um grupo de usuários. A resposta é paginada, e cada linha informa a política vinculada, o perfil que o vínculo concede, seu nível de aprovação e quem o criou.

Um vínculo é o que conecta os membros do grupo a uma política de acesso PAM. Para as políticas em si, acesse [GET | Listar todas as políticas de acesso](/v4-2/docs/pt/api-v2-get-list-all-access-policies).

A listagem retorna apenas os vínculos com políticas de acesso PAM liberadas para a autorização da aplicação no A2A. A regra também vale para uma autorização com o **Super admin** habilitado. Vínculos com qualquer outra política de acesso ficam fora de `data`, inclusive os criados na tela de grupo de usuários. Eles não são contados em `total_items`. Se a aplicação não tiver uma autorização ativa no A2A, a lista vem vazia.

---

## Pré-requisitos

- Uma aplicação com a autorização **Users** concedida pelo administrador no A2A. Para mais informações, acesse [Como gerenciar autorizações no A2A API v2](/v4-2/docs/pt/api-v2-how-to-manage-authorizations-in-a2a).
- Um token de acesso OAuth 2.0 válido. Para mais informações, acesse [Como autenticar uma aplicação A2A](/v4-2/docs/pt/how-to-authenticate-an-application-in-a2a).
- As políticas de acesso a listar devem ser políticas de acesso PAM liberadas para a autorização da aplicação no A2A. Para mais informações, acesse [Como gerenciar autorizações no A2A API v2](/v4-2/docs/pt/api-v2-how-to-manage-authorizations-in-a2a).

---

## Requisição

`GET` `/api/v2/iam/user-groups/{id}/access-policies`

### Parâmetros de path

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | integer | Sim | Código de identificação único do grupo de usuários. |

### Parâmetros de query

| Parâmetro | Tipo | Descrição |
| --- | --- | --- |
| `page` | integer | Número da página, indexado a partir de 1. O padrão é `1`. |
| `limit` | integer | Tamanho da página. O padrão é `50`, limitado ao máximo de `200` definido para toda a plataforma. |

---

### Exemplo de requisição

`GET` `{{url}}/api/v2/iam/user-groups/7/access-policies?page=1&limit=50`

---

## Resposta

```
HTTP/1.1 200 OK
X-Request-Id: 7f3c1a90-2c4e-4b1a-9f5e-0a2b7c9d1e34
```

### Exemplo de corpo de resposta

```
{
  "data": [
    {
      "id": "200",
      "access_group": {
        "id": "1",
        "name": "Linux Servers"
      },
      "profile": "user",
      "level": 1,
      "added_by": "admin",
      "added_at": "2026-04-10T14:00:00+00:00"
    },
    {
      "id": "201",
      "access_group": {
        "id": "2",
        "name": "Windows Servers"
      },
      "profile": "approver",
      "level": 2,
      "added_by": "admin",
      "added_at": "2026-04-12T11:30:00+00:00"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 50,
      "total_items": 2,
      "total_pages": 1
    },
    "links": {
      "self": "/api/v2/iam/user-groups/7/access-policies?page=1&limit=50"
    }
  }
}
```

---

## Campos do corpo de resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `data` | array[object] | Vínculos ativos na página atual. |
| `data[].id` | string | Código de identificação único do vínculo. Use esse valor para remover o vínculo. |
| `data[].access_group` | object | A política de acesso vinculada. |
| `data[].access_group.id` | string | Código de identificação único da política de acesso. |
| `data[].access_group.name` | string | Nome da política de acesso. |
| `data[].profile` | string | Papel que o vínculo concede aos membros do grupo. Valores permitidos: `user`, `approver`, `user_approver`. |
| `data[].level` | integer | Nível de aprovação do vínculo. Valores permitidos: `1`, `2`, `3`. Retorna `null` quando o vínculo não carrega um nível. |
| `data[].added_by` | string | Nome de exibição do usuário que criou o vínculo. Retorna `null` quando o autor não é registrado. |
| `data[].added_at` | datetime | Data e hora de criação do vínculo. |
| `meta` | object | Metadados da listagem. |
| `meta.pagination` | object | Estado da paginação para a requisição atual. |
| `meta.pagination.total_items` | integer | Número de vínculos que a listagem retorna em todas as páginas. Vínculos com políticas de acesso fora do escopo da aplicação não são contados. |
| `meta.links.self` | string | Caminho da página atual. |

---

## Erros

| Código HTTP | Mensagem | Possível causa | Solução |
| --- | --- | --- | --- |
| `401` | `api.auth.unauthorized` | O token de acesso está ausente, inválido ou expirou. | Solicite um novo token de acesso. |
| `404` | `api.resource.not_found` | O grupo de usuários não existe ou está fora do escopo da autorização. Uma política de acesso fora do escopo nunca retorna `404`; ela fica fora da lista. | Verifique o código de identificação do grupo de usuários e o escopo da autorização. |
| `429` | `api.rate_limit_exceeded` | O limite de requisições foi excedido. | Aguarde o número de segundos retornado no cabeçalho `Retry-After` e tente novamente. |

Para as mensagens de erro de autenticação e a política de `403` versus `404`, acesse [API v2 - Convenções e comportamentos compartilhados](/v4-2/docs/pt/api-v2-conventions-and-shared-behaviors).