Excluir um agente - Qoder CN Series: Central de Documentação do Alibaba Cloud

Exclua permanentemente um agente. Esta operação é irreversível.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`

Parâmetro	Tipo	Obrigatório	Descrição
`agent_id`	string	Sim	Identificador exclusivo do agente.

Esta requisição não exige corpo.

curl -X DELETE "https://api.qoder.com.cn/api/v1/cloud/agents/agent_019eXXXX..." \
  -H "Authorization: Bearer $QODER_PAT"

HTTP 200 OK

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "deleted": true
}

Campo	Tipo	Descrição
`type`	string	Sempre `"agent"`.
`id`	string	Identificador exclusivo do agente excluído.
`deleted`	boolean	Retorna `true` em caso de sucesso.

HTTP	Tipo	Gatilho
401	`authentication_error`	PAT inválido ou expirado.
403	`permission_error`	O chamador não tem permissão para excluir este agente. Pode ser necessária uma função de administrador.
404	`not_found_error`	Não existe nenhum agente com o ID fornecido ou ele já foi excluído.

Consulte Erros para ver a estrutura completa de erros.

A exclusão é permanente e irreversível.
Para desativar temporariamente um agente, use Arquivar um agente.
É permitido excluir um agente já arquivado.
Chamar DELETE novamente para o mesmo ID retorna 404.
Alguns ambientes exigem permissões administrativas adicionais (cabeçalho x-gw-roles: admin); permissões insuficientes resultam em erro 403.

Confirme se o agente não possui sessões ativas em execução.
Se houver dúvida sobre a necessidade de exclusão permanente, arquive o agente primeiro.
Faça backup da configuração do agente pelo endpoint de histórico de versões antes de prosseguir com a exclusão.