Skip to main content

Endpoint dei processi

Endpoint e parametri dei processi

Recupero dei dettagli di un processo specifico

Recupero dei messaggi di un processo specifico

Annulla un processo specifico

Per ulteriori informazioni sulle relazioni tra oggetti e su come utilizzarle nell'API, consulta la sezione Relazioni tra oggetti.

Per ulteriori informazioni sui processi, consulta la pagina di assistenza Processi: interfaccia di amministrazione.

Recupero dei dettagli di un processo specifico

Per recuperare i dettagli di un processo esistente e il suo stato corrente, utilizza l'endpoint GET {baseURL}/v3/jobs/{jobId}. Utilizza vari parametri per filtrare i processi che desideri visualizzare.

Nota

È possibile utilizzare solo i flussi di lavoro delle app.

Gli utenti possono visualizzare i lavori eseguiti da loro e quelli eseguiti su pianificazioni condivise tramite Raccolte.

Parametri

  • jobId (stringa): obbligatorio. Immetti l'ID del processo di cui desideri visualizzare i dettagli.

  • includeMessages (booleano): opzionale. È possibile non specificare nessun valore o selezionare "true" e "false". Se il parametro è impostato su "false", viene restituito un oggetto ridotto. Se non è specificato nessun valore, viene utilizzato "true".

curl -X 'GET' \
  'http://localhost/webapi/v3/jobs/66ebd18d3d6200007e000d8c?includeMessages=true' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

    {
      "id": "string",
      "appId": "string",
      "createDateTime": "2024-09-19T10:02:54.589Z",
      "status": "string",
      "disposition": "string",
      "outputs": [
        {
          "id": "string",
          "availableFormats": [
            "string"
          ],
          "fileName": "string"
        }
      ],
      "messages": [
        {
          "status": 0,
          "text": "string",
          "toolId": 0
        }
      ],
      "priority": "Default",
      "workerTag": "string",
      "runWithE2": true
    }
  • 401: Unauthorized

  • 404: NotFound

Recupero dei messaggi di un processo specifico

Per recuperare tutti i messaggi su un processo specifico, utilizza l'endpoint GET {baseURL}/v3/jobs/{jobId}/messages.

Nota

Solo gli amministratori possono usare questo endpoint.

Parametri

  • jobId (stringa): obbligatorio. Immetti l'ID del processo di cui desideri visualizzare i messaggi.

curl -X 'GET' \
  'http://localhost/webapi/v3/jobs/66ebd18d3d6200007e000d8c/messages' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

    {
      "status": 0,
      "text": "string",
      "toolId": 0
    }
  • 401: Unauthorized

  • 404: NotFound

Annulla un processo specifico

Per annullare un processo specifico, utilizza l'endpoint DELETE {baseURL}/v3/jobs/{jobId}. Il lavoro deve essere nello stato "In coda" o "In esecuzione".

Se annulli un processo in esecuzione, questo viene annullato. Se annulli un processo in coda, questo viene eliminato.

Nota

I curatori possono annullare qualsiasi processo, mentre altri ruoli possono annullare i lavori che loro stessi hanno creato, attivato o pianificato.

Altri ruoli possono annullare i processi creati, attivati o pianificati. Sono inclusi i processi condivisi con loro tramite raccolte, anche se non sono proprietari del processo.

Parametri

  • jobId (stringa): obbligatorio. Immetti l'ID del processo che desideri annullare.

curl -X 'DELETE' \
  'http://localhost/webapi/v3/jobs/678f97baa15300008c0039fc' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

    • Risposta quando annulli un processo in esecuzione:

      {
        "message": "Cancelled Successfully."
      }
    • Risposta quando annulli un processo in coda:

      {
        "message": "Deleted Successfully."
      }
  • 400: BadRequest

    • Risposta quando il processo non ha lo stato "In coda" o "In esecuzione":

      {
        "message": "This job is not in 'Queued' or 'Running' state."
      }
    • Risposta quando l'utente che effettua la chiamata API non dispone dell'autorizzazione per annullare il processo:

      {
        "message": "You do not have permission to cancel this job."
      }
  • 401: Unauthorized

  • 404: NotFound

Relazioni tra oggetti

Per avere informazioni su un processo specifico, hai bisogno di un parametro jobId. Per ottenere il parametro jobId, utilizza l'endpoint GET {baseURL}/v3/workflows/{workflowId}/jobs. Per ulteriori informazioni su questo endpoint, consulta la pagina di assistenza Endpoint del flusso di lavoro.

Richieste Postman

Per ulteriori informazioni sulle richieste Postman, consulta la pagina di assistenza Come utilizzare Postman.