3 POST /service/{serviceid}/provisioning
Thomas Brinkmann edited this page 2 years ago

POST /service/{serviceid}/provisioning

Inhalt


  • Parameter
  • Optionale Parameter
  • Beispiel Anfrage
  • Beispiel Antwort
  • Mögliche Fehlermeldungen

Parameter

URL Parameter Typ Beschreibung
serviceid integer Beschreibt die ID des Services
Body Parameter Typ Beschreibung
templateid integer Die ID des Templates das geladen werden soll für die Neuinstallation
rootpass string Das Root Password welches für das System gesetzt wird

Für die KVM SERVER ändert sich der Parameter templateid zu template

Body Parameter Typ Beschreibung
template string Der Name des Templates welches verwendet werden soll
rootpass string Das Root Password welches für das System gesetzt wird

Optionale Parameter

Query-String Parameter Typ Beschreibung
- - -

Beispiel Anfrage

PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.dsh.gg/api/v2/service/12345/provisioning',
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "template": "Debian10-64Bit", // templateid for Dedicated Server, Win VPS/Rootservers, Storage VPS
  "rootpass": "1qQertzuiopas!d" 
  }',
  CURLOPT_HTTPHEADER => array(
    'X-TOKEN: test-token',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
cURL
curl --location --request POST 'https://api.dsh.gg/api/v2/service/12345/provisioning' \
--header 'X-TOKEN: test-token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "template": "Debian10-64Bit", // templateid for Dedicated Server, Win VPS/Rootservers, Storage VPS
    "rootpass": "1qQertzuiopas!d" 
}'

Beispiel Antwort

{
    "status": "OK"
}

Mögliche Fehlermeldungen

Status Code 403 - Permission denied

Status Code 400 - Error, installation could not be queued. Is another installation already queued?

Status Code 400 - Password Weak. At least 12 characters, at least one uppercase character, at least one number and at least one special character!

Status Code 400 - Server is already provisioning please wait.

Status Code 400 - Template not found

Status Code 500 - This action is not available for this service!