MetriBeacon
Menü
Deutsch

POST Gerät und separate CLI-/MCP-Verwaltungskennung freigeben

/api/v1/agent/device-link

CSRF erforderlich. Eigenen Arbeitsbereich auswählen oder anlegen; unkonfigurierten Server auswählen oder anlegen. Standard sind CPU, RAM und Systemlaufwerk alle 30 Sekunden. Kontokontingente werden in derselben Transaktion geprüft. Wiederholungen desselben Kontos erzeugen keine weiteren Schlüssel; ein anderes Konto kann abgeschlossene Anfragen nicht freigeben.

Auf dieser Seite

Zugriff und Rechte

CSRF erforderlich. Eigenen Arbeitsbereich auswählen oder anlegen; unkonfigurierten Server auswählen oder anlegen. Standard sind CPU, RAM und Systemlaufwerk alle 30 Sekunden. Kontokontingente werden in derselben Transaktion geprüft. Wiederholungen desselben Kontos erzeugen keine weiteren Schlüssel; ein anderes Konto kann abgeschlossene Anfragen nicht freigeben.

Browsersitzung: Cookie __Host-mb_session.

Parameter und Header

Keine Pfad-, Query- oder zusätzlichen Anfrageheader-Parameter.

Anfragekörper

FeldTyp und GrenzenErforderlichBedeutung
$DeviceLinkApprovalJa—
$.codestring; {"pattern":"^[0-9]{8}$"}Ja—
$.device_idstring; {"format":"uuid"}Nein—
$.namestring; {"maxLength":128,"minLength":1}Ja—
$.selectionsarray<AgentSelection>; {"maxItems":200}Nein—
$.selections[]AgentSelectionJa—
$.selections[].component_idstringJa—
$.selections[].interval_secondsinteger; {"maximum":86400,"minimum":1}Ja—
$.selections[].parameter_keystringJa—
$.workspace_idstring; {"format":"uuid"}Nein—
$.workspace_namestring; {"maxLength":128,"minLength":1}Nein—
$.server_profileServerProfileRequestNein—
$.server_profile.componentsarray<object>; {"maxItems":200} | nullNeinErkannte oder ausdrücklich ausgewählte Serverkomponenten.
$.server_profile.components (anyOf 1)array<object>; {"maxItems":200}Nein—
$.server_profile.components (anyOf 1)[]objectJa—
$.server_profile.components (anyOf 1)[].addressstringNein—
$.server_profile.components (anyOf 1)[].familystringNein—
$.server_profile.components (anyOf 1)[].idstringJaUUID dieser Ressource. Bewahren Sie die zurückgegebene Kennung für weitere Operationen auf.
$.server_profile.components (anyOf 1)[].kindstringJaRessourcenart oder Messwerttyp aus den angegebenen Werten.
$.server_profile.components (anyOf 1)[].labelstring; {"maxLength":128,"minLength":1}JaAnzeigename der Komponente.
$.server_profile.components (anyOf 1)[].local_refstringNein—
$.server_profile.components (anyOf 1)[].namestringNeinLesbarer Ressourcenname. Beachten Sie die angegebene Längengrenze.
$.server_profile.components (anyOf 1)[].pathstring; {"maxLength":1024}Nein—
$.server_profile.components (anyOf 1)[].portintegerNein—
$.server_profile.components (anyOf 1)[].projectstringNein—
$.server_profile.components (anyOf 1)[].protocolstringNein—
$.server_profile.components (anyOf 1)[].text_languagesobjectNein—
$.server_profile.components (anyOf 1)[].timeout_secondsintegerNein—
$.server_profile.components (anyOf 1)[].translationsobject; {"additionalProperties":false}Nein—
$.server_profile.components (anyOf 1)[].translations.deobjectNein—
$.server_profile.components (anyOf 1)[].translations.enobjectNein—
$.server_profile.components (anyOf 1)[].transportstringNein—
$.server_profile.components (anyOf 1)[].filesystem_identitystring; {"maxLength":256}NeinVom Agenten gemeldete Volumeidentität. Unverändert beibehalten, damit ein Ersatzvolume nicht die Historie eines anderen Volumes fortsetzt.
$.server_profile.components (anyOf 1)[].disk_identitystring; {"maxLength":256}Nein—
$.server_profile.components (anyOf 2)nullNein—
$.server_profile.selectionsarray<object>; {"maxItems":200} | nullNeinGewählte Komponenten-/Parameterpaare mit Abtastintervallen.
$.server_profile.selections (anyOf 1)array<object>; {"maxItems":200}Nein—
$.server_profile.selections (anyOf 1)[]objectJa—
$.server_profile.selections (anyOf 1)[].component_idstringJaStabile Kennung der gewählten oder erkannten Komponente.
$.server_profile.selections (anyOf 1)[].interval_secondsinteger; {"maximum":86400,"minimum":0}NeinAbtast- oder Prüfintervall in Sekunden innerhalb der angegebenen Grenzen.
$.server_profile.selections (anyOf 1)[].parameter_keystringJaStabile Parameterkennung aus dem Serverkatalog.
$.server_profile.selections (anyOf 2)nullNein—
$.server_profile.versionJSON; {"const":2}Ja—
$.server_profile.overviewobject; {"additionalProperties":false}NeinAusdrückliche Ziele für die Serverübersicht mit sechs Diagrammen; wählen Sie alle benötigten Messwerte aus.
$.server_profile.overview.system_idstring; {"maxLength":128}Ja—
$.server_profile.overview.filesystem_idstring; {"maxLength":128}Ja—
$.server_profile.overview.disk_idstring; {"maxLength":128}Ja—
$.server_profile.overview.network_idstring; {"maxLength":128}Ja—
$.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.
$.server_profile.filesystem_discovery.modestring; {"enum":["off","local"]}Ja—
$.server_profile.filesystem_discovery.interval_secondsinteger; {"minimum":10,"maximum":86400}Ja—
$.server_profile.system_discoveryobject; {"additionalProperties":false}Nein—
$.server_profile.system_discovery.modestring; {"enum":["off","local"]}Ja—
$.server_profile.system_discovery.interval_secondsinteger; {"minimum":10,"maximum":86400}Ja—
$.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.

Antworten

application/json

FeldTyp und GrenzenErforderlichBedeutung
$object; {"additionalProperties":false}Ja—
$.approvedbooleanJa—
$.replayedbooleanJa—
Stabile Fehlercodes
invalid_link
not_found
Stabile Fehlercodes
revision_conflict
Stabile Fehlercodes
invalid_link
invalid_profile
unsupported_parameter
Stabile Fehlercodes
creation_quota
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 POST https://metribeacon.com/api/v1/agent/device-link --header 'Accept: application/json' --header 'Cookie: __Host-mb_session=YOUR_SESSION; __Host-mb_csrf=YOUR_CSRF' --header 'Content-Type: application/json' --header 'Origin: https://metribeacon.com' --header 'X-CSRF-Token: YOUR_CSRF' --data '{"code":"12345678","name":"Demo device"}'
python
import urllib.request
headers = {'Accept': 'application/json', 'Cookie': '__Host-mb_session=YOUR_SESSION; __Host-mb_csrf=YOUR_CSRF', 'Content-Type': 'application/json', 'Origin': 'https://metribeacon.com', 'X-CSRF-Token': 'YOUR_CSRF'}
request = urllib.request.Request('https://metribeacon.com/api/v1/agent/device-link', headers=headers, method='POST', data='{"code":"12345678","name":"Demo device"}'.encode())
with urllib.request.urlopen(request) as response:
    print(response.read().decode())
javascript
const response = await fetch("https://metribeacon.com/api/v1/agent/device-link", {"method": "POST", "headers": {"Accept": "application/json", "Cookie": "__Host-mb_session=YOUR_SESSION; __Host-mb_csrf=YOUR_CSRF", "Content-Type": "application/json", "Origin": "https://metribeacon.com", "X-CSRF-Token": "YOUR_CSRF"}, "body": "{\"code\":\"12345678\",\"name\":\"Demo device\"}"});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());
go
package main
import ("fmt"; "io"; "net/http"; "strings")
func main() {
 req, err := http.NewRequest("POST", "https://metribeacon.com/api/v1/agent/device-link", strings.NewReader("{\"code\":\"12345678\",\"name\":\"Demo device\"}")); 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")
 req.Header.Set("Content-Type", "application/json")
 req.Header.Set("Origin", "https://metribeacon.com")
 req.Header.Set("X-CSRF-Token", "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)
}