GET Gesamtverfügbarkeitsquelle des Monitors lesen
/api/v1/monitors/{id}/availability
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.
Auf dieser Seite
Zugriff und Rechte
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.
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 |
|---|---|---|---|---|
| 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 | — |
| $.monitor_id | string; {"format":"uuid"} | Ja | — |
| $.workspace_id | string; {"format":"uuid"} | Ja | — |
| $.name | string | Ja | — |
| $.type | string | Ja | — |
| $.series_id | string; {"format":"uuid"} | Ja | — |
| $.selected | boolean | Ja | — |
| $.metric_ids | object | Nein | — |
| $.config_revision | integer | Nein | — |
| $.retention_revision | string | Nein | — |
| $.retained_from | string; {"format":"date-time"} | Nein | — |
{
"monitor_id": "00000000-0000-4000-8000-000000000001",
"workspace_id": "00000000-0000-4000-8000-000000000002",
"name": "API availability",
"type": "tcp",
"series_id": "00000000-0000-4000-8000-000000000003",
"selected": true
}| 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 |
|---|
| 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 |
|---|
| 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
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/monitors/00000000-0000-4000-8000-000000000001/availability"
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/availability',data=None,headers=headers,method='GET')
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/availability",{method:"GET",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("GET","https://metribeacon.com/api/v1/monitors/00000000-0000-4000-8000-000000000001/availability",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.
- POST Monitorverfügbarkeit auswerten
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.
- 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.