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: 2024-01-01' 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": "2024-01-01",
"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_allocation_ru": 3.5,
"usage_limit_seconds": 200,
"usage_limit_ru": 3.5,
"unallocated_usage_seconds": 200,
"unallocated_usage_ru": 3.5,
"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_allocation_ru": 2.5,
"usage_limit_seconds": 300,
"usage_limit_ru": 5,
"unallocated_usage_seconds": 10,
"unallocated_usage_ru": 0.166667,
"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, expresada en segundos, para todas las instancias de la cuenta. Es obligatorio cuando plan\\_id se refiere a un plan flexible."
},
"usage_allocation_ru": {
"type": "number",
"format": "float",
"minimum": 0,
"maximum": 9007199254740991,
"description": "La suma máxima de la asignación de uso permitida en unidades de recurso 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, expresado en segundos, durante el cual pueden ejecutarse las cargas de trabajo en todas las instancias de la cuenta para el plan especificado. Es obligatorio cuando plan\\_id se refiere a un plan flexible."
},
"usage_limit_ru": {
"type": "number",
"format": "float",
"minimum": 0,
"maximum": 9007199254740991,
"description": "El tiempo máximo durante el que las cargas de trabajo pueden ejecutarse en todas las instancias de la cuenta para el plan especificado, expresado en unidades de recursos. 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, en segundos, que aún se puede asignar a las instancias."
}
}
},
{
"type": "object",
"properties": {
"unallocated_usage_ru": {
"type": "number",
"format": "float",
"minimum": 0,
"maximum": 9007199254740991,
"description": "La asignación de uso restante, expresada en unidades de recurso, 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.