Erstellen und Verwalten von Token für AI Model Experiments
Zuletzt aktualisiert am
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“Bevor Sie ein Token erstellen, stellen Sie sicher, dass Ihre Umgebung die folgenden Voraussetzungen erfüllt:
- Sie haben ein STACKIT Kundenkonto: Kundenkonto erstellen
- Sie haben ein STACKIT Benutzerkonto: Benutzerkonto erstellen
- Sie haben ein STACKIT Projekt: Projekte erstellen
- Sie haben eine STACKIT AI Model Experiments-Instanz: Erstellen und Verwalten von AI Model Experiments-Instanzen
Token verstehen
Abschnitt betitelt „Token verstehen“Um mit einer AI Model Experiments-Instanz über das MLflow™-Python-SDK oder die REST-API zu interagieren, müssen Sie zunächst ein Zugriffstoken generieren. Diese Token bieten eine sichere Authentifizierungsmethode für die Verbindung Ihrer lokalen Entwicklungsumgebungen oder CI/CD-Pipelines mit dem Server. Bitte beachten Sie, dass jedes Token instanzspezifisch ist und nicht für den Zugriff auf mehrere Instanzen verwendet werden kann.
Token erstellen
Abschnitt betitelt „Token erstellen“- Klicken Sie in der Seitenleiste auf AI Model Experiments.
- Klicken Sie auf die Instanz, für die Sie ein Auth-Token erstellen möchten.
- Wählen Sie links Tracking-Tokens aus.
- Klicken Sie in der oberen Leiste auf Tracking-Token erstellen.
- Geben Sie einen Token-Namen und optional eine Beschreibung sowie eine Lebensdauer ein.
- Klicken Sie auf Speichern.
- Kopieren Sie das generierte Token an einen sicheren Ort.
Um ein Token über die API zu erhalten, benötigen Sie ein Auth-Token für Ihren Benutzer oder für Ihr Servicekonto. Um dieses vom Auth-Token für die AI Model Experiments-API zu unterscheiden, nennen wir es STACKIT Auth-Token. Die folgende Tabelle gibt Ihnen einen vollständigen Überblick über alle Parameter:
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| stackit-auth-token | Auth-Token für Benutzer oder Servicekonto | BZasjkdasbu… |
| project-id | Die ID Ihres Projekts | 89783241-32… |
| region-id | Die ID der Region | eu01 |
| instance-id | Die ID Ihrer Instanz | 12345678-12… |
| token-description | Beschreibung des Verwendungszwecks des Tokens | My token |
| token-name | Name des Tokens | my-token |
| token-lifetime | Gewünschte Token-Lebensdauer | 30d |
curl -X POST [https://model-experiments.api.stackit.cloud/v1alpha/projects/](https://model-experiments.api.stackit.cloud/v1alpha/projects/)[project-id]/regions/[region-id]/instances/[instance-id]/tokens \--header "Authorization: Bearer [stackit-auth-token]" \--header "Content-Type: application/json" \--data '{"description": "[token-description]", "name": "[token-name]", "ttlDuration": "[token-lifetime]"}'Token auflisten
Abschnitt betitelt „Token auflisten“- Klicken Sie in der Seitenleiste auf AI Model Experiments.
- Klicken Sie auf die Instanz, für die Sie die Auth-Token auflisten möchten.
- Wählen Sie links Tracking-Tokens aus, um eine Liste aller mit der Instanz verknüpften Auth-Token zu sehen.
- Klicken Sie auf ein Token, um dessen Detailbereich anzuzeigen.
Um eine Liste aller verfügbaren Token zu erhalten, führen Sie den folgenden API-Aufruf aus:
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| stackit-auth-token | Auth-Token für Benutzer oder Servicekonto | BZasjkdasbu… |
| project-id | Die ID Ihres Projekts | 89783241-32… |
| region-id | Die ID der Region | eu01 |
| instance-id | Die ID Ihrer Instanz | 12345678-12… |
curl -X GET [https://model-experiments.api.stackit.cloud/v1alpha/projects/](https://model-experiments.api.stackit.cloud/v1alpha/projects/)[project-id]/regions/[region-id]/instances/[instance-id]/tokens \--header "Authorization: Bearer [stackit-auth-token]"Token aktualisieren
Abschnitt betitelt „Token aktualisieren“- Klicken Sie in der Seitenleiste auf AI Model Experiments.
- Klicken Sie auf die Instanz, für die Sie das Auth-Token aktualisieren möchten.
- Wählen Sie links Tracking tokens aus, um eine Liste aller mit der Instanz verknüpften Auth-Token zu sehen.
- Klicken Sie auf ein Token, um dessen Detailbereich anzuzeigen.
- Ändern Sie den gewünschten Eintrag.
- Klicken Sie auf Speichern, um das Token zu aktualisieren.
Um die Beschreibung oder den Namen eines Tokens zu ändern, verwenden Sie den folgenden API-Aufruf. Im gezeigten Beispiel wird die Beschreibung eines Tokens aktualisiert.
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| stackit-auth-token | Auth-Token für Benutzer oder Servicekonto | BZasjkdasbu… |
| project-id | Die ID Ihres Projekts | 89783241-32… |
| region-id | Die ID der Region | eu01 |
| instance-id | Die ID Ihrer Instanz | 12345678-12… |
| token-id | Die ID Ihres Tokens | 12341234-21… |
| token-description | Beschreibung des Verwendungszwecks des Tokens | My token |
curl -X PATCH [https://model-experiments.api.stackit.cloud/v1alpha/projects/](https://model-experiments.api.stackit.cloud/v1alpha/projects/)[project-id]/regions/[region-id]/instances/[instance-id]/tokens/[token-id] \--header "Authorization: Bearer [stackit-auth-token]" \--header "Content-Type: application/json" \--data '{"description": "[token-description]"}'Token löschen
Abschnitt betitelt „Token löschen“- Klicken Sie in der Seitenleiste auf AI Model Experiments.
- Klicken Sie auf die Instanz, für die Sie das Auth-Token löschen möchten.
- Wählen Sie links Tracking-Token aus, um eine Liste aller mit der Instanz verknüpften Auth-Token zu sehen.
- Klicken Sie auf die Drei-Punkte-Schaltfläche des Tokens und dann auf Löschen, um den Löschbereich zu öffnen.
- Geben Sie den Namen des Tokens ein und klicken Sie auf Löschen, um das Token endgültig zu löschen.
Um ein Token zu löschen, verwenden Sie den folgenden API-Aufruf:
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| stackit-auth-token | Auth-Token für Benutzer oder Servicekonto | BZasjkdasbu… |
| project-id | Die ID Ihres Projekts | 89783241-32… |
| region-id | Die ID der Region | eu01 |
| instance-id | Die ID Ihrer Instanz | 12345678-12… |
| token-id | Die ID Ihres Tokens | 12341234-21… |
curl -X DELETE [https://model-experiments.api.stackit.cloud/v1alpha/projects/](https://model-experiments.api.stackit.cloud/v1alpha/projects/)[project-id]/regions/[region-id]/instances/[instance-id]/tokens/[token-id] \--header "Authorization: Bearer [stackit-auth-token]"