Skip to main content
POST
Obtener la configuración de uso

Descripción general

Obtén el límite efectivo de créditos adicionales por usuario de tu organización. Los límites siempre se aplican por usuario. La respuesta devuelve el límite que se aplica al sujeto solicitado después de combinar la configuración de los ámbitos más amplios, y no solo el límite configurado directamente en el ámbito solicitado.

Solicitud

string
requerido
Tu clave de servicio con el permiso “Billing Read”

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

boolean
Establézcalo en true para obtener el límite por usuario a nivel de equipo
string
Obtenga el límite efectivo por usuario de un grupo específico indicando el ID del grupo. El resultado combina el límite a nivel de equipo con la anulación de este grupo, si la hay, y no tiene en cuenta otros grupos a los que pueda pertenecer un usuario ni las anulaciones a nivel de usuario.
string
Obtenga el límite efectivo por usuario de un usuario específico indicando su dirección de correo electrónico. El resultado combina el límite a nivel de equipo, las anulaciones de todos los grupos a los que pertenece el usuario y cualquier anulación a nivel de usuario.
Debe proporcionar uno de los parámetros team_level, group_id o user_email para definir el ámbito.

Ejemplo de solicitud: obtener el límite por usuario a nivel de equipo

Ejemplo de solicitud: GET del límite por usuario efectivo para un grupo

Solicitud de ejemplo - GET del límite efectivo por usuario de un usuario

Respuesta

integer
Límite efectivo de créditos adicionales para el sujeto solicitado. En los ámbitos de grupo y de usuario, este valor puede heredarse de un ámbito más amplio. Si este campo no aparece en la respuesta, no se aplica ningún límite en el ámbito solicitado ni en ninguno de los ámbitos de los que hereda.
Este endpoint no indica qué ámbito proporcionó el límite devuelto. Una consulta de grupo o de usuario puede devolver un límite heredado del equipo (o, en el caso de un usuario, de uno de sus grupos) aunque no haya ninguna anulación configurada en el ámbito solicitado.

Respuesta de ejemplo - Con límite aplicado

Respuesta de ejemplo - No hay límite vigente

Respuestas de error

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