Skip to main content
IBM Quantum Platform

Analytics

Ottenere i filtri di analisi

Ottenere i filtri di analisi

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.account-analytics-filters.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.account-analytics-filters.read

Input

Parametri della query
Nome, tipo
Descrizione
instance
string[]
Esempio: "crn:v1:staging:public:quantum-computing:region:a/account:instance::"
Esempi di codice
GET
/v1/analytics/filters

Se la tua istanza si trova nella regione eu-de, utilizza invece questo 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: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200
401Non autorizzato
403Non consentito
404Non trovato
500Errore interno del server
Risposte
{
  "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"
    }
  ]
}

Ottenere analisi di utilizzo

Ottenere analisi di utilizzo

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.account-analytics-usage.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.account-analytics-usage.read

Input

Parametri della query
Nome, tipo
Descrizione
instance
string[]
Esempio: "crn:v1:staging:public:quantum-computing:region:a/account:instance::"
interval_start
string
Esempio: "2024-01-01T00:00:00.000Z"
interval_end
string
Esempio: "2024-01-01T00:00:00.000Z"
backend
string[]
Esempio: "ibm_tenerife"
user_id
string[]
Esempio: "123"
simulators
boolean

Includere i simulatori

Valore predefinito: true
plan
string[]
Esempio: "premium"
subscription_id
string[]

L'ID dell'abbonamento per il quale vengono richieste le statistiche. Può trattarsi di un singolo ID o di un array di ID.

Esempio: ["91b2c828-2952-4f05-aed8-bedf92c6c480"]
Esempi di codice
GET
/v1/analytics/usage

Se la tua istanza si trova nella regione eu-de, utilizza invece questo 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: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200
401Non autorizzato
403Non consentito
404Non trovato
500Errore interno del server
Risposte
{
  "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
}

Ottenere analisi di utilizzo raggruppate

Ottenere analisi di utilizzo raggruppate

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.account-analytics-usage.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.account-analytics-usage.read

Input

Parametri della query
Nome, tipo
Descrizione
group_by
Obbligatorio
string

per raggruppare l'utilizzo per

Valori possibili: instancebackenduser_idplansubscription_id
Esempio: "instance"
instance
string[]
Esempio: "crn:v1:staging:public:quantum-computing:region:a/account:instance::"
interval_start
string

data di inizio

Esempio: "2024-01-01T00:00:00.000Z"
interval_end
string

data di fine

Esempio: "2024-01-01T00:00:00.000Z"
backend
string[]

per filtrare in base a

Esempio: "ibm_tenerife"
user_id
string[]
Esempio: "123"
simulators
boolean

Includere i simulatori

Valore predefinito: true
plan
string[]
Esempio: "premium"
subscription_id
string[]

L'ID dell'abbonamento per il quale vengono richieste le statistiche. Può trattarsi di un singolo ID o di un array di ID.

Esempio: ["91b2c828-2952-4f05-aed8-bedf92c6c480"]
Esempi di codice
GET
/v1/analytics/usage_grouped

Se la tua istanza si trova nella regione eu-de, utilizza invece questo 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: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200
401Non autorizzato
403Non consentito
404Non trovato
500Errore interno del server
Risposte
{
  "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
    }
  ]
}

Ottenere le analisi di utilizzo raggruppate per data

Ottenere le analisi di utilizzo raggruppate per data

Autorizzazione

Per richiamare questo metodo, è necessario disporre di uno o più ruoli di accesso IAM che includano le seguenti azioni. È possibile verificare il proprio accesso andando su Users > User > Access

  • quantum-computing.account-analytics-usage.read

Verifica

La chiamata di questo metodo genera i seguenti eventi di auditing.

  • quantum-computing.account-analytics-usage.read

Input

Parametri della query
Nome, tipo
Descrizione
group_by
Obbligatorio
string

per raggruppare l'utilizzo per

Valori possibili: instance
Esempio: "instance"
instance
string[]
Esempio: "crn:v1:staging:public:quantum-computing:region:a/account:instance::"
interval_start
string
Esempio: "2024-01-01T00:00:00.000Z"
interval_end
string
Esempio: "2024-01-01T00:00:00.000Z"
backend
string[]
Esempio: "ibm_tenerife"
user_id
string[]
Esempio: "123"
simulators
boolean

Includere i simulatori

Valore predefinito: true
plan
string[]
Esempio: "premium"
subscription_id
string[]

L'ID dell'abbonamento per il quale vengono richieste le statistiche. Può trattarsi di un singolo ID o di un array di ID.

Esempio: ["91b2c828-2952-4f05-aed8-bedf92c6c480"]
Esempi di codice
GET
/v1/analytics/usage_grouped_by_date

Se la tua istanza si trova nella regione eu-de, utilizza invece questo 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: 2024-01-01'

Output

HTTP Codici di stato della risposta
Codice di stato
Descrizione
200
400Richiesta non valida
401Non autorizzato
403Non consentito
404Non trovato
500Errore interno del server
Risposte
{
  "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
    }
  ]
}
Questa pagina è stata utile?
Segnala un bug, un errore di battitura o richiedi contenuti su GitHub.