SSH-Schlüssel generieren

Generiert ein neues SSH-Schlüsselpaar auf einem VPS. Der öffentliche Schlüssel wird in der Antwort zurückgegeben. Optional kann der Schlüssel für den Web-Terminal-Zugang gespeichert werden.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter	Typ	Beschreibung
`id`	string	Die VPS-ID

Header

Header	Erforderlich	Wert
`Authorization`	Ja	`Bearer DEIN_API_SCHLÜSSEL`
`Content-Type`	Ja	`application/json`

Body

Feld	Typ	Erforderlich	Beschreibung
`action`	string	Ja	Muss `"generate"` sein
`displayName`	string	Nein	Anzeigename für den Schlüssel
`useForWebTerminal`	boolean	Nein	Schlüssel für Web-Terminal-Zugang speichern (Standard: false)

Antwort

{
  "data": {
    "keyId": "abc123",
    "displayName": "mein-schlüssel",
    "publicKey": "ssh-ed25519 AAAAC3NzaC1...",
    "webTerminalKeyId": "abc123"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`keyId`	string	Eindeutiger Bezeichner des generierten Schlüssels
`displayName`	string	Anzeigename des Schlüssels
`publicKey`	string	Der generierte öffentliche Schlüssel im OpenSSH-Format
`webTerminalKeyId`	string \| null	Die Schlüssel-ID, falls für das Web-Terminal gespeichert, sonst null

Fehler

Status	Code	Beschreibung
400	`INVALID_ACTION`	action muss "generate" oder "upload" sein
404	`NOT_FOUND`	VPS nicht gefunden oder kein Zugriff
502	`PROVIDER_ERROR`	Schlüsselgenerierung beim Provider fehlgeschlagen

Beispiel

curl -X POST "https://hosting.site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/ssh/keys" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "displayName": "mein-schlüssel", "useForWebTerminal": true}'

MCP

Diese Aktion ist auch über das MCP-Tool generate_ssh_key verfügbar.