Skip to main content
POST
Définir la configuration d’utilisation

Vue d’ensemble

Définissez ou réinitialisez des plafonds d’utilisation par utilisateur sur les crédits d’add-on pour votre organisation. Les plafonds sont toujours appliqués par utilisateur. Lorsque vous spécifiez une portée d’équipe ou de groupe, le plafond est appliqué individuellement à chaque utilisateur au sein de cette équipe ou de ce groupe — il ne définit pas un plafond partagé pour l’ensemble de l’équipe ou du groupe.

Requête

string
requis
Votre clé de service avec les autorisations « Facturation Write »

Configuration du plafond de crédits (choisissez une option)

boolean
Définissez sur true pour réinitialiser le plafond de crédits de l’add-on existant
integer
Définissez un nouveau plafond de crédits pour l’add-on (valeur entière)
Vous devez fournir soit clear_add_on_credit_cap, soit set_add_on_credit_cap, mais pas les deux.

Configuration de la portée (Choisir une option)

boolean
Définissez sur true pour appliquer le plafond par utilisateur à tous les utilisateurs de l’équipe
string
Appliquez le plafond par utilisateur à tous les utilisateurs d’un groupe spécifique en indiquant l’ID du groupe
string
Appliquez la configuration à un utilisateur spécifique en indiquant son adresse e‑mail
Vous devez fournir l’un de team_level, group_id ou user_email pour définir la portée.

Exemple de requête – Définir le plafond de crédits par utilisateur pour tous les membres de l’équipe

Exemple de requête – Définir le plafond de crédit individuel pour tous les membres d’un groupe

Exemple de requête – Définir un plafond de crédit pour un utilisateur

Exemple de requête - Suppression du plafond de crédits

Réponse

Le corps de la réponse est vide. Un code d’état HTTP 200 indique que l’opération a réussi.

Réponses d’erreur

Scénarios d’erreur courants :
  • Clé de service invalide ou autorisations insuffisantes
  • clear_add_on_credit_cap et set_add_on_credit_cap tous deux fournis
  • Ni clear_add_on_credit_cap ni set_add_on_credit_cap fourni
  • Plusieurs paramètres de scope fournis
  • Aucun paramètre de scope fourni
  • ID de groupe ou adresse e‑mail utilisateur invalide
  • Limite de taux dépassée