인스턴스
현재 인스턴스 세부 정보 가져오기
요청 헤더의 CRN을 사용하여 현재 로그인한 인스턴스의 세부 정보를 반환합니다.
권한 부여
이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access
quantum-computing.instance.read
감사
이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.
quantum-computing.instance.read
입력
정보 |
|---|
| 이 엔드포인트는 입력을 허용하지 않습니다. |
인스턴스가 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' 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/instance
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/instance",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 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"
}{
"type": "object",
"description": "인스턴스",
"properties": {
"backends": {
"type": "array",
"description": "서비스 인스턴스와 연결된 백엔드 시스템 또는 클러스터 목록",
"items": {
"type": "string",
"pattern": "^.*$",
"minLength": 1,
"maxLength": 128,
"nullable": false
},
"minItems": 0,
"maxItems": 100
},
"instance_limit": {
"type": "number",
"format": "double",
"description": "인스턴스 제한을 초 단위로 나타내며, 인스턴스\\_limit\\_seconds로 대체됩니다",
"deprecated": true
},
"instance_limit_seconds": {
"type": "string",
"description": "이 인스턴스에서 실행할 수 있는 최대 리소스 시간을 지정합니다"
},
"plan_id": {
"type": "string",
"description": "글로벌 카탈로그에 정의된 인스턴스와 연결된 서비스 플랜의 식별자입니다",
"pattern": "^.*$",
"minLength": 1,
"maxLength": 128
},
"usage_allocation_seconds": {
"type": "string",
"description": "인스턴스에서 허용되는 사용량 할당의 최대 합계입니다."
}
}
}인스턴스 구성 가져오기
사용 중단됨: 인스턴스 구성을 관리하려면 Resource Controller 를 사용하십시오. /docs/guides/access-instances-platform-apis 를 참조하십시오. 요청 헤더의 CRN를 사용하여 지정된 인스턴스에 대한 구성 정보(예: 초 단위의 인스턴스 제한)를 반환합니다.
권한 부여
이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access
quantum-computing.instance.configuration.read
감사
이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.
quantum-computing.instance.configuration.read
입력
정보 |
|---|
| 이 엔드포인트는 입력을 허용하지 않습니다. |
인스턴스가 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' 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/instances/configuration
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/instances/configuration",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 200 | 확인 |
| 401 | 권한 없음 |
| 403 | 금지됨 |
| 404 | 찾을 수 없음 |
{
"instance_limit": 123456
}{
"type": "object",
"description": "인스턴스 구성",
"properties": {
"instance_limit": {
"type": "number",
"format": "double",
"description": "초 단위 인스턴스 사용량 제한"
}
}
}인스턴스 구성 업데이트
사용 중단됨: 인스턴스 구성을 관리하려면 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 |
인스턴스가 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' 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/instances/configuration
import requests
response = requests.request(
"PUT",
"https://quantum.cloud.ibm.com/api/v1/instances/configuration",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 204 | 확인 |
| 400 | 잘못된 요청 |
| 401 | 권한 없음 |
| 403 | 금지됨 |
| 404 | 찾을 수 없음 |
| 409 | 사용량이 인스턴스 제한을 초과함 |
인스턴스 사용량 가져오기
인스턴스 사용량 가져오기
권한 부여
이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access
quantum-computing.instance-usage.read
감사
이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.
quantum-computing.instance-usage.read
입력
정보 |
|---|
| 이 엔드포인트는 입력을 허용하지 않습니다. |
인스턴스가 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' 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/instances/usage
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/instances/usage",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 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"
}{
"type": "object",
"properties": {
"instance_id": {
"type": "string"
},
"plan_id": {
"type": "string"
},
"usage_period": {
"description": "사용 기간의 시작 및 종료 시간",
"allOf": [
{
"type": "object",
"properties": {
"start_time": {
"format": "date-time",
"type": "string",
"description": "사용 시작 시간"
},
"end_time": {
"format": "date-time",
"type": "string",
"description": "사용 종료 시간"
}
}
}
]
},
"usage_consumed_seconds": {
"type": "number",
"example": 12,
"description": "현재 사용 기간에 소비된 사용량"
},
"usage_limit_seconds": {
"type": "number",
"example": 60,
"description": "사용 기간 동안 초 단위의 사용 제한"
},
"usage_allocation_seconds": {
"type": "number",
"example": 120,
"description": "사용 기간 동안 인스턴스에 할당된 시간(초)"
},
"usage_limit_reached": {
"type": "boolean",
"example": false,
"description": "사용량 제한에 도달하면 참입니다. 도달하지 못하면 거짓입니다. 사용량 제한이 이 인스턴스에 적용되지 않는 경우 정의되지 않음."
},
"time_available_at": {
"format": "date-time",
"type": "string",
"description": "28일 기간이 지나면서 이전 사용량이 제외됨에 따라 사용량이 인스턴스 한도를 밑돌게 되는 가장 이른 시점. 롤링 윈도우 계획에서 인스턴스 수준 제한에 도달한 경우에만 표시됩니다.",
"example": "2024-01-01T00:00:00.000Z",
"minLength": 20,
"maxLength": 29
}
},
"required": [
"instance_id",
"plan_id",
"usage_consumed_seconds"
]
}