Skip to main content
IBM Quantum Platform
이 REST API는 환경에서 해당 기능을 사용으로 설정한 On-Prem Plan 멤버만 사용 가능합니다.

작업

작업 실행

Qiskit Runtime 의 기본 함수를 호출합니다.

권한 부여

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

  • quantum-computing.direct-access-job.create

감사

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

  • quantum-computing.direct-access-job.create

입력

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

백엔드 이름

예: "ibm_rensselaer"
id
필수
string

작업 식별자. UUID로 권장됨

log_level
string

프로그램의 로깅 수준

가능한 값: infodebugwarningerrorcritical
기본값: warning
program_id
필수
string

프로그램 ID

예: "sampler"
storage
필수
object
timeout_secs
필수
integer

작업이 시간 초과되어 취소되기까지의 시간(초). 시스템 실행 시간(벽시계 시간이 아님)을 기준으로 합니다. 시스템 실행 시간은 시스템이 귀하의 작업을 처리하는 데 할당된 시간입니다.

코드 샘플
POST
/v1/jobs
curl -X POST \
  '<YOUR_QSA_URL>/v1/jobs' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"id":"example","program_id":"sampler","backend":"ibm_rensselaer","timeout_secs":1,"storage":{}}'

출력

HTTP 응답 상태 코드
상태 코드
설명
204작업이 성공적으로 제출되었을 때 반환됨.
400잘못된 입력이 수신되었을 때 반환됩니다.
401인증에 실패했을 때 반환됩니다.
404백엔드를 찾을 수 없을 때 반환됨
408요청을 읽는 데 너무 오래 걸렸을 때 반환됨.
409동일한 작업 ID를 가진 중복 작업이 제출되었을 때 반환됩니다.
413요청 본문이 너무 클 때 반환됩니다.
422요청 유효성 검사가 실패했을 때 반환됩니다. 오류 메시지에는 특정 유효성 검사 오류에 대한 세부 정보가 포함되어 있습니다.
423요청된 백엔드는 예약되어 있으며 예약 범위를 벗어난 작업은 실행할 수 없습니다.
429백엔드 동시 작업 제한에 도달했을 때 반환됩니다. 기존 작업이 종료된 후 다시 시도하고, 종료된 작업을 삭제하여 추가 작업을 제출하십시오.
응답
작업이 성공적으로 제출되었을 때 반환됨.

작업 가져오기

현재 인증된 클라이언트가 제출한 모든 작업 목록을 생성 시간 순으로 오름차순으로 정렬하여 가져옵니다.

권한 부여

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

  • quantum-computing.direct-access-job.list

감사

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

  • quantum-computing.direct-access-job.list

입력

정보
이 엔드포인트는 입력을 허용하지 않습니다.
코드 샘플
GET
/v1/jobs
curl -X GET \
  '<YOUR_QSA_URL>/v1/jobs' \
  -H 'Accept: application/json'

출력

HTTP 응답 상태 코드
상태 코드
설명
200작업이 성공적으로 검색되었을 때 반환됨.
401인증에 실패했을 때 반환됩니다.
응답
{
  "jobs": [
    {
      "backend": "ibm_rensselaer",
      "created_time": "example",
      "end_time": "example",
      "id": "example",
      "log_level": "info",
      "metrics": {
        "circuits_execution_time_ns": 1,
        "timestamps": {
          "created": "example",
          "finished": "example"
        }
      },
      "program_id": "sampler",
      "reason_code": 1,
      "reason_message": "example",
      "reason_solution": "example",
      "status": "Running",
      "storage": {
        "input": {
          "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
          "object_name": "example",
          "presigned_url": "example",
          "region": "us-east",
          "region_type": "regional",
          "runtime_instance_crn": "crn:v1:bluemix:public:quantum-computing:us-east:a/abc123:abc123::",
          "type": "s3_compatible"
        },
        "logs": {
          "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
          "object_name": "example",
          "presigned_url": "example",
          "region": "us-east",
          "region_type": "regional",
          "runtime_instance_crn": "crn:v1:bluemix:public:quantum-computing:us-east:a/abc123:abc123::",
          "type": "s3_compatible"
        },
        "results": {
          "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
          "object_name": "example",
          "presigned_url": "example",
          "region": "us-east",
          "region_type": "regional",
          "runtime_instance_crn": "crn:v1:bluemix:public:quantum-computing:us-east:a/abc123:abc123::",
          "type": "s3_compatible"
        }
      },
      "timeout_secs": 1,
      "usage": {
        "quantum_nanoseconds": 1
      }
    }
  ]
}

ID로 일자리 찾기

현재 인증된 클라이언트에 대해 고유 식별자를 사용하여 단일 작업을 가져옵니다.

권한 부여

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

  • quantum-computing.direct-access-job.read

감사

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

  • quantum-computing.direct-access-job.read

입력

경로 매개변수
이름, 유형
설명
job-id
필수
string
코드 샘플
GET
/v1/jobs/{job-id}
curl -X GET \
  '<YOUR_QSA_URL>/v1/jobs/{job-id}' \
  -H 'Accept: application/json'

출력

HTTP 응답 상태 코드
상태 코드
설명
200작업이 성공적으로 검색되었습니다.
401인증에 실패했을 때 반환됩니다.
404인증된 클라이언트에 속한 제공된 ID에 대한 작업이 발견되지 않았습니다.
응답
{
  "backend": "ibm_rensselaer",
  "created_time": "example",
  "end_time": "example",
  "id": "example",
  "log_level": "info",
  "metrics": {
    "circuits_execution_time_ns": 1,
    "timestamps": {
      "created": "example",
      "finished": "example"
    }
  },
  "program_id": "sampler",
  "reason_code": 1,
  "reason_message": "example",
  "reason_solution": "example",
  "status": "Running",
  "storage": {
    "input": {
      "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
      "object_name": "example",
      "presigned_url": "example",
      "region": "us-east",
      "region_type": "regional",
      "runtime_instance_crn": "crn:v1:bluemix:public:quantum-computing:us-east:a/abc123:abc123::",
      "type": "s3_compatible"
    },
    "logs": {
      "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
      "object_name": "example",
      "presigned_url": "example",
      "region": "us-east",
      "region_type": "regional",
      "runtime_instance_crn": "crn:v1:bluemix:public:quantum-computing:us-east:a/abc123:abc123::",
      "type": "s3_compatible"
    },
    "results": {
      "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
      "object_name": "example",
      "presigned_url": "example",
      "region": "us-east",
      "region_type": "regional",
      "runtime_instance_crn": "crn:v1:bluemix:public:quantum-computing:us-east:a/abc123:abc123::",
      "type": "s3_compatible"
    }
  },
  "timeout_secs": 1,
  "usage": {
    "quantum_nanoseconds": 1
  }
}

작업 삭제

작업이 종료된 경우 해당 작업을 삭제합니다.

권한 부여

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

  • quantum-computing.direct-access-job.delete

감사

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

  • quantum-computing.direct-access-job.delete

입력

경로 매개변수
이름, 유형
설명
job-id
필수
string
코드 샘플
DELETE
/v1/jobs/{job-id}
curl -X DELETE \
  '<YOUR_QSA_URL>/v1/jobs/{job-id}' \
  -H 'Accept: application/json'

출력

HTTP 응답 상태 코드
상태 코드
설명
204작업이 성공적으로 삭제되었을 때 반환됨.
401인증에 실패했을 때 반환됩니다.
404작업이 발견되지 않을 때 반환됩니다.
409작업이 아직 종료되지 않았고 삭제하기 전에 취소해야 할 때 반환됩니다.
응답
작업이 성공적으로 삭제되었을 때 반환됨.

작업 취소

작업이 아직 종료되지 않은 경우 작업을 취소합니다.

권한 부여

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

  • quantum-computing.direct-access-job.cancel

감사

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

  • quantum-computing.direct-access-job.cancel

입력

경로 매개변수
이름, 유형
설명
job-id
필수
string
코드 샘플
POST
/v1/jobs/{job-id}/cancel
curl -X POST \
  '<YOUR_QSA_URL>/v1/jobs/{job-id}/cancel' \
  -H 'Accept: application/json'

출력

HTTP 응답 상태 코드
상태 코드
설명
204작업 취소 요청이 성공적으로 제출되었을 때 반환됩니다.
401인증에 실패했을 때 반환됩니다.
404작업이 발견되지 않을 때 반환됩니다.
409작업이 이미 종료되어 취소할 수 없을 때 반환됩니다.
500내부 서버 오류가 발생했을 때 반환됩니다.
응답
작업 취소 요청이 성공적으로 제출되었을 때 반환됩니다.
이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.