Saltar al contenido principal
POST
Configurar el uso

Descripción general

Establece o quita límites de uso por usuario para los créditos adicionales de tu organización. Los límites siempre se aplican por usuario. Cuando especificas un ámbito de equipo o grupo, el límite se aplica individualmente a cada usuario de ese equipo o grupo; no establece un límite compartido para todo el equipo o grupo.

Solicitud

service_key
string
requerido
Tu clave de servicio con permisos de “Billing Write”

Configuración del límite de créditos (elige una opción)

clear_add_on_credit_cap
boolean
Establécelo en true para eliminar el límite actual de créditos adicionales
set_add_on_credit_cap
integer
Establece un nuevo límite de créditos adicionales (valor entero)
Debes proporcionar clear_add_on_credit_cap o set_add_on_credit_cap, pero no ambos.

Configuración del ámbito (elige una opción)

team_level
boolean
Establece true para aplicar el límite por usuario a todos los usuarios del equipo
group_id
string
Aplica el límite por usuario a todos los usuarios de un grupo específico indicando el ID del grupo
user_email
string
Aplica la configuración a un usuario específico indicando su dirección de correo electrónico
Debes proporcionar uno de team_level, group_id o user_email para definir el ámbito.

Ejemplo de solicitud: establecer el límite de crédito por usuario para todos los usuarios del equipo

Ejemplo de solicitud - establecer el límite de crédito por usuario para todos los usuarios de un grupo

Ejemplo de solicitud: establecer el límite de crédito para un usuario

Solicitud de ejemplo - Restablecer el límite de crédito

Respuesta

El cuerpo de la respuesta está vacío. Un código de estado 200 indica que la operación se completó correctamente.

Respuestas de error

Escenarios de error comunes:
  • Clave de servicio no válida o permisos insuficientes
  • Se proporcionaron clear_add_on_credit_cap y set_add_on_credit_cap
  • No se proporcionó ni clear_add_on_credit_cap ni set_add_on_credit_cap
  • Se proporcionaron múltiples parámetros de ámbito
  • No se proporcionó ningún parámetro de ámbito
  • ID de grupo o correo electrónico de usuario no válidos
  • Se superó el límite de solicitudes