Zugriffstoken erstellen und verwalten

Voraussetzungen

• Sie verfügen über eine Instanz des Telemetry Router. Instanzen erstellen und verwalten

Verwechseln Sie die Zugriffstoken, die Sie mit dieser Anleitung erstellen, nicht mit den Zugriffstoken Ihres Service-Accounts. Letztere müssen Sie bei jedem Aufruf der STACKIT API angeben, um den Telemetry Router zu verwalten.

Zugriffstoken erstellen

STACKIT API

Um ein Zugriffstoken für den Telemetry Router zu erstellen, müssen Sie den entsprechenden Endpunkt aufrufen.

Eigenschaften für Ihr neues Zugriffstoken wählen

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 Instanz des Telemetry Router befindet	eu01
telemetryRouterId	Die ID Ihrer Instanz des Telemetry Router	d5b5cdcc-c155-4d66-82ef-4289db8e4557
ttl	Eine Ganzzahl oder null, um die Lebensdauer des Tokens in Tagen zu definieren. null steht für ein Token mit unbegrenzter Lebensdauer.	28800
displayName	Ein Name für die Instanz des Telemetry Router	my-telemetry-router
description	Eine optionale Beschreibung für Ihre Unterlagen	Meine Instanz des Telemetry Router

curl  -X POST \
'[https://telemetry-router.api.stackit.cloud/v1beta/projects/](https://telemetry-router.api.stackit.cloud/v1beta/projects/)[projectId]/regions/[regionId]/telemetry-routers/[telemetryRouterId]/access-tokens' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ttl": [ttl],
    "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/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens)' \
--header 'Authorization: Bearer eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ttl": 180,
    "displayName": "my-telemetry-router-access-token",
    "description": "Mein Zugriffstoken für den Telemetry Router"
}'

Alle Zugriffstoken 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 Instanz des Telemetry Router befindet	eu01
telemetryRouterId	Die ID Ihrer Instanz des Telemetry Router	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]/access-tokens' \
--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/access-tokens](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens)' \
--header 'Authorization: Bearer eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4' \
--header 'Content-Type: application/json'

Ein Zugriffstoken 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 Instanz des Telemetry Router befindet	eu01
telemetryRouterId	Die ID Ihrer Instanz des Telemetry Router	d5b5cdcc-c155-4d66-82ef-4289db8e4557
accessTokenId	Die ID Ihres Zugriffstokens für die Instanz des Telemetry Router	988d3545-68fb-47f2-acd7-b3ea96036ba9

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]/access-tokens/[accessTokenId]' \
--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/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9)' \
--header 'Authorization: Bearer eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4' \
--header 'Content-Type: application/json'

Ein Zugriffstoken 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 Instanz des Telemetry Router befindet	eu01
telemetryRouterId	Die ID Ihrer Instanz des Telemetry Router	d5b5cdcc-c155-4d66-82ef-4289db8e4557
accessTokenId	Die ID Ihres Zugriffstokens für die Instanz des Telemetry Router	988d3545-68fb-47f2-acd7-b3ea96036ba9
displayName	Ein Name für die Instanz des Telemetry Router. Bei diesem Endpunkt ist der Parameter optional.	my-telemetry-router
description	Eine optionale Beschreibung für Ihre Unterlagen	Meine Instanz des Telemetry Router

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]/access-tokens/[accessTokenId]' \
--header 'Authorization: Bearer [accessToken]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "displayName": [name],
    "description": [description]
}'

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/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9)' \
--header 'Authorization: Bearer eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4' \
--header 'Content-Type: application/json' \
--data-raw '{
    "displayName": 'my-new-access-token-name',
    "description": 'Meine neue Beschreibung für das Zugriffstoken'
}'

Ein Zugriffstoken löschen

STACKIT API

Um eine Instanz des Telemetry Router 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 Instanz des Telemetry Router befindet	eu01
telemetryRouterId	Die ID Ihrer Instanz des Telemetry Router	d5b5cdcc-c155-4d66-82ef-4289db8e4557
accessTokenId	Die ID Ihres Zugriffstokens für die Instanz des Telemetry Router	988d3545-68fb-47f2-acd7-b3ea96036ba9

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]/access-tokens/[accessTokenId]' \
--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/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9](https://telemetry-router.api.eu01.stackit.cloud/v1beta/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9)' \
--header 'Authorization: Bearer eyJhbGci0iJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi0iIxMjM0NTY30DkwIiwibmFtZSI6IkpvaG4gRG91IiwiaXNTb2NpYWwiOnRydWV9.4pcPyMD09o1PSyXnrXCjTwXyr4BsezdI1AVTmud2fU4' \
--header 'Content-Type: application/json' \