Instanzen erstellen und verwalten

Voraussetzungen

• Sie haben ein STACKIT Kundenkonto: Kundenkonto erstellen
• Sie haben ein STACKIT Benutzerkonto: Benutzerkonto erstellen
• Sie haben ein STACKIT Projekt: Projekt erstellen

Instanz erstellen

STACKIT API

Um eine Telemetry Router-Instanz zu erstellen, müssen Sie den entsprechenden Endpunkt aufrufen.

Wählen Sie die Eigenschaften für Ihre neue Instanz

Parameter	Bedeutung	Beispiel
accessToken	Das individuelle Zugriffstoken Ihres Service Accounts	eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4
projectId	Ihre individuelle Projekt-ID	16dbfb51-7a75-42d3-a51d-99f87f48cd32
regionId	Die Region, in der sich Ihre Telemetry Router-Instanz befindet	eu01
displayName	Ein Name für die Telemetry Router-Instanz	my-telemetry-router
description	Eine optionale Beschreibung für Ihre Unterlagen	Meine Telemetry Router-Instanz

curl  -X POST \
'[https://telemetry-router.api.stackit.cloud/v1beta/projects/](https://telemetry-router.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-routers' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "displayName": [displayName],
    "description": [description]
}'

Beispiel

curl  -X POST \
'[https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers)' \
--header 'Authorization: Bearer eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4' \
--header 'Content-Type: application/json' \
--data-raw '{
    "displayName": "my-telemetry-router",
    "description": "Meine Telemetry Router-Instanz"
}'

Alle Instanzen auflisten

STACKIT API

Parameter	Bedeutung	Beispiel
accessToken	Das individuelle Zugriffstoken Ihres Service Accounts	eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4
projectId	Ihre individuelle Projekt-ID	16dbfb51-7a75-42d3-a51d-99f87f48cd32
regionId	Die Region, in der sich Ihre Telemetry Router-Instanz befindet	eu01

curl  -X GET \
'[https://telemetry-router.api.stackit.cloud/v1beta/projects/](https://telemetry-router.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-routers' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json'

Beispiel

curl  -X GET \
'[https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers)' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json'

Eine Instanz anzeigen

STACKIT API

Parameter	Bedeutung	Beispiel
accessToken	Das individuelle Zugriffstoken Ihres Service Accounts	eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4
projectId	Ihre individuelle Projekt-ID	16dbfb51-7a75-42d3-a51d-99f87f48cd32
regionId	Die Region, in der sich Ihre Telemetry Router-Instanz befindet	eu01
telemetryRouterId	Die ID Ihrer Telemetry Router-Instanz	d5b5cdcc-c155-4d66-82ef-4289db8e4557

curl  -X GET \
'[https://telemetry-router.api.stackit.cloud/v1beta/projects/](https://telemetry-router.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-routers/[telemetryRouterId]' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json'

Beispiel

curl  -X GET \
'[https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557)' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json'

Eine Instanz bearbeiten

STACKIT API

Parameter	Bedeutung	Beispiel
accessToken	Das individuelle Zugriffstoken Ihres Service Accounts	eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4
projectId	Ihre individuelle Projekt-ID	16dbfb51-7a75-42d3-a51d-99f87f48cd32
regionId	Die Region, in der sich Ihre Telemetry Router-Instanz befindet	eu01
telemetryRouterId	Die ID Ihrer Telemetry Router-Instanz	d5b5cdcc-c155-4d66-82ef-4289db8e4557
displayName	Ein Name für die Telemetry Router-Instanz. In diesem Endpunkt ist der Parameter optional.	my-telemetry-router
description	Eine optionale Beschreibung für Ihre Unterlagen	Meine Telemetry Router-Instanz
filter	Ein optionales Filter-Objekt. Lesen Sie Filter, um zu erfahren, wie Filter funktionieren.	Siehe Filter-Beispiel

curl  -X PUT \
'[https://telemetry-router.api.stackit.cloud/v1beta/projects/](https://telemetry-router.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-routers/[telemetryRouterId]' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json'
--data-raw '{
    "displayName": [name],
    "description": [description],
    "filter": [filter]
}'

Filter-Beispiel

attributes: [
    {
        key: 'my-special-filter',
        level: 'scope',
        matcher: '=',,
        value: 'user',
    },
]

Beispiel für das Hinzufügen eines Filters zu einer bestehenden Telemetry Router-Instanz

curl -X PUT \
'[https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557)' \
--header 'Authorization: Bearer eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filter": {
        "attributes": [
            {
                "key": "my-special-filter",
                "level": "scope",
                "matcher": "=",
                "value": "user"
            }
        ]
    }
}'

Eine Instanz löschen

STACKIT API

Um eine Telemetry Router-Instanz zu löschen, müssen Sie den DELETE-Endpunkt aufrufen.

Parameter	Bedeutung	Beispiel
accessToken	Das individuelle Zugriffstoken Ihres Service Accounts	eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4
projectId	Ihre individuelle Projekt-ID	16dbfb51-7a75-42d3-a51d-99f87f48cd32
regionId	Die Region, in der sich Ihre Telemetry Router-Instanz befindet	eu01
telemetryRouterId	Die ID Ihrer Telemetry Router-Instanz	d5b5cdcc-c155-4d66-82ef-4289db8e4557

curl  -X DELETE \
'[https://telemetry-router.api.stackit.cloud/v1beta/projects/](https://telemetry-router.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-routers/[telemetryRouterId]' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \

Beispiel:

curl  -X DELETE \
'[https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557)' \
--header 'Authorization: Bearer eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4' \
--header 'Content-Type: application/json' \