Skip to main content
POST
Get Usage Configuration

Vue d’ensemble

Récupérez le plafond de crédits additionnel effectivement appliqué au niveau utilisateur pour votre organisation. Les plafonds s’appliquent toujours au niveau utilisateur. La réponse renvoie le plafond appliqué au sujet demandé après fusion des configurations définies dans les périmètres plus larges, et pas seulement le plafond configuré directement dans le périmètre demandé.

Requête

string
requis
Votre clé de service avec l’autorisation « Billing Read »

Configuration du périmètre (choisissez une option)

boolean
Définissez ce paramètre sur true pour récupérer le plafond par utilisateur au niveau de la Team
string
Récupérez le plafond effectif par utilisateur pour un groupe spécifique en fournissant l’ID du groupe. Le résultat combine le plafond au niveau de la Team avec l’éventuelle dérogation de ce groupe, sans tenir compte des autres groupes auxquels un utilisateur peut appartenir ni des dérogations au niveau utilisateur.
string
Récupérez le plafond effectif par utilisateur pour un utilisateur spécifique en fournissant son adresse e-mail. Le résultat combine le plafond au niveau de la Team, les dérogations de tous les groupes auxquels l’utilisateur appartient et toute dérogation au niveau utilisateur.
Vous devez fournir l’un des paramètres team_level, group_id ou user_email pour définir le périmètre.

Exemple de requête - Récupérer le plafond par utilisateur au niveau de la Team

Exemple de requête - Récupérer le plafond effectif par utilisateur pour un groupe

Exemple de requête - Récupérer le plafond effectif applicable au niveau utilisateur

Réponse

integer
Le plafond de crédits additionnel effectif pour le sujet demandé. Pour les périmètres de groupe et de niveau utilisateur, cette valeur peut être héritée d’un périmètre plus large. Si ce champ est absent de la réponse, aucun plafond ne s’applique au périmètre demandé ni aux périmètres dont il hérite.
Cet endpoint n’indique pas de quel périmètre provient le plafond renvoyé. Une requête au périmètre de groupe ou de niveau utilisateur peut renvoyer un plafond hérité de la Team (ou, au niveau utilisateur, de l’un des groupes de la personne concernée), même si aucune dérogation n’est configurée pour le périmètre demandé.

Exemple de réponse - Avec un plafond en vigueur

Exemple de réponse - Aucun plafond ne s’applique

Réponses d’erreur

Scénarios d’erreur courants :
  • Clé de service invalide ou autorisations insuffisantes
  • Plusieurs paramètres de périmètre fournis
  • Aucun paramètre de périmètre fourni
  • ID de groupe ou adresse e-mail d’utilisateur invalide
  • Limite de débit dépassée