Account
Ottieni configurazione account
Ottenere le informazioni sul conto corrente. Se non vengono trovate informazioni sul conto, viene restituita la configurazione predefinita.
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-configuration.read
Verifica
La chiamata di questo metodo genera i seguenti eventi di auditing.
quantum-computing.account-configuration.read
Input
Nome, tipo | Descrizione |
|---|---|
id Obbligatorio string | Id del conto (senza prefisso |
Nome, tipo | Descrizione |
|---|---|
plan_id string | Ottenere la configurazione dell'account solo per il piano specificato |
Esempi di codice
GET
/v1/accounts/{id} Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: 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' Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: 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())Output
Codice di stato | Descrizione |
|---|---|
| 200 | Configurazione dell'account recuperata con successo |
| 400 | Richiesta non valida |
| 401 | Non autorizzato |
| 404 | Non trovato |
| 500 | Errore interno |
Risposte
{
"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": "Configurazione per un account gestito dal servizio IBM Qiskit Runtime.",
"properties": {
"plans": {
"description": "L'elenco di configurazioni per l'account per piano",
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"description": "L'id del piano come definito in Global Catalog",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"subscription_id": {
"type": "string",
"description": "L'ID dell'abbonamento che identifica ogni contratto di piano all'interno di un account",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 36
},
"subscription_name": {
"type": "string",
"description": "Il nome dell'abbonamento comprensibile per l'utente",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"usage_allocation_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "La somma massima dell'allocazione di utilizzo consentita per tutte le istanze dell'account. Obbligatorio quando plan_id si riferisce a un piano flessibile."
},
"usage_limit_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "Il tempo massimo di esecuzione dei carichi di lavoro su tutte le istanze dell'account per il piano specificato. Obbligatorio quando plan_id si riferisce a un piano flessibile."
},
"backends": {
"type": "array",
"description": "Elenco dei backend che l'account può assegnare alle istanze.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"minItems": 0,
"maxItems": 100
},
"max_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "Il tempo massimo (in secondi) di esecuzione della sessione, soggetto ai limiti del piano."
},
"active_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "Il tempo rimanente (in secondi) per la sessione nello stato attivo durante l'esecuzione dei lavori. Deve essere inferiore o uguale al ttl massimo."
},
"interactive_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "Il tempo massimo (in secondi) tra i lavori per mantenere attiva la sessione. Deve essere inferiore o uguale al ttl attivo."
},
"start_time": {
"type": "string",
"format": "date-time",
"description": "Data di inizio dei piani a contratto. Obbligatorio quando plan_id si riferisce a un piano flessibile."
},
"end_time": {
"type": "string",
"format": "date-time",
"description": "Data di scadenza dei piani a contratto. Obbligatorio quando plan_id si riferisce a un piano flessibile."
},
"functions": {
"type": "array",
"description": "Funzioni disponibili per questo piano tariffario. Ogni voce specifica un ID funzione, un modello di fatturazione e l'insieme delle azioni consentite. A differenza della configurazione a livello di istanza, `[\"ANY\"]` non è un valore valido: le funzioni devono essere elencate esplicitamente.",
"items": {
"type": "object",
"description": "Una funzione disponibile per un piano di account.",
"properties": {
"provider": {
"type": "string",
"description": "Il nome del fornitore della funzione.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "ibm"
},
"name": {
"type": "string",
"description": "Il nome della funzione, univoco all'interno di un provider.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "circuit-function"
},
"business_model": {
"type": "string",
"description": "Il modello di business in base al quale viene offerta la funzione.",
"enum": [
"trial",
"subsidized",
"consumption"
]
},
"permissions": {
"type": "array",
"description": "Azioni in stile IAM concesse per questa funzione.",
"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": "Diritti relativi alle funzioni personalizzate configurati in un piano dell'account.",
"properties": {
"permissions": {
"type": "array",
"description": "Azioni disponibili per le funzioni personalizzate.",
"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": "L'allocazione d'uso rimanente che può ancora essere assegnata alle istanze."
}
}
}
]
},
"minItems": 0,
"maxItems": 20
}
},
"required": [
"plans"
]
}Questa pagina è stata utile?
Segnala un bug, un errore di battitura o richiedi contenuti su GitHub.