SSH Public-Key hochladen

POST /vm/:vmid/sshkey/upload

URL Variablen

Name Beschreibung
vmid Identifier der VM (fünfstellige Zahl)

Body Parameter (application/x-www-form-urlencoded)

Name Format Beschreibung Optional
public_key String URL-Encoded Public SSH-Key —
displayname String Beschreibung zum SSH-Key: - Maximal 48 Zeichen - Erlaubt sind: Buchstaben (a-z, A-Z), Umlaute (ä, ö, ü, Ä, Ö, Ü), Scharf-s (ß), Leerzeichen, Bindestriche, Unterstriche, Pluszeichen, Rautezeichen, Klammern, Punke, Doppelpunkte

Response (application/json) 

{4 Eigenschaften
  "status": "success",
  "requestID": "0362e053-1bdd-4b17-badf-d33b595a423c",
  "message": "SSH key successfully uploaded",
  "data": {3 Eigenschaften
    "key_id": "b8bf5ef3-b53d-4f74-b1d1-ca7d18ff23b1",
    "displayname": "Beschreibung hier",
    "ssh_key": {1 Eigenschaft
      "public": "ssh-ed25519%20AAAAC3NzaC1lZDI1NTE5AAAAIC5rvS%2FZj9IlvWp8RbSA%2BNVQcegcOz9Btaufi4mjnjcK%20Generated%20By%20Termiu%2019455331%0A"
    }
  }
}
{5 Eigenschaften
  "status": "error",
  "type": "invalid_parameters",
  "requestID": "079472f5-e603-4c0a-84aa-48c093ef97c6",
  "message": "Your public key is not a valid SSH key and cannot be saved",
  "data": {1 Eigenschaft
    "invalid_parameters": {1 Eigenschaft
      "public_key": "INVALID"
    }
  }
}

cURL

curl -X POST 'https://live.fireapi.de/vm/:vmid/sshkey/upload' \
  -H 'X-FIRE-APIKEY: YOUR-API-KEY' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'public_key=VALUE&displayname=VALUE'