Skip to main content
IBM Quantum Platform

인스턴스


현재 인스턴스 세부 정보 가져오기

요청 헤더의 CRN을 사용하여 현재 로그인한 인스턴스의 세부 정보를 반환합니다.

권한 부여

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

  • quantum-computing.instance.read

감사

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

  • quantum-computing.instance.read

입력

정보
이 엔드포인트는 입력을 허용하지 않습니다.
코드 샘플
GET
/v1/instance

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

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/instance' \
  -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찾을 수 없음
응답
{
  "backends": [
    "ibm_backend"
  ],
  "instance_limit": 60.7,
  "instance_limit_seconds": "61",
  "plan_id": "flex-plan-id-1",
  "usage_allocation_seconds": "200"
}

인스턴스 구성 가져오기

사용 중단됨: 인스턴스 구성을 관리하려면 Resource Controller 를 사용하십시오. /docs/guides/access-instances-platform-apis 를 참조하십시오. 요청 헤더의 CRN를 사용하여 지정된 인스턴스에 대한 구성 정보(예: 초 단위의 인스턴스 제한)를 반환합니다.

권한 부여

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

  • quantum-computing.instance.configuration.read

감사

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

  • quantum-computing.instance.configuration.read

입력

정보
이 엔드포인트는 입력을 허용하지 않습니다.
코드 샘플
GET
/v1/instances/configuration

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

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/instances/configuration' \
  -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찾을 수 없음
응답
{
  "instance_limit": 123456
}

인스턴스 구성 업데이트

사용 중단됨: 인스턴스 구성을 관리하려면 Resource Controller 를 사용하십시오. /docs/guides/access-instances-platform-apis 를 참조하십시오. 요청의 컨텍스트 매개변수에서 CRN 를 사용하여 지정된 인스턴스의 구성(예: 초 단위의 인스턴스 제한)을 업데이트합니다.

권한 부여

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

  • quantum-computing.instance.configuration.update

감사

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

  • quantum-computing.instance.configuration.update

입력

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

이 필드는 널 또는 정수일 수 있습니다. 인스턴스 제한을 재설정/제거하려면 null을 사용합니다.

최소값: 1
최대값: 2147483647
코드 샘플
PUT
/v1/instances/configuration

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

curl -X PUT \
  'https://quantum.cloud.ibm.com/api/v1/instances/configuration' \
  -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사용량이 인스턴스 제한을 초과함
응답
확인

인스턴스 사용량 가져오기

인스턴스 사용량 가져오기

권한 부여

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

  • quantum-computing.instance-usage.read

감사

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

  • quantum-computing.instance-usage.read

입력

정보
이 엔드포인트는 입력을 허용하지 않습니다.
코드 샘플
GET
/v1/instances/usage

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

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/instances/usage' \
  -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권한 없음
응답
{
  "instance_id": "example",
  "plan_id": "example",
  "usage_period": {
    "start_time": "example",
    "end_time": "example"
  },
  "usage_consumed_seconds": 12,
  "usage_limit_seconds": 60,
  "usage_allocation_seconds": 120,
  "usage_limit_reached": true,
  "time_available_at": "2024-01-01T00:00:00.000Z"
}
이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.