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.

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.
Um token de acesso OAuth 2.0 válido. Para mais informações, acesse Como autenticar uma aplicação 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.

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.