Comptes
Obtenir une configuration de compte
Obtenir les informations sur le compte courant. Si aucune information sur le compte n'est trouvée, la configuration par défaut est renvoyée.
Autorisation
Pour appeler cette méthode, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM incluant les actions suivantes. Vous pouvez vérifier votre accès en vous rendant sur Users > User > Access
quantum-computing.account-configuration.read
Audit
L'appel de cette méthode génère les événements d'audit suivants.
quantum-computing.account-configuration.read
Entrée
Nom, type | Description |
|---|---|
id Obligatoire string | Identifiant du compte (sans le préfixe |
Nom, type | Description |
|---|---|
plan_id string | Obtenir la configuration du compte uniquement pour le plan spécifié |
Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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' Si votre instance se trouve dans la région « eu-de », utilisez plutôt ce lien : 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())Sortie
Code d'état | Description |
|---|---|
| 200 | La configuration du compte a été récupérée avec succès |
| 400 | Demande incorrecte |
| 401 | Non autorisé |
| 404 | Introuvable |
| 500 | Erreur interne |
{
"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": "Configuration d'un compte géré par le service IBM Qiskit Runtime.",
"properties": {
"plans": {
"description": "La liste des configurations du compte par plan",
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"description": "L'identifiant du plan tel que défini dans le catalogue général",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"subscription_id": {
"type": "string",
"description": "L'identifiant de l'abonnement permettant d'identifier chaque contrat de forfait au sein d'un même compte",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 36
},
"subscription_name": {
"type": "string",
"description": "Le nom de l'abonnement, lisible par l'utilisateur",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"usage_allocation_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "La somme maximale de l'allocation d'utilisation autorisée pour l'ensemble des instances du compte. Obligatoire lorsque plan_id correspond à un plan flexible."
},
"usage_limit_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "La durée maximale pendant laquelle les charges de travail peuvent s'exécuter sur l'ensemble des instances du compte pour le forfait spécifié. Obligatoire lorsque plan_id correspond à un plan flexible."
},
"backends": {
"type": "array",
"description": "Liste des backends permettant au compte d'attribuer des instances.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"minItems": 0,
"maxItems": 100
},
"max_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "Durée maximale (en secondes) d'exécution de la session, sous réserve des limites du plan."
},
"active_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "Le temps restant (en secondes) pour que la session soit dans l'état actif pendant que des travaux sont en cours. Doit être inférieur ou égal à max ttl."
},
"interactive_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "Le temps maximum (en secondes) entre les tâches pour maintenir la session active. Doit être inférieur ou égal au ttl actif."
},
"start_time": {
"type": "string",
"format": "date-time",
"description": "Date de début des forfaits avec engagement. Obligatoire lorsque plan_id correspond à un plan flexible."
},
"end_time": {
"type": "string",
"format": "date-time",
"description": "Date d'expiration des forfaits à durée déterminée. Obligatoire lorsque plan_id correspond à un plan flexible."
},
"functions": {
"type": "array",
"description": "Fonctionnalités disponibles pour ce type de compte. Chaque entrée précise un identifiant de fonction, un modèle de facturation et l'ensemble des actions autorisées. Contrairement à la configuration au niveau de l'instance, `[\"ANY\"]` n'est pas une valeur valide — les fonctions doivent être énumérées explicitement.",
"items": {
"type": "object",
"description": "Une fonctionnalité accessible à un plan de compte.",
"properties": {
"provider": {
"type": "string",
"description": "Le nom du fournisseur de fonction.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "ibm"
},
"name": {
"type": "string",
"description": "Le nom de la fonction, unique au sein d'un fournisseur.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "circuit-function"
},
"business_model": {
"type": "string",
"description": "Le modèle économique dans le cadre duquel cette fonctionnalité est proposée.",
"enum": [
"trial",
"subsidized",
"consumption"
]
},
"permissions": {
"type": "array",
"description": "Actions de type IAM attribuées à cette fonction.",
"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": "Droits d'accès aux fonctions personnalisées configurés dans un plan de compte.",
"properties": {
"permissions": {
"type": "array",
"description": "Actions disponibles pour les fonctions personnalisées.",
"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'allocation d'utilisation restante qui peut encore être allouée aux instances."
}
}
}
]
},
"minItems": 0,
"maxItems": 20
}
},
"required": [
"plans"
]
}