Skip to main content
IBM Quantum Platform

Trabajos

Ejecución de un trabajo

Invoca una primitiva Qiskit Runtime. Anote el ID del trabajo devuelto. La utilizará para comprobar el estado del trabajo y revisar los resultados. Esta solicitud está limitada a 5 trabajos por minuto y usuario.

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.create

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.create

Entrada

Parámetros del cuerpo
Nombre, Tipo
Descripción
program_id
string

ID del programa a ejecutar

backend
string

Nombre que identifica el backend en el que ejecutar el programa.

runtime
string

Nombre y etiqueta de la imagen que se utilizará al ejecutar un programa (sólo usuarios del canal IBM Quantum ). Debe seguir el patrón "nombre:etiqueta".

tags
string[]

Lista de etiquetas de trabajos o programas

log_level
string

Nivel de registro del programa

Valores posibles: criticalerrorwarninginfodebug
cost
integer

Coste del trabajo como el tiempo estimado que debería tardar en completarse (en segundos). No debe superar el coste del programa. Si el valor proporcionado supera el máximo, se limitará a ese valor.

Valor mínimo: 0
Valor máximo: 10800
session_id
string

Identificador de la sesión de la que forma parte el trabajo

calibration_id
string

ID de la calibración utilizada para el trabajo

params
one of
SamplerV2 entrada
object

La entrada para una llamada a la API SamplerV2

EstimatorV2 entrada
object

La entrada para una llamada a la API EstimatorV2

NoiseLearner entrada
object

La entrada para una llamada a la API NoiseLearner

Entrada del ejecutor « v0.1 »
object

Un modelo que describe los datos de entrada del programa Executor.

Entrada del ejecutor « v0.2 »
object

Un modelo que describe los datos de entrada del programa Executor.

Executor v1.0 ParamsModel
object

Un modelo que describe los datos de entrada del programa Executor.

Executor v1.1 ParamsModel
object

Un modelo que describe los datos de entrada del programa Executor.

NoiseLearnerV3 v0.1 entrada
object

Un modelo que describe las entradas del programa «Noise Learner» V3.

NoiseLearnerV3 v0.2 entrada
object

Un modelo que describe las entradas del programa «Noise Learner» V3.

NoiseLearnerV3 v0.3 ParamsModel
object

Un modelo que describe las entradas del programa «Noise Learner» V3.

private
boolean

Cuando se establece en true, los parámetros de entrada no se devuelven, y los resultados sólo se pueden leer una vez. Una vez finalizado el trabajo, los parámetros de entrada se eliminan del servicio. Una vez leídos los resultados, se borran del servicio. Cuando se establece en false, los parámetros de entrada y los resultados siguen el comportamiento de retención estándar de la API. Sólo se devuelve en la respuesta si el valor es verdadero; en caso contrario, se omite.

Ejemplos de código
POST
/v1/jobs

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
200Aceptar
400Solicitud errónea
401No autorizado
403Prohibido
404No se ha encontrado
409El uso supera el límite de instancias
Respuestas
{
  "id": "c5dge2d3rn7breq27i9g",
  "backend": "ibm_backend",
  "private": true
}

Listar trabajos

Enumera los trabajos de programas cuánticos que has ejecutado.

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.read

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.read

Entrada

Parámetros de consulta
Nombre, Tipo
Descripción
limit
integer

Número de resultados a devolver cada vez. Si el valor proporcionado está fuera del rango viable, no se produce ningún error y en su lugar se utiliza el valor por defecto.

Valor predeterminado: 200
Valor mínimo: 1
Valor máximo: 200
offset
integer

Número de resultados a compensar al recuperar la lista de trabajos. Si el valor proporcionado está fuera del rango viable, no se produce ningún error y en su lugar se utiliza el valor por defecto.

Valor predeterminado: 0
Valor mínimo: 0
Valor máximo: 2147483647
pending
boolean

Devuelve los trabajos 'En cola' y 'En ejecución' si es verdadero. Devuelve los trabajos 'Completados', 'Cancelados' y 'Fallidos' si es falso.

program
string

ID del programa para filtrar los trabajos

backend
string

Backend para filtrar trabajos

created_after
string

Trabajo creado después del filtro

created_before
string

Trabajo creado antes del filtro

sort
string

Ordenar los trabajos por hora de creación ASC o DESC (por defecto)

tags
string[]

Etiquetas para filtrar empleos

session_id
string

ID de sesión para filtrar trabajos

exclude_params
boolean

Excluir parámetros de trabajo de la respuesta

Valor predeterminado: true
Ejemplos de código
GET
/v1/jobs

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
200Aceptar
400Solicitud errónea
401No autorizado
403Prohibido
404No se ha encontrado
Respuestas
{
  "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
}

Enumerar los detalles del trabajo

Lista los detalles sobre el trabajo de programa cuántico especificado.

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.read

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.read

Entrada

Parámetros de vía de acceso
Nombre, Tipo
Descripción
id
Obligatorio
string

Identificador de un trabajo existente

Parámetros de consulta
Nombre, Tipo
Descripción
exclude_params
boolean

Excluir parámetros de trabajo de la respuesta

Valor predeterminado: false
Ejemplos de código
GET
/v1/jobs/{id}

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
200Aceptar
401No autorizado
403Prohibido
404No se ha encontrado
Respuestas
{
  "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"
}

Suprimir un trabajo

Elimina el trabajo especificado y sus datos asociados. El trabajo debe estar en estado terminal.

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.delete

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.delete

Entrada

Parámetros de vía de acceso
Nombre, Tipo
Descripción
id
Obligatorio
string

Identificador de un trabajo existente

Ejemplos de código
DELETE
/v1/jobs/{id}

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
204Aceptar
400Solicitud errónea
401No autorizado
403Prohibido
404No se ha encontrado
500Error interno al borrar el trabajo
Respuestas
Aceptar

Cancele un trabajo

Cancela el trabajo especificado.

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.cancel

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.cancel

Entrada

Parámetros de vía de acceso
Nombre, Tipo
Descripción
id
Obligatorio
string

Un identificador de trabajo

Ejemplos de código
POST
/v1/jobs/{id}/cancel

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
204Aceptar
400Solicitud de cancelación errónea
401No autorizado
403Prohibido
404No se ha encontrado
409El trabajo está en estado no cancelable.
500Error interno al cancelar el trabajo
Respuestas
Aceptar

Listar registros de trabajos

Lista todos los registros del trabajo especificado.

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.read

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.read

Entrada

Parámetros de vía de acceso
Nombre, Tipo
Descripción
id
Obligatorio
string

Un identificador de trabajo

Ejemplos de código
GET
/v1/jobs/{id}/logs

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
200Devuelve los registros de trabajo.
401No autorizado
403Prohibido
404No encontrado
Respuestas
Devuelve los registros de trabajo.

Obtener métricas de trabajo

Obtiene las métricas del trabajo especificado

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.read

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.read

Entrada

Parámetros de vía de acceso
Nombre, Tipo
Descripción
id
Obligatorio
string

Un identificador de trabajo

Ejemplos de código
GET
/v1/jobs/{id}/metrics

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
200Aceptar
401No autorizado
403Prohibido
404No se ha encontrado
Respuestas
{
  "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"
}

Lista de resultados

Devuelve el resultado final de este trabajo.

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.read

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.read

Entrada

Parámetros de vía de acceso
Nombre, Tipo
Descripción
id
Obligatorio
string

Un identificador de trabajo

Ejemplos de código
GET
/v1/jobs/{id}/results

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
200Devuelve el resultado final del trabajo.
204Resultado final del trabajo no encontrado.
400Solicitud errónea
401No autorizado
403Prohibido
404No se ha encontrado
Respuestas
{
  "schema_version": "v0.1",
  "data": [
    {
      "results": {},
      "metadata": null
    }
  ],
  "metadata": {
    "chunk_timing": [
      {
        "start": "example",
        "stop": "example",
        "parts": [
          {
            "idx_item": 1,
            "size": 1
          }
        ]
      }
    ]
  }
}

Sustituir etiquetas de trabajo

Sustituir etiquetas de trabajo

Autorización

Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access

  • quantum-computing.job.update

Auditoría

La invocación de este método genera los siguientes eventos de auditoría.

  • quantum-computing.job.update

Entrada

Parámetros de vía de acceso
Nombre, Tipo
Descripción
id
Obligatorio
string

Un identificador de trabajo

Parámetros del cuerpo
Nombre, Tipo
Descripción
tags
Obligatorio
string[]

Lista de etiquetas de trabajos o programas

Ejemplos de código
PUT
/v1/jobs/{id}/tags

Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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: 2026-04-15' \
  -H 'Content-Type: application/json' \
  -d '{"tags":["example"]}'

Resultado

Códigos de estado de la respuesta de HTTP
Código de estado
Descripción
204Aceptar
401No autorizado
403Prohibido
404No se ha encontrado
Respuestas
Aceptar
¿Le ha resultado útil esta página?
Informe de un error, de una errata o solicite contenido en GitHub.