GET Kontoweiten Verbrauch und Grenzen lesen
/api/v1/usage
Mit table=1 wird die vollständige berechtigte Monitor-Verbrauchsliste in gefilterten Cursor-Seiten geliefert. Sort erlaubt zusätzlich items, bytes und planned für absteigende numerische Beiträge. Ohne Pagination bleibt die Antwort die Konto-Verbrauchsübersicht.
Auf dieser Seite
Zugriff und Rechte
Mit table=1 wird die vollständige berechtigte Monitor-Verbrauchsliste in gefilterten Cursor-Seiten geliefert. Sort erlaubt zusätzlich items, bytes und planned für absteigende numerische Beiträge. Ohne Pagination bleibt die Antwort die Konto-Verbrauchsübersicht.
Browsersitzung: Cookie __Host-mb_session.
Maschinen-Verwaltungszugang in Authorization: Bearer. Beachten Sie die von der Operation benötigten Berechtigungen (Scopes).
Parameter und Header
| Feld | Position | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|---|
| workspace_id | URL-Parameter | string; {"format":"uuid"} | Nein | Wählen Sie einen zugänglichen Arbeitsbereich und das Budget seines Ownerkontos. Mitglieder sehen nur die Monitordetails dieses Arbeitsbereichs. |
| device_id | URL-Parameter | string; {"format":"uuid"} | Nein | Behalten Sie diesen zugänglichen Monitor für Bearbeitungsvorschauen in der begrenzten Aufschlüsselung. Fremde oder nicht zugängliche Monitore liefern 404. |
| forecast_sort | URL-Parameter | string; {"enum":["items","events","bytes","event_bytes","planned","planned_items","planned_events","planned_bytes","planned_event_bytes"],"default":"items"} | Nein | Wählen Sie die höchsten 100 Monitorbeiträge nach verbuchten Objekten, verbuchten Bytes oder geplanten Tagesobjekten vor Begrenzung des Ergebnisses. Der angefragte Monitor bleibt enthalten. |
| table | URL-Parameter | string; {"enum":["1"]} | Nein | Für eine gefilterte Cursor-Seite auf 1 setzen; ohne Tabellenparameter bleibt die ursprüngliche Antwort erhalten. |
| q | URL-Parameter | string; {"maxLength":128} | Nein | Suche nach wörtlichem Text ohne Beachtung der Groß-/Kleinschreibung in den dokumentierten Textfeldern, vor dem Seitenlimit. |
| limit | URL-Parameter | integer; {"default":50,"maximum":100,"minimum":1} | Nein | Seitengröße 1–100, standardmäßig 50. Eine Folgeseite besteht nur bei einer weiteren passenden Zeile. |
| cursor | URL-Parameter | string; {"maxLength":4096} | Nein | Opaker next_cursor der vorherigen Seite. Ressource, Konto, Filter, Sortierung und Limit beibehalten; Listen-Cursor verfallen nach 15 Minuten. |
| sort | URL-Parameter | string; {"enum":["items","bytes","planned","newest","oldest","name_asc","name_desc","events","event_bytes","planned_items","planned_events","planned_bytes","planned_event_bytes","projected_items","projected_events","projected_bytes","projected_event_bytes"]} | Nein | Stabile Sortierung mit der Datensatz-ID bei Gleichstand: newest, oldest, name_asc oder name_desc. |
| type | URL-Parameter | string | Nein | Exakter Feldfilter; Parameter für alle Werte weglassen. |
| status | URL-Parameter | string | Nein | Exakter Feldfilter; Parameter für alle Werte weglassen. |
| copy_source | URL-Parameter | string; {"enum":["device","workspace"]} | Nein | Optionale Metadatenvorschau einer Kopie des gewählten Monitors oder Arbeitsbereichs. Reserviert keine Kapazität. |
| counts_only | URL-Parameter | string; {"enum":["1"]} | Nein | Liefert Anzahlen für den angegebenen Filter statt Tabellenzeilen. Suche und weitere Filter gelten; die eigene Auswahl, Sortierung und Pagination beeinflussen die Zählung nicht. |
| count_filter | URL-Parameter | string; {"enum":["type","status"]} | Nein | Deklarierter Tabellenfilter für die Zählung. Erfordert counts_only=1. |
| snapshot | URL-Parameter | string; {"format":"date-time"} | Nein | Optionaler Snapshot der zugehörigen Tabellenseite. |
Anfragekörper
Kein Anfragekörper.
Antworten
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | JSON | JSON | object | Ja | — |
| $ (anyOf 1) | JSON | JSON | Nein | — |
| $ (anyOf 1).active_archive_queries_limit | integer; {"minimum":1} | Nein | Höchstzahl gleichzeitiger Archivabfragen einschließlich Exporten. |
| $ (anyOf 1).active_exports_limit | integer; {"minimum":1} | Nein | Höchstzahl gleichzeitiger Exporte. |
| $ (anyOf 1).alarms_limit | integer | Nein | — |
| $ (anyOf 1).batch_bytes_limit | integer | Nein | — |
| $ (anyOf 1).batch_items_limit | integer | Nein | — |
| $ (anyOf 1).bytes_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).day_bytes | integer | Nein | — |
| $ (anyOf 1).day_bytes_limit | integer | Nein | — |
| $ (anyOf 1).day_event_bytes | integer | Nein | — |
| $ (anyOf 1).day_event_bytes_limit | integer | Nein | — |
| $ (anyOf 1).day_events | integer | Nein | — |
| $ (anyOf 1).day_events_limit | integer | Nein | — |
| $ (anyOf 1).day_items | integer | Nein | — |
| $ (anyOf 1).day_items_limit | integer | Nein | — |
| $ (anyOf 1).day_notifications | integer | Nein | — |
| $ (anyOf 1).day_points | integer | Nein | — |
| $ (anyOf 1).day_points_limit | integer | Nein | — |
| $ (anyOf 1).devices | integer | Nein | — |
| $ (anyOf 1).devices_limit | integer | Nein | — |
| $ (anyOf 1).events_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).groups | integer; {"minimum":0} | Nein | Aktive Gruppen in allen Arbeitsbereichen dieses Kontos. |
| $ (anyOf 1).groups_limit | integer; {"minimum":1} | Nein | Wirksames Kontolimit für aktive Gruppen. |
| $ (anyOf 1).items_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).keys | integer | Nein | — |
| $ (anyOf 1).keys_limit | integer | Nein | — |
| $ (anyOf 1).limits | object | Nein | Feld der Kontingentverwaltung: limits. |
| $ (anyOf 1).limits.active_alarms | integer; {"maximum":1099511627776,"minimum":1} | Nein | Aktive Alarmregeln. |
| $ (anyOf 1).limits.active_archive_queries | integer; {"maximum":1099511627776,"minimum":1} | Nein | Wartende oder laufende Archivabfragen einschließlich Exporten. |
| $ (anyOf 1).limits.active_devices | integer; {"maximum":1099511627776,"minimum":1} | Nein | Aktive Monitore des Kontos. |
| $ (anyOf 1).limits.active_exports | integer; {"maximum":1099511627776,"minimum":1} | Nein | Wartende oder laufende Exporte. Sie zählen auch zur Archivabfragenkapazität. |
| $ (anyOf 1).limits.active_groups | integer; {"maximum":1099511627776,"minimum":1} | Nein | Aktive Gruppen in den Arbeitsbereichen des Kontos. |
| $ (anyOf 1).limits.active_keys | integer; {"maximum":1099511627776,"minimum":1} | Nein | Aktive API-Schlüssel, die nicht widerrufen wurden. |
| $ (anyOf 1).limits.active_series | integer; {"maximum":1099511627776,"minimum":1} | Nein | Aktive Messreihen einschließlich reservierter Messreihenplätze. |
| $ (anyOf 1).limits.active_workspaces | integer; {"maximum":1099511627776,"minimum":1} | Nein | Aktive Arbeitsbereiche des Kontos. |
| $ (anyOf 1).limits.alarm_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Alarmregeln pro Minute. |
| $ (anyOf 1).limits.batch_bytes | integer; {"maximum":1099511627776,"minimum":1} | Nein | Bytes pro Datenanfrage. Größenlimits gelten vor und nach dem Entpacken. |
| $ (anyOf 1).limits.batch_items | integer; {"maximum":1099511627776,"minimum":1} | Nein | Einträge pro Datenanfrage. |
| $ (anyOf 1).limits.bytes_per_day | integer; {"maximum":1099511627776,"minimum":1} | Nein | Übertragene Bytes pro UTC-Tag, gezählt nach dem Entpacken. |
| $ (anyOf 1).limits.bytes_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Übertragene Bytes pro Minute, gezählt nach dem Entpacken. |
| $ (anyOf 1).limits.device_per_day | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Monitore pro UTC-Tag. |
| $ (anyOf 1).limits.device_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Monitore pro Minute. |
| $ (anyOf 1).limits.event_bytes_per_day | integer; {"maximum":1099511627776,"minimum":1} | Nein | Ereignisdaten in Bytes pro UTC-Tag. |
| $ (anyOf 1).limits.event_per_day | integer; {"maximum":1099511627776,"minimum":1} | Nein | Ereignisse pro UTC-Tag, zusätzlich zum gemeinsamen Datenlimit. |
| $ (anyOf 1).limits.event_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Ereignisse pro Minute, zusätzlich zum gemeinsamen Datenlimit. |
| $ (anyOf 1).limits.group_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Gruppen pro Minute. |
| $ (anyOf 1).limits.key_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue API-Schlüssel pro Minute. |
| $ (anyOf 1).limits.live_series_per_connection | integer; {"maximum":1099511627776,"minimum":1} | Nein | Messreihen pro Live-Verbindung. |
| $ (anyOf 1).limits.notifications_per_day | integer; {"maximum":1099511627776,"minimum":1} | Nein | Benachrichtigungen über alle Kanäle pro UTC-Tag. |
| $ (anyOf 1).limits.notifications_per_hour | integer; {"maximum":1099511627776,"minimum":1} | Nein | Benachrichtigungen über alle Kanäle pro Stunde. |
| $ (anyOf 1).limits.point_per_day | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Messwerte und Ereignisse zusammen pro UTC-Tag. |
| $ (anyOf 1).limits.point_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Messwerte und Ereignisse zusammen pro Minute. |
| $ (anyOf 1).limits.request_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Anfragen zur Datenübertragung pro Minute. |
| $ (anyOf 1).limits.series_per_30_days | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Messreihen innerhalb der letzten 30 Tage. |
| $ (anyOf 1).limits.series_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Messreihen pro Minute. |
| $ (anyOf 1).limits.workspace_per_minute | integer; {"maximum":1099511627776,"minimum":1} | Nein | Neue Arbeitsbereiche pro Minute. |
| $ (anyOf 1).limits.active_browser_monitors | integer; {"maximum":1000,"minimum":1} | Nein | — |
| $ (anyOf 1).limits.browser_seconds_per_day | integer; {"maximum":86400,"minimum":1} | Nein | — |
| $ (anyOf 1).limits.check_artifact_bytes | integer; {"maximum":5368709120,"minimum":1} | Nein | — |
| $ (anyOf 1).limits.network_checks_per_minute | integer; {"maximum":100000,"minimum":1} | Nein | — |
| $ (anyOf 1).limits.log_bytes_per_day | integer; {"minimum":1,"maximum":1099511627776} | Nein | Das normale Logkontingent beträgt 1 GiB normalisierte, unkomprimierte angenommene Einträge je UTC-Tag, gemeinsam für alle eigenen Arbeitsbereiche. Unverifizierte Maschinenkonten beginnen mit 100 MiB. Maskierung verringert die gezählten Bytes nicht, Filtern hingegen schon. Logs haben ein eigenes Budget neben Messwerten und Ereignissen. Individuelle Erhöhungen erscheinen in Ihrem Konto. |
| $ (anyOf 1).limits_version | string; {"pattern":"^[0-9a-f]{64}$"} | Nein | Version aus Kontotyp, Standards und individuellen Werten. Beim Prüfen und Speichern von Änderungen erforderlich. |
| $ (anyOf 1).live_series_per_connection_limit | integer; {"minimum":1} | Nein | Geltendes Limit für Messreihen pro Live-Verbindung. |
| $ (anyOf 1).monitors | integer; {"minimum":0} | array<object> | Nein | — |
| $ (anyOf 1).monitors (oneOf 1) | integer; {"minimum":0} | Nein | — |
| $ (anyOf 1).monitors (oneOf 2) | array<object> | Nein | — |
| $ (anyOf 1).monitors (oneOf 2)[] | object | Ja | — |
| $ (anyOf 1).monitors_limit | integer | Nein | — |
| $ (anyOf 1).new_devices_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).new_devices_today | integer | Nein | — |
| $ (anyOf 1).new_devices_today_limit | integer | Nein | — |
| $ (anyOf 1).new_keys_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).new_series_30d | integer | Nein | — |
| $ (anyOf 1).new_series_30d_limit | integer | Nein | — |
| $ (anyOf 1).new_series_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).new_workspaces_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).notifications_per_day_limit | integer | Nein | — |
| $ (anyOf 1).notifications_per_hour_limit | integer | Nein | — |
| $ (anyOf 1).points_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).registration_origin | string | Nein | Ursprünglicher Registrierungsweg des Kontos. Bestätigung ändert diesen Ursprung nicht. |
| $ (anyOf 1).requests_per_minute_limit | integer | Nein | — |
| $ (anyOf 1).series | integer | Nein | — |
| $ (anyOf 1).series_limit | integer | Nein | — |
| $ (anyOf 1).tier | string | Nein | — |
| $ (anyOf 1).workspaces | integer | Nein | — |
| $ (anyOf 1).workspaces_limit | integer | Nein | — |
| $ (anyOf 1).forecast | UsageForecast | Nein | Konsistenter lesender Snapshot von wirksamen Kontingenten, verbuchtem Tagesverbrauch und Intervallschätzungen. Kontosummen umfassen alle Arbeitsbereiche des Owners; Mitglieder sehen Monitornamen ausschließlich aus ihrem gewählten Arbeitsbereich. Der angefragte Monitor bleibt innerhalb der maximal 100 Einträge enthalten. Die Prognose bis Tageswechsel ergänzt den verbuchten Verbrauch um den verbleibenden UTC-Tagesanteil der Planung. Übertragungsspitzen, Ereignisse, Wiederholungen und Korrekturen sind nicht vorhersagbar; Kapazität wird nicht reserviert. |
| $ (anyOf 1).forecast.monitors | array<object>; {"maxItems":100} | Ja | — |
| $ (anyOf 1).forecast.monitors[] | object | Ja | Ein sichtbarer Monitor. Geplante Raten schließen pausierte Monitore, Monitore mit angeforderter Löschung sowie deaktivierte oder archivierte Reihen aus. HTTP nutzt sein konfiguriertes Intervall, berechnete Reihen liefern einen Wert pro Minute, andere Reihen nutzen ihr erwartetes Intervall. Volumenschätzungen verwenden die Profilannahmen ohne Heartbeat-Overhead. |
| $ (anyOf 1).forecast.monitors[].archived | boolean | Ja | — |
| $ (anyOf 1).forecast.monitors[].id | string; {"format":"uuid"} | Ja | — |
| $ (anyOf 1).forecast.monitors[].interval_seconds | integer; {"minimum":10} | null | Ja | — |
| $ (anyOf 1).forecast.monitors[].interval_seconds (anyOf 1) | integer; {"minimum":10} | Nein | — |
| $ (anyOf 1).forecast.monitors[].interval_seconds (anyOf 2) | null | Nein | — |
| $ (anyOf 1).forecast.monitors[].name | string | Ja | — |
| $ (anyOf 1).forecast.monitors[].paused | boolean | Ja | — |
| $ (anyOf 1).forecast.monitors[].planned | QuotaDaily | Ja | Datenobjekte umfassen numerische Punkte, Zustände und Textmeldungen. Ereignisse sind die Teilmenge aus Zuständen und Textmeldungen. Bytes und Ereignisbytes beschreiben berechnete unkomprimierte Nutzdaten. Geplante Werte sind Schätzungen je 24 Stunden, heutige Werte verbuchte Zähler. |
| $ (anyOf 1).forecast.monitors[].planned.bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].planned.event_bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].planned.events | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].planned.items | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].profile_planned | QuotaDaily | Nein | Datenobjekte umfassen numerische Punkte, Zustände und Textmeldungen. Ereignisse sind die Teilmenge aus Zuständen und Textmeldungen. Bytes und Ereignisbytes beschreiben berechnete unkomprimierte Nutzdaten. Geplante Werte sind Schätzungen je 24 Stunden, heutige Werte verbuchte Zähler. |
| $ (anyOf 1).forecast.monitors[].profile_planned.bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].profile_planned.event_bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].profile_planned.events | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].profile_planned.items | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].recorded_from | string; {"format":"date-time"} | null | Ja | — |
| $ (anyOf 1).forecast.monitors[].recorded_from (anyOf 1) | string; {"format":"date-time"} | Nein | — |
| $ (anyOf 1).forecast.monitors[].recorded_from (anyOf 2) | null | Nein | — |
| $ (anyOf 1).forecast.monitors[].today | QuotaDaily | Ja | Datenobjekte umfassen numerische Punkte, Zustände und Textmeldungen. Ereignisse sind die Teilmenge aus Zuständen und Textmeldungen. Bytes und Ereignisbytes beschreiben berechnete unkomprimierte Nutzdaten. Geplante Werte sind Schätzungen je 24 Stunden, heutige Werte verbuchte Zähler. |
| $ (anyOf 1).forecast.monitors[].today.bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].today.event_bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].today.events | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].today.items | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.monitors[].type | string | Ja | — |
| $ (anyOf 1).forecast.monitors[].workspace_id | string; {"format":"uuid"} | Ja | — |
| $ (anyOf 1).forecast.other_today | QuotaDaily | Ja | Datenobjekte umfassen numerische Punkte, Zustände und Textmeldungen. Ereignisse sind die Teilmenge aus Zuständen und Textmeldungen. Bytes und Ereignisbytes beschreiben berechnete unkomprimierte Nutzdaten. Geplante Werte sind Schätzungen je 24 Stunden, heutige Werte verbuchte Zähler. |
| $ (anyOf 1).forecast.other_today.bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.other_today.event_bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.other_today.events | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.other_today.items | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.planned | QuotaDaily | Ja | Datenobjekte umfassen numerische Punkte, Zustände und Textmeldungen. Ereignisse sind die Teilmenge aus Zuständen und Textmeldungen. Bytes und Ereignisbytes beschreiben berechnete unkomprimierte Nutzdaten. Geplante Werte sind Schätzungen je 24 Stunden, heutige Werte verbuchte Zähler. |
| $ (anyOf 1).forecast.planned.bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.planned.event_bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.planned.events | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.planned.items | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.reset_at | string; {"format":"date-time"} | Ja | — |
| $ (anyOf 1).forecast.sampled_at | string; {"format":"date-time"} | Ja | — |
| $ (anyOf 1).forecast.truncated | boolean | Ja | — |
| $ (anyOf 1).forecast.workspace_planned | QuotaDaily | Ja | Datenobjekte umfassen numerische Punkte, Zustände und Textmeldungen. Ereignisse sind die Teilmenge aus Zuständen und Textmeldungen. Bytes und Ereignisbytes beschreiben berechnete unkomprimierte Nutzdaten. Geplante Werte sind Schätzungen je 24 Stunden, heutige Werte verbuchte Zähler. |
| $ (anyOf 1).forecast.workspace_planned.bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.workspace_planned.event_bytes | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.workspace_planned.events | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).forecast.workspace_planned.items | number; {"minimum":0} | Ja | — |
| $ (anyOf 1).limit | integer; {"maximum":100,"minimum":1} | Nein | — |
| $ (anyOf 1).next_cursor | string | Nein | Cursor zur nächsten passenden Seite; leer, wenn keine Folgeseite besteht. |
| $ (anyOf 1).snapshot | string; {"format":"date-time"} | Nein | An den Cursor gebundener UTC-Snapshot; später angelegte Zeilen gelangen nicht in diese Seitenfolge. |
| $ (anyOf 1).limit_presentation | array<object> | Nein | — |
| $ (anyOf 1).limit_presentation[] | object | Ja | — |
| $ (anyOf 1).limit_presentation[].key | string | Ja | — |
| $ (anyOf 1).limit_presentation[].visibility | string; {"enum":["core","contextual","protection"]} | Ja | Darstellungsklasse: Kernkontingente, funktionsbezogene Kontingente oder Hintergrundschutz. Rohwerte bleiben verfügbar und werden weiterhin geprüft. |
| $ (anyOf 1).limit_presentation[].context | string; {"enum":["browser","logs"]} | Nein | — |
| $ (anyOf 1).series_slots | integer; {"minimum":0} | Nein | — |
| $ (anyOf 1).copy_counts | null | object | Nein | — |
| $ (anyOf 1).copy_counts (anyOf 1) | null | Nein | — |
| $ (anyOf 1).copy_counts (anyOf 2) | object | Nein | — |
| $ (anyOf 1).copy_counts (anyOf 2).monitors | integer; {"minimum":0} | Ja | — |
| $ (anyOf 1).copy_counts (anyOf 2).series | integer; {"minimum":0} | Ja | — |
| $ (anyOf 1) (anyOf 1) | JSON | Nein | — |
| $ (anyOf 1) (anyOf 2) | JSON | Nein | — |
| $ (anyOf 2) | object | Nein | — |
| $ (anyOf 2).filter_counts | TableFilterCounts | Ja | — |
| $ (anyOf 2).filter_counts.field | string | Ja | — |
| $ (anyOf 2).filter_counts.total | integer; {"minimum":0} | Ja | — |
| $ (anyOf 2).filter_counts.values | object | Ja | — |
| $ (anyOf 2).filter_counts.complete | boolean | Ja | — |
| $ (anyOf 2).filter_counts.snapshot | string; {"format":"date-time"} | Ja | — |
| $ (anyOf 2).filter_counts.counted_at | string; {"format":"date-time"} | Ja | — |
{
"active_archive_queries_limit": 2,
"active_exports_limit": 1,
"alarms_limit": 0,
"batch_bytes_limit": 0,
"batch_items_limit": 0,
"bytes_per_minute_limit": 0,
"day_bytes": 0,
"day_bytes_limit": 0,
"day_event_bytes": 0,
"day_event_bytes_limit": 0,
"day_events": 0,
"day_events_limit": 0,
"day_items": 0,
"day_items_limit": 0,
"day_notifications": 0,
"day_points": 0,
"day_points_limit": 0,
"devices": 0,
"devices_limit": 0,
"events_per_minute_limit": 0,
"groups": 2,
"groups_limit": 100,
"items_per_minute_limit": 0,
"keys": 0,
"keys_limit": 0,
"limits": {
"active_alarms": 200,
"active_archive_queries": 2,
"active_devices": 10,
"active_exports": 1,
"active_groups": 100,
"active_keys": 20,
"active_series": 200,
"active_workspaces": 50,
"alarm_per_minute": 10,
"batch_bytes": 262144,
"batch_items": 1000,
"bytes_per_day": 1073741824,
"bytes_per_minute": 2097152,
"device_per_day": 20,
"device_per_minute": 5,
"event_bytes_per_day": 10485760,
"event_per_day": 10000,
"event_per_minute": 60,
"group_per_minute": 10,
"key_per_minute": 5,
"live_series_per_connection": 32,
"notifications_per_day": 500,
"notifications_per_hour": 60,
"point_per_day": 4000000,
"point_per_minute": 3000,
"request_per_minute": 180,
"series_per_30_days": 500,
"series_per_minute": 60,
"workspace_per_minute": 10,
"log_bytes_per_day": 1073741824
},
"limits_version": "0000000000000000000000000000000000000000000000000000000000000000",
"live_series_per_connection_limit": 32,
"monitors": 0,
"monitors_limit": 0,
"new_devices_per_minute_limit": 0,
"new_devices_today": 0,
"new_devices_today_limit": 0,
"new_keys_per_minute_limit": 0,
"new_series_30d": 0,
"new_series_30d_limit": 0,
"new_series_per_minute_limit": 0,
"new_workspaces_per_minute_limit": 0,
"notifications_per_day_limit": 0,
"notifications_per_hour_limit": 0,
"points_per_minute_limit": 0,
"registration_origin": "demo",
"requests_per_minute_limit": 0,
"series": 0,
"series_limit": 0,
"tier": "demo",
"workspaces": 0,
"workspaces_limit": 0,
"forecast": {
"monitors": [],
"other_today": {
"bytes": 0,
"event_bytes": 0,
"events": 0,
"items": 0
},
"planned": {
"bytes": 0,
"event_bytes": 0,
"events": 0,
"items": 0
},
"reset_at": "2026-10-03T00:00:00Z",
"sampled_at": "2026-10-02T12:00:00Z",
"truncated": false,
"workspace_planned": {
"bytes": 0,
"event_bytes": 0,
"events": 0,
"items": 0
}
}
}| Stabile Fehlercodes |
|---|
| invalid_credential |
| unauthorized |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 401,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| csrf |
| insufficient_scope |
| invalid_origin |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 403,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| unavailable |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Retry-After | string; {"pattern":"^[0-9]+$"} | Sekunden bis zur Wiederholung. Bewahren Sie unterstützte Idempotenzkennungen und beachten Sie die Änderungsregeln der Operation. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 503,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| invalid_device |
| invalid_input |
| invalid_sort |
| invalid_workspace |
| invalid_copy_source |
| Header | Typ und Grenzen | Bedeutung |
|---|---|---|
| Cache-Control | string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"} | Private API-Antworten verbieten Speicherung. Öffentliche OAuth-Metadaten werden 300 Sekunden gecacht; Livestreams verbieten zusätzlich Transformation. |
| Content-Language | string; {"enum":["en","de"]} | Sprache lesbarer Antworttexte aus Accept-Language oder der dokumentierten Browserpräferenz. Technische Codes und Kennungen bleiben stabil. |
| Referrer-Policy | JSON; {"enum":["strict-origin-when-cross-origin","no-referrer"]} | Standard-Referrerpolicy ist strict-origin-when-cross-origin. Anbieterloginantworten verwenden no-referrer zum Schutz der Loginparameter. |
| Vary | string | Antworten variieren nach Accept-Language; browsergerenderte Antworten können zusätzlich nach Präferenzcookie variieren. |
| X-Content-Type-Options | JSON; {"const":"nosniff"} | Der Browser muss den angegebenen Inhaltstyp verwenden. |
| X-Frame-Options | JSON; {"const":"DENY"} | Die Antwort darf nicht in einem Frame eingebettet werden. |
| X-Request-ID | string | Vom Server erzeugte Anfragekennung. Bei Fehlermeldungen mitgeben; eingehende Werte werden nicht als vertrauenswürdig übernommen. |
application/problem+json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | Problem | Ja | — |
| $.code | string | Ja | Stabiler maschinenlesbarer Fehlercode |
| $.detail | string | Ja | Kurze lokalisierte Erklärung ohne interne Fehlerdaten |
| $.instance | string | Ja | Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource |
| $.message | string | Ja | Vorübergehend für bestehende Clients gleich detail |
| $.message_key | string | Ja | Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage |
| $.message_params | object; {"additionalProperties":true} | Ja | Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Ja | Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten. |
| $.status | integer; {"maximum":599,"minimum":400} | Ja | — |
| $.title | string | Ja | Lokalisierte HTTP-Statusbezeichnung |
| $.type | string; {"const":"about:blank"} | Ja | — |
{
"code": "demo",
"detail": "Demo error detail; inspect the documented code.",
"instance": "demo",
"message": "Demo error detail; inspect the documented code.",
"message_key": "errors.requestFailed",
"message_params": {},
"request_id": "00000000000000000000000000000000",
"status": 422,
"title": "Demo error",
"type": "about:blank"
}| Stabile Fehlercodes |
|---|
| not_found |
Wiederholungen und asynchrone Aufträge
Diese Operation liest oder prüft, ohne eine Ressourcenänderung anzuwenden. Beachten Sie Ratenlimits und Zugangslaufzeiten.
Anfragebeispiele
Ersetzen Sie Demokennungen, Zeitstempel und Platzhalter durch eigene Werte. Behalten Sie bei Wiederholungen Kennungen, Zeit und Inhalt bei. Diese Beispiele führen auf der Seite keine Anfragen aus.
Halten Sie Anmeldelinks, Codes, Cookies und Schlüssel privat. Schreiben Sie sie nicht in Logs und teilen Sie sie nicht in Hilfeanfragen.
curl --silent --show-error --output /dev/null --write-out "%{http_code}\n" \
--request GET \
--header @"$HOME/.config/metribeacon/headers.txt" \
"https://metribeacon.com/api/v1/usage"
import json
from pathlib import Path
from urllib.request import Request, HTTPRedirectHandler, build_opener
from urllib.error import HTTPError
headers = json.loads((Path.home() / ".config/metribeacon/headers.json").read_text())
request = Request("https://metribeacon.com/api/v1/usage", data=None, headers=headers, method="GET")
class NoRedirect(HTTPRedirectHandler):
def redirect_request(self, request, fp, code, message, headers, target):
return None
opener = build_opener(NoRedirect())
try:
with opener.open(request, timeout=10) as response:
print(response.status)
except HTTPError as error:
print(error.code)
error.close()
import { readFile } from "node:fs/promises";
import { homedir } from "node:os";
import { join } from "node:path";
const headers = JSON.parse(await readFile(join(homedir(), ".config/metribeacon/headers.json"), "utf8"));
const response = await fetch("https://metribeacon.com/api/v1/usage", {
method: "GET", headers, redirect: "manual",
signal: AbortSignal.timeout(10000),
});
console.log(response.status);
await response.body?.cancel();
package main
import (
"fmt"
"net/http"
"time"
"encoding/json"
"os"
"path/filepath"
)
func main() {
home, err := os.UserHomeDir(); if err != nil { panic("request failed; credentials and response omitted") }
raw, err := os.ReadFile(filepath.Join(home, ".config/metribeacon/headers.json")); if err != nil { panic("request failed; credentials and response omitted") }
var headers map[string]string
if json.Unmarshal(raw, &headers) != nil { panic("invalid local headers") }
request, err := http.NewRequest("GET", "https://metribeacon.com/api/v1/usage", nil)
if err != nil { panic("request failed; credentials and response omitted") }
for name, value := range headers { request.Header.Set(name, value) }
client := &http.Client{Timeout: 10*time.Second, CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}
response, err := client.Do(request)
if err != nil { panic("request failed; credentials and response omitted") }
defer response.Body.Close()
fmt.Println(response.StatusCode)
}
Verwandte Anleitungen
- HTTP-API, OAuth und MCP
Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
- GET Limits für Liveansichten und Historien abrufen
Liefert nur die wirksamen Kontolimits für Historien und Liveansichten. Mit workspace_id gelten die gemeinsamen Limits des berechtigten Arbeitsbereichsinhabers. Verbrauch und Prognosen werden nicht berechnet.
- GET Aktuell freigegebene API-Funktionen lesen
Lesen Sie aktuell verfügbare Monitoringfunktionen und die passende Vorlagenversion. Ihre eigenen Kontolimits gelten weiterhin.
- GET Öffentlichen Bereitschaftsstatus lesen
Öffentlichen Bereitschaftsstatus lesen.