계정
계정 구성 가져오기
현재 계정 정보를 가져옵니다. 계정 정보를 찾을 수 없는 경우 기본 구성을 반환합니다.
권한 부여
이 메소드를 호출하려면 다음 조치를 포함하는 하나 이상의 IAM 액세스 역할이 지정되어야 합니다. 다음으로 이동하여 액세스 권한을 확인할 수 있습니다. Users > User > Access
quantum-computing.account-configuration.read
감사
이 메소드를 호출하면 다음과 같은 감사 이벤트가 생성됩니다.
quantum-computing.account-configuration.read
입력
이름, 유형 | 설명 |
|---|---|
id 필수 string | 계정 아이디( |
이름, 유형 | 설명 |
|---|---|
plan_id string | 지정된 요금제에 대해서만 계정 구성을 가져옵니다 |
코드 샘플
GET
/v1/accounts/{id} 인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/accounts/{id}
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/accounts/{id}' \
-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/accounts/{id}
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/accounts/{id}",
headers={
"Accept": "application/json",
"IBM-API-Version": "2024-01-01",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())출력
상태 코드 | 설명 |
|---|---|
| 200 | 계정 구성이 성공적으로 검색되었습니다 |
| 400 | 잘못된 요청 |
| 401 | 권한 없음 |
| 404 | 찾을 수 없음 |
| 500 | 내부 오류 |
응답
{
"plans": [
{
"plan_id": "flex-plan-id-1",
"subscription_id": "53bde9d3-cdbb-46f5-a98f-60ebcadf7260",
"subscription_name": "flex",
"usage_allocation_seconds": 200,
"usage_limit_seconds": 200,
"unallocated_usage_seconds": 200,
"backends": [
"ibm_backend"
],
"max_ttl": 28800,
"active_ttl": 28800,
"interactive_ttl": 60,
"start_time": "2025-05-17T00:00:00Z",
"end_time": "2026-05-17T00:00:00Z"
},
{
"plan_id": "plan-id-2",
"subscription_id": "52fde9d3-cdbb-46f5-a98f-60ebchdf7260",
"subscription_name": "open",
"usage_allocation_seconds": 150,
"usage_limit_seconds": 300,
"unallocated_usage_seconds": 10,
"backends": [
"backend1",
"backend2"
]
},
{
"plan_id": "plan-id-3",
"subscription_id": "91b2c828-2952-4f05-aed8-bedf92c6c480",
"subscription_name": "internal",
"backends": [
"backend1",
"backend2"
]
}
]
}{
"type": "object",
"description": "IBM Qiskit Runtime 서비스에서 관리하는 계정에 대한 구성입니다.",
"properties": {
"plans": {
"description": "요금제별 계정에 대한 구성 목록",
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"description": "글로벌 카탈로그에 정의된 플랜 ID",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"subscription_id": {
"type": "string",
"description": "하나의 계정 내 각 플랜 계약을 식별하기 위한 구독 ID",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 36
},
"subscription_name": {
"type": "string",
"description": "구독의 사용자 친화적인 이름",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"usage_allocation_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "계정 내 모든 인스턴스에 대해 허용되는 사용량 할당량의 최대 합계. plan_id가 플렉스 플랜과 관련된 경우 필수입니다."
},
"usage_limit_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "지정된 요금제에 대해 계정 내 모든 인스턴스에서 워크로드가 실행될 수 있는 최대 시간입니다. plan_id가 플렉스 플랜과 관련된 경우 필수입니다."
},
"backends": {
"type": "array",
"description": "계정이 인스턴스에 할당할 수 있도록 허용할 백엔드 목록입니다.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"minItems": 0,
"maxItems": 100
},
"max_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "세션이 실행되는 최대 시간(초)으로, 요금제 제한에 따라 달라질 수 있습니다."
},
"active_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "작업이 실행되는 동안 세션이 활성 상태로 유지되는 남은 시간(초)입니다. 최대 TTL보다 작거나 같아야 합니다."
},
"interactive_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "세션을 활성 상태로 유지하기 위한 작업 간 최대 시간(초)입니다. 활성 TTL보다 작거나 같아야 합니다."
},
"start_time": {
"type": "string",
"format": "date-time",
"description": "계약 기반 요금제의 시작 시간. plan_id가 플렉스 플랜과 관련된 경우 필수입니다."
},
"end_time": {
"type": "string",
"format": "date-time",
"description": "계약형 요금제의 종료 시점. plan_id가 플렉스 플랜과 관련된 경우 필수입니다."
},
"functions": {
"type": "array",
"description": "이 계정 플랜에서 이용할 수 있는 기능. 각 항목에는 함수 ID, 과금 모델 및 허용된 작업 집합이 명시되어 있습니다. 인스턴스 수준 구성과 달리, `[\"ANY\"]` 는 유효한 값이 아닙니다. 함수는 반드시 명시적으로 나열해야 합니다.",
"items": {
"type": "object",
"description": "계정 플랜에서 사용할 수 있는 기능입니다.",
"properties": {
"provider": {
"type": "string",
"description": "함수 제공자의 이름.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "ibm"
},
"name": {
"type": "string",
"description": "프로바이더 내에서 고유한 함수 이름.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "circuit-function"
},
"business_model": {
"type": "string",
"description": "해당 기능이 제공되는 비즈니스 모델.",
"enum": [
"trial",
"subsidized",
"consumption"
]
},
"permissions": {
"type": "array",
"description": "이 함수에 부여된 IAM 스타일의 작업.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256
},
"minItems": 1,
"maxItems": 2147483647,
"example": [
"function.run"
]
}
},
"required": [
"provider",
"name",
"business_model",
"permissions"
]
},
"minItems": 0,
"maxItems": 2147483647
},
"custom_functions": {
"type": "object",
"description": "계정 플랜에 구성된 사용자 정의 기능 이용 권한.",
"properties": {
"permissions": {
"type": "array",
"description": "사용자 정의 함수에 대해 허용되는 작업.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256
},
"minItems": 1,
"maxItems": 2147483647,
"example": [
"function-custom.run"
]
}
},
"required": [
"permissions"
]
}
},
"required": [
"backends",
"plan_id",
"subscription_id",
"subscription_name"
]
},
{
"type": "object",
"properties": {
"unallocated_usage_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "인스턴스에 할당할 수 있는 남은 사용량 할당량입니다."
}
}
}
]
},
"minItems": 0,
"maxItems": 20
}
},
"required": [
"plans"
]
}이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.