Descrição
Ative um agente desativado do Network Connector. O agente volta na mesma porta e mantém o fingerprint.
Depois da ativação, é possível vincular dispositivos ao agente de novo pelo campo network_connector_id.
Pré-requisitos
- Uma aplicação com a Permissão do recurso PAM definida como Leitura e escrita, 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.
- Um agente desativado. Ativar um agente que já está ativo retorna
409.
Requisição
POST /api/v2/platform/network-connector/agents/{agent_id}/activate
Parâmetros de caminho
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
agent_id |
integer | Sim | Código de identificação único do agente. Aceita apenas dígitos. Para encontrar os agentes desativados, acesse GET | Listar todos os agentes do Network Connector com active=false. |
Esta ação não tem corpo de requisição e não exige o cabeçalho If-Match.
Exemplo de requisição
POST {{url}}/api/v2/platform/network-connector/agents/12/activate
Resposta
HTTP/1.1 204 No Content
A resposta não tem corpo. O cabeçalho ETag traz o novo estado do agente.
Erros
| Código HTTP | Mensagem | Causa possível | Solução |
|---|---|---|---|
403 |
api.auth.insufficient_permission |
A Permissão do recurso PAM da aplicação é Apenas leitura. | Peça ao administrador para definir a Permissão do recurso PAM como Leitura e escrita no A2A. |
404 |
api.resource.not_found |
O agente não existe. | Verifique o código de identificação enviado no caminho. |
404 |
api.route.not_found |
O valor de agent_id não é formado apenas por dígitos. |
Envie o código de identificação do agente usando apenas dígitos. |
409 |
api.resource.conflict.already_active |
O agente já está ativo. | Nenhuma ação é necessária. O agente já está no estado pedido. |
Para erros de autenticação, limites de requisição e o formato da resposta de erro, acesse API v2 - Convenções e comportamentos compartilhados.
Exemplo de resposta de erro
409 o agente já está ativo:
{
"code": "api.resource.conflict.already_active",
"message": "Network connector agent is already active.",
"details": null
}