POST | Ativar dispositivo

Descrição

Ative um dispositivo cadastrado no PAM Core utilizando a API v2. A ativação restabelece o dispositivo como alvo operacional, permitindo novamente operações de escrita e sessões.

Atenção

A ativação se aplica apenas ao dispositivo. As credenciais desativadas por um POST | Desativar dispositivo (v2) anterior não são reativadas: reativá-las é responsabilidade do integrador e precisa ser feito explicitamente pela API de credenciais ou pela interface web.

Pré-requisitos

Autorização com permissão de escrita para o PAM Core, concedida pelo administrador no A2A. Para mais informações, acesse Como gerenciar autorizações no A2A API v2.
Um dispositivo inativo. Ativar um dispositivo que já está ativo retorna 409.

Requisição

POST /api/v2/platform/devices/{id}/activate

Info

Este endpoint faz parte da superfície da API v2 do A2A e está disponível a partir da versão 4.2.9 do Segura®. Os dispositivos são servidos pelo caminho base /api/v2/platform, e não por /api/v2/pam como os demais recursos v2. O equivalente v1 está documentado em PUT | Ativar dispositivo.

Parâmetros de caminho

Campo	Tipo	Obrigatório	Descrição
`id`	integer	Sim	Código de identificação único do dispositivo. Nota: este valor é atribuído pelo Segura® em POST \| Criar dispositivo (v2).

Esta ação não recebe corpo de requisição e não exige o cabeçalho If-Match requerido por PUT | Atualizar dispositivo (v2) e PATCH | Atualizar dispositivo (v2).

Exemplo de requisição

POST {{url}}/api/v2/platform/devices/55/activate

Resposta

HTTP/1.1 204 No Content

A resposta não tem corpo. Para confirmar o novo estado, consulte o dispositivo com GET | Listar um dispositivo (v2): o campo device.active retorna true, e meta.actions passa a expor apenas deactivate.

Erros

Código HTTP	Mensagem	Causa possível	Solução
`401`	`api.auth.token.invalid`	O token de acesso está ausente ou expirou.	Solicite um novo token de acesso.
`403`	`api.permission.denied`	A autorização não tem permissão de escrita para os recursos do PAM Core.	Peça ao administrador para verificar as permissões da autorização no A2A e gere um novo token.
`404`	`api.resource.not_found`	O dispositivo não existe ou pertence a outro tenant.	Verifique o código de identificação enviado no caminho.
`409`	`api.resource.conflict.already_active`	O dispositivo já está ativo.	Nenhuma ação é necessária, o dispositivo já está no estado solicitado.
`429`	`rate_limit_exceeded`	O limite de requisições foi excedido.	Aguarde o número de segundos indicado no cabeçalho `Retry-After` e tente novamente.
`500`	`api.internal.error`	Erro interno do servidor.	Entre em contato com a equipe de suporte da Segura®.

Exemplo de resposta de erro

409 o dispositivo já está ativo:

{
    "error": {
        "code": "api.resource.conflict.already_active",
        "message": "Device is already active."
    }
}

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.`	Cabeçalho 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®.