Skip to main content
IBM Quantum Platform

Travaux

Exécution d'un travail

Invoquer une primitive Qiskit Runtime. Notez l'identifiant du travail renvoyé. Vous l'utiliserez pour vérifier l'état d'avancement du travail et examiner les résultats. Cette demande est limitée à 5 travaux par minute et par utilisateur.

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.create

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.create

Entrée

Paramètres de corps
Nom, type
Description
program_id
string

ID du programme à exécuter

backend
string

Nom qui identifie le backend sur lequel le programme doit être exécuté.

runtime
string

Nom et étiquette de l'image à utiliser lors de l'exécution d'un programme (uniquement pour les utilisateurs du canal IBM Quantum ). Doit suivre le modèle "name:tag".

tags
string[]

Liste des balises de l'emploi ou du programme

log_level
string

Niveau de journalisation du programme

Valeurs possibles: criticalerrorwarninginfodebug
cost
integer

Coût du travail en tant que durée estimée (en secondes). Ne doit pas dépasser le coût du programme. Si la valeur fournie dépasse le maximum, elle sera plafonnée à cette valeur.

Valeur minimale: 0
Valeur maximale: 10800
session_id
string

Identifiant de la session dont fait partie l'emploi

calibration_id
string

L'ID de l'étalonnage utilisé pour le travail

params
one of
SamplerV2 entrée
object

L'entrée d'un appel à l'API SamplerV2

EstimatorV2 entrée
object

L'entrée d'un appel à l'API EstimatorV2

NoiseLearner entrée
object

L'entrée d'un appel à l'API NoiseLearner

Entrée de l'exécuteur v0.1
object

Un modèle décrivant les données d'entrée du programme Executor.

Entrée de l'exécuteur v0.2
object

Un modèle décrivant les données d'entrée du programme Executor.

Exécuteur testamentaire v1.0 ParamsModel
object

Un modèle décrivant les données d'entrée du programme Executor.

Exécuteur testamentaire v1.1 ParamsModel
object

Un modèle décrivant les données d'entrée du programme Executor.

Exécuteur testamentaire v2.0 ParamsModel
object

Un modèle décrivant les données d'entrée du programme Executor.

NoiseLearnerV3 v0.1 entrée
object

Un modèle décrivant les données d'entrée du programme « Noise Learner » V3.

NoiseLearnerV3 v0.2 entrée
object

Un modèle décrivant les données d'entrée du programme « Noise Learner » V3.

NoiseLearnerV3 v0.3 ParamsModel
object

Un modèle décrivant les données d'entrée du programme « Noise Learner » V3.

private
boolean

Lorsqu'il vaut true, les paramètres d'entrée ne sont pas renvoyés et les résultats ne peuvent être lus qu'une seule fois. Une fois le travail terminé, les paramètres d'entrée sont supprimés du service. Une fois les résultats lus, ils sont supprimés du service. Lorsqu'il est défini sur false, les paramètres d'entrée et les résultats suivent le comportement de rétention standard de l'API. N'est renvoyée dans la réponse que si la valeur est vraie, sinon elle est omise.

Exemples de code
POST
/v1/jobs

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
200bouton OK
400Demande incorrecte
401Non autorisé
403Interdit
404Introuvable
409L'utilisation dépasse la limite de l'instance
Réponses
{
  "id": "c5dge2d3rn7breq27i9g",
  "backend": "ibm_backend",
  "private": true
}

Lister les travaux

Dressez la liste des programmes quantiques que vous avez exécutés.

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.read

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.read

Entrée

Paramètres de requête
Nom, type
Description
limit
integer

Nombre de résultats à renvoyer à la fois. Si la valeur fournie est en dehors de la plage viable, aucune erreur ne se produit et la valeur par défaut est utilisée à la place.

Valeur par défaut: 200
Valeur minimale: 1
Valeur maximale: 200
offset
integer

Nombre de résultats à décaler lors de la récupération de la liste des emplois. Si la valeur fournie est en dehors de la plage viable, aucune erreur ne se produit et la valeur par défaut est utilisée à la place.

Valeur par défaut: 0
Valeur minimale: 0
Valeur maximale: 2147483647
pending
boolean

Renvoie les travaux "en file d'attente" et "en cours" s'ils sont vrais. Renvoie les travaux "Terminé", "Annulé" et "Échec" s'ils sont faux.

program
string

ID du programme pour filtrer les travaux

backend
string

Backend pour filtrer les travaux

created_after
string

Emploi créé après le filtre

created_before
string

Emploi créé avant le filtre

sort
string

Trier les travaux par heure de création ASC ou DESC (par défaut)

tags
string[]

Tags pour filtrer les emplois

session_id
string

ID de session pour filtrer les travaux

exclude_params
boolean

Exclure les paramètres du travail de la réponse

Valeur par défaut: true
Exemples de code
GET
/v1/jobs

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
200bouton OK
400Demande incorrecte
401Non autorisé
403Interdit
404Introuvable
Réponses
{
  "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
}

Liste des détails de l'emploi

Liste les détails de la tâche du programme quantique spécifié.

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.read

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.read

Entrée

Paramètres de chemin
Nom, type
Description
id
Obligatoire
string

Identifiant d'un emploi existant

Paramètres de requête
Nom, type
Description
exclude_params
boolean

Exclure les paramètres du travail de la réponse

Valeur par défaut: false
Exemples de code
GET
/v1/jobs/{id}

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
200bouton OK
401Non autorisé
403Interdit
404Introuvable
Réponses
{
  "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"
}

Supprimer un travail

Supprime le travail spécifié et les données qui lui sont associées. L'emploi doit être en phase terminale.

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.delete

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.delete

Entrée

Paramètres de chemin
Nom, type
Description
id
Obligatoire
string

Identifiant d'un emploi existant

Exemples de code
DELETE
/v1/jobs/{id}

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
204bouton OK
400Demande incorrecte
401Non autorisé
403Interdit
404Introuvable
500Erreur interne lors de la suppression d'un travail
Réponses
bouton OK

Annuler un travail

Annule le travail spécifié.

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.cancel

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.cancel

Entrée

Paramètres de chemin
Nom, type
Description
id
Obligatoire
string

Un numéro d'identification de l'emploi

Exemples de code
POST
/v1/jobs/{id}/cancel

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
204bouton OK
400Mauvaise demande d'annulation
401Non autorisé
403Interdit
404Introuvable
409L'emploi est en statut non annulable.
500Erreur interne d'annulation du travail
Réponses
bouton OK

Liste des journaux de travail

Liste tous les journaux de travail pour le travail spécifié.

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.read

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.read

Entrée

Paramètres de chemin
Nom, type
Description
id
Obligatoire
string

Un numéro d'identification de l'emploi

Exemples de code
GET
/v1/jobs/{id}/logs

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
200Renvoie les journaux des travaux.
401Non autorisé
403Interdit
404Non trouvé
Réponses
Renvoie les journaux des travaux.

Obtenir des données sur l'emploi

Obtient les métriques de l'emploi spécifié

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.read

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.read

Entrée

Paramètres de chemin
Nom, type
Description
id
Obligatoire
string

Un numéro d'identification de l'emploi

Exemples de code
GET
/v1/jobs/{id}/metrics

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
200bouton OK
401Non autorisé
403Interdit
404Introuvable
Réponses
{
  "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"
}

Liste des résultats de l'emploi

Renvoie le résultat final de ce travail.

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.read

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.read

Entrée

Paramètres de chemin
Nom, type
Description
id
Obligatoire
string

Un numéro d'identification de l'emploi

Exemples de code
GET
/v1/jobs/{id}/results

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
200Renvoie le résultat final du travail.
204Le résultat final de Job n'a pas été trouvé.
400Demande incorrecte
401Non autorisé
403Interdit
404Introuvable
Réponses
{
  "schema_version": "v0.1",
  "data": [
    {
      "results": {},
      "metadata": null
    }
  ],
  "metadata": {
    "chunk_timing": [
      {
        "start": "example",
        "stop": "example",
        "parts": [
          {
            "idx_item": 1,
            "size": 1
          }
        ]
      }
    ]
  }
}

Remplacer les étiquettes d'emploi

Remplacer les étiquettes d'emploi

Autorisation

Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access

  • quantum-computing.job.update

Audit

L'appel de cette méthode génère les événements d'audit suivants.

  • quantum-computing.job.update

Entrée

Paramètres de chemin
Nom, type
Description
id
Obligatoire
string

Un numéro d'identification de l'emploi

Paramètres de corps
Nom, type
Description
tags
Obligatoire
string[]

Liste des balises de l'emploi ou du programme

Exemples de code
PUT
/v1/jobs/{id}/tags

Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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"]}'

Sortie

Codes d'état de la réponse HTTP
Code d'état
Description
204bouton OK
401Non autorisé
403Interdit
404Introuvable
Réponses
bouton OK
Cette page a-t-elle été utile ?
Signaler un bogue, une coquille ou proposer du contenu sur GitHub.