Analytics
Get analytics filters
Get analytics filters
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-analytics-filters.read
Auditoría
La invocación de este método genera los siguientes eventos de auditoría.
quantum-computing.account-analytics-filters.read
Entrada
Nombre, Tipo | Descripción |
|---|---|
instance string[] | Ejemplo: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
Ejemplos de código
GET
/v1/analytics/filters 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/analytics/filters
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/analytics/filters' \
-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/analytics/filters
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/analytics/filters",
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 | |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not found |
| 500 | Internal server error |
Respuestas
{
"backends": [
{
"name": "simulator"
}
],
"instances": [
{
"id": "crn:v1:staging:public:quantum-computing:region:a/account:",
"deleted": true
}
],
"users": [
{
"id": "123"
}
],
"plans": [
{
"name": "premium"
}
],
"subscriptions": [
{
"id": "7f666d17-7893-47d8-bf9d-2b2389fc4dfc",
"name": "premium"
}
]
}{
"type": "object",
"properties": {
"backends": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "simulator"
}
},
"required": [
"name"
]
}
},
"instances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "crn:v1:staging:public:quantum-computing:region:a/account:"
},
"deleted": {
"type": "boolean"
}
},
"required": [
"id",
"deleted"
]
}
},
"users": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "123"
}
},
"required": [
"id"
]
}
},
"plans": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "premium"
}
},
"required": [
"name"
]
}
},
"subscriptions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "7f666d17-7893-47d8-bf9d-2b2389fc4dfc"
},
"name": {
"type": "string",
"example": "premium"
}
},
"required": [
"id",
"name"
]
}
}
},
"required": [
"backends",
"instances",
"users",
"plans",
"subscriptions"
]
}Get usage analytics
Get usage analytics
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-analytics-usage.read
Auditoría
La invocación de este método genera los siguientes eventos de auditoría.
quantum-computing.account-analytics-usage.read
Entrada
Nombre, Tipo | Descripción |
|---|---|
instance string[] | Ejemplo: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | Ejemplo: "2024-01-01T00:00:00.000Z" |
interval_end string | Ejemplo: "2024-01-01T00:00:00.000Z" |
backend string[] | Ejemplo: "ibm_tenerife" |
user_id string[] | Ejemplo: "123" |
simulators boolean | Include simulators Valor predeterminado: true |
plan string[] | Ejemplo: "premium" |
subscription_id string[] | The subscription ID whose analytics are being requested. Could be a single ID or an array of IDs. Ejemplo: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
Ejemplos de código
GET
/v1/analytics/usage 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/analytics/usage
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/analytics/usage' \
-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/analytics/usage
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/analytics/usage",
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 | |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not found |
| 500 | Internal server error |
Respuestas
{
"usage": 10,
"jobs": 10,
"sessions": 10,
"sessions_usage": 10,
"avg_sessions_usage": 10,
"max_sessions_usage": 10,
"batch_sessions": 10,
"batch_sessions_usage": 10,
"avg_batch_sessions_usage": 10,
"max_batch_sessions_usage": 10,
"dedicated_sessions": 10,
"dedicated_sessions_usage": 10,
"avg_dedicated_sessions_usage": 10,
"max_dedicated_sessions_usage": 10,
"individual_jobs": 10,
"individual_jobs_usage": 10,
"avg_individual_jobs_usage": 10,
"max_individual_jobs_usage": 10,
"queue_time": 10,
"avg_queue_time": 10,
"max_queue_time": 10
}{
"type": "object",
"properties": {
"usage": {
"type": "number",
"example": 10,
"description": "Total usage (in milliseconds)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "Total number of jobs"
},
"sessions": {
"type": "number",
"example": 10,
"description": "Total number of sessions"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "Total sessions usage (in milliseconds)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average sessions usage (in milliseconds)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max sessions usage (in milliseconds)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "Total number of batch sessions"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Total batch sessions usage (in milliseconds)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average batch sessions usage (in milliseconds)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max batch sessions usage (in milliseconds)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "Total number of dedicated sessions"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Total dedicated sessions usage (in milliseconds)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average dedicated sessions usage (in milliseconds)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max dedicated sessions usage (in milliseconds)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "Total number of individual jobs"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Total individual jobs usage (in milliseconds)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Average individual jobs usage (in milliseconds)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Max individual jobs usage (in milliseconds)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "Total queue time (in milliseconds)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "Average queue time (in milliseconds)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "Max queue time (in milliseconds)"
}
},
"required": [
"usage",
"jobs",
"sessions",
"sessions_usage",
"avg_sessions_usage",
"max_sessions_usage",
"batch_sessions",
"batch_sessions_usage",
"avg_batch_sessions_usage",
"max_batch_sessions_usage",
"dedicated_sessions",
"dedicated_sessions_usage",
"avg_dedicated_sessions_usage",
"max_dedicated_sessions_usage",
"individual_jobs",
"individual_jobs_usage",
"avg_individual_jobs_usage",
"max_individual_jobs_usage",
"queue_time",
"avg_queue_time",
"max_queue_time"
]
}Get usage analytics grouped
Get usage analytics grouped
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-analytics-usage.read
Auditoría
La invocación de este método genera los siguientes eventos de auditoría.
quantum-computing.account-analytics-usage.read
Entrada
Nombre, Tipo | Descripción |
|---|---|
group_by Obligatorio string | key to group usage by Valores posibles: instancebackenduser_idplansubscription_idEjemplo: "instance" |
instance string[] | Ejemplo: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | start date Ejemplo: "2024-01-01T00:00:00.000Z" |
interval_end string | end date Ejemplo: "2024-01-01T00:00:00.000Z" |
backend string[] | backend to filter by Ejemplo: "ibm_tenerife" |
user_id string[] | Ejemplo: "123" |
simulators boolean | Include simulators Valor predeterminado: true |
plan string[] | Ejemplo: "premium" |
subscription_id string[] | The subscription ID whose analytics are being requested. Could be a single ID or an array of IDs. Ejemplo: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
Ejemplos de código
GET
/v1/analytics/usage_grouped 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/analytics/usage_grouped
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/analytics/usage_grouped' \
-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/analytics/usage_grouped
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/analytics/usage_grouped",
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 | |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not found |
| 500 | Internal server error |
Respuestas
{
"data": [
{
"key": "ibm-q/main/open",
"usage": 10,
"jobs": 10,
"sessions": 10,
"sessions_usage": 10,
"avg_sessions_usage": 10,
"max_sessions_usage": 10,
"batch_sessions": 10,
"batch_sessions_usage": 10,
"avg_batch_sessions_usage": 10,
"max_batch_sessions_usage": 10,
"dedicated_sessions": 10,
"dedicated_sessions_usage": 10,
"avg_dedicated_sessions_usage": 10,
"max_dedicated_sessions_usage": 10,
"individual_jobs": 10,
"individual_jobs_usage": 10,
"avg_individual_jobs_usage": 10,
"max_individual_jobs_usage": 10,
"queue_time": 10,
"avg_queue_time": 10,
"max_queue_time": 10
}
]
}{
"type": "object",
"properties": {
"data": {
"description": "Data",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"example": "ibm-q/main/open",
"description": "Grouping key",
"nullable": true
},
"usage": {
"type": "number",
"example": 10,
"description": "Total usage (in milliseconds)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "Total number of jobs"
},
"sessions": {
"type": "number",
"example": 10,
"description": "Total number of sessions"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "Total sessions usage (in milliseconds)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average sessions usage (in milliseconds)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max sessions usage (in milliseconds)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "Total number of batch sessions"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Total batch sessions usage (in milliseconds)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average batch sessions usage (in milliseconds)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max batch sessions usage (in milliseconds)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "Total number of dedicated sessions"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Total dedicated sessions usage (in milliseconds)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average dedicated sessions usage (in milliseconds)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max dedicated sessions usage (in milliseconds)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "Total number of individual jobs"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Total individual jobs usage (in milliseconds)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Average individual jobs usage (in milliseconds)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Max individual jobs usage (in milliseconds)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "Total queue time (in milliseconds)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "Average queue time (in milliseconds)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "Max queue time (in milliseconds)"
}
},
"required": [
"key",
"usage",
"jobs",
"sessions",
"sessions_usage",
"avg_sessions_usage",
"max_sessions_usage",
"batch_sessions",
"batch_sessions_usage",
"avg_batch_sessions_usage",
"max_batch_sessions_usage",
"dedicated_sessions",
"dedicated_sessions_usage",
"avg_dedicated_sessions_usage",
"max_dedicated_sessions_usage",
"individual_jobs",
"individual_jobs_usage",
"avg_individual_jobs_usage",
"max_individual_jobs_usage",
"queue_time",
"avg_queue_time",
"max_queue_time"
]
}
}
},
"required": [
"data"
]
}Get usage analytics grouped by date
Get usage analytics grouped by date
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-analytics-usage.read
Auditoría
La invocación de este método genera los siguientes eventos de auditoría.
quantum-computing.account-analytics-usage.read
Entrada
Nombre, Tipo | Descripción |
|---|---|
group_by Obligatorio string | key to group usage by Valores posibles: instanceEjemplo: "instance" |
instance string[] | Ejemplo: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | Ejemplo: "2024-01-01T00:00:00.000Z" |
interval_end string | Ejemplo: "2024-01-01T00:00:00.000Z" |
backend string[] | Ejemplo: "ibm_tenerife" |
user_id string[] | Ejemplo: "123" |
simulators boolean | Include simulators Valor predeterminado: true |
plan string[] | Ejemplo: "premium" |
subscription_id string[] | The subscription ID whose analytics are being requested. Could be a single ID or an array of IDs. Ejemplo: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
Ejemplos de código
GET
/v1/analytics/usage_grouped_by_date 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/analytics/usage_grouped_by_date
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/analytics/usage_grouped_by_date' \
-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/analytics/usage_grouped_by_date
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/analytics/usage_grouped_by_date",
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 | |
| 400 | Bad request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not found |
| 500 | Internal server error |
Respuestas
{
"interval_start": "2024-01-01T00:00:00.000Z",
"interval_end": "2024-01-01T00:00:00.000Z",
"data": [
{
"key": "ibm-q/open/main",
"interval_start": "2024-01-01T00:00:00.000Z",
"interval_end": "2024-01-01T00:00:00.000Z",
"usage": 10,
"jobs": 10,
"sessions": 10,
"sessions_usage": 10,
"avg_sessions_usage": 10,
"max_sessions_usage": 10,
"batch_sessions": 10,
"batch_sessions_usage": 10,
"avg_batch_sessions_usage": 10,
"max_batch_sessions_usage": 10,
"dedicated_sessions": 10,
"dedicated_sessions_usage": 10,
"avg_dedicated_sessions_usage": 10,
"max_dedicated_sessions_usage": 10,
"individual_jobs": 10,
"individual_jobs_usage": 10,
"avg_individual_jobs_usage": 10,
"max_individual_jobs_usage": 10,
"queue_time": 10,
"avg_queue_time": 10,
"max_queue_time": 10
}
]
}{
"type": "object",
"properties": {
"interval_start": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "Interval start"
},
"interval_end": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "Interval end"
},
"data": {
"description": "Results",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"example": "ibm-q/open/main",
"description": "Group key. Depends on the groupBy query params."
},
"interval_start": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "Interval start"
},
"interval_end": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "Interval end"
},
"usage": {
"type": "number",
"example": 10,
"description": "Total usage (in milliseconds)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "Total number of jobs"
},
"sessions": {
"type": "number",
"example": 10,
"description": "Total number of sessions"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "Total sessions usage (in milliseconds)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average sessions usage (in milliseconds)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max sessions usage (in milliseconds)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "Total number of batch sessions"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Total batch sessions usage (in milliseconds)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average batch sessions usage (in milliseconds)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max batch sessions usage (in milliseconds)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "Total number of dedicated sessions"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Total dedicated sessions usage (in milliseconds)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Average dedicated sessions usage (in milliseconds)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Max dedicated sessions usage (in milliseconds)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "Total number of individual jobs"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Total individual jobs usage (in milliseconds)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Average individual jobs usage (in milliseconds)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Max individual jobs usage (in milliseconds)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "Total queue time (in milliseconds)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "Average queue time (in milliseconds)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "Max queue time (in milliseconds)"
}
},
"required": [
"key",
"interval_start",
"interval_end",
"usage",
"jobs",
"sessions",
"sessions_usage",
"avg_sessions_usage",
"max_sessions_usage",
"batch_sessions",
"batch_sessions_usage",
"avg_batch_sessions_usage",
"max_batch_sessions_usage",
"dedicated_sessions",
"dedicated_sessions_usage",
"avg_dedicated_sessions_usage",
"max_dedicated_sessions_usage",
"individual_jobs",
"individual_jobs_usage",
"avg_individual_jobs_usage",
"max_individual_jobs_usage",
"queue_time",
"avg_queue_time",
"max_queue_time"
]
}
}
},
"required": [
"interval_start",
"interval_end",
"data"
]
}¿Le ha resultado útil esta página?
Informe de un error, de una errata o solicite contenido en GitHub.