Skip to main content
IBM Quantum Platform

작업

작업 실행

Qiskit Runtime 프리미티브를 호출합니다. 반환된 작업 ID를 기록해 두세요. 작업의 상태를 확인하고 결과를 검토하는 데 사용합니다. 이 요청은 사용자당 분당 5개 작업으로 제한됩니다.

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.create

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.create

입력

본문 매개변수
이름, 유형
설명
program_id
string

실행할 프로그램의 ID

backend
string

프로그램을 실행할 백엔드를 식별하는 이름입니다.

runtime
string

프로그램을 실행할 때 사용할 이미지의 이름과 태그( IBM Quantum 채널 사용자만 해당). "name:tag" 패턴을 따라야 합니다.

tags
string[]

작업 또는 프로그램 태그 목록

log_level
string

프로그램의 로깅 수준

가능한 값: criticalerrorwarninginfodebug
cost
integer

완료하는 데 걸리는 예상 시간(초)으로 작업 비용입니다. 프로그램 비용을 초과해서는 안 됩니다. 제공된 값이 최대값을 초과하는 경우 해당 값으로 제한됩니다.

최소값: 0
최대값: 10800
session_id
string

작업이 속한 세션의 식별자

calibration_id
string

작업에 사용된 캘리브레이션의 ID입니다

params
one of
SamplerV2 입력
object

SamplerV2 API 호출의 입력값

EstimatorV2 입력
object

EstimatorV2 API 호출의 입력값

NoiseLearner 입력
object

NoiseLearner API 호출의 입력값

v0.1 의 입력
object

Executor 프로그램의 입력값을 설명하는 모델.

v0.2 의 입력
object

Executor 프로그램의 입력값을 설명하는 모델.

집행인 v1.0 ParamsModel
object

Executor 프로그램의 입력값을 설명하는 모델.

유언집행인 v1.1 ParamsModel
object

Executor 프로그램의 입력값을 설명하는 모델.

유언집행인 v2.0 ParamsModel
object

Executor 프로그램의 입력값을 설명하는 모델.

NoiseLearnerV3 v0.1 입력
object

Noise Learner V3 프로그램의 입력값을 설명하는 모델.

NoiseLearnerV3 v0.2 입력
object

Noise Learner V3 프로그램의 입력값을 설명하는 모델.

NoiseLearnerV3 v0.3 ParamsModel
object

Noise Learner V3 프로그램의 입력값을 설명하는 모델.

private
boolean

True로 설정하면 입력 매개변수가 반환되지 않으며 결과를 한 번만 읽을 수 있습니다. 작업이 완료되면 입력 매개변수가 서비스에서 삭제됩니다. 결과를 읽은 후에는 서비스에서 삭제됩니다. False로 설정하면 입력 매개변수와 결과가 API의 표준 보존 동작을 따릅니다. 값이 참인 경우에만 응답에 반환되며, 그렇지 않으면 생략됩니다.

코드 샘플
POST
/v1/jobs

인스턴스가 eu-de 리전에 있는 경우, 대신 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
200확인
400잘못된 요청
401권한 없음
403금지됨
404찾을 수 없음
409사용량이 인스턴스 제한을 초과함
응답
{
  "id": "c5dge2d3rn7breq27i9g",
  "backend": "ibm_backend",
  "private": true
}

작업 나열

실행한 양자 프로그램 작업을 나열합니다.

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.read

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.read

입력

쿼리 매개변수
이름, 유형
설명
limit
integer

한 번에 반환할 결과의 수입니다. 제공된 값이 실행 가능한 범위를 벗어나는 경우 오류가 발생하지 않고 기본값이 대신 사용됩니다.

기본값: 200
최소값: 1
최대값: 200
offset
integer

작업 목록을 검색할 때 상쇄할 결과의 수입니다. 제공된 값이 실행 가능한 범위를 벗어나는 경우 오류가 발생하지 않고 기본값이 대신 사용됩니다.

기본값: 0
최소값: 0
최대값: 2147483647
pending
boolean

참이면 '대기 중' 및 '실행 중' 작업을 반환합니다. 거짓이면 '완료됨', '취소됨', '실패됨' 작업을 반환합니다.

program
string

프로그램 ID로 작업 필터링

backend
string

작업을 필터링하는 백엔드

created_after
string

필터 후 생성된 작업

created_before
string

필터 전에 생성된 작업

sort
string

생성 시간 ASC 또는 DESC(기본값)를 기준으로 작업 정렬

tags
string[]

작업 필터링할 태그

session_id
string

작업을 필터링하는 세션 ID

exclude_params
boolean

응답에서 작업 매개변수 제외

기본값: true
코드 샘플
GET
/v1/jobs

인스턴스가 eu-de 리전에 있는 경우, 대신 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
200확인
400잘못된 요청
401권한 없음
403금지됨
404찾을 수 없음
응답
{
  "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
}

작업 세부 정보 나열

지정된 퀀텀 프로그램 작업에 대한 세부 정보를 나열합니다.

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.read

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.read

입력

경로 매개변수
이름, 유형
설명
id
필수
string

기존 작업의 식별자

쿼리 매개변수
이름, 유형
설명
exclude_params
boolean

응답에서 작업 매개변수 제외

기본값: false
코드 샘플
GET
/v1/jobs/{id}

인스턴스가 eu-de 리전에 있는 경우, 대신 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
200확인
401권한 없음
403금지됨
404찾을 수 없음
응답
{
  "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"
}

작업 삭제

지정된 작업 및 관련 데이터를 삭제합니다. 작업은 종료 상태여야 합니다.

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.delete

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.delete

입력

경로 매개변수
이름, 유형
설명
id
필수
string

기존 작업의 식별자

코드 샘플
DELETE
/v1/jobs/{id}

인스턴스가 eu-de 리전에 있는 경우, 대신 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
204확인
400잘못된 요청
401권한 없음
403금지됨
404찾을 수 없음
500내부 오류 삭제 작업
응답
확인

작업 취소

지정된 작업을 취소합니다.

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.cancel

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.cancel

입력

경로 매개변수
이름, 유형
설명
id
필수
string

작업 ID

코드 샘플
POST
/v1/jobs/{id}/cancel

인스턴스가 eu-de 리전에 있는 경우, 대신 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
204확인
400잘못된 취소 요청
401권한 없음
403금지됨
404찾을 수 없음
409작업이 취소할 수 없는 상태입니다.
500내부 오류로 작업 취소
응답
확인

작업 로그 나열

지정된 작업에 대한 모든 작업 로그를 나열합니다.

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.read

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.read

입력

경로 매개변수
이름, 유형
설명
id
필수
string

작업 ID

코드 샘플
GET
/v1/jobs/{id}/logs

인스턴스가 eu-de 리전에 있는 경우, 대신 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
200작업 로그를 반환합니다.
401권한 없음
403금지됨
404찾을 수 없음
응답
작업 로그를 반환합니다.

작업 메트릭 가져오기

지정된 작업의 메트릭을 가져옵니다

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.read

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.read

입력

경로 매개변수
이름, 유형
설명
id
필수
string

작업 ID

코드 샘플
GET
/v1/jobs/{id}/metrics

인스턴스가 eu-de 리전에 있는 경우, 대신 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
200확인
401권한 없음
403금지됨
404찾을 수 없음
응답
{
  "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"
}

작업 결과 나열

이 작업의 최종 결과를 반환합니다.

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.read

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.read

입력

경로 매개변수
이름, 유형
설명
id
필수
string

작업 ID

코드 샘플
GET
/v1/jobs/{id}/results

인스턴스가 eu-de 리전에 있는 경우, 대신 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'

출력

HTTP 응답 상태 코드
상태 코드
설명
200작업의 최종 결과를 반환합니다.
204작업의 최종 결과를 찾을 수 없습니다.
400잘못된 요청
401권한 없음
403금지됨
404찾을 수 없음
응답
{
  "schema_version": "v0.1",
  "data": [
    {
      "results": {},
      "metadata": null
    }
  ],
  "metadata": {
    "chunk_timing": [
      {
        "start": "example",
        "stop": "example",
        "parts": [
          {
            "idx_item": 1,
            "size": 1
          }
        ]
      }
    ]
  }
}

작업 태그 교체

작업 태그 교체

권한 부여

이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access

  • quantum-computing.job.update

감사

이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.

  • quantum-computing.job.update

입력

경로 매개변수
이름, 유형
설명
id
필수
string

작업 ID

본문 매개변수
이름, 유형
설명
tags
필수
string[]

작업 또는 프로그램 태그 목록

코드 샘플
PUT
/v1/jobs/{id}/tags

인스턴스가 eu-de 리전에 있는 경우, 대신 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"]}'

출력

HTTP 응답 상태 코드
상태 코드
설명
204확인
401권한 없음
403금지됨
404찾을 수 없음
응답
확인
이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.