DELETE | Excluir sincronização de grupo LDAP por [id]

Descrição

Exclua uma sincronização de grupo LDAP na plataforma Segura™. A plataforma realiza uma exclusão lógica: remove a sincronização e limpa os registros que a vinculam a suas roles, departamentos, perfis e usuários.

Pré-requisitos

Uma aplicação com a autorização Users concedida pelo administrador no A2A, com a permissão do recurso definida como Leitura e escrita. Para mais informações, acesse Como gerenciar autorizações no A2A.
Um token de acesso OAuth 2.0 válido. Para mais informações, acesse Como autenticar uma aplicação no A2A.
O ETag atual da sincronização, retornado por GET | Consultar sincronização de grupo LDAP por [id].

Alerta

Os usuários e roles que a sincronização já criou permanecem na plataforma. Excluir a sincronização interrompe execuções futuras; não revoga os acessos concedidos por execuções anteriores. Revise esses acessos separadamente.

Requisição

DELETE /api/v2/iam/ldap-group-syncs/[id]

Parâmetros de caminho

Campo	Tipo	Obrigatório	Descrição
`id`	int	Sim	Código de identificação único da sincronização.

Cabeçalhos

Cabeçalho	Obrigatório	Descrição
`If-Match`	Sim	O `ETag` da sincronização conforme lido pela última vez. A plataforma rejeita a requisição quando a versão armazenada é diferente, e a sincronização é preservada.

Exemplo de requisição `DELETE` `{{url}}/api/v2/iam/ldap-group-syncs/501`

Resposta

HTTP/1.1 204 No Content

A resposta não carrega corpo.

Atenção

A exclusão não é permanente. Uma requisição posterior a GET | Consultar sincronização de grupo LDAP por [id] para o mesmo código de identificação retorna 200 OK com active definido como false, não 404. A plataforma não tem um estado de excluído separado.

Erros

Código HTTP	Mensagem	Causa possível	Solução
`403`	`api.permission.denied`	A aplicação não tem permissão para este recurso.	Peça ao administrador para verificar a autorização Users da aplicação no A2A.
`404`	`api.resource.not_found`	Não existe sincronização com o código de identificação enviado.	Verifique o `id` e reenvie a requisição.
`412`	`api.precondition.failed`	O valor de `If-Match` não corresponde à versão armazenada. A sincronização é preservada.	Leia o recurso novamente, confirme se ainda deseja excluí-lo e reenvie a requisição com o novo `ETag`.
`428`	`api.precondition.required`	O header `If-Match` está ausente.	Leia o recurso, depois reenvie a requisição com seu `ETag` em `If-Match`.
`429`	`rate_limit_exceeded`	A aplicação excedeu sua cota de requisições.	Aguarde o período indicado no header `Retry-After` e reenvie a requisição.

Erros de autenticação

Mensagem	Causa possível	Solução
`Client authentication failed.`	Falha na autenticação da aplicação com o servidor Segura.	Verifique os parâmetros de autenticação (`Access Token URL`, `Client ID` e `Client secret`) e solicite um novo token de acesso.
`Invalid signature`	Falha no reconhecimento da URL da aplicação cliente.	Verifique a URL da aplicação cliente e reenvie a requisição.
`No route matched with those values.`	Header de autorização ausente na requisição da API.	Solicite um novo token de acesso.
`Request timed out.`	A requisição excedeu o limite de tempo.	Verifique a conectividade entre a origem da requisição e o servidor Segura.