Zum Inhalt springen

Links erstellen und verwalten

Zuletzt aktualisiert am

Der Telemetry Link setzt einen bestehenden Telemetry Router voraus. Für jedes Level (Projekt, Ordner, Organisation) kann pro Region ein Telemetry Link angelegt werden. Für die Konfiguration eines Telemetry Links bedarf es sowohl der ID als auch eines Zugriffstokens des Telemetry Routers, welcher verknüpft werden soll. Ein Telemetry Link geht strikt davon aus, dass der konfigurierte Telemetry Router sich in der selben Region befindet.

Telemetrie-Links sind in drei Ebenen organisiert:

  • Ordner: Erfasst alles, was sich auf die Ordner selbst bezieht.
  • Organisationen: Erfasst alles, was sich auf die Organisationen selbst bezieht.
  • Projekte: Erfasst alles, was sich auf Projekte und alle darin enthaltenen Daten bezieht. Die überwiegende Mehrheit der Daten läuft über diesen Link.

Ein Telemetrie-Link erfasst Daten nur entsprechend seiner zugehörigen Ebene. Es gibt keine Vererbung – um alle verfügbaren Informationen zu erfassen, benötigen Sie mindestens einen Telemetrie-Link für jede Ebene.

Abschnitt betitelt „Eigenschaften für Ihren neuen oder bearbeiteten Link wählen“

Um einen Telemetrie-Link zu erstellen oder zu bearbeiten, müssen Sie dessen Parameter definieren. Alle Parameter sind Teil eines JSON-Konfigurations-Body-Objekts in dieser Form:

Für die Erstellung sind alle Parameter außer description erforderlich. Für die Bearbeitung sind alle Parameter optional.

{
[accessToken],
[telemetryRouterId],
[enabled],
[displayName],
[description]
}

Um einen Telemetrie-Link zu erstellen, müssen Sie den entsprechenden Endpunkt aufrufen. Jede Ebene (Ordner, Organisationen und Projekte) hat ihren eigenen Endpunkt. Das Body-Schema ist für jede Ebene gleich.

Terminal-Fenster
curl -X PUT \
'[https://telemetry-link.api.stackit.cloud/v1beta/folders/](https://telemetry-link.api.stackit.cloud/v1beta/folders/)[folderId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
[config]
}'
Terminal-Fenster
curl -X PUT \
'[https://telemetry-link.api.stackit.cloud/v1beta/organizations/](https://telemetry-link.api.stackit.cloud/v1beta/organizations/)[organizationId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
[config]
}'
Terminal-Fenster
curl -X PUT \
'[https://telemetry-link.api.stackit.cloud/v1beta/projects/](https://telemetry-link.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
[config]
}'

Um einen Telemetrie-Link anzuzeigen, müssen Sie den entsprechenden Endpunkt aufrufen. Jede Ebene (Ordner, Organisationen und Projekte) hat ihren eigenen Endpunkt.

Terminal-Fenster
curl -X GET \
'[https://telemetry-link.api.stackit.cloud/v1beta/folders/](https://telemetry-link.api.stackit.cloud/v1beta/folders/)[folderId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
Terminal-Fenster
curl -X GET \
'[https://telemetry-link.api.stackit.cloud/v1beta/organizations/](https://telemetry-link.api.stackit.cloud/v1beta/organizations/)[organizationId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
Terminal-Fenster
curl -X GET \
'[https://telemetry-link.api.stackit.cloud/v1beta/projects/](https://telemetry-link.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \

Um einen Telemetrie-Link zu bearbeiten, müssen Sie den entsprechenden Endpunkt aufrufen. Jede Ebene (Ordner, Organisationen und Projekte) hat ihren eigenen Endpunkt. Das Body-Schema ist für jede Ebene gleich.

Terminal-Fenster
curl -X PATCH \
'[https://telemetry-link.api.stackit.cloud/v1beta/folders/](https://telemetry-link.api.stackit.cloud/v1beta/folders/)[folderId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
[config]
}'
Terminal-Fenster
curl -X PATCH \
'[https://telemetry-link.api.stackit.cloud/v1beta/organizations/](https://telemetry-link.api.stackit.cloud/v1beta/organizations/)[organizationId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
[config]
}'
Terminal-Fenster
curl -X PATCH \
'[https://telemetry-link.api.stackit.cloud/v1beta/projects/](https://telemetry-link.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
[config]
}'

Um einen Telemetrie-Link zu löschen, müssen Sie den entsprechenden Endpunkt aufrufen. Jede Ebene (Ordner, Organisationen und Projekte) hat ihren eigenen Endpunkt.

Terminal-Fenster
curl -X DELETE \
'https://telemetry-link.api.stackit.cloud/v1beta/folders/[folderId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
Terminal-Fenster
curl -X DELETE \
'https://telemetry-link.api.stackit.cloud/v1beta/organizations/[organizationId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
Terminal-Fenster
curl -X DELETE \
'https://telemetry-link.api.stackit.cloud/v1beta/projects/[projectId]/regions/[regionId]/telemetry-link' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \