Skip to main content
POST
Nutzungskonfiguration abrufen

Überblick

Ruft die effektive Add-on-Credit-Obergrenze pro Nutzer für Ihre Organisation ab. Obergrenzen gelten immer pro Nutzer. Die Antwort enthält die Obergrenze, die für das angefragte Subjekt tatsächlich durchgesetzt wird, nachdem die Konfigurationen aus übergeordneten Geltungsbereichen zusammengeführt wurden – also nicht nur eine Obergrenze, die direkt im angefragten Geltungsbereich konfiguriert ist.

Anfrage

string
erforderlich
Ihr Service-Schlüssel mit „Billing Read“-Berechtigungen

Konfiguration des Geltungsbereichs (eine Option wählen)

boolean
Auf true setzen, um die Obergrenze pro Nutzer auf Teamebene abzurufen
string
Geben Sie die Gruppen-ID an, um die effektive Obergrenze pro Nutzer für eine bestimmte Gruppe abzurufen. Das Ergebnis kombiniert die Obergrenze auf Teamebene mit der Überschreibung dieser Gruppe (sofern vorhanden). Weitere Gruppen, denen ein Nutzer angehören kann, sowie Überschreibungen auf Nutzerebene werden dabei nicht berücksichtigt.
string
Geben Sie die E-Mail-Adresse eines Nutzers an, um die effektive Obergrenze pro Nutzer für diesen Nutzer abzurufen. Das Ergebnis kombiniert die Obergrenze auf Teamebene, die Überschreibungen aller Gruppen, denen der Nutzer angehört, sowie eine etwaige Überschreibung auf Nutzerebene.
Sie müssen entweder team_level, group_id oder user_email angeben, um den Geltungsbereich festzulegen.

Beispielanfrage – Obergrenze pro Nutzer auf Team-Ebene abrufen

Beispielanfrage - Die effektive Pro-Nutzer-Obergrenze für eine Gruppe abrufen

Beispielanfrage - Effektive Obergrenze pro Nutzer für einen Nutzer abrufen

Antwort

integer
Die effektive Obergrenze für Add-on-Credits für das angefragte Subjekt. Bei Gruppen- und Nutzer-Geltungsbereichen kann dieser Wert von einem übergeordneten Geltungsbereich vererbt sein. Fehlt dieses Feld in der Antwort, gilt weder im angefragten Geltungsbereich noch in einem der Geltungsbereiche, von denen er erbt, eine Obergrenze.
Dieser Endpunkt gibt nicht an, aus welchem Geltungsbereich die zurückgegebene Obergrenze stammt. Eine Abfrage für eine Gruppe oder einen Nutzer kann eine vom Team (bzw. bei einem Nutzer von einer seiner Gruppen) vererbte Obergrenze zurückgeben, auch wenn im angefragten Geltungsbereich keine Überschreibung konfiguriert ist.

Beispielantwort – Mit aktiver Obergrenze

Beispielantwort – Keine Obergrenze aktiv

Fehlerantworten

Häufige Fehlerfälle:
  • Ungültiger Service-Schlüssel oder unzureichende Berechtigungen
  • Mehrere Parameter für den Geltungsbereich angegeben
  • Kein Parameter für den Geltungsbereich angegeben
  • Ungültige Gruppen-ID oder Nutzer-E-Mail
  • Rate-Limit überschritten