POST Monitorverfügbarkeit auswerten
/api/v1/monitors/{id}/overview/evaluate
Wertet die letzten 90 Tage und Zeiträume von 24 Stunden, 7, 30 und 90 Tagen mit der Gesamtverfügbarkeitsreihe des Monitors aus. Kalendertage verwenden die Zeitzone des anfragenden Kontos. Unbekannte, pausierte und fehlende Zeit ist keine bestätigte Verfügbarkeit. Bestehende Historienkapazität und Aufbewahrung gelten. Passende laufende Jobs oder höchstens fünf Minuten alte Ergebnisse werden wiederverwendet; den zurückgegebenen Archivjob bis zum Abschluss abfragen.
Auf dieser Seite
Zugriff und Rechte
Wertet die letzten 90 Tage und Zeiträume von 24 Stunden, 7, 30 und 90 Tagen mit der Gesamtverfügbarkeitsreihe des Monitors aus. Kalendertage verwenden die Zeitzone des anfragenden Kontos. Unbekannte, pausierte und fehlende Zeit ist keine bestätigte Verfügbarkeit. Bestehende Historienkapazität und Aufbewahrung gelten. Passende laufende Jobs oder höchstens fünf Minuten alte Ergebnisse werden wiederverwendet; den zurückgegebenen Archivjob bis zum Abschluss abfragen.
Browsersitzung: Cookie __Host-mb_session.
Maschinen-Verwaltungszugang in Authorization: Bearer. Beachten Sie die von der Operation benötigten Berechtigungen (Scopes).
Senden Sie bei einer Änderung mit Browsersitzung das aktuelle CSRF-Token in X-CSRF-Token zusammen mit dem Same-Site-Cookie. OAuth-Zustimmung verwendet ihr dokumentiertes Formularfeld.
Parameter und Header
| Feld | Position | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|---|
| id | Pfad | string; {"format":"uuid"} | Ja | Ressourcen-ID in diesem Arbeitsbereich |
Anfragekörper
Kein Anfragekörper.
Antworten
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
| $.id | string; {"format":"uuid"} | Ja | — |
| $.result | MonitorOverviewResult | null | HTTPResponseTimes | Ja | — |
| $.result (anyOf 1) | MonitorOverviewResult | Nein | — |
| $.result (anyOf 1).days | array<object>; {"maxItems":90,"minItems":90} | Ja | — |
| $.result (anyOf 1).days[] | object | Ja | — |
| $.result (anyOf 1).days[].before_creation | boolean | Ja | — |
| $.result (anyOf 1).days[].coverage_percent | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].day | string; {"format":"date"} | Ja | — |
| $.result (anyOf 1).days[].down_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).days[].to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).days[].unknown_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].unobserved_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].up_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].uptime_percent | number | null; {"maximum":100,"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].confirming_seconds | number | Ja | — |
| $.result (anyOf 1).evidence_from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).monitor_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 1).periods | array<object>; {"maxItems":4,"minItems":4} | Ja | — |
| $.result (anyOf 1).periods[] | object | Ja | — |
| $.result (anyOf 1).periods[].before_creation | boolean | Ja | — |
| $.result (anyOf 1).periods[].coverage_percent | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].down_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).periods[].hours | integer; {"enum":[24,168,720,2160]} | Ja | — |
| $.result (anyOf 1).periods[].to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).periods[].unknown_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].unobserved_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].up_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].uptime_percent | number | null; {"maximum":100,"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].confirming_seconds | number | Ja | — |
| $.result (anyOf 1).series_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 1).snapshot | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).source | string; {"enum":["local","mixed","archive"]} | Ja | — |
| $.result (anyOf 1).timezone | string | Ja | — |
| $.result (anyOf 2) | null | Nein | — |
| $.result (anyOf 3) | HTTPResponseTimes | Nein | — |
| $.result (anyOf 3).monitor_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 3).snapshot | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).display_seconds | integer | Ja | — |
| $.result (anyOf 3).resolution | string | Ja | — |
| $.result (anyOf 3).source | string | Ja | — |
| $.result (anyOf 3).completeness | string | Ja | — |
| $.result (anyOf 3).sources | array<HTTPResponseSource> | Ja | — |
| $.result (anyOf 3).sources[] | HTTPResponseSource | Ja | — |
| $.result (anyOf 3).sources[].id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 3).sources[].location_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 3).sources[].name | string | Ja | — |
| $.result (anyOf 3).sources[].group | string; {"enum":["Europe","NorthAmerica","SouthAmerica","MiddleEast","Asia","Africa","Oceania","Private","Unknown"]} | Ja | — |
| $.result (anyOf 3).sources[].interval_seconds | integer | Ja | — |
| $.result (anyOf 3).sources[].country_code | string | Ja | — |
| $.result (anyOf 3).sources[].active | boolean | Ja | — |
| $.result (anyOf 3).regions | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).regions[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).regions[].group | string; {"enum":["Europe","NorthAmerica","SouthAmerica","MiddleEast","Asia","Africa","Oceania","Private","Unknown"]} | Ja | — |
| $.result (anyOf 3).regions[].source_count | integer | Ja | — |
| $.result (anyOf 3).regions[].sum | number | Ja | — |
| $.result (anyOf 3).regions[].count | integer | Ja | — |
| $.result (anyOf 3).regions[].points | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).regions[].points[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).regions[].points[].time | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).regions[].points[].sum | number | Ja | — |
| $.result (anyOf 3).regions[].points[].count | integer | Ja | — |
| $.result (anyOf 3).regions[].gaps | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).regions[].gaps[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).regions[].gaps[].from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).regions[].gaps[].to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).regions[].gaps[].reason | string | Ja | — |
| $.result (anyOf 3).sum | number | Ja | — |
| $.result (anyOf 3).count | integer | Ja | — |
| $.result (anyOf 3).version | integer; {"const":2} | Ja | — |
| $.result (anyOf 3).locations | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).locations[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).locations[].sum | number | Ja | — |
| $.result (anyOf 3).locations[].count | integer | Ja | — |
| $.result (anyOf 3).locations[].points | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).locations[].points[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).locations[].points[].time | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).locations[].points[].sum | number | Ja | — |
| $.result (anyOf 3).locations[].points[].count | integer | Ja | — |
| $.result (anyOf 3).locations[].gaps | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).locations[].gaps[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).locations[].gaps[].from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).locations[].gaps[].to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).locations[].gaps[].reason | string | Ja | — |
| $.result (anyOf 3).locations[].series_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 3).locations[].location_id | string; {"format":"uuid"} | Ja | — |
| $.status | string; {"enum":["queued","running","complete"]} | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
| $.id | string; {"format":"uuid"} | Ja | — |
| $.result | MonitorOverviewResult | null | HTTPResponseTimes | Ja | — |
| $.result (anyOf 1) | MonitorOverviewResult | Nein | — |
| $.result (anyOf 1).days | array<object>; {"maxItems":90,"minItems":90} | Ja | — |
| $.result (anyOf 1).days[] | object | Ja | — |
| $.result (anyOf 1).days[].before_creation | boolean | Ja | — |
| $.result (anyOf 1).days[].coverage_percent | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].day | string; {"format":"date"} | Ja | — |
| $.result (anyOf 1).days[].down_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).days[].to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).days[].unknown_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].unobserved_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].up_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].uptime_percent | number | null; {"maximum":100,"minimum":0} | Ja | — |
| $.result (anyOf 1).days[].confirming_seconds | number | Ja | — |
| $.result (anyOf 1).evidence_from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).monitor_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 1).periods | array<object>; {"maxItems":4,"minItems":4} | Ja | — |
| $.result (anyOf 1).periods[] | object | Ja | — |
| $.result (anyOf 1).periods[].before_creation | boolean | Ja | — |
| $.result (anyOf 1).periods[].coverage_percent | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].down_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).periods[].hours | integer; {"enum":[24,168,720,2160]} | Ja | — |
| $.result (anyOf 1).periods[].to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).periods[].unknown_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].unobserved_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].up_seconds | number; {"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].uptime_percent | number | null; {"maximum":100,"minimum":0} | Ja | — |
| $.result (anyOf 1).periods[].confirming_seconds | number | Ja | — |
| $.result (anyOf 1).series_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 1).snapshot | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 1).source | string; {"enum":["local","mixed","archive"]} | Ja | — |
| $.result (anyOf 1).timezone | string | Ja | — |
| $.result (anyOf 2) | null | Nein | — |
| $.result (anyOf 3) | HTTPResponseTimes | Nein | — |
| $.result (anyOf 3).monitor_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 3).snapshot | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).display_seconds | integer | Ja | — |
| $.result (anyOf 3).resolution | string | Ja | — |
| $.result (anyOf 3).source | string | Ja | — |
| $.result (anyOf 3).completeness | string | Ja | — |
| $.result (anyOf 3).sources | array<HTTPResponseSource> | Ja | — |
| $.result (anyOf 3).sources[] | HTTPResponseSource | Ja | — |
| $.result (anyOf 3).sources[].id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 3).sources[].location_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 3).sources[].name | string | Ja | — |
| $.result (anyOf 3).sources[].group | string; {"enum":["Europe","NorthAmerica","SouthAmerica","MiddleEast","Asia","Africa","Oceania","Private","Unknown"]} | Ja | — |
| $.result (anyOf 3).sources[].interval_seconds | integer | Ja | — |
| $.result (anyOf 3).sources[].country_code | string | Ja | — |
| $.result (anyOf 3).sources[].active | boolean | Ja | — |
| $.result (anyOf 3).regions | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).regions[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).regions[].group | string; {"enum":["Europe","NorthAmerica","SouthAmerica","MiddleEast","Asia","Africa","Oceania","Private","Unknown"]} | Ja | — |
| $.result (anyOf 3).regions[].source_count | integer | Ja | — |
| $.result (anyOf 3).regions[].sum | number | Ja | — |
| $.result (anyOf 3).regions[].count | integer | Ja | — |
| $.result (anyOf 3).regions[].points | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).regions[].points[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).regions[].points[].time | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).regions[].points[].sum | number | Ja | — |
| $.result (anyOf 3).regions[].points[].count | integer | Ja | — |
| $.result (anyOf 3).regions[].gaps | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).regions[].gaps[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).regions[].gaps[].from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).regions[].gaps[].to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).regions[].gaps[].reason | string | Ja | — |
| $.result (anyOf 3).sum | number | Ja | — |
| $.result (anyOf 3).count | integer | Ja | — |
| $.result (anyOf 3).version | integer; {"const":2} | Ja | — |
| $.result (anyOf 3).locations | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).locations[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).locations[].sum | number | Ja | — |
| $.result (anyOf 3).locations[].count | integer | Ja | — |
| $.result (anyOf 3).locations[].points | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).locations[].points[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).locations[].points[].time | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).locations[].points[].sum | number | Ja | — |
| $.result (anyOf 3).locations[].points[].count | integer | Ja | — |
| $.result (anyOf 3).locations[].gaps | array<object; {"additionalProperties":false}> | Ja | — |
| $.result (anyOf 3).locations[].gaps[] | object; {"additionalProperties":false} | Ja | — |
| $.result (anyOf 3).locations[].gaps[].from | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).locations[].gaps[].to | string; {"format":"date-time"} | Ja | — |
| $.result (anyOf 3).locations[].gaps[].reason | string | Ja | — |
| $.result (anyOf 3).locations[].series_id | string; {"format":"uuid"} | Ja | — |
| $.result (anyOf 3).locations[].location_id | string; {"format":"uuid"} | Ja | — |
| $.status | string; {"enum":["queued","running","complete"]} | Ja | — |
| Stabile Fehlercodes |
|---|
| invalid_session |
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 | — |
| Stabile Fehlercodes |
|---|
| csrf |
| forbidden |
| insufficient_scope |
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 | — |
| Stabile Fehlercodes |
|---|
| not_found |
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 | — |
| Stabile Fehlercodes |
|---|
| invalid_monitor |
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 | — |
| Stabile Fehlercodes |
|---|
| query_limit |
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 | — |
| Stabile Fehlercodes |
|---|
| unavailable |
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 | — |
Wiederholungen und asynchrone Aufträge
Für diese Änderung gibt es keine allgemeine Wiederholungsgarantie. Prüfen Sie bei unklarer Antwort den betroffenen Eintrag, bevor Sie es erneut versuchen. Beachten Sie Wartezeiten aus Retry-After und fordern Sie abgelaufene Anmelde- oder Aktionscodes neu an.
HTTP 202 bedeutet, dass der Hintergrundauftrag angenommen wurde. Prüfen Sie seinen Status mit der zurückgegebenen Auftragskennung. Laden Sie Ergebnisse nach dem Abschluss herunter oder lesen Sie den Fehler- beziehungsweise Abbruchstatus.
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 POST --header @"$HOME/.config/metribeacon/headers.txt" "https://metribeacon.com/api/v1/monitors/00000000-0000-4000-8000-000000000001/overview/evaluate"
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())
class NoRedirect(HTTPRedirectHandler):
def redirect_request(self, request, fp, code, message, headers, target): return None
request=Request('https://metribeacon.com/api/v1/monitors/00000000-0000-4000-8000-000000000001/overview/evaluate',data=None,headers=headers,method='POST')
try:
with build_opener(NoRedirect()).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/monitors/00000000-0000-4000-8000-000000000001/overview/evaluate",{method:"POST",headers,redirect:"manual",signal:AbortSignal.timeout(10000)});
console.log(response.status);await response.body?.cancel();
package main
import("encoding/json";"fmt";"net/http";"os";"path/filepath";"time")
func main(){home,e:=os.UserHomeDir();if e!=nil{return};raw,e:=os.ReadFile(filepath.Join(home,".config/metribeacon/headers.json"));if e!=nil{return};var headers map[string]string;if json.Unmarshal(raw,&headers)!=nil{return};req,e:=http.NewRequest("POST","https://metribeacon.com/api/v1/monitors/00000000-0000-4000-8000-000000000001/overview/evaluate",nil);if e!=nil{return};for k,v:=range headers{req.Header.Set(k,v)};client:=&http.Client{Timeout:10*time.Second,CheckRedirect:func(*http.Request,[]*http.Request)error{return http.ErrUseLastResponse}};res,e:=client.Do(req);if e!=nil{return};defer res.Body.Close();fmt.Println(res.StatusCode)}
Verwandte Anleitungen
- HTTP-API, OAuth und MCP
Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
- GET Gesamtverfügbarkeitsquelle des Monitors lesen
HTTP- sowie TCP-, UDP-, DNS-, TLS-, Ping-, Dienst-, Domain- und Browsermonitore verwenden eine Gesamtverfügbarkeitsreihe je Monitor. Bei mehreren Prüfstandorten folgt diese der eingestellten Bestätigung und Standortregel (ein Standort, alle oder Quorum). Zeiten einzelner Standorte oder Engines werden nicht addiert. Der Katalog enthält aktive Monitore mit aktivierter Verfügbarkeitserfassung; die einzelne Quelle macht auch erhaltene Historie bei deaktivierter Erfassung zugänglich. Unbekannte, pausierte und unbeobachtete Zeit zählen niemals als bestätigte Verfügbarkeit. SLOs und Berichte verwenden dieselbe Quelle und behalten ihre getrennte Wartungsberechnung.
- POST HTTP-Antwortzeiten nach Standort und Region auswerten
Vergleichen Sie alle aufbewahrten regulären HTTP-Prüfdauern nach Standort oder Weltregion in einem gemeinsamen Datenstand. Mittelwerte sind nach Messungsanzahl gewichtet; der Gesamtdurchschnitt berücksichtigt ausgeblendete Standorte. Fehlende Messungen bleiben Lücken. Die automatische Darstellung teilt ein Ergebnisbudget von 16.000 Anzeigepunkten und 4 MiB zwischen beiden Ansichten. Original- und Livegrenzen werden ausdrücklich angezeigt; Echtzeit-Alarmreihen bleiben unverändert.
- GET SSL-Zertifikatsdetails lesen
Lesen Sie begrenzte, standortgebundene Zertifikatsnachweise. Automatische Zertifikatsdiagnosen und Resttagemessungen erfolgen stündlich, Domaindiagnosen täglich. Nachprüfungen erfordern Bearbeitungsrechte, ein gespeichertes Ziel, die aktuelle Konfigurationsrevision und eine Vorgangskennung. Sie nutzen Prüfkontingente, ohne reguläre HTTP-Messungen oder Alarmbestätigungen zu ändern. Unbekannte oder veraltete Nachweise bestätigen keine Gültigkeit.