MetriBeacon
Menü
Deutsch

GET Wartungszeitpläne des Arbeitsbereichs lesen

/api/v1/workspaces/{id}/maintenance-schedules

Interne einmalige oder wöchentliche Wartung. Messungen und Alarmzustände laufen weiter; Zustellungen werden unterdrückt. IANA-Zeitlücken werden ausgelassen, doppelte Uhrzeiten verwenden die erste Ausführung. Deaktivierte Zeitpläne belegen einen der 20 Plätze. Änderungen erhalten vergangene Zeiten; Gruppenänderungen wirken ab ihrem Zeitpunkt. Öffentliche Hinweise erfordern einen getrennten Entwurf und Veröffentlichungsberechtigung der Statusseite.

Auf dieser Seite

Zugriff und Rechte

Interne einmalige oder wöchentliche Wartung. Messungen und Alarmzustände laufen weiter; Zustellungen werden unterdrückt. IANA-Zeitlücken werden ausgelassen, doppelte Uhrzeiten verwenden die erste Ausführung. Deaktivierte Zeitpläne belegen einen der 20 Plätze. Änderungen erhalten vergangene Zeiten; Gruppenänderungen wirken ab ihrem Zeitpunkt. Öffentliche Hinweise erfordern einen getrennten Entwurf und Veröffentlichungsberechtigung der Statusseite.

Browsersitzung: Cookie __Host-mb_session.

Maschinen-Verwaltungszugang in Authorization: Bearer. Beachten Sie die von der Operation benötigten Berechtigungen (Scopes).

Parameter und Header

FeldPositionTyp und GrenzenErforderlichBedeutung
idPfadstring; {"format":"uuid"}JaRessourcen-ID in diesem Arbeitsbereich

Anfragekörper

Kein Anfragekörper.

Antworten

application/json

FeldTyp und GrenzenErforderlichBedeutung
$objectJa—
$.limitinteger; {"const":20}Ja—
$.schedulesarray<object>; {"maxItems":20}Ja—
$.schedules[]objectJa—
$.schedules[].configobjectJaInterne einmalige oder wöchentliche Wartung. Messungen und Alarmzustände laufen weiter; Zustellungen werden unterdrückt. IANA-Zeitlücken werden ausgelassen, doppelte Uhrzeiten verwenden die erste Ausführung. Deaktivierte Zeitpläne belegen einen der 20 Plätze. Änderungen erhalten vergangene Zeiten; Gruppenänderungen wirken ab ihrem Zeitpunkt. Öffentliche Hinweise erfordern einen getrennten Entwurf und Veröffentlichungsberechtigung der Statusseite.
$.schedules[].config.device_idsarray<string; {"format":"uuid"}>; {"maxItems":100}Ja—
$.schedules[].config.device_ids[]string; {"format":"uuid"}Ja—
$.schedules[].config.duration_secondsinteger; {"maximum":604800,"minimum":60}Nein—
$.schedules[].config.ends_atstring; {"format":"date-time"}Nein—
$.schedules[].config.group_idsarray<string; {"format":"uuid"}>; {"maxItems":100}Ja—
$.schedules[].config.group_ids[]string; {"format":"uuid"}Ja—
$.schedules[].config.kindstring; {"enum":["once","weekly"]}Ja—
$.schedules[].config.local_timestring; {"pattern":"^[0-2][0-9]:[0-5][0-9]$"}Nein—
$.schedules[].config.starts_atstring; {"format":"date-time"}Nein—
$.schedules[].config.targetstring; {"enum":["workspace","groups","monitors"]}Ja—
$.schedules[].config.timezonestring; {"maxLength":64,"minLength":1}Ja—
$.schedules[].config.weekdayinteger; {"maximum":7,"minimum":1}Nein—
$.schedules[].enabledbooleanJa—
$.schedules[].idstring; {"format":"uuid"}Ja—
$.schedules[].namestring; {"maxLength":128,"minLength":1}Ja—
$.schedules[].occurrencesarray<object>Ja—
$.schedules[].occurrences[]objectJa—
$.schedules[].occurrences[].ends_atstring; {"format":"date-time"}Ja—
$.schedules[].occurrences[].starts_atstring; {"format":"date-time"}Ja—
$.schedules[].revisioninteger; {"minimum":1}Ja—
$.schedules[].updated_atstring; {"format":"date-time"}Ja—
$.schedules[].workspace_idstring; {"format":"uuid"}Ja—
json
{
  "limit": 20,
  "schedules": []
}
Stabile Fehlercodes
unauthorized
invalid_credential

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
forbidden
csrf
insufficient_scope
workspace_scope

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
not_found

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
idempotency_conflict
revision_conflict

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
invalid_dashboard
invalid_dashboard_sources
invalid_idempotency_key
invalid_maintenance
invalid_maintenance_targets
invalid_reference
invalid_workspace

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
dashboard_limit
maintenance_limit

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
unavailable

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"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.

shell
curl --fail-with-body --request GET --header @"$HOME/.config/metribeacon/headers.txt" "https://metribeacon.com/api/v1/workspaces/00000000-0000-4000-8000-000000000001/maintenance-schedules"
python
import json, os, urllib.request
request = urllib.request.Request("https://metribeacon.com/api/v1/workspaces/00000000-0000-4000-8000-000000000001/maintenance-schedules", method="GET", headers={"Cookie": os.environ["MB_COOKIE"], "X-CSRF-Token": os.environ["MB_CSRF"], "Content-Type": "application/json"})
with urllib.request.urlopen(request, timeout=30) as response:
    print(json.load(response))
javascript
const response = await fetch("https://metribeacon.com/api/v1/workspaces/00000000-0000-4000-8000-000000000001/maintenance-schedules", {method: "GET", headers: {"Cookie": process.env.MB_COOKIE, "X-CSRF-Token": process.env.MB_CSRF, "Content-Type": "application/json"}});
console.log(await response.json());
go
package main
import ("fmt"; "net/http"; "os"; "io"; "strings")
func main() {
 req, err := http.NewRequest("GET", "https://metribeacon.com/api/v1/workspaces/00000000-0000-4000-8000-000000000001/maintenance-schedules", strings.NewReader("")); if err != nil { panic(err) }; req.Header.Set("Cookie", os.Getenv("MB_COOKIE")); req.Header.Set("X-CSRF-Token", os.Getenv("MB_CSRF")); req.Header.Set("Content-Type", "application/json"); response, err := http.DefaultClient.Do(req); if err != nil { panic(err) }; defer response.Body.Close(); _, _ = io.Copy(os.Stdout, response.Body); fmt.Println()
}
  • HTTP-API, OAuth und MCP

    Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.

  • POST Internen Wartungszeitplan anlegen

    Interne einmalige oder wöchentliche Wartung. Messungen und Alarmzustände laufen weiter; Zustellungen werden unterdrückt. IANA-Zeitlücken werden ausgelassen, doppelte Uhrzeiten verwenden die erste Ausführung. Deaktivierte Zeitpläne belegen einen der 20 Plätze. Änderungen erhalten vergangene Zeiten; Gruppenänderungen wirken ab ihrem Zeitpunkt. Öffentliche Hinweise erfordern einen getrennten Entwurf und Veröffentlichungsberechtigung der Statusseite.

  • DELETE Internen Wartungszeitplan entfernen

    Interne einmalige oder wöchentliche Wartung. Messungen und Alarmzustände laufen weiter; Zustellungen werden unterdrückt. IANA-Zeitlücken werden ausgelassen, doppelte Uhrzeiten verwenden die erste Ausführung. Deaktivierte Zeitpläne belegen einen der 20 Plätze. Änderungen erhalten vergangene Zeiten; Gruppenänderungen wirken ab ihrem Zeitpunkt. Öffentliche Hinweise erfordern einen getrennten Entwurf und Veröffentlichungsberechtigung der Statusseite.

  • PUT Internen Wartungszeitplan speichern

    Interne einmalige oder wöchentliche Wartung. Messungen und Alarmzustände laufen weiter; Zustellungen werden unterdrückt. IANA-Zeitlücken werden ausgelassen, doppelte Uhrzeiten verwenden die erste Ausführung. Deaktivierte Zeitpläne belegen einen der 20 Plätze. Änderungen erhalten vergangene Zeiten; Gruppenänderungen wirken ab ihrem Zeitpunkt. Öffentliche Hinweise erfordern einen getrennten Entwurf und Veröffentlichungsberechtigung der Statusseite.