Cuentas
Obtener configuración de cuenta
Obtener la información de la cuenta corriente. Si no se encuentra información sobre la cuenta, devuelve la configuración por defecto.
Autorización
Para llamar a este método, debe tener asignados uno o varios roles de acceso IAM que incluyan las siguientes acciones. Para comprobar su acceso, vaya a Users > User > Access
quantum-computing.account-configuration.read
Auditoría
La invocación de este método genera los siguientes eventos de auditoría.
quantum-computing.account-configuration.read
Entrada
Nombre, Tipo | Descripción |
|---|---|
id Obligatorio string | Id. de cuenta (sin el prefijo |
Nombre, Tipo | Descripción |
|---|---|
plan_id string | Obtener la configuración de la cuenta sólo para el plan especificado |
Ejemplos de código
GET
/v1/accounts/{id} Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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' Si tu instancia se encuentra en la región «eu-de», utiliza en su lugar este enlace: 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())Resultado
Código de estado | Descripción |
|---|---|
| 200 | Configuración de la cuenta recuperada correctamente |
| 400 | Solicitud errónea |
| 401 | No autorizado |
| 404 | No se ha encontrado |
| 500 | Error interno |
Respuestas
{
"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": "Configuración de una cuenta gestionada por el servicio IBM Qiskit Runtime.",
"properties": {
"plans": {
"description": "La lista de configuraciones de la cuenta por plan",
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"description": "El identificador del plan definido en el Catálogo Global",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"subscription_id": {
"type": "string",
"description": "El ID de la suscripción para identificar cada contrato de plan en una cuenta",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 36
},
"subscription_name": {
"type": "string",
"description": "El nombre legible para el usuario de la suscripción",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"usage_allocation_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "La suma máxima de la asignación de uso permitida para todas las instancias de la cuenta. Es obligatorio cuando plan_id se refiere a un plan flexible."
},
"usage_limit_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "El tiempo máximo durante el cual las cargas de trabajo pueden ejecutarse en todas las instancias de la cuenta para el plan especificado. Es obligatorio cuando plan_id se refiere a un plan flexible."
},
"backends": {
"type": "array",
"description": "Lista de backends que la cuenta puede asignar a instancias.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"minItems": 0,
"maxItems": 100
},
"max_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "El tiempo máximo (en segundos) de ejecución de la sesión, sujeto a los límites del plan."
},
"active_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "El tiempo restante (en segundos) para que la sesión esté en estado activo mientras se ejecutan trabajos. Debe ser menor o igual que ttl máx."
},
"interactive_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "El tiempo máximo (en segundos) entre trabajos para mantener la sesión activa. Debe ser menor o igual que el ttl activo."
},
"start_time": {
"type": "string",
"format": "date-time",
"description": "Fecha de inicio de los planes con contrato. Es obligatorio cuando plan_id se refiere a un plan flexible."
},
"end_time": {
"type": "string",
"format": "date-time",
"description": "Fecha de vencimiento de los planes con contrato. Es obligatorio cuando plan_id se refiere a un plan flexible."
},
"functions": {
"type": "array",
"description": "Funciones disponibles para este plan de cuenta. Cada entrada especifica un identificador de función, un modelo de facturación y el conjunto de acciones permitidas. A diferencia de la configuración a nivel de instancia, `[\"ANY\"]` no es un valor válido: las funciones deben indicarse explícitamente.",
"items": {
"type": "object",
"description": "Una función disponible para un plan de cuentas.",
"properties": {
"provider": {
"type": "string",
"description": "El nombre del proveedor de la función.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "ibm"
},
"name": {
"type": "string",
"description": "El nombre de la función, único dentro de un proveedor.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "circuit-function"
},
"business_model": {
"type": "string",
"description": "El modelo de negocio en el que se ofrece el servicio.",
"enum": [
"trial",
"subsidized",
"consumption"
]
},
"permissions": {
"type": "array",
"description": "Acciones de tipo IAM concedidas para esta función.",
"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": "Derechos a funciones personalizadas configurados en un plan de cuenta.",
"properties": {
"permissions": {
"type": "array",
"description": "Acciones disponibles para las funciones personalizadas.",
"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": "La asignación de uso restante que aún puede asignarse a instancias."
}
}
}
]
},
"minItems": 0,
"maxItems": 20
}
},
"required": [
"plans"
]
}¿Le ha resultado útil esta página?
Informe de un error, de una errata o solicite contenido en GitHub.