Skip to main content
IBM Quantum Platform

Lavori

Eseguire un lavoro

Invoca una primitiva di Qiskit Runtime. Notare l'ID del lavoro restituito. Si utilizzerà per controllare lo stato del lavoro e rivedere i risultati. Questa richiesta è limitata a 5 lavori al minuto per utente.

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.create

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.create

Input

Parametri del corpo
Nome, tipo
Descrizione
program_id
string

ID del programma da eseguire

backend
string

Nome che identifica il backend su cui eseguire il programma.

runtime
string

Nome e tag dell'immagine da utilizzare quando si esegue un programma (solo per gli utenti del canale IBM Quantum ). Dovrebbe seguire lo schema "nome:tag".

tags
string[]

Elenco dei tag del lavoro o del programma

log_level
string

Livello di registrazione del programma

Valori possibili: criticalerrorwarninginfodebug
cost
integer

Costo del lavoro come tempo stimato di completamento (in secondi). Non deve superare il costo del programma. Se il valore fornito supera il massimo, verrà limitato a tale valore.

Valore minimo: 0
Valore massimo: 10800
session_id
string

Identificatore della sessione di cui il lavoro fa parte

calibration_id
string

L'ID della calibrazione usata per il lavoro

params
one of
SamplerV2 ingresso
object

L'input per una chiamata API a SamplerV2

EstimatorV2 ingresso
object

L'input per una chiamata API a EstimatorV2

NoiseLearner ingresso
object

L'input per una chiamata API a NoiseLearner

Dati inseriti dall'amministratore v0.1
object

Un modello che descrive gli input del programma Executor.

Dati inseriti dall'amministratore v0.2
object

Un modello che descrive gli input del programma Executor.

Amministratore v1.0 ParamsModel
object

Un modello che descrive gli input del programma Executor.

Amministratore v1.1 ParamsModel
object

Un modello che descrive gli input del programma Executor.

Amministratore v2.0 ParamsModel
object

Un modello che descrive gli input del programma Executor.

NoiseLearnerV3 v0.1 dati in ingresso
object

Un modello che descrive gli input del programma "Noise Learner" V3.

NoiseLearnerV3 v0.2 dati in ingresso
object

Un modello che descrive gli input del programma "Noise Learner" V3.

NoiseLearnerV3 v0.3 ParamsModel
object

Un modello che descrive gli input del programma "Noise Learner" V3.

private
boolean

Se impostato su true, i parametri di input non vengono restituiti e i risultati possono essere letti una sola volta. Al termine del lavoro, i parametri di input vengono eliminati dal servizio. Dopo la lettura dei risultati, questi vengono eliminati dal servizio. Se impostato su false, i parametri di input e i risultati seguono il comportamento di conservazione standard dell'API. Viene restituito nella risposta solo se il valore è vero, altrimenti viene omesso.

Esempi di codice
POST
/v1/jobs

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs

curl -X POST \
  'https://quantum.cloud.ibm.com/api/v1/jobs' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200Accettabilmente
400Richiesta non valida
401Non autorizzato
403Non consentito
404Non trovato
409L'utilizzo supera il limite dell'istanza
Risposte
{
  "id": "c5dge2d3rn7breq27i9g",
  "backend": "ibm_backend",
  "private": true
}

Elenca lavori

Elencare i lavori del programma quantum eseguiti.

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.read

Input

Parametri della query
Nome, tipo
Descrizione
limit
integer

Numero di risultati da restituire alla volta. Se il valore fornito non rientra nell'intervallo consentito, non si verifica alcun errore e viene utilizzato il valore predefinito.

Valore predefinito: 200
Valore minimo: 1
Valore massimo: 200
offset
integer

Numero di risultati da sfalsare quando si recupera l'elenco dei lavori. Se il valore fornito non rientra nell'intervallo consentito, non si verifica alcun errore e viene utilizzato il valore predefinito.

Valore predefinito: 0
Valore minimo: 0
Valore massimo: 2147483647
pending
boolean

Restituisce i lavori "in coda" e "in esecuzione", se vero. Restituisce i lavori "Completati", "Annullati" e "Falliti" se falso.

program
string

ID programma per filtrare i lavori

backend
string

Backend per filtrare i lavori

created_after
string

Lavoro creato dopo il filtro

created_before
string

Lavoro creato prima del filtro

sort
string

Ordinare i lavori per ora di creazione ASC o DESC (predefinito)

tags
string[]

Tag per filtrare i lavori

session_id
string

ID di sessione per filtrare i lavori

exclude_params
boolean

Escludere i parametri del lavoro dalla risposta

Valore predefinito: true
Esempi di codice
GET
/v1/jobs

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200Accettabilmente
400Richiesta non valida
401Non autorizzato
403Non consentito
404Non trovato
Risposte
{
  "jobs": [
    {
      "id": "c5dge2d3rn7breq27i9g",
      "backend": "ibmq_qasm_simulator",
      "cost": 0,
      "state": {
        "status": "Completed",
        "reason": ""
      },
      "status": "Completed",
      "params": {
        "iterations": 3
      },
      "program": {
        "id": "myprogram-abcdef12345"
      },
      "created": "2021-10-04T13:52:09.456851Z",
      "runtime": "ntc-provider-primitives:latest",
      "tags": [
        "tag1",
        "tag2",
        "tag3",
        "tag4"
      ],
      "session_id": "c5dge2d3rn7breq27i9g",
      "usage": {
        "qpu_charge_time_seconds": 20,
        "status": "complete"
      },
      "private": true,
      "estimated_running_time_seconds": 30.5,
      "calibration_id": "fez-ac-tls-test"
    },
    {
      "id": "c2gfe1m3ln7breq27i6e",
      "backend": "ibmq_qasm_simulator",
      "cost": 0,
      "state": {
        "status": "Completed",
        "reason": ""
      },
      "status": "Completed",
      "params": {
        "iterations": 3
      },
      "program": {
        "id": "myprogram-abcdef12345"
      },
      "created": "2021-10-05T13:52:09.456851Z",
      "runtime": "ntc-provider-primitives:latest",
      "tags": [
        "tag1",
        "tag2",
        "tag3",
        "tag4"
      ],
      "session_id": "c1mre2f3pn9breq18i4g"
    }
  ],
  "count": 2,
  "limit": 2,
  "offset": 0
}

Elencare i dettagli del lavoro

Elenca i dettagli del lavoro del programma quantum specificato.

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.read

Input

Parametri del percorso
Nome, tipo
Descrizione
id
Obbligatorio
string

Identificatore di un lavoro esistente

Parametri della query
Nome, tipo
Descrizione
exclude_params
boolean

Escludere i parametri del lavoro dalla risposta

Valore predefinito: false
Esempi di codice
GET
/v1/jobs/{id}

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200Accettabilmente
401Non autorizzato
403Non consentito
404Non trovato
Risposte
{
  "id": "c5dge2d3rn7breq27i9g",
  "backend": "ibmq_qasm_simulator",
  "cost": 0,
  "state": {
    "status": "Completed",
    "reason": ""
  },
  "status": "Completed",
  "params": {
    "iterations": 3
  },
  "program": {
    "id": "myprogram-abcdef12345"
  },
  "created": "2021-10-04T13:52:09.456851Z",
  "runtime": "ntc-provider-primitives:latest",
  "tags": [
    "tag1",
    "tag2",
    "tag3",
    "tag4"
  ],
  "session_id": "c5dge2d3rn7breq27i9g",
  "private": true,
  "estimated_running_time_seconds": 30.5,
  "calibration_id": "fez-ac-tls-test"
}

Cancella un lavoro

Elimina il lavoro specificato e i dati ad esso associati. Il lavoro deve essere in uno stato terminale.

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.delete

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.delete

Input

Parametri del percorso
Nome, tipo
Descrizione
id
Obbligatorio
string

Identificatore di un lavoro esistente

Esempi di codice
DELETE
/v1/jobs/{id}

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}

curl -X DELETE \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
204Accettabilmente
400Richiesta non valida
401Non autorizzato
403Non consentito
404Non trovato
500Errore interno nell'eliminazione del lavoro
Risposte
Accettabilmente

Annulla un lavoro

Annulla il lavoro specificato.

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.cancel

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.cancel

Input

Parametri del percorso
Nome, tipo
Descrizione
id
Obbligatorio
string

Un ID lavoro

Esempi di codice
POST
/v1/jobs/{id}/cancel

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/cancel

curl -X POST \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/cancel' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
204Accettabilmente
400Richiesta di annullamento errata
401Non autorizzato
403Non consentito
404Non trovato
409Il lavoro è in stato non cancellabile.
500Errore interno di annullamento del lavoro
Risposte
Accettabilmente

Elenco dei registri di lavoro

Elenca tutti i registri del lavoro per il lavoro specificato.

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.read

Input

Parametri del percorso
Nome, tipo
Descrizione
id
Obbligatorio
string

Un ID lavoro

Esempi di codice
GET
/v1/jobs/{id}/logs

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/logs

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/logs' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200Restituisce i registri dei lavori.
401Non autorizzato
403Non consentito
404Non trovato
Risposte
Restituisce i registri dei lavori.

Ottenere metriche di lavoro

Ottiene le metriche del lavoro specificato

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.read

Input

Parametri del percorso
Nome, tipo
Descrizione
id
Obbligatorio
string

Un ID lavoro

Esempi di codice
GET
/v1/jobs/{id}/metrics

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/metrics

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/metrics' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200Accettabilmente
401Non autorizzato
403Non consentito
404Non trovato
Risposte
{
  "timestamps": {
    "created": "2026-03-06T14:02:11Z",
    "running": "2026-03-06T14:02:18Z",
    "finished": "2026-03-06T14:05:47Z"
  },
  "usage": {
    "qpu_charge_time_seconds": 20,
    "status": "complete"
  },
  "circuits_execution_time_ns": 20000000,
  "qiskit_version": "2.3.0"
}

Elenco dei risultati del lavoro

Restituisce il risultato finale di questo lavoro.

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.read

Input

Parametri del percorso
Nome, tipo
Descrizione
id
Obbligatorio
string

Un ID lavoro

Esempi di codice
GET
/v1/jobs/{id}/results

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/results

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/results' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200Restituisce il risultato finale del lavoro.
204Il risultato finale del lavoro non è stato trovato.
400Richiesta non valida
401Non autorizzato
403Non consentito
404Non trovato
Risposte
{
  "schema_version": "v0.1",
  "data": [
    {
      "results": {},
      "metadata": null
    }
  ],
  "metadata": {
    "chunk_timing": [
      {
        "start": "example",
        "stop": "example",
        "parts": [
          {
            "idx_item": 1,
            "size": 1
          }
        ]
      }
    ]
  }
}

Sostituire i cartellini dei lavori

Sostituire i cartellini dei lavori

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.job.update

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.job.update

Input

Parametri del percorso
Nome, tipo
Descrizione
id
Obbligatorio
string

Un ID lavoro

Parametri del corpo
Nome, tipo
Descrizione
tags
Obbligatorio
string[]

Elenco dei tag del lavoro o del programma

Esempi di codice
PUT
/v1/jobs/{id}/tags

Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/jobs/{id}/tags

curl -X PUT \
  'https://quantum.cloud.ibm.com/api/v1/jobs/{id}/tags' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2024-01-01' \
  -H 'Content-Type: application/json' \
  -d '{"tags":["example"]}'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
204Accettabilmente
401Non autorizzato
403Non consentito
404Non trovato
Risposte
Accettabilmente
Questa pagina è stata utile?
Segnala un bug, un errore di battitura o richiedi contenuti su GitHub.