POST | Reexecutar um job do IAM por [id]

Descrição

Rode novamente um job em segundo plano do IAM que falhou na plataforma Segura™. O job é enfileirado mais uma vez no mesmo registro: seu código de identificação permanece o mesmo, retry_count aumenta em um, e o resultado e o erro anteriores são apagados.

Apenas um job no estado failed pode ser reexecutado. Para verificar o estado antes, acesse GET | Listar um job do IAM por [id].

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 A2A.
O job deve estar no estado failed e deve ter sido iniciado pela mesma aplicação ou pelo mesmo usuário que faz esta requisição.

Requisição

POST /api/v2/iam/jobs/{id}/retry

Parâmetros de caminho

Campo	Tipo	Obrigatório	Descrição
`id`	string	Sim	Código de identificação único do job, no formato UUID. Nota: este valor é retornado pelo endpoint que iniciou o job.

A requisição não leva corpo.

Exemplo de requisição

POST {{url}}/api/v2/iam/jobs/019e0a01-b7b8-7062-82dd-43a8aa0ed6f8/retry

Resposta

HTTP/1.1 202 Accepted
Location: /api/v2/iam/jobs/019e0a01-b7b8-7062-82dd-43a8aa0ed6f8

O cabeçalho Location contém o caminho do job, que é o mesmo job que foi reexecutado.

Exemplo de corpo da resposta

{
    "data": {
        "job": {
            "id": "019e0a01-b7b8-7062-82dd-43a8aa0ed6f8",
            "type": "ldap.test_connection",
            "state": "queued",
            "retry_count": 1,
            "created_at": "2026-05-08 23:52:25",
            "started_at": null,
            "finished_at": null
        }
    },
    "meta": {
        "links": { "self": "/api/v2/iam/jobs/019e0a01-b7b8-7062-82dd-43a8aa0ed6f8" }
    }
}

Campos do corpo da resposta

Campo	Tipo	Descrição
`data`	object	A requisição aceita.
`data.job`	object	Job que foi enfileirado novamente.
`data.job.id`	string	Código de identificação único do job, inalterado pela nova execução.
`data.job.type`	string	Tipo do job.
`data.job.state`	string	Estado do job. Um job reexecutado retorna `queued`.
`data.job.retry_count`	integer	Número de vezes que o job foi reexecutado, aumentado em um por esta requisição.
`data.job.created_at`	datetime	Data e hora em que o job foi criado pela primeira vez. A nova execução não altera este valor.
`data.job.started_at`	datetime	Reiniciado para `null` até que um worker processe o job novamente.
`data.job.finished_at`	datetime	Reiniciado para `null` até que o job termine.
`meta`	object	Metadados da resposta.
`meta.links`	object	Links de navegação para o job.
`meta.links.self`	string	Caminho do job.

Info

A nova execução reaproveita o registro do job, então o resultado da tentativa anterior é perdido. Leia o objeto error com GET | Listar um job do IAM por [id] antes de reexecutar, caso a falha anterior ainda seja importante.

Erros

Código HTTP	Mensagem	Causa possível	Solução
`401`	`api.auth.unauthorized`	O token de acesso está ausente ou expirou.	Solicite um novo token de acesso.
`404`	`api.resource.not_found`	O job não existe, tem mais de 24 horas ou foi iniciado por outro usuário por meio de outra aplicação.	Verifique o código de identificação e envie a requisição com a aplicação ou o usuário que iniciou o job.
`409`	`api.job.invalid_transition`	O job não está no estado `failed`.	Leia o job e reexecute-o apenas depois que ele falhar.
`429`	`api.rate_limit.exceeded`	O limite de requisições foi excedido.	Reduza a frequência de requisições e tente novamente.

A plataforma também responde 503 Service Unavailable (api.service.unavailable) quando a fila de workers em segundo plano está cheia e o job não pode ser enfileirado. O corpo da resposta informa em details.retry_after o número de segundos a aguardar antes de reenviar a requisição. A partir da versão 4.2.15, a plataforma também envia o mesmo valor no cabeçalho Retry-After.

Para mensagens de erros de autenticação e a política de 403 versus 404, acesse API v2 - Convenções e comportamentos compartilhados.