Skip to main content
IBM Quantum Platform

세션

세션 작성

세션 작성

권한 부여

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

  • quantum-computing.session.create

감사

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

  • quantum-computing.session.create

입력

본문 매개변수
이름, 유형
설명
max_ttl
integer

세션이 실행되는 최대 시간(초)으로, 요금제 제한에 따라 달라질 수 있습니다.

기본값: 28800
최소값: 1
최대값: 2147483647
mode
string

세션을 실행할 실행 모드

가능한 값: batchdedicated
backend
string

백엔드 이름

backend_name
string

백엔드 이름(대체)

코드 샘플
POST
/v1/sessions

인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/sessions

curl -X POST \
  'https://quantum.cloud.ibm.com/api/v1/sessions' \
  -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권한 없음
500내부 오류
응답
{
  "id": "example",
  "backend_name": "example",
  "started_at": "example",
  "activated_at": "example",
  "closed_at": "example",
  "last_job_started": "example",
  "last_job_completed": "example",
  "interactive_ttl": 1,
  "max_ttl": 1,
  "active_ttl": 1,
  "state": "open",
  "state_reason": "example",
  "accepting_jobs": true,
  "mode": "batch",
  "timestamps": [
    {
      "status": "open",
      "timestamp": "example"
    }
  ],
  "user_id": "example",
  "elapsed_time": 1.432
}

세션 받기

세션 받기

권한 부여

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

  • quantum-computing.session.read

감사

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

  • quantum-computing.session.read

입력

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

작업 세션 ID

코드 샘플
GET
/v1/sessions/{id}

인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/sessions/{id}

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/sessions/{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권한 없음
404찾을 수 없음
500내부 오류
응답
{
  "id": "example",
  "backend_name": "example",
  "started_at": "example",
  "activated_at": "example",
  "closed_at": "example",
  "last_job_started": "example",
  "last_job_completed": "example",
  "interactive_ttl": 1,
  "max_ttl": 1,
  "active_ttl": 1,
  "state": "open",
  "state_reason": "example",
  "accepting_jobs": true,
  "mode": "batch",
  "timestamps": [
    {
      "status": "open",
      "timestamp": "example"
    }
  ],
  "user_id": "example",
  "elapsed_time": 1.432
}

세션 업데이트

세션 업데이트

권한 부여

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

  • quantum-computing.session.update

감사

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

  • quantum-computing.session.update

입력

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

작업 세션 ID

본문 매개변수
이름, 유형
설명
accepting_jobs
필수
boolean

참이면 세션이 대기열에 추가할 새 작업을 적극적으로 수락하는 것입니다. 거짓이면 작업 생성 시 작업이 거부되고 세션에 더 이상 실행할 작업이 없으면 세션이 즉시 닫힙니다.

코드 샘플
PATCH
/v1/sessions/{id}

인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/sessions/{id}

curl -X PATCH \
  'https://quantum.cloud.ibm.com/api/v1/sessions/{id}' \
  -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 '{"accepting_jobs":true}'

출력

HTTP 응답 상태 코드
상태 코드
설명
204세션 업데이트 성공
401권한 없음
404찾을 수 없음
500내부 오류
응답
세션 업데이트 성공

작업 세션 닫기

런타임 세션을 닫습니다. 세션에서 새 작업 수락이 중지되고 대기 중인 작업이 실행되지 않습니다. 기존에 실행 중인 작업이 완료될 때까지 실행됩니다. 이는 키스킷의 cancel() 함수와 유사합니다.

권한 부여

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

  • quantum-computing.session.update

감사

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

  • quantum-computing.session.update

입력

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

세션 ID

코드 샘플
DELETE
/v1/sessions/{id}/close

인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/sessions/{id}/close

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

출력

HTTP 응답 상태 코드
상태 코드
설명
204런타임 세션이 성공적으로 종료되었습니다
응답
런타임 세션이 성공적으로 종료되었습니다
이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.