Istanze
Ottenere i dettagli dell'istanza corrente
Restituisce i dettagli dell'istanza correntemente connessa, utilizzando il CRN dall'intestazione della richiesta.
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.instance.read
Verifica
La chiamata di questo metodo genera i seguenti eventi di auditing.
quantum-computing.instance.read
Input
Informazioni |
|---|
| Questo endpoint non accetta alcun input. |
Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/instance
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/instance' \
-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/instance
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/instance",
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 | Accettabilmente |
| 401 | Non autorizzato |
| 403 | Non consentito |
| 404 | Non trovato |
{
"backends": [
"ibm_backend"
],
"instance_limit": 60.7,
"instance_limit_seconds": "61",
"plan_id": "flex-plan-id-1",
"usage_allocation_seconds": "200"
}{
"type": "object",
"description": "Istanza",
"properties": {
"backends": {
"type": "array",
"description": "Elenco dei sistemi o cluster di backend associati all'istanza di servizio",
"items": {
"type": "string",
"pattern": "^.*$",
"minLength": 1,
"maxLength": 128,
"nullable": false
},
"minItems": 0,
"maxItems": 100
},
"instance_limit": {
"type": "number",
"format": "double",
"description": "Rappresenta i limiti dell'istanza in secondi; sarà sostituito da istanza_limite\\_secondi",
"deprecated": true
},
"instance_limit_seconds": {
"type": "string",
"description": "Specifica il numero massimo di risorse che possono essere eseguite su questa istanza"
},
"plan_id": {
"type": "string",
"description": "Identificatore del piano di servizio associato all'istanza, come definito in Global Catalog",
"pattern": "^.*$",
"minLength": 1,
"maxLength": 128
},
"usage_allocation_seconds": {
"type": "string",
"description": "La somma massima dell'allocazione d'uso consentita sull'istanza."
}
}
}Ottenere la configurazione dell'istanza
Funzionalità obsoleta: utilizzare Resource Controller per gestire la configurazione dell'istanza. Vedi /docs/guides/access-instances-platform-apis. Restituisce la configurazione dell'istanza specificata, ad esempio il limite di istanza in secondi, utilizzando il parametro " CRN " presente nell'intestazione della richiesta.
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.instance.configuration.read
Verifica
La chiamata di questo metodo genera i seguenti eventi di auditing.
quantum-computing.instance.configuration.read
Input
Informazioni |
|---|
| Questo endpoint non accetta alcun input. |
Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/instances/configuration
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/instances/configuration' \
-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/instances/configuration
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/instances/configuration",
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 | Accettabilmente |
| 401 | Non autorizzato |
| 403 | Non consentito |
| 404 | Non trovato |
{
"instance_limit": 123456
}{
"type": "object",
"description": "Configurazione dell'istanza",
"properties": {
"instance_limit": {
"type": "number",
"format": "double",
"description": "Limite di utilizzo dell'istanza in secondi"
}
}
}Aggiornare la configurazione dell'istanza
Funzionalità obsoleta: utilizzare Resource Controller per gestire la configurazione dell'istanza. Vedi /docs/guides/access-instances-platform-apis. Aggiornare la configurazione dell'istanza specificata, ad esempio il limite di durata dell'istanza in secondi, utilizzando CRN dai parametri di contesto della richiesta.
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.instance.configuration.update
Verifica
La chiamata di questo metodo genera i seguenti eventi di auditing.
quantum-computing.instance.configuration.update
Input
Nome, tipo | Descrizione |
|---|---|
instance_limit integer | Questo campo può essere nullo o un numero intero. Usare null per azzerare/rimuovere il limite dell'istanza. Valore minimo: 1Valore massimo: 2147483647 |
Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/instances/configuration
curl -X PUT \
'https://quantum.cloud.ibm.com/api/v1/instances/configuration' \
-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/instances/configuration
import requests
response = requests.request(
"PUT",
"https://quantum.cloud.ibm.com/api/v1/instances/configuration",
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 |
|---|---|
| 204 | Accettabilmente |
| 400 | Richiesta non valida |
| 401 | Non autorizzato |
| 403 | Non consentito |
| 404 | Non trovato |
| 409 | L'utilizzo supera il limite dell'istanza |
Ottenere l'utilizzo dell'istanza
Ottenere l'utilizzo dell'istanza
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.instance-usage.read
Verifica
La chiamata di questo metodo genera i seguenti eventi di auditing.
quantum-computing.instance-usage.read
Input
Informazioni |
|---|
| Questo endpoint non accetta alcun input. |
Se la tua istanza si trova nella regione eu-de, utilizza invece questo link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/instances/usage
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/instances/usage' \
-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/instances/usage
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/instances/usage",
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 | |
| 401 | Non autorizzato |
{
"instance_id": "example",
"plan_id": "example",
"usage_period": {
"start_time": "example",
"end_time": "example"
},
"usage_consumed_seconds": 12,
"usage_limit_seconds": 60,
"usage_allocation_seconds": 120,
"usage_limit_reached": true,
"time_available_at": "2024-01-01T00:00:00.000Z"
}{
"type": "object",
"properties": {
"instance_id": {
"type": "string"
},
"plan_id": {
"type": "string"
},
"usage_period": {
"description": "Ora di inizio e di fine del periodo di utilizzo",
"allOf": [
{
"type": "object",
"properties": {
"start_time": {
"format": "date-time",
"type": "string",
"description": "L'ora di inizio dell'utilizzo"
},
"end_time": {
"format": "date-time",
"type": "string",
"description": "L'ora di fine dell'utilizzo"
}
}
}
]
},
"usage_consumed_seconds": {
"type": "number",
"example": 12,
"description": "Consumo consumato nel periodo di utilizzo corrente"
},
"usage_limit_seconds": {
"type": "number",
"example": 60,
"description": "Il limite di utilizzo in secondi durante il periodo di utilizzo"
},
"usage_allocation_seconds": {
"type": "number",
"example": 120,
"description": "I secondi assegnati all'istanza durante il periodo di utilizzo"
},
"usage_limit_reached": {
"type": "boolean",
"example": false,
"description": "vero se il limite di utilizzo è stato raggiunto. falso se non viene raggiunto. undefined se i limiti di utilizzo non si applicano a questa istanza."
},
"time_available_at": {
"format": "date-time",
"type": "string",
"description": "La data e l'ora più vicine nel tempo in cui l'utilizzo scenderà al di sotto del limite previsto, poiché i dati relativi all'utilizzo precedente usciranno dal periodo di 28 giorni. Viene visualizzato solo quando viene raggiunto il limite a livello di istanza in un piano a finestra mobile.",
"example": "2024-01-01T00:00:00.000Z",
"minLength": 20,
"maxLength": 29
}
},
"required": [
"instance_id",
"plan_id",
"usage_consumed_seconds"
]
}