MetriBeacon
Menü
Deutsch

GET Fortschritt der automatischen Servereinrichtung lesen

/api/v1/agent/install-codes/{id}

Meldet den Eingang des ersten Lebenszeichens und ausgewählter Messwerte nach der Verbindung. Der ausstellende Browser kann den Fortschritt auch nach Ablauf des Codes lesen.

Auf dieser Seite

Zugriff und Rechte

Meldet den Eingang des ersten Lebenszeichens und ausgewählter Messwerte nach der Verbindung. Der ausstellende Browser kann den Fortschritt auch nach Ablauf des Codes lesen.

Browsersitzung: Cookie __Host-mb_session.

Parameter und Header

FeldPositionTyp und GrenzenErforderlichBedeutung
idPfadstring; {"format":"uuid"}JaInstallationseinstellung oder vom Gerät gemeldeter Wert.
workspace_idURL-Parameterstring; {"format":"uuid"}NeinInstallationseinstellung oder vom Gerät gemeldeter Wert.

Anfragekörper

Kein Anfragekörper.

Antworten

application/json

FeldTyp und GrenzenErforderlichBedeutung
$AgentInstallStatusJa—
$.idstring; {"format":"uuid"}JaInstallationseinstellung oder vom Gerät gemeldeter Wert.
$.statusstring; {"enum":["waiting","connected","ready","expired","revoked"]}JaInstallationseinstellung oder vom Gerät gemeldeter Wert.
$.expires_atstring; {"format":"date-time"}JaInstallationseinstellung oder vom Gerät gemeldeter Wert.
$.device_idstring | null; {"format":"uuid"}JaInstallationseinstellung oder vom Gerät gemeldeter Wert.
$.heartbeat_acceptedbooleanJaInstallationseinstellung oder vom Gerät gemeldeter Wert.
$.measurement_acceptedbooleanJaInstallationseinstellung oder vom Gerät gemeldeter Wert.
$.settingsobjectNein—
$.settings.namestringNein—
$.settings.platformstring; {"enum":["unix","windows"]}Nein—
$.settings.interval_secondsintegerNein—
$.settings.group_idsarray | nullNein—
$.settings.group_ids[]string; {"format":"uuid"}Ja—
$.settings.server_profileAgentProfileNein—
$.settings.server_profile.componentsarray<AgentComponent>; {"maxItems":200}Ja—
$.settings.server_profile.components[]AgentComponentJa—
$.settings.server_profile.components[].addressstringNein—
$.settings.server_profile.components[].familystringNein—
$.settings.server_profile.components[].idstringJa—
$.settings.server_profile.components[].kindstring; {"enum":["system","filesystem","disk","network","process","container","file","program","connection","ping","storage_pool"]}Ja—
$.settings.server_profile.components[].labelstringJa—
$.settings.server_profile.components[].local_refstringNein—
$.settings.server_profile.components[].namestringNein—
$.settings.server_profile.components[].pathstringNein—
$.settings.server_profile.components[].portinteger; {"maximum":65535,"minimum":0}Nein—
$.settings.server_profile.components[].projectstringNein—
$.settings.server_profile.components[].protocolstringNein—
$.settings.server_profile.components[].text_languagesobjectNein—
$.settings.server_profile.components[].timeout_secondsinteger; {"minimum":0}Nein—
$.settings.server_profile.components[].translationsobject; {"additionalProperties":false}Nein—
$.settings.server_profile.components[].translations.deobjectNein—
$.settings.server_profile.components[].translations.enobjectNein—
$.settings.server_profile.components[].transportstringNein—
$.settings.server_profile.components[].filesystem_identitystring; {"maxLength":256}NeinVom Agenten gemeldete Volumeidentität. Unverändert beibehalten, damit ein Ersatzvolume nicht die Historie eines anderen Volumes fortsetzt.
$.settings.server_profile.components[].disk_identitystring; {"maxLength":256}Nein—
$.settings.server_profile.selectionsarray<AgentSelection>; {"maxItems":200}Ja—
$.settings.server_profile.selections[]AgentSelectionJa—
$.settings.server_profile.selections[].component_idstringJa—
$.settings.server_profile.selections[].interval_secondsinteger; {"maximum":86400,"minimum":1}Ja—
$.settings.server_profile.selections[].parameter_keystringJa—
$.settings.server_profile.versioninteger; {"const":2}Ja—
$.settings.server_profile.overviewobject; {"additionalProperties":false}NeinAusdrückliche Ziele für die Serverübersicht mit sechs Diagrammen; wählen Sie alle benötigten Messwerte aus.
$.settings.server_profile.overview.system_idstring; {"maxLength":128}Ja—
$.settings.server_profile.overview.filesystem_idstring; {"maxLength":128}Ja—
$.settings.server_profile.overview.disk_idstring; {"maxLength":128}Ja—
$.settings.server_profile.overview.network_idstring; {"maxLength":128}Ja—
$.settings.server_profile.filesystem_discoveryobject; {"additionalProperties":false}NeinOptionale Erkennung lokaler Dateisysteme mit einem Grundintervall von mindestens 10 Sekunden. Neue Server/NAS-Einrichtungen aktivieren sie. Bestehende Profile benötigen eine ausdrückliche Aktivierung. Manuell deaktivierte Messreihen bleiben erhalten.
$.settings.server_profile.filesystem_discovery.modestring; {"enum":["off","local"]}Ja—
$.settings.server_profile.filesystem_discovery.interval_secondsinteger; {"minimum":10,"maximum":86400}Ja—
$.settings.server_profile.system_discoveryobject; {"additionalProperties":false}Nein—
$.settings.server_profile.system_discovery.modestring; {"enum":["off","local"]}Ja—
$.settings.server_profile.system_discovery.interval_secondsinteger; {"minimum":10,"maximum":86400}Ja—
$.settings.server_profile.global_interval_secondsinteger; {"minimum":1,"maximum":86400}NeinAusdrückliche globale Intervallauswahl. Jede Quelle behält ihr Plattformminimum; einzelne schnelle Reihen gelten nicht als globale Auswahl.

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—

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—

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—

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

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.

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 'https://metribeacon.com/api/v1/agent/install-codes/33333333-3333-4333-8333-333333333333' --header 'Accept: application/json' --header 'Cookie: __Host-mb_session=YOUR_SESSION; __Host-mb_csrf=YOUR_CSRF'
python
import urllib.request
headers = {'Accept': 'application/json', 'Cookie': '__Host-mb_session=YOUR_SESSION; __Host-mb_csrf=YOUR_CSRF'}
request = urllib.request.Request('https://metribeacon.com/api/v1/agent/install-codes/33333333-3333-4333-8333-333333333333', headers=headers, method='GET')
with urllib.request.urlopen(request) as response:
    print(response.read().decode())
javascript
const response = await fetch("https://metribeacon.com/api/v1/agent/install-codes/33333333-3333-4333-8333-333333333333", {"method": "GET", "headers": {"Accept": "application/json", "Cookie": "__Host-mb_session=YOUR_SESSION; __Host-mb_csrf=YOUR_CSRF"}});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.text());
go
package main
import ("fmt"; "io"; "net/http"; "strings")
func main() {
 req, err := http.NewRequest("GET", "https://metribeacon.com/api/v1/agent/install-codes/33333333-3333-4333-8333-333333333333", strings.NewReader("")); if err != nil { panic(err) }
 req.Header.Set("Accept","application/json")
 req.Header.Set("Cookie","__Host-mb_session=YOUR_SESSION; __Host-mb_csrf=YOUR_CSRF")
 response, err := http.DefaultClient.Do(req); if err != nil { panic(err) }; defer response.Body.Close(); data, err := io.ReadAll(response.Body); if err != nil { panic(err) }; fmt.Printf("HTTP %d\n%s\n", response.StatusCode, data)
}
  • HTTP-API, OAuth und MCP

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

  • DELETE Unbenutzten Installationscode widerrufen

    Widerruft einen unbenutzten Code. Bereits verbundene Server und ihre Geräteschlüssel werden über die vorhandenen Monitor- und Schlüsselschnittstellen verwaltet.

  • POST Einmaligen Server-Installationscode erstellen

    Im Browser freigegebener Zehn-Minuten-Code für diesen Arbeitsbereich und das gewählte Profil. Erst beim Einlösen entsteht ein Monitor; Bearbeitungsrechte sind erforderlich. Gespeichert wird nur der Codehash.

  • POST Server mit Installationscode verbinden

    Legt den gebundenen Server, Profil, Gruppen und einen Geräteschlüssel aus dem lokal erzeugten Schlüsselhash atomar an oder verbindet sie. Identische Anfragen können sicher fortgesetzt werden; der private Geräteschlüssel kann eine gespeicherte Verbindung nach Ablauf des Codes wiederaufnehmen.