アカウント
アカウント構成の取得
現在の口座情報を入手する。 アカウント情報が見つからない場合は、デフォルトの設定を返します。
許可
このメソッドを呼び出すには、以下のアクションを含む1つ以上のIAMアクセス・ロールが割り当てられている必要があります。 アクセス状況を確認するには、次に移動してください。 Users > User > Access
quantum-computing.account-configuration.read
監査
このメソッドを呼び出すと、以下の監査イベントが生成されます。
quantum-computing.account-configuration.read
入力
名前、タイプ | 説明 |
|---|---|
id 必須 string | アカウントID( |
名前、タイプ | 説明 |
|---|---|
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: 2026-04-15' インスタンスが 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": "2026-04-15",
"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": "1つのアカウント内の各プラン契約を識別するためのサブスクリプション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で行ってください。