Analítica
Obter filtros de análise
Obter filtros de análise
Autorização
Para chamar esse método, deve-se ter sido designado a uma ou mais funções de acesso do IAM que incluam as ações a seguir. É possível verificar seu acesso indo para Users > User > Access
quantum-computing.account-analytics-filters.read
Auditoria
A chamada desse método gera os seguintes eventos de auditoria.
quantum-computing.account-analytics-filters.read
Entrada
Nome, Tipo | Descrição |
|---|---|
instance string[] | Exemplo: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
Amostras de código
GET
/v1/analytics/filters Se sua instância estiver na região eu-de, use este link: 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' Se sua instância estiver na região eu-de, use este link: 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())Saída
Código de status | Descrição |
|---|---|
| 200 | |
| 401 | Desautorizado |
| 403 | Proibido |
| 404 | Não localizadas |
| 500 | Erro interno do servidor |
Respostas
{
"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"
]
}Obter análises de uso
Obter análises de uso
Autorização
Para chamar esse método, deve-se ter sido designado a uma ou mais funções de acesso do IAM que incluam as ações a seguir. É possível verificar seu acesso indo para Users > User > Access
quantum-computing.account-analytics-usage.read
Auditoria
A chamada desse método gera os seguintes eventos de auditoria.
quantum-computing.account-analytics-usage.read
Entrada
Nome, Tipo | Descrição |
|---|---|
instance string[] | Exemplo: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | Exemplo: "2024-01-01T00:00:00.000Z" |
interval_end string | Exemplo: "2024-01-01T00:00:00.000Z" |
backend string[] | Exemplo: "ibm_tenerife" |
user_id string[] | Exemplo: "123" |
simulators boolean | Incluir simuladores Valor Padrão: true |
plan string[] | Exemplo: "premium" |
subscription_id string[] | O ID da assinatura cujas métricas estão sendo solicitadas. Pode ser um único ID ou uma matriz de IDs. Exemplo: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
Amostras de código
GET
/v1/analytics/usage Se sua instância estiver na região eu-de, use este link: 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' Se sua instância estiver na região eu-de, use este link: 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())Saída
Código de status | Descrição |
|---|---|
| 200 | |
| 401 | Desautorizado |
| 403 | Proibido |
| 404 | Não localizadas |
| 500 | Erro interno do servidor |
Respostas
{
"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": "Uso total (em milissegundos)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "Número total de tarefas"
},
"sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões (em milissegundos)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões (em milissegundos)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões (em milissegundos)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões em lote"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões em lote (em milissegundos)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões em lote (em milissegundos)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões em lote (em milissegundos)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões dedicadas"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões dedicadas (em milissegundos)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões dedicadas (em milissegundos)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões dedicadas (em milissegundos)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "Número total de trabalhos individuais"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso total de trabalhos individuais (em milissegundos)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de trabalhos individuais (em milissegundos)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de trabalhos individuais (em milissegundos)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "Tempo total da fila (em milissegundos)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "Tempo médio da fila (em milissegundos)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "Tempo máximo de fila (em milissegundos)"
}
},
"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"
]
}Obter análises de uso agrupadas
Obter análises de uso agrupadas
Autorização
Para chamar esse método, deve-se ter sido designado a uma ou mais funções de acesso do IAM que incluam as ações a seguir. É possível verificar seu acesso indo para Users > User > Access
quantum-computing.account-analytics-usage.read
Auditoria
A chamada desse método gera os seguintes eventos de auditoria.
quantum-computing.account-analytics-usage.read
Entrada
Nome, Tipo | Descrição |
|---|---|
group_by Necessário string | chave para agrupar o uso por Valores possíveis: instancebackenduser_idplansubscription_idExemplo: "instance" |
instance string[] | Exemplo: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | data de início Exemplo: "2024-01-01T00:00:00.000Z" |
interval_end string | data de encerramento Exemplo: "2024-01-01T00:00:00.000Z" |
backend string[] | backend para filtrar por Exemplo: "ibm_tenerife" |
user_id string[] | Exemplo: "123" |
simulators boolean | Incluir simuladores Valor Padrão: true |
plan string[] | Exemplo: "premium" |
subscription_id string[] | O ID da assinatura cujas métricas estão sendo solicitadas. Pode ser um único ID ou uma matriz de IDs. Exemplo: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
Amostras de código
GET
/v1/analytics/usage_grouped Se sua instância estiver na região eu-de, use este link: 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' Se sua instância estiver na região eu-de, use este link: 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())Saída
Código de status | Descrição |
|---|---|
| 200 | |
| 401 | Desautorizado |
| 403 | Proibido |
| 404 | Não localizadas |
| 500 | Erro interno do servidor |
Respostas
{
"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": "Dados",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"example": "ibm-q/main/open",
"description": "Chave de agrupamento",
"nullable": true
},
"usage": {
"type": "number",
"example": 10,
"description": "Uso total (em milissegundos)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "Número total de tarefas"
},
"sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões (em milissegundos)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões (em milissegundos)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões (em milissegundos)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões em lote"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões em lote (em milissegundos)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões em lote (em milissegundos)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões em lote (em milissegundos)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões dedicadas"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões dedicadas (em milissegundos)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões dedicadas (em milissegundos)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões dedicadas (em milissegundos)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "Número total de trabalhos individuais"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso total de trabalhos individuais (em milissegundos)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de trabalhos individuais (em milissegundos)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de trabalhos individuais (em milissegundos)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "Tempo total da fila (em milissegundos)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "Tempo médio da fila (em milissegundos)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "Tempo máximo de fila (em milissegundos)"
}
},
"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"
]
}Obter análises de uso agrupadas por data
Obter análises de uso agrupadas por data
Autorização
Para chamar esse método, deve-se ter sido designado a uma ou mais funções de acesso do IAM que incluam as ações a seguir. É possível verificar seu acesso indo para Users > User > Access
quantum-computing.account-analytics-usage.read
Auditoria
A chamada desse método gera os seguintes eventos de auditoria.
quantum-computing.account-analytics-usage.read
Entrada
Nome, Tipo | Descrição |
|---|---|
group_by Necessário string | chave para agrupar o uso por Valores possíveis: instanceExemplo: "instance" |
instance string[] | Exemplo: "crn:v1:staging:public:quantum-computing:region:a/account:instance::" |
interval_start string | Exemplo: "2024-01-01T00:00:00.000Z" |
interval_end string | Exemplo: "2024-01-01T00:00:00.000Z" |
backend string[] | Exemplo: "ibm_tenerife" |
user_id string[] | Exemplo: "123" |
simulators boolean | Incluir simuladores Valor Padrão: true |
plan string[] | Exemplo: "premium" |
subscription_id string[] | O ID da assinatura cujas métricas estão sendo solicitadas. Pode ser um único ID ou uma matriz de IDs. Exemplo: ["91b2c828-2952-4f05-aed8-bedf92c6c480"] |
Amostras de código
GET
/v1/analytics/usage_grouped_by_date Se sua instância estiver na região eu-de, use este link: 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' Se sua instância estiver na região eu-de, use este link: 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())Saída
Código de status | Descrição |
|---|---|
| 200 | |
| 400 | Solicitação inválida |
| 401 | Desautorizado |
| 403 | Proibido |
| 404 | Não localizadas |
| 500 | Erro interno do servidor |
Respostas
{
"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": "Início do intervalo"
},
"interval_end": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "Término do intervalo"
},
"data": {
"description": "Resultados",
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"example": "ibm-q/open/main",
"description": "Chave de grupo. Depende dos parâmetros da consulta groupBy."
},
"interval_start": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "Início do intervalo"
},
"interval_end": {
"type": "string",
"example": "2024-01-01T00:00:00.000Z",
"description": "Término do intervalo"
},
"usage": {
"type": "number",
"example": 10,
"description": "Uso total (em milissegundos)"
},
"jobs": {
"type": "number",
"example": 10,
"description": "Número total de tarefas"
},
"sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões"
},
"sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões (em milissegundos)"
},
"avg_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões (em milissegundos)"
},
"max_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões (em milissegundos)"
},
"batch_sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões em lote"
},
"batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões em lote (em milissegundos)"
},
"avg_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões em lote (em milissegundos)"
},
"max_batch_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões em lote (em milissegundos)"
},
"dedicated_sessions": {
"type": "number",
"example": 10,
"description": "Número total de sessões dedicadas"
},
"dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso total de sessões dedicadas (em milissegundos)"
},
"avg_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de sessões dedicadas (em milissegundos)"
},
"max_dedicated_sessions_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de sessões dedicadas (em milissegundos)"
},
"individual_jobs": {
"type": "number",
"example": 10,
"description": "Número total de trabalhos individuais"
},
"individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso total de trabalhos individuais (em milissegundos)"
},
"avg_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso médio de trabalhos individuais (em milissegundos)"
},
"max_individual_jobs_usage": {
"type": "number",
"example": 10,
"description": "Uso máximo de trabalhos individuais (em milissegundos)"
},
"queue_time": {
"type": "number",
"example": 10,
"description": "Tempo total da fila (em milissegundos)"
},
"avg_queue_time": {
"type": "number",
"example": 10,
"description": "Tempo médio da fila (em milissegundos)"
},
"max_queue_time": {
"type": "number",
"example": 10,
"description": "Tempo máximo de fila (em milissegundos)"
}
},
"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"
]
}Esta página foi útil?
Relate um bug, erro de digitação ou solicite conteúdo no GitHub.