Hetzner - DokuWiki

Robot Webservice
Zeile 1: Zeile 1:
 +
{{Languages|Robot_Webservice}}
 +
 
= Allgemein  =
 
= Allgemein  =
  
 
== Allgemeines  ==
 
== Allgemeines  ==
  
Die Schnittstelle setzt auf dem HTTP-Protokoll auf und kann somit mit jeder beliebigen HTTP-Library benutzt werden. Als einfacher Client für die Kommandozeile kann zum Beispiel [http://curl.haxx.se/ curl] verwendet werden.
+
Die Schnittstelle setzt auf dem HTTP-Protokoll auf und kann somit mit jeder beliebigen HTTP-Library benutzt werden. Als einfacher Client für die Kommandozeile kann zum Beispiel [http://curl.haxx.se/ curl] verwendet werden.  
  
Grundsätzlich gilt:
+
Grundsätzlich gilt:  
  
*POST-Parameter werden im Format "application/x-www-form-urlencoded" übergeben
+
*POST-Parameter werden im Format "application/x-www-form-urlencoded" übergeben  
*Das Rückgabeformat ist [http://json.org JSON], durch Anhängen von ".yaml" wird das Format auf [http://yaml.org/spec/1.1 YAML] gesetzt
+
*Das Rückgabeformat ist [http://json.org JSON], durch Anhängen von ".yaml" wird das Format auf [http://yaml.org/spec/1.1 YAML] gesetzt  
*Wenn die Abfrage erfolgreich war, wird der HTTP-Status-Code 200 OK zurückgeliefert. Wenn eine neue Ressource erstellt wurde, wird der HTTP-Status-Code 201 CREATED zurückgegeben.
+
*Wenn die Abfrage erfolgreich war, wird der HTTP-Status-Code 200 OK zurückgeliefert. Wenn eine neue Ressource erstellt wurde, wird der HTTP-Status-Code 201 CREATED zurückgegeben.  
*Im Fehlerfall wird der entsprechende HTTP-Error-Code gesetzt
+
*Im Fehlerfall wird der entsprechende HTTP-Error-Code gesetzt  
*Die Authentifizierung erfolgt über HTTP-Basic-Auth
+
*Die Authentifizierung erfolgt über HTTP-Basic-Auth  
*Die Schnittstelle ist nur über HTTPS erreichbar
+
*Die Schnittstelle ist nur über HTTPS erreichbar  
 
*Für den Webservice kann ein eigener Benutzer angelegt werden, sie finden diese Option im Robot unter dem Menüpunkt "Einstellungen"
 
*Für den Webservice kann ein eigener Benutzer angelegt werden, sie finden diese Option im Robot unter dem Menüpunkt "Einstellungen"
  
 
==== URL  ====
 
==== URL  ====
<pre>https://robot-ws.your-server.de</pre>
+
<pre>https://robot-ws.your-server.de</pre>  
 
==== Beispiel JSON  ====
 
==== Beispiel JSON  ====
 
<pre>curl -u login:password https://robot-ws.your-server.de/reset
 
<pre>curl -u login:password https://robot-ws.your-server.de/reset
</pre>
+
</pre>  
'''Ausgabe'''
+
'''Ausgabe'''  
 
<pre>[
 
<pre>[
 
   {
 
   {
Zeile 30: Zeile 32:
 
   }
 
   }
 
]
 
]
</pre>
+
</pre>  
 
==== Beispiel YAML  ====
 
==== Beispiel YAML  ====
 
<pre>curl -u login:password https://robot-ws.your-server.de/reset.yaml
 
<pre>curl -u login:password https://robot-ws.your-server.de/reset.yaml
</pre>
+
</pre>  
'''Ausgabe'''
+
'''Ausgabe'''  
 
<pre>-
 
<pre>-
 
   reset: { server_ip: 123.123.123.123, type: [man, hw, sw] }
 
   reset: { server_ip: 123.123.123.123, type: [man, hw, sw] }
</pre>
+
</pre>  
 
== Fehler  ==
 
== Fehler  ==
  
Zeile 44: Zeile 46:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| error (Object)
+
| error (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| status (Integer)
+
| status (Integer)  
 
| HTTP Status Code
 
| HTTP Status Code
 
|-
 
|-
| code (String)
+
| code (String)  
 
| Spezifischer Error-Code
 
| Spezifischer Error-Code
 
|-
 
|-
| message (String)
+
| message (String)  
 
| Spezifische Fehlermeldung
 
| Spezifische Fehlermeldung
 
|}
 
|}
Zeile 60: Zeile 62:
 
|}
 
|}
  
'''Beispiel:'''
+
'''Beispiel:'''  
 
<pre>{
 
<pre>{
 
   "error":
 
   "error":
Zeile 69: Zeile 71:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
==== Fehler-Format bei falschen Eingabeparametern  ====
 
==== Fehler-Format bei falschen Eingabeparametern  ====
  
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| error (Object)
+
| error (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| status (Integer)
+
| status (Integer)  
 
| 400
 
| 400
 
|-
 
|-
| code (String)
+
| code (String)  
 
| INVALID_INPUT
 
| INVALID_INPUT
 
|-
 
|-
| message (String)
+
| message (String)  
 
| invalid input
 
| invalid input
 
|-
 
|-
| missing (Array)
+
| missing (Array)  
 
| Array der fehlenden Eingabeparameter oder null
 
| Array der fehlenden Eingabeparameter oder null
 
|-
 
|-
| invalid (Array)
+
| invalid (Array)  
 
| Array der fehlerhaften Eingabeparameter oder null
 
| Array der fehlerhaften Eingabeparameter oder null
 
|}
 
|}
Zeile 98: Zeile 100:
 
==== Authentifizierungsfehler  ====
 
==== Authentifizierungsfehler  ====
  
Bei falschem Login/Passwort wird der Status 401 - Unauthorized zurückgeliefert.
+
Bei falschem Login/Passwort wird der Status 401 - Unauthorized zurückgeliefert.  
  
 
==== Limitierung  ====
 
==== Limitierung  ====
  
Wenn das Request-Limit erreicht wurde, wird der Status 403 - Forbidden gesetzt.
+
Wenn das Request-Limit erreicht wurde, wird der Status 403 - Forbidden gesetzt.  
  
 
==== Nichterreichbarkeit aufgrund von Wartungsarbeiten  ====
 
==== Nichterreichbarkeit aufgrund von Wartungsarbeiten  ====
  
Wenn die Schnittstelle aufgrund von Wartungsarbeiten nicht erreichbar ist wird der Status 503 - Service Unavailable gesetzt.
+
Wenn die Schnittstelle aufgrund von Wartungsarbeiten nicht erreichbar ist wird der Status 503 - Service Unavailable gesetzt.  
  
__TOC__
+
__TOC__  
  
 
= Server  =
 
= Server  =
Zeile 116: Zeile 118:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abragen aller Server
+
Abragen aller Server  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 169: Zeile 171:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Es konnten keine Server gefunden werden
 
| Es konnten keine Server gefunden werden
 
|}
 
|}
Zeile 180: Zeile 182:
 
==== Beispiel  ====
 
==== Beispiel  ====
 
<pre>curl -u login:password https://robot-ws.your-server.de/server</pre> <pre>[
 
<pre>curl -u login:password https://robot-ws.your-server.de/server</pre> <pre>[
 +
 
   {
 
   {
    "server": {
+
  "server": {
      "server_ip": "123.123.123.123",
+
    "server_ip": "123.123.123.123",
      "server_name": "Server1",
+
    "server_name": "Server1",
      "product": "DS 3000",
+
    "product": "DS 3000",
      "dc": "6",
+
    "dc": "6",
      "traffic": "5 TB",
+
    "traffic": "5 TB",
      "flaterate": true,
+
    "flaterate": true,
      "status": "ready",
+
    "status": "ready",
      "throttled": true,
+
    "throttled": true,
      "cancelled": false,
+
    "cancelled": false,
      "paid_until": "2010-09-02"
+
    "paid_until": "2010-09-02"
    }
+
  }
  },
+
},
  {
+
{
    "server": {
+
  "server": {
      "server_ip": "123.123.123.124",
+
    "server_ip": "123.123.123.124",
      "server_name": "Server2",
+
    "server_name": "Server2",
      "product": "X5",
+
    "product": "X5",
      "dc": "5",
+
    "dc": "5",
      "traffic": "2 TB",
+
    "traffic": "2 TB",
      "flaterate": true,
+
    "flaterate": true,
      "status": "ready",
+
    "status": "ready",
      "throttled": false,
+
    "throttled": false,
      "cancelled": false,
+
    "cancelled": false,
      "paid_until": "2010-06-11"
+
    "paid_until": "2010-06-11"
    }
+
  }
  }
+
}
 +
 
 +
 
 
]
 
]
</pre>
 
  
 +
 +
</pre>
 
== GET /server/&lt;server-ip&gt;  ==
 
== GET /server/&lt;server-ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Server-Daten für einen bestimmten Server
+
Abfragen der Server-Daten für einen bestimmten Server  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 289: Zeile 295:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server konnte nicht gefunden werden
 
| Der Server konnte nicht gefunden werden
 
|}
 
|}
Zeile 300: Zeile 306:
 
==== Beispiel  ====
 
==== Beispiel  ====
 
<pre>curl -u login:password https://robot-ws.your-server.de/server/123.123.123.123</pre> <pre>{
 
<pre>curl -u login:password https://robot-ws.your-server.de/server/123.123.123.123</pre> <pre>{
 +
 
   "server": {
 
   "server": {
    "server_ip":" 123.132.123.123",
+
  "server_ip":" 123.132.123.123",
    "server_name": "Server1",
+
  "server_name": "Server1",
    "product": "EQ 8",
+
  "product": "EQ 8",
    "dc": "11",
+
  "dc": "11",
    "traffic": "5 TB",
+
  "traffic": "5 TB",
    "flatrate": true,
+
  "flatrate": true,
    "status": "ready",
+
  "status": "ready",
    "throttled": false,
+
  "throttled": false,
    "cancelled": false,
+
  "cancelled": false,
    "paid_until": "2010-08-04",
+
  "paid_until": "2010-08-04",
    "ip": ["124.124.124.124"],
+
  "ip": ["124.124.124.124"],
    "subnet": [{"ip": "2a01:4f8:111:4221::", "mask": "64"}],
+
  "subnet": [{"ip": "2a01:4f8:111:4221::", "mask": "64"}],
    "reset": true,
+
  "reset": true,
    "rescue": true,
+
  "rescue": true,
    "vnc": true,
+
  "vnc": true,
    "windows": true,
+
  "windows": true,
    "plesk": true,
+
  "plesk": true,
    "cpanel": true,
+
  "cpanel": true,
    "wol": true
+
  "wol": true
  }
+
}
 +
 
 +
 
 
}
 
}
</pre>
 
  
 +
 +
</pre>
 
== POST /server/&lt;server-ip&gt;  ==
 
== POST /server/&lt;server-ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Anpassen des Servernamens für einen bestimmten Server
+
Anpassen des Servernamens für einen bestimmten Server  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 334: Zeile 344:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| server_name
+
| server_name  
 
| Name des Servers
 
| Name des Servers
 
|}
 
|}
Zeile 362: Zeile 372:
 
|-
 
|-
 
| flatrate (Boolean)  
 
| flatrate (Boolean)  
| Zeigt an, ob Server eine Traffic-Flatrate hat (keine Bezahlung bei Traffic-Überschreitung, sondern Drosselung) oder nicht (Bezahlung bei Traffic-Überschreitung)  
+
| Zeigt an, ob Server eine Traffic-Flatrate hat (keine Bezahlung bei Traffic-Überschreitung, sondern Drosselung) oder nicht (Bezahlung bei Traffic-Überschreitung)
 
|-
 
|-
 
| status (String)  
 
| status (String)  
Zeile 410: Zeile 420:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server konnte nicht gefunden werden
 
| Der Server konnte nicht gefunden werden
 
|}
 
|}
Zeile 421: Zeile 431:
 
==== Beispiel  ====
 
==== Beispiel  ====
 
<pre>curl -u login:password https://robot-ws.your-server.de/server/123.123.123.123 -d server_name=Server1</pre> <pre>{
 
<pre>curl -u login:password https://robot-ws.your-server.de/server/123.123.123.123 -d server_name=Server1</pre> <pre>{
 +
 
   "server": {
 
   "server": {
    "server_ip":" 123.132.123.123",
+
  "server_ip":" 123.132.123.123",
    "server_name": "Server1",
+
  "server_name": "Server1",
    "product": "EQ 8",
+
  "product": "EQ 8",
    "dc": "11",
+
  "dc": "11",
    "traffic": "5 TB",
+
  "traffic": "5 TB",
    "flatrate": true,
+
  "flatrate": true,
    "status": "ready",
+
  "status": "ready",
    "throttled": false,
+
  "throttled": false,
    "cancelled": false,
+
  "cancelled": false,
    "paid_until": "2010-08-04",
+
  "paid_until": "2010-08-04",
    "ip": ["124.124.124.124"],
+
  "ip": ["124.124.124.124"],
    "subnet": [{"ip": "2a01:4f8:111:4221::", "mask": "64"}],
+
  "subnet": [{"ip": "2a01:4f8:111:4221::", "mask": "64"}],
    "reset": true,
+
  "reset": true,
    "rescue": true,
+
  "rescue": true,
    "vnc": true,
+
  "vnc": true,
    "windows": true,
+
  "windows": true,
    "plesk": true,
+
  "plesk": true,
    "cpanel": true,
+
  "cpanel": true,
    "wol": true
+
  "wol": true
  }
+
}
 +
 
 +
 
 
}
 
}
</pre>
 
  
 +
 +
</pre>
 
= IP  =
 
= IP  =
  
Zeile 451: Zeile 465:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen aller Einzel-IPs
+
Abfragen aller Einzel-IPs  
  
 
==== Eingabe (optional)  ====
 
==== Eingabe (optional)  ====
Zeile 457: Zeile 471:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| server_ip
+
| server_ip  
 
| Server Haupt-IP. Bei Angabe werden nur Ips angezeigt, die diesem Server zugeordnet sind
 
| Server Haupt-IP. Bei Angabe werden nur Ips angezeigt, die diesem Server zugeordnet sind
 
|}
 
|}
Zeile 465: Zeile 479:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| (Array)
+
| (Array)  
|
+
|  
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| ip (Object)
+
| ip (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| IP-Adresse
 
| IP-Adresse
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| locked (Boolean)
+
| locked (Boolean)  
 
| Zeigt an, ob die IP gesperrt ist
 
| Zeigt an, ob die IP gesperrt ist
 
|-
 
|-
| traffic_warnings (Boolean)
+
| traffic_warnings (Boolean)  
 
| Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
 
| Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
 
|-
 
|-
| traffic_hourly (Integer)
+
| traffic_hourly (Integer)  
 
| Stündliches Trafficlimit in MB
 
| Stündliches Trafficlimit in MB
 
|-
 
|-
| traffic_daily (Integer)
+
| traffic_daily (Integer)  
 
| Tägliches Trafficlimit in MB
 
| Tägliches Trafficlimit in MB
 
|-
 
|-
| traffic_monthly (Integer)
+
| traffic_monthly (Integer)  
 
| Monatliches Trafficlimit in MB
 
| Monatliches Trafficlimit in MB
 
|}
 
|}
Zeile 503: Zeile 517:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Keine Einzel-Ips gefunden
 
| Keine Einzel-Ips gefunden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/ip</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/ip</pre> <pre>[
<pre>[
+
 
   {
 
   {
 
     "ip": {
 
     "ip": {
Zeile 538: Zeile 551:
 
   }
 
   }
 
]
 
]
</pre>
+
</pre>  
 
== GET /ip/&lt;ip&gt;  ==
 
== GET /ip/&lt;ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Daten für eine bestimme IP
+
Abfragen der Daten für eine bestimme IP  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 549: Zeile 562:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| ip (Object)
+
| ip (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| IP-Adresse
 
| IP-Adresse
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| locked (Boolean)
+
| locked (Boolean)  
 
| Zeigt an, ob die IP gesperrt ist
 
| Zeigt an, ob die IP gesperrt ist
 
|-
 
|-
| traffic_warnings (Boolean)
+
| traffic_warnings (Boolean)  
 
| Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
 
| Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
 
|-
 
|-
| traffic_hourly (Integer)
+
| traffic_hourly (Integer)  
 
| Stündliches Trafficlimit in MB
 
| Stündliches Trafficlimit in MB
 
|-
 
|-
| traffic_daily (Integer)
+
| traffic_daily (Integer)  
 
| Tägliches Trafficlimit in MB
 
| Tägliches Trafficlimit in MB
 
|-
 
|-
| traffic_monthly (Integer)
+
| traffic_monthly (Integer)  
 
| Monatliches Trafficlimit in MB
 
| Monatliches Trafficlimit in MB
 
|}
 
|}
Zeile 581: Zeile 594:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| IP_NOT_FOUND
+
| IP_NOT_FOUND  
 
| Die IP-Adresse konnte nicht gefunden werden
 
| Die IP-Adresse konnte nicht gefunden werden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/ip/123.123.123.123</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/ip/123.123.123.123</pre> <pre>{
<pre>{
+
 
   "ip": {
 
   "ip": {
 
     "ip":"123.123.123.123",
 
     "ip":"123.123.123.123",
Zeile 603: Zeile 615:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== POST /ip/&lt;ip&gt;  ==
 
== POST /ip/&lt;ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Anpassen der Traffic-Warnungen eines IP
+
Anpassen der Traffic-Warnungen eines IP  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 614: Zeile 626:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| traffic_warnings
+
| traffic_warnings  
 
| Aktivieren/Deaktiveren der Traffic-Warnungen (true,false)
 
| Aktivieren/Deaktiveren der Traffic-Warnungen (true,false)
 
|-
 
|-
| traffic_hourly
+
| traffic_hourly  
 
| Stündliches Trafficlimit in MB
 
| Stündliches Trafficlimit in MB
 
|-
 
|-
| traffic_daily
+
| traffic_daily  
 
| Tägliches Trafficlimit in MB
 
| Tägliches Trafficlimit in MB
 
|-
 
|-
| traffic_monthly
+
| traffic_monthly  
 
| Monatliches Trafficlimit in GB
 
| Monatliches Trafficlimit in GB
 
|}
 
|}
Zeile 631: Zeile 643:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| ip (Object)
+
| ip (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| IP-Adresse
 
| IP-Adresse
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| locked (Boolean)
+
| locked (Boolean)  
 
| Zeigt an, ob die IP gesperrt ist
 
| Zeigt an, ob die IP gesperrt ist
 
|-
 
|-
| traffic_warnings (Boolean)
+
| traffic_warnings (Boolean)  
 
| Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
 
| Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
 
|-
 
|-
| traffic_hourly (Integer)
+
| traffic_hourly (Integer)  
 
| Stündliches Trafficlimit in MB
 
| Stündliches Trafficlimit in MB
 
|-
 
|-
| traffic_daily (Integer)
+
| traffic_daily (Integer)  
 
| Tägliches Trafficlimit in MB
 
| Tägliches Trafficlimit in MB
 
|-
 
|-
| traffic_monthly (Integer)
+
| traffic_monthly (Integer)  
 
| Monatliches Trafficlimit in MB
 
| Monatliches Trafficlimit in MB
 
|}
 
|}
Zeile 663: Zeile 675:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| IP_NOT_FOUND
+
| IP_NOT_FOUND  
 
| Die IP-Adresse konnte nicht gefunden werden
 
| Die IP-Adresse konnte nicht gefunden werden
 
|-
 
|-
| 500
+
| 500  
| TRAFFIC_WARNING_UPDATE_FAILED
+
| TRAFFIC_WARNING_UPDATE_FAILED  
 
| Die Einstellungen konnten wegen eines internen Fehlers nicht vorgenommen werden
 
| Die Einstellungen konnten wegen eines internen Fehlers nicht vorgenommen werden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/ip/123.123.123.123 -d traffic_warnings=true</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/ip/123.123.123.123 -d traffic_warnings=true</pre> <pre>{
<pre>{
+
 
   "ip": {
 
   "ip": {
 
     "ip":"123.123.123.123",
 
     "ip":"123.123.123.123",
Zeile 693: Zeile 704:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
= Subnet  =
 
= Subnet  =
  
Zeile 700: Zeile 711:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen aller Subnetze
+
Abfragen aller Subnetze  
  
 
==== Eingabe (optional)  ====
 
==== Eingabe (optional)  ====
Zeile 706: Zeile 717:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| server_ip
+
| server_ip  
 
| Server Haupt-IP. Bei Angabe werden nur Subnetze angezeigt, die diesem Server zugeordnet sind
 
| Server Haupt-IP. Bei Angabe werden nur Subnetze angezeigt, die diesem Server zugeordnet sind
 
|}
 
|}
Zeile 714: Zeile 725:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| (Array)
+
| (Array)  
|
+
|  
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| subnet (Object)
+
| subnet (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| Netz-Adresse
 
| Netz-Adresse
 
|-
 
|-
| mask (Integer)
+
| mask (Integer)  
 
| Netzwerkmaske in CIDR Notation
 
| Netzwerkmaske in CIDR Notation
 
|-
 
|-
| gateway (String)
+
| gateway (String)  
 
| Gateway des Subnetzes
 
| Gateway des Subnetzes
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| failover (Boolean)
+
| failover (Boolean)  
 
| True, wenn das Netz ein Failover-Netz ist
 
| True, wenn das Netz ein Failover-Netz ist
 
|-
 
|-
| locked (Boolean)
+
| locked (Boolean)  
 
| Zeigt an, ob das Netz gesperrt ist
 
| Zeigt an, ob das Netz gesperrt ist
 
|-
 
|-
| traffic_warnings (Boolean)
+
| traffic_warnings (Boolean)  
 
| Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
 
| Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
 
|-
 
|-
| traffic_hourly (Integer)
+
| traffic_hourly (Integer)  
 
| Stündliches Trafficlimit in MB
 
| Stündliches Trafficlimit in MB
 
|-
 
|-
| traffic_daily (Integer)
+
| traffic_daily (Integer)  
 
| Tägliches Trafficlimit in MB
 
| Tägliches Trafficlimit in MB
 
|-
 
|-
| traffic_monthly (Integer)
+
| traffic_monthly (Integer)  
 
| Monatliches Trafficlimit in GB
 
| Monatliches Trafficlimit in GB
 
|}
 
|}
Zeile 761: Zeile 772:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Es wurden keine Subnetze gefunden
 
| Es wurden keine Subnetze gefunden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/subnet</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/subnet</pre> <pre>[
<pre>[
+
 
   {
 
   {
 
     "subnet": {
 
     "subnet": {
Zeile 802: Zeile 812:
 
   }
 
   }
 
]
 
]
</pre>
+
</pre>  
 
== GET /subnet/&lt;net-ip&gt;  ==
 
== GET /subnet/&lt;net-ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Daten für ein bestimmtes Subnetz
+
Abfragen der Daten für ein bestimmtes Subnetz  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 813: Zeile 823:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| subnet (Object)
+
| subnet (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| Netz-Adresse
 
| Netz-Adresse
 
|-
 
|-
| mask (Integer)
+
| mask (Integer)  
 
| Netzwerkmaske in CIDR Notation
 
| Netzwerkmaske in CIDR Notation
 
|-
 
|-
| gateway (String)
+
| gateway (String)  
 
| Gateway des Subnetzes
 
| Gateway des Subnetzes
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| failover (Boolean)
+
| failover (Boolean)  
 
| True, wenn das Netz ein Failover-Netz ist
 
| True, wenn das Netz ein Failover-Netz ist
 
|-
 
|-
| locked (Boolean)
+
| locked (Boolean)  
 
| Zeigt an, ob das Netz gesperrt ist
 
| Zeigt an, ob das Netz gesperrt ist
 
|-
 
|-
| traffic_warnings (Boolean)
+
| traffic_warnings (Boolean)  
 
| Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
 
| Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
 
|-
 
|-
| traffic_hourly (Integer)
+
| traffic_hourly (Integer)  
 
| Stündliches Trafficlimit in MB
 
| Stündliches Trafficlimit in MB
 
|-
 
|-
| traffic_daily (Integer)
+
| traffic_daily (Integer)  
 
| Tägliches Trafficlimit in MB
 
| Tägliches Trafficlimit in MB
 
|-
 
|-
| traffic_monthly (Integer)
+
| traffic_monthly (Integer)  
 
| Monatliches Trafficlimit in GB
 
| Monatliches Trafficlimit in GB
 
|}
 
|}
Zeile 854: Zeile 864:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SUBNET_NOT_FOUND
+
| SUBNET_NOT_FOUND  
 
| Das Subnetz konnte nicht gefunden werden
 
| Das Subnetz konnte nicht gefunden werden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/subnet/123.123.123.123</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/subnet/123.123.123.123</pre> <pre>{
<pre>{
+
 
   "subnet": {
 
   "subnet": {
 
     "ip": "123.123.123.123",
 
     "ip": "123.123.123.123",
Zeile 879: Zeile 888:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== POST /subnet/&lt;net-ip&gt;  ==
 
== POST /subnet/&lt;net-ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Anpassen der Traffic-Warnungen eines Subnetzes
+
Anpassen der Traffic-Warnungen eines Subnetzes  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 890: Zeile 899:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| traffic_warnings
+
| traffic_warnings  
 
| Aktivieren/Deaktiveren der Traffic-Warnungen (true,false)
 
| Aktivieren/Deaktiveren der Traffic-Warnungen (true,false)
 
|-
 
|-
| traffic_hourly
+
| traffic_hourly  
 
| Stündliches Trafficlimit in MB
 
| Stündliches Trafficlimit in MB
 
|-
 
|-
| traffic_daily
+
| traffic_daily  
 
| Tägliches Trafficlimit in MB
 
| Tägliches Trafficlimit in MB
 
|-
 
|-
| traffic_monthly
+
| traffic_monthly  
 
| Monatliches Trafficlimit in GB
 
| Monatliches Trafficlimit in GB
 
|}
 
|}
Zeile 907: Zeile 916:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| subnet (Object)
+
| subnet (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| Netz-Adresse
 
| Netz-Adresse
 
|-
 
|-
| mask (Integer)
+
| mask (Integer)  
 
| Netzwerkmaske in CIDR Notation
 
| Netzwerkmaske in CIDR Notation
 
|-
 
|-
| gateway (String)
+
| gateway (String)  
 
| Gateway des Subnetzes
 
| Gateway des Subnetzes
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| failover (Boolean)
+
| failover (Boolean)  
 
| True, wenn das Netz ein Failover-Netz ist
 
| True, wenn das Netz ein Failover-Netz ist
 
|-
 
|-
| locked (Boolean)
+
| locked (Boolean)  
 
| Zeigt an, ob das Netz gesperrt ist
 
| Zeigt an, ob das Netz gesperrt ist
 
|-
 
|-
| traffic_warnings (Boolean)
+
| traffic_warnings (Boolean)  
 
| Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
 
| Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
 
|-
 
|-
| traffic_hourly (Integer)
+
| traffic_hourly (Integer)  
 
| Stündliches Trafficlimit in MB
 
| Stündliches Trafficlimit in MB
 
|-
 
|-
| traffic_daily (Integer)
+
| traffic_daily (Integer)  
 
| Tägliches Trafficlimit in MB
 
| Tägliches Trafficlimit in MB
 
|-
 
|-
| traffic_monthly (Integer)
+
| traffic_monthly (Integer)  
 
| Monatliches Trafficlimit in GB
 
| Monatliches Trafficlimit in GB
 
|}
 
|}
Zeile 948: Zeile 957:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| SUBNET_NOT_FOUND
+
| SUBNET_NOT_FOUND  
 
| Das Subnetz konnte nicht gefunden werden
 
| Das Subnetz konnte nicht gefunden werden
 
|-
 
|-
| 500
+
| 500  
| TRAFFIC_WARNING_UPDATE_FAILED
+
| TRAFFIC_WARNING_UPDATE_FAILED  
 
| Die Einstellungen konnten wegen eines internen Fehlers nicht vorgenommen werden
 
| Die Einstellungen konnten wegen eines internen Fehlers nicht vorgenommen werden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/subnet/123.123.123.123 -d traffic_warnings=true</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/subnet/123.123.123.123 -d traffic_warnings=true</pre> <pre>{
<pre>{
+
 
   "subnet": {
 
   "subnet": {
 
     "ip": "123.123.123.123",
 
     "ip": "123.123.123.123",
Zeile 981: Zeile 989:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
<br>
+
<br>  
  
 
= Reset  =
 
= Reset  =
Zeile 990: Zeile 998:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Reset-Optionen für alle Server
+
Abfragen der Reset-Optionen für alle Server  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 996: Zeile 1.004:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| (Array)
+
| (Array)  
|
+
|  
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| reset (Object)
+
| reset (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| type (Array)
+
| type (Array)  
 
| Mögliche Reset-Optionen
 
| Mögliche Reset-Optionen
 
|}
 
|}
Zeile 1.019: Zeile 1.027:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Keine Server mit Reset-Option gefunden
 
| Keine Server mit Reset-Option gefunden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/reset</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/reset</pre> <pre>[
<pre>[
+
 
   {
 
   {
 
     "reset":
 
     "reset":
Zeile 1.046: Zeile 1.053:
 
   }
 
   }
 
]
 
]
</pre>
+
</pre>  
 
== GET /reset/&lt;server-ip&gt;  ==
 
== GET /reset/&lt;server-ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Reset-Optionen für einen bestimmten Server
+
Abfragen der Reset-Optionen für einen bestimmten Server  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.057: Zeile 1.064:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| reset (Object)
+
| reset (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| type (Array)
+
| type (Array)  
 
| Mögliche Reset-Optionen
 
| Mögliche Reset-Optionen
 
|}
 
|}
Zeile 1.074: Zeile 1.081:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| RESET_NOT_AVAILABLE
+
| RESET_NOT_AVAILABLE  
 
| Dieser Server hat keine Reset-Option
 
| Dieser Server hat keine Reset-Option
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/reset/123.123.123.123</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/reset/123.123.123.123</pre> <pre>{
<pre>{
+
 
   "reset":
 
   "reset":
 
   {
 
   {
Zeile 1.096: Zeile 1.102:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== POST /reset/&lt;server-ip&gt;  ==
 
== POST /reset/&lt;server-ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Ausführen eines Reset für einen bestimmten Server
+
Ausführen eines Reset für einen bestimmten Server  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 1.107: Zeile 1.113:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| type
+
| type  
 
| Reset-Typ der ausgeführt werden soll
 
| Reset-Typ der ausgeführt werden soll
 
|}
 
|}
Zeile 1.115: Zeile 1.121:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| reset (Object)
+
| reset (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| type (String)
+
| type (String)  
 
| Ausgeführte Reset-Option
 
| Ausgeführte Reset-Option
 
|}
 
|}
Zeile 1.132: Zeile 1.138:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| RESET_NOT_AVAILABLE
+
| RESET_NOT_AVAILABLE  
 
| Der Server hat keine Reset-Option
 
| Der Server hat keine Reset-Option
 
|-
 
|-
| 409
+
| 409  
| RESET_MANUAL_ACTIVE
+
| RESET_MANUAL_ACTIVE  
 
| Es läuft bereits ein manueller Reset
 
| Es läuft bereits ein manueller Reset
 
|-
 
|-
| 500
+
| 500  
| RESET_FAILED
+
| RESET_FAILED  
 
| Der Reset konnte wegen eines internen Fehlers nicht durchgeführt werden
 
| Der Reset konnte wegen eines internen Fehlers nicht durchgeführt werden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/reset/123.123.123.123 -d type=hw</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/reset/123.123.123.123 -d type=hw</pre> <pre>{
<pre>{
+
 
   "reset":
 
   "reset":
 
   {
 
   {
Zeile 1.166: Zeile 1.171:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
= Failover  =
 
= Failover  =
  
WICHTIG: Für die reibungslose Nutzung der Failover-IP muß diese auf allen Servern konfiguriert sein, unabhängig davon, ob sie aktuell darauf geroutet wird.
+
WICHTIG: Für die reibungslose Nutzung der Failover-IP muß diese auf allen Servern konfiguriert sein, unabhängig davon, ob sie aktuell darauf geroutet wird.  
  
 
== GET /failover  ==
 
== GET /failover  ==
Zeile 1.175: Zeile 1.180:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Failover-Daten aller Server
+
Abfragen der Failover-Daten aller Server  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.181: Zeile 1.186:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| (Array)
+
| (Array)  
|
+
|  
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| failover (Object)
+
| failover (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| Failover Netz-Adresse
 
| Failover Netz-Adresse
 
|-
 
|-
| netmask (String)
+
| netmask (String)  
 
| Failover Netzmaske
 
| Failover Netzmaske
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| active_server_ip (String)
+
| active_server_ip (String)  
 
| Haupt-IP des Servers, auf den das Netz zur Zeit geroutet wird
 
| Haupt-IP des Servers, auf den das Netz zur Zeit geroutet wird
 
|}
 
|}
Zeile 1.210: Zeile 1.215:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Es konnten keine Failover-IPs gefunden werden
 
| Es konnten keine Failover-IPs gefunden werden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/failover</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/failover</pre> <pre>[
<pre>[
+
 
   {
 
   {
 
     "failover":
 
     "failover":
Zeile 1.232: Zeile 1.236:
 
   }
 
   }
 
]
 
]
</pre>
+
</pre>  
 
== GET /failover/&lt;failover-ip&gt;  ==
 
== GET /failover/&lt;failover-ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Failover-Daten für eine bestimmte Failover-IP
+
Abfragen der Failover-Daten für eine bestimmte Failover-IP  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.243: Zeile 1.247:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| failover (Object)
+
| failover (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| Failover Netz-Adresse
 
| Failover Netz-Adresse
 
|-
 
|-
| netmask (String)
+
| netmask (String)  
 
| Failover Netzmaske
 
| Failover Netzmaske
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| active_server_ip (String)
+
| active_server_ip (String)  
 
| Haupt-IP des Servers, auf den das Netz zur Zeit geroutet wird
 
| Haupt-IP des Servers, auf den das Netz zur Zeit geroutet wird
 
|}
 
|}
Zeile 1.266: Zeile 1.270:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Die Failover-IP konnte nicht gefunden werden
 
| Die Failover-IP konnte nicht gefunden werden
 
|}
 
|}
Zeile 1.277: Zeile 1.281:
 
==== Beispiel  ====
 
==== Beispiel  ====
 
<pre>curl -u login:password https://robot-ws.your-server.de/failover/123.123.123.123</pre> <pre>{
 
<pre>curl -u login:password https://robot-ws.your-server.de/failover/123.123.123.123</pre> <pre>{
 +
 
   "failover":
 
   "failover":
  {
+
{
    "ip": "123.123.123.123",
+
  "ip": "123.123.123.123",
    "netmask": "255.255.255.255",
+
  "netmask": "255.255.255.255",
    "server_ip": "78.46.1.93",
+
  "server_ip": "78.46.1.93",
    "active_server_ip": "78.46.1.93"
+
  "active_server_ip": "78.46.1.93"
  }
+
}
 +
 
 +
 
 
}
 
}
</pre>
+
 
 +
 
 +
</pre>  
 
== POST /failover/&lt;failover-ip&gt;  ==
 
== POST /failover/&lt;failover-ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Umrouten der Failover-IP
+
Umrouten der Failover-IP  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 1.296: Zeile 1.305:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| active_server_ip
+
| active_server_ip  
 
| Haupt-IP des Server, auf den die Failover-IP geroutet werden soll
 
| Haupt-IP des Server, auf den die Failover-IP geroutet werden soll
 
|}
 
|}
Zeile 1.304: Zeile 1.313:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| failover (Object)
+
| failover (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| Failover Netz-Adresse
 
| Failover Netz-Adresse
 
|-
 
|-
| netmask (String)
+
| netmask (String)  
 
| Failover Netzmaske
 
| Failover Netzmaske
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des zugehörigen Servers
 
| Haupt-IP des zugehörigen Servers
 
|-
 
|-
| active_server_ip (String)
+
| active_server_ip (String)  
 
| Haupt-IP des Servers, auf den das Netz aktuell geroutet wird
 
| Haupt-IP des Servers, auf den das Netz aktuell geroutet wird
 
|}
 
|}
Zeile 1.327: Zeile 1.336:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Die Failover-IP konnte nicht gefunden werden
 
| Die Failover-IP konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| FAILOVER_NEW_SERVER_NOT_FOUND
+
| FAILOVER_NEW_SERVER_NOT_FOUND  
 
| Der Server, auf den das Netz geroutet werden soll, konnte nicht gefunden werden
 
| Der Server, auf den das Netz geroutet werden soll, konnte nicht gefunden werden
 
|-
 
|-
| 409
+
| 409  
| FAILOVER_ALREADY_ROUTED
+
| FAILOVER_ALREADY_ROUTED  
 
| Die Failover-IP ist bereits auf den ausgewählten Server geroutet
 
| Die Failover-IP ist bereits auf den ausgewählten Server geroutet
 
|-
 
|-
| 409
+
| 409  
| FAILOVER_LOCKED
+
| FAILOVER_LOCKED  
 
| Das Umrouten der Failover-IP ist gesperrt, da bereits eine Anfrage bearbeitet wird
 
| Das Umrouten der Failover-IP ist gesperrt, da bereits eine Anfrage bearbeitet wird
 
|-
 
|-
| 500
+
| 500  
| FAILOVER_FAILED
+
| FAILOVER_FAILED  
 
| Aufgrund eines internen Fehlers konnte die Failover-IP nicht um-geroutet werden
 
| Aufgrund eines internen Fehlers konnte die Failover-IP nicht um-geroutet werden
 
|-
 
|-
| 500
+
| 500  
| FAILOVER_NOT_COMPLETE
+
| FAILOVER_NOT_COMPLETE  
 
| Aufgrund eines internen Fehlers konnte die Failover-IP nicht um-geroutet werden
 
| Aufgrund eines internen Fehlers konnte die Failover-IP nicht um-geroutet werden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/failover/123.123.123.123 -d active_server_ip=124.124.124.124</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/failover/123.123.123.123 -d active_server_ip=124.124.124.124</pre> <pre>{
<pre>{
+
 
   "failover":
 
   "failover":
 
   {
 
   {
Zeile 1.371: Zeile 1.379:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
= Wake on LAN  =
 
= Wake on LAN  =
  
Zeile 1.378: Zeile 1.386:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der WOL-Daten eines Servers
+
Abfragen der WOL-Daten eines Servers  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.384: Zeile 1.392:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| wol (Object)
+
| wol (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|}
 
|}
Zeile 1.398: Zeile 1.406:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server konnte nicht gefunden werden
 
| Der Server konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| WOL_NOT_AVAILABLE
+
| WOL_NOT_AVAILABLE  
 
| Wake On LAN ist bei diesem Server nicht verfügbar
 
| Wake On LAN ist bei diesem Server nicht verfügbar
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/wol/123.123.123.123</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/wol/123.123.123.123</pre> <pre>{
<pre>{
+
 
   "wol":
 
   "wol":
 
   {
 
   {
Zeile 1.419: Zeile 1.426:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
<br>
+
<br>  
  
 
== POST /wol/&lt;server-ip&gt;  ==
 
== POST /wol/&lt;server-ip&gt;  ==
Zeile 1.426: Zeile 1.433:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Versenden des WOL-Pakets an einen Server
+
Versenden des WOL-Pakets an einen Server  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.432: Zeile 1.439:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| wol (Object)
+
| wol (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|}
 
|}
Zeile 1.446: Zeile 1.453:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server konnte nicht gefunden werden
 
| Der Server konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| WOL_NOT_AVAILABLE
+
| WOL_NOT_AVAILABLE  
 
| Wake On LAN ist bei diesem Server nicht verfügbar
 
| Wake On LAN ist bei diesem Server nicht verfügbar
 
|-
 
|-
| 500
+
| 500  
| WOL_FAILED
+
| WOL_FAILED  
 
| Das senden des WOL-Pakets konnte aufgrund eines internen Fehlers nicht ausgeführt werden
 
| Das senden des WOL-Pakets konnte aufgrund eines internen Fehlers nicht ausgeführt werden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/wol/123.123.123.123 -d foo</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/wol/123.123.123.123 -d foo</pre> <pre>{
<pre>{
+
 
   "wol":
 
   "wol":
 
   {
 
   {
Zeile 1.471: Zeile 1.477:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
= Boot-Konfiguration  =
 
= Boot-Konfiguration  =
  
Zeile 1.478: Zeile 1.484:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Boot-Konfiguration für einen Server. Es kann pro Server nur eine Konfiguration aktiv sein.
+
Abfragen der Boot-Konfiguration für einen Server. Es kann pro Server nur eine Konfiguration aktiv sein.  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.484: Zeile 1.490:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| boot (Object)
+
| boot (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| rescue (Object)
+
| rescue (Object)  
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Frescue]]
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Frescue]]
 
|-
 
|-
| linux (Object)
+
| linux (Object)  
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Flinux]]
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Flinux]]
 
|-
 
|-
| vnc (Object)
+
| vnc (Object)  
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Fvnc]]
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Fvnc]]
 
|-
 
|-
| windows (Object)
+
| windows (Object)  
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Fwindows]]
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Fwindows]]
 
|-
 
|-
| plesk (Object)
+
| plesk (Object)  
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Fplesk]]
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Fplesk]]
 
|-
 
|-
| cpanel (Object)
+
| cpanel (Object)  
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Fcpanel]]
 
| siehe [[#GET_.2Fboot.2F.3Cserver-ip.3E.2Fcpanel]]
 
|}
 
|}
Zeile 1.513: Zeile 1.519:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123</pre> <pre>{
<pre>{
+
 
   "boot": {
 
   "boot": {
 
     "rescue": {
 
     "rescue": {
Zeile 1.553: Zeile 1.558:
 
     }
 
     }
 
   }
 
   }
}</pre>
+
}</pre>  
 
== GET /boot/&lt;server-ip&gt;/rescue  ==
 
== GET /boot/&lt;server-ip&gt;/rescue  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Boot-Optionen für das Rescue-System
+
Abfragen der Boot-Optionen für das Rescue-System  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.564: Zeile 1.569:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| rescue (Object)
+
| rescue (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| os (Array&#124;String)
+
| os (Array&#124;String)  
 
| Array der verfügbaren Betriebssysteme oder das aktive Betriebssystem
 
| Array der verfügbaren Betriebssysteme oder das aktive Betriebssystem
 
|-
 
|-
| arch (Array&#124; Integer)
+
| arch (Array&#124; Integer)  
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| Status des Rescue-Systems
 
| Status des Rescue-Systems
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Aktuelles Passwort oder null
 
| Aktuelles Passwort oder null
 
|}
 
|}
Zeile 1.590: Zeile 1.595:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue</pre> <pre>{
<pre>{
+
 
   "rescue": {
 
   "rescue": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 1.613: Zeile 1.617:
 
     "password": null
 
     "password": null
 
   }
 
   }
}</pre>
+
}</pre>  
 
== POST /boot/&lt;server-ip&gt;/rescue  ==
 
== POST /boot/&lt;server-ip&gt;/rescue  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Aktivieren des Rescue-Systens
+
Aktivieren des Rescue-Systens  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 1.624: Zeile 1.628:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| os
+
| os  
 
| Betriebssystem
 
| Betriebssystem
 
|-
 
|-
| arch
+
| arch  
 
| Architektur
 
| Architektur
 
|}
 
|}
Zeile 1.635: Zeile 1.639:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| rescue (Object)
+
| rescue (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| os (String)
+
| os (String)  
 
| Betriebssystem
 
| Betriebssystem
 
|-
 
|-
| arch (Integer)
+
| arch (Integer)  
 
| Architektur
 
| Architektur
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| true
 
| true
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort
 
| Passwort
 
|}
 
|}
Zeile 1.661: Zeile 1.665:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 409
+
| 409  
| BOOT_ALREADY_ENABLED
+
| BOOT_ALREADY_ENABLED  
 
| Das Rescue-System ist bereits aktiviert
 
| Das Rescue-System ist bereits aktiviert
 
|-
 
|-
| 409
+
| 409  
| BOOT_BLOCKED
+
| BOOT_BLOCKED  
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Linux, VNC, Windows, cPanel oder Plesk)
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Linux, VNC, Windows, cPanel oder Plesk)
 
|-
 
|-
| 500
+
| 500  
| BOOT_ACTIVATION_FAILED
+
| BOOT_ACTIVATION_FAILED  
 
| Das aktivieren des Rescue-Systems ist aufgrund eines internen Fehlers fehlgeschlagen
 
| Das aktivieren des Rescue-Systems ist aufgrund eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue -d 'os=linux&amp;arch=32'</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue -d 'os=linux&amp;arch=32'</pre> <pre>{
<pre>{
+
 
   "rescue": {
 
   "rescue": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 1.700: Zeile 1.703:
 
     "password": "u7Ng5j43"
 
     "password": "u7Ng5j43"
 
   }
 
   }
}</pre>
+
}</pre>  
 
== DELETE /boot/&lt;server-ip&gt;/rescue  ==
 
== DELETE /boot/&lt;server-ip&gt;/rescue  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Deaktivieren des Rescue-Systems
+
Deaktivieren des Rescue-Systems  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.711: Zeile 1.714:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| rescue (Object)
+
| rescue (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| os (Array)
+
| os (Array)  
 
| Array der verfügbaren Betriebssysteme
 
| Array der verfügbaren Betriebssysteme
 
|-
 
|-
| arch (Array)
+
| arch (Array)  
 
| Array der verfügbaren Architekturen
 
| Array der verfügbaren Architekturen
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| false
 
| false
 
|-
 
|-
| password (String)
+
| password (String)  
 
| null
 
| null
 
|}
 
|}
Zeile 1.737: Zeile 1.740:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 500
+
| 500  
| BOOT_DEACTIVATION_FAILED
+
| BOOT_DEACTIVATION_FAILED  
 
| Das Deaktivieren des Rescue-Systems ist aufgrund eines internen Fehlers fehlgeschlagen
 
| Das Deaktivieren des Rescue-Systems ist aufgrund eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue -X DELETE</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue -X DELETE</pre> <pre>{
<pre>{
+
 
   "rescue": {
 
   "rescue": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 1.764: Zeile 1.766:
 
     "password": null
 
     "password": null
 
   }
 
   }
}</pre>
+
}</pre>  
 
== GET /boot/&lt;server-ip&gt;/linux  ==
 
== GET /boot/&lt;server-ip&gt;/linux  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfrage der Boot-Optionen für die Linux-Installation
+
Abfrage der Boot-Optionen für die Linux-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.775: Zeile 1.777:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| linux (Object)
+
| linux (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (Array&#124;String)
+
| dist (Array&#124;String)  
 
| Array der verfügbaren Distributionen oder die aktive Distribution
 
| Array der verfügbaren Distributionen oder die aktive Distribution
 
|-
 
|-
| arch (Array&#124; Integer)
+
| arch (Array&#124; Integer)  
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
|-
 
|-
| lang (Array&#124; String)
+
| lang (Array&#124; String)  
 
| Array der verfügbaren Sprachen oder die aktive Sprache
 
| Array der verfügbaren Sprachen oder die aktive Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| Status der Linux-Installation
 
| Status der Linux-Installation
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort der Linux-Installtion oder null
 
| Passwort der Linux-Installtion oder null
 
|}
 
|}
Zeile 1.804: Zeile 1.806:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux</pre> <pre>{
<pre>{
+
 
   "linux": {
 
   "linux": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 1.828: Zeile 1.829:
 
     "password": null
 
     "password": null
 
   }
 
   }
}</pre>
+
}</pre>  
 
== POST /boot/&lt;server-ip&gt;/linux  ==
 
== POST /boot/&lt;server-ip&gt;/linux  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Aktivieren der Linux-Installation
+
Aktivieren der Linux-Installation  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 1.839: Zeile 1.840:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| dist
+
| dist  
 
| Distribution
 
| Distribution
 
|-
 
|-
| arch
+
| arch  
 
| Architektur
 
| Architektur
 
|-
 
|-
| lang
+
| lang  
 
| Sprache
 
| Sprache
 
|}
 
|}
Zeile 1.853: Zeile 1.854:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| linux (Object)
+
| linux (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (String)
+
| dist (String)  
 
| Distribution
 
| Distribution
 
|-
 
|-
| arch (Integer)
+
| arch (Integer)  
 
| Architektur
 
| Architektur
 
|-
 
|-
| lang (String)
+
| lang (String)  
 
| Sprache
 
| Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| true
 
| true
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort Linux-Installation
 
| Passwort Linux-Installation
 
|}
 
|}
Zeile 1.882: Zeile 1.883:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 409
+
| 409  
| BOOT_ALREADY_ENABLED
+
| BOOT_ALREADY_ENABLED  
 
| Die Linux-Installtion ist bereits aktiviert
 
| Die Linux-Installtion ist bereits aktiviert
 
|-
 
|-
| 409
+
| 409  
| BOOT_BLOCKED
+
| BOOT_BLOCKED  
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, VNC, Windows, cPanel oder Plesk)
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, VNC, Windows, cPanel oder Plesk)
 
|-
 
|-
| 500
+
| 500  
| BOOT_ACTIVATION_FAILED
+
| BOOT_ACTIVATION_FAILED  
 
| Das Aktiveren der Linux-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Aktiveren der Linux-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux -d 'dist=CentOS 5.5 minimal&amp;arch=32&amp;lang=en'</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux -d 'dist=CentOS 5.5 minimal&amp;arch=32&amp;lang=en'</pre> <pre>{
<pre>{
+
 
   "linux": {
 
   "linux": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 1.922: Zeile 1.922:
 
     "password": "u7Ng5j43"
 
     "password": "u7Ng5j43"
 
   }
 
   }
}</pre>
+
}</pre>  
 
== DELETE /boot/&lt;server-ip&gt;/linux  ==
 
== DELETE /boot/&lt;server-ip&gt;/linux  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Deaktivieren der Linux-Installation
+
Deaktivieren der Linux-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 1.933: Zeile 1.933:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| linux (Object)
+
| linux (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| os (Array)
+
| os (Array)  
 
| Array der verfügbaren Distributionen
 
| Array der verfügbaren Distributionen
 
|-
 
|-
| arch (Array)
+
| arch (Array)  
 
| Array der verfügbaren Architekturen
 
| Array der verfügbaren Architekturen
 
|-
 
|-
| lang (Array)
+
| lang (Array)  
 
| Array der verfügbaren Sprachen
 
| Array der verfügbaren Sprachen
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| false
 
| false
 
|-
 
|-
| password (String)
+
| password (String)  
 
| null
 
| null
 
|}
 
|}
Zeile 1.962: Zeile 1.962:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 500
+
| 500  
| BOOT_DEACTIVATION_FAILED
+
| BOOT_DEACTIVATION_FAILED  
 
| Das Deaktivieren der Linux-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Deaktivieren der Linux-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux -X DELETE</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux -X DELETE</pre> <pre>{
<pre>{
+
 
   "linux": {
 
   "linux": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 1.990: Zeile 1.989:
 
     "password": null
 
     "password": null
 
   }
 
   }
}</pre>
+
}</pre>  
 
== GET /boot/&lt;server-ip&gt;/vnc  ==
 
== GET /boot/&lt;server-ip&gt;/vnc  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfrage der Boot-Optionen für die VNC-Installation
+
Abfrage der Boot-Optionen für die VNC-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 2.001: Zeile 2.000:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| vnc (Object)
+
| vnc (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (Array&#124;String)
+
| dist (Array&#124;String)  
 
| Array der verfügbaren Distributionen oder die aktive Distribution
 
| Array der verfügbaren Distributionen oder die aktive Distribution
 
|-
 
|-
| arch (Array&#124; Integer)
+
| arch (Array&#124; Integer)  
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
|-
 
|-
| lang (Array&#124; String)
+
| lang (Array&#124; String)  
 
| Array der verfügbaren Sprachen oder die aktive Sprache
 
| Array der verfügbaren Sprachen oder die aktive Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| Status der VNC-Installation
 
| Status der VNC-Installation
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort der VNC-Installtion oder null
 
| Passwort der VNC-Installtion oder null
 
|}
 
|}
Zeile 2.030: Zeile 2.029:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc</pre> <pre>{
<pre>{
+
 
   "vnc": {
 
   "vnc": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.054: Zeile 2.052:
 
     "password": null
 
     "password": null
 
   }
 
   }
}</pre>
+
}</pre>  
 
== POST /boot/&lt;server-ip&gt;/vnc  ==
 
== POST /boot/&lt;server-ip&gt;/vnc  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Aktivieren der VNC-Installation
+
Aktivieren der VNC-Installation  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 2.065: Zeile 2.063:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| dist
+
| dist  
 
| Distribution
 
| Distribution
 
|-
 
|-
| arch
+
| arch  
 
| Architektur
 
| Architektur
 
|-
 
|-
| lang
+
| lang  
 
| Sprache
 
| Sprache
 
|}
 
|}
Zeile 2.079: Zeile 2.077:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| vnc (Object)
+
| vnc (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (String)
+
| dist (String)  
 
| Distribution
 
| Distribution
 
|-
 
|-
| arch (Integer)
+
| arch (Integer)  
 
| Architektur
 
| Architektur
 
|-
 
|-
| lang (String)
+
| lang (String)  
 
| Sprache
 
| Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| true
 
| true
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort VNC-Installation
 
| Passwort VNC-Installation
 
|}
 
|}
Zeile 2.108: Zeile 2.106:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 409
+
| 409  
| BOOT_ALREADY_ENABLED
+
| BOOT_ALREADY_ENABLED  
 
| Die VNC-Installtion ist bereits aktiviert
 
| Die VNC-Installtion ist bereits aktiviert
 
|-
 
|-
| 409
+
| 409  
| BOOT_BLOCKED
+
| BOOT_BLOCKED  
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, Windows, cPanel oder Plesk)
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, Windows, cPanel oder Plesk)
 
|-
 
|-
| 500
+
| 500  
| BOOT_ACTIVATION_FAILED
+
| BOOT_ACTIVATION_FAILED  
 
| Das Aktiveren der VNC-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Aktiveren der VNC-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc -d 'dist=centOS-5.0&amp;arch=32&amp;lang=en_US'</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc -d 'dist=centOS-5.0&amp;arch=32&amp;lang=en_US'</pre> <pre>{
<pre>{
+
 
   "vnc": {
 
   "vnc": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.148: Zeile 2.145:
 
     "password": "u7Ng5j43"
 
     "password": "u7Ng5j43"
 
   }
 
   }
}</pre>
+
}</pre>  
 
== DELETE /boot/&lt;server-ip&gt;/vnc  ==
 
== DELETE /boot/&lt;server-ip&gt;/vnc  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Deaktivieren der VNC-Installation
+
Deaktivieren der VNC-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 2.159: Zeile 2.156:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| vnc (Object)
+
| vnc (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| os (Array)
+
| os (Array)  
 
| Array der verfügbaren Distributionen
 
| Array der verfügbaren Distributionen
 
|-
 
|-
| arch (Array)
+
| arch (Array)  
 
| Array der verfügbaren Architekturen
 
| Array der verfügbaren Architekturen
 
|-
 
|-
| lang (Array)
+
| lang (Array)  
 
| Array der verfügbaren Sprachen
 
| Array der verfügbaren Sprachen
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| false
 
| false
 
|-
 
|-
| password (String)
+
| password (String)  
 
| null
 
| null
 
|}
 
|}
Zeile 2.188: Zeile 2.185:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 500
+
| 500  
| BOOT_DEACTIVATION_FAILED
+
| BOOT_DEACTIVATION_FAILED  
 
| Das Deaktivieren der VNC-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Deaktivieren der VNC-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc -X DELETE</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc -X DELETE</pre> <pre>{
<pre>{
+
 
   "vnc": {
 
   "vnc": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.216: Zeile 2.212:
 
     "password": null
 
     "password": null
 
   }
 
   }
}</pre>
+
}</pre>  
 
== GET /boot/&lt;server-ip&gt;/windows  ==
 
== GET /boot/&lt;server-ip&gt;/windows  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Boot-Optionen für die Windows-Installation
+
Abfragen der Boot-Optionen für die Windows-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 2.227: Zeile 2.223:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| windows (Object)
+
| windows (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Server main ip
 
| Server main ip
 
|-
 
|-
| dist (Array&#124;String)
+
| dist (Array&#124;String)  
 
| Array of available windows distributions or the active distributon
 
| Array of available windows distributions or the active distributon
 
|-
 
|-
| arch (Array&#124; String)
+
| arch (Array&#124; String)  
 
| Array of available languages or the active language
 
| Array of available languages or the active language
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| Current windows installation status
 
| Current windows installation status
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Current windows installation password or null
 
| Current windows installation password or null
 
|}
 
|}
Zeile 2.253: Zeile 2.249:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows</pre> <pre>{
<pre>{
+
 
   "windows": {
 
   "windows": {
 
     "server_ip": "88.198.49.132",
 
     "server_ip": "88.198.49.132",
Zeile 2.276: Zeile 2.271:
 
     "password": null
 
     "password": null
 
   }
 
   }
}</pre>
+
}</pre>  
 
== POST /boot/&lt;server-ip&gt;/windows  ==
 
== POST /boot/&lt;server-ip&gt;/windows  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Aktivieren der Windows-Installation. Dies ist nur möglich, wenn für den Server das Windows-Addon gebucht wurde. Nach dem Neustart des Servers wird die automatische Windows-Installation gestartet. Alle Daten auf dem Server werden bei der Installation gelöscht.
+
Aktivieren der Windows-Installation. Dies ist nur möglich, wenn für den Server das Windows-Addon gebucht wurde. Nach dem Neustart des Servers wird die automatische Windows-Installation gestartet. Alle Daten auf dem Server werden bei der Installation gelöscht.  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 2.287: Zeile 2.282:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| lang
+
| lang  
 
| Sprache
 
| Sprache
 
|}
 
|}
Zeile 2.295: Zeile 2.290:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| windows (Object)
+
| windows (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (String)
+
| dist (String)  
 
| Distribution
 
| Distribution
 
|-
 
|-
| lang (String)
+
| lang (String)  
 
| Sprache
 
| Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| true
 
| true
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Windows installation password
 
| Windows installation password
 
|}
 
|}
Zeile 2.321: Zeile 2.316:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 404
+
| 404  
| WINDOWS_MISSING_ADDON
+
| WINDOWS_MISSING_ADDON  
 
| Das Windows-Addon fehlt
 
| Das Windows-Addon fehlt
 
|-
 
|-
| 409
+
| 409  
| BOOT_ALREADY_ENABLED
+
| BOOT_ALREADY_ENABLED  
 
| Die Windows-Installation ist für diesen Server bereits aktiv
 
| Die Windows-Installation ist für diesen Server bereits aktiv
 
|-
 
|-
| 409
+
| 409  
| BOOT_BLOCKED
+
| BOOT_BLOCKED  
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, cPanel oder Plesk)
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, cPanel oder Plesk)
 
|-
 
|-
| 500
+
| 500  
| BOOT_ACTIVATION_FAILED
+
| BOOT_ACTIVATION_FAILED  
 
| Das Aktivieren der Windows-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Aktivieren der Windows-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows -d 'lang=en'</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows -d 'lang=en'</pre> <pre>{
<pre>{
+
 
   "windows": {
 
   "windows": {
 
     "server_ip": "88.198.49.132",
 
     "server_ip": "88.198.49.132",
Zeile 2.364: Zeile 2.358:
 
     "password": "u7Ng5j43"
 
     "password": "u7Ng5j43"
 
   }
 
   }
}</pre>
+
}</pre>  
 
== DELETE /boot/&lt;server-ip&gt;/windows  ==
 
== DELETE /boot/&lt;server-ip&gt;/windows  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Deaktivieren der Windows-Installation
+
Deaktivieren der Windows-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 2.375: Zeile 2.369:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| windows (Object)
+
| windows (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Server main ip
 
| Server main ip
 
|-
 
|-
| os (Array)
+
| os (Array)  
 
| Array der verfügbaren Distributionen
 
| Array der verfügbaren Distributionen
 
|-
 
|-
| lang (Array)
+
| lang (Array)  
 
| Array der verfügbaren Sprachen
 
| Array der verfügbaren Sprachen
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| false
 
| false
 
|-
 
|-
| password (String)
+
| password (String)  
 
| null
 
| null
 
|}
 
|}
Zeile 2.401: Zeile 2.395:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 500
+
| 500  
| BOOT_DEACTIVATION_FAILED
+
| BOOT_DEACTIVATION_FAILED  
 
| Das Deaktivieren der Windows-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Deaktivieren der Windows-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows -X DELETE</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows -X DELETE</pre> <pre>{
<pre>{
+
 
   "windows": {
 
   "windows": {
 
     "server_ip": "88.198.49.132",
 
     "server_ip": "88.198.49.132",
Zeile 2.428: Zeile 2.421:
 
     "password": null
 
     "password": null
 
   }
 
   }
}</pre>
+
}</pre>  
 
== GET /boot/&lt;server-ip&gt;/plesk  ==
 
== GET /boot/&lt;server-ip&gt;/plesk  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Boot-Optionen für die Plesk-Installation
+
Abfragen der Boot-Optionen für die Plesk-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 2.439: Zeile 2.432:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| plesk (Object)
+
| plesk (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (Array&#124;String)
+
| dist (Array&#124;String)  
 
| Array der verfügbaren Distributionen oder die aktive Distribution
 
| Array der verfügbaren Distributionen oder die aktive Distribution
 
|-
 
|-
| arch (Array&#124; Integer)
+
| arch (Array&#124; Integer)  
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
|-
 
|-
| lang (Array&#124; String)
+
| lang (Array&#124; String)  
 
| Array der verfügbaren Sprachen oder die aktive Sprache
 
| Array der verfügbaren Sprachen oder die aktive Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| Status der Plesk-Installation
 
| Status der Plesk-Installation
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort der Plesk-Installation oder null
 
| Passwort der Plesk-Installation oder null
 
|-
 
|-
| hostname (String)
+
| hostname (String)  
 
| Hostname der Plesk-Installation oder null
 
| Hostname der Plesk-Installation oder null
 
|}
 
|}
Zeile 2.471: Zeile 2.464:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/plesk</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/plesk</pre> <pre>{
<pre>{
+
 
   "plesk": {
 
   "plesk": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.497: Zeile 2.489:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== POST /boot/&lt;server-ip&gt;/plesk  ==
 
== POST /boot/&lt;server-ip&gt;/plesk  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Aktivieren der Plesk-Installation
+
Aktivieren der Plesk-Installation  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 2.508: Zeile 2.500:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| dist
+
| dist  
 
| Distribution
 
| Distribution
 
|-
 
|-
| arch
+
| arch  
 
| Architektur
 
| Architektur
 
|-
 
|-
| lang
+
| lang  
 
| Sprache
 
| Sprache
 
|-
 
|-
| hostname
+
| hostname  
 
| Hostname
 
| Hostname
 
|}
 
|}
Zeile 2.525: Zeile 2.517:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| plesk (Object)
+
| plesk (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (String)
+
| dist (String)  
 
| Distribution
 
| Distribution
 
|-
 
|-
| arch (Integer)
+
| arch (Integer)  
 
| Architektur
 
| Architektur
 
|-
 
|-
| lang (String)
+
| lang (String)  
 
| Sprache
 
| Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| true
 
| true
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort der Plesk-Installation
 
| Passwort der Plesk-Installation
 
|-
 
|-
| hostname (String)
+
| hostname (String)  
 
| Hostname der Plesk-Installation
 
| Hostname der Plesk-Installation
 
|}
 
|}
Zeile 2.557: Zeile 2.549:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 404
+
| 404  
| PLESK_MISSING_ADDON
+
| PLESK_MISSING_ADDON  
 
| Das Plesk-Addon fehlt
 
| Das Plesk-Addon fehlt
 
|-
 
|-
| 409
+
| 409  
| BOOT_ALREADY_ENABLED
+
| BOOT_ALREADY_ENABLED  
 
| Die Plesk-Installtion ist bereits aktiviert
 
| Die Plesk-Installtion ist bereits aktiviert
 
|-
 
|-
| 409
+
| 409  
| BOOT_BLOCKED
+
| BOOT_BLOCKED  
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, cPanel oder Windows)
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, cPanel oder Windows)
 
|-
 
|-
| 500
+
| 500  
| BOOT_ACTIVATION_FAILED
+
| BOOT_ACTIVATION_FAILED  
 
| Das Aktiveren der Plesk-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Aktiveren der Plesk-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
Zeile 2.592: Zeile 2.584:
 
==== Beispiel  ====
 
==== Beispiel  ====
 
<pre>curl -u login:password https://robot-ws.your-server.de/boot.yaml/123.123.123.123/plesk -d 'dist=CentOS 5.4 minimal&amp;arch=32&amp;lang=de&amp;hostname=plesk.testen.de'
 
<pre>curl -u login:password https://robot-ws.your-server.de/boot.yaml/123.123.123.123/plesk -d 'dist=CentOS 5.4 minimal&amp;arch=32&amp;lang=de&amp;hostname=plesk.testen.de'
</pre>
+
</pre> <pre>{
<pre>{
+
 
   "plesk": {
 
   "plesk": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.604: Zeile 2.595:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== DELETE /boot/&lt;server-ip&gt;/plesk  ==
 
== DELETE /boot/&lt;server-ip&gt;/plesk  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Deaktivieren der Plesk-Installation
+
Deaktivieren der Plesk-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 2.615: Zeile 2.606:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| plesk (Object)
+
| plesk (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (Array&#124;String)
+
| dist (Array&#124;String)  
 
| Array der verfügbaren Distributionen
 
| Array der verfügbaren Distributionen
 
|-
 
|-
| arch (Array&#124; Integer)
+
| arch (Array&#124; Integer)  
 
| Array der verfügbaren Architekturen
 
| Array der verfügbaren Architekturen
 
|-
 
|-
| lang (Array&#124; String)
+
| lang (Array&#124; String)  
 
| Array der verfügbaren Sprachen
 
| Array der verfügbaren Sprachen
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| false
 
| false
 
|-
 
|-
| password (String)
+
| password (String)  
 
| null
 
| null
 
|-
 
|-
| hostname (String)
+
| hostname (String)  
 
| null
 
| null
 
|}
 
|}
Zeile 2.647: Zeile 2.638:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 500
+
| 500  
| BOOT_DEACTIVATION_FAILED
+
| BOOT_DEACTIVATION_FAILED  
 
| Das Deaktivieren der Plesk-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Deaktivieren der Plesk-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/plesk -X DELETE</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/plesk -X DELETE</pre> <pre>{
<pre>{
+
 
   "plesk": {
 
   "plesk": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.677: Zeile 2.667:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== GET /boot/&lt;server-ip&gt;/cpanel  ==
 
== GET /boot/&lt;server-ip&gt;/cpanel  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Boot-Optionen für die cPanel-Installation
+
Abfragen der Boot-Optionen für die cPanel-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 2.688: Zeile 2.678:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| cpanel (Object)
+
| cpanel (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (Array&#124;String)
+
| dist (Array&#124;String)  
 
| Array der verfügbaren Distributionen oder die aktive Distribution
 
| Array der verfügbaren Distributionen oder die aktive Distribution
 
|-
 
|-
| arch (Array&#124; Integer)
+
| arch (Array&#124; Integer)  
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
| Array der verfügbaren Architekturen oder die aktive Architektur
 
|-
 
|-
| lang (Array&#124; String)
+
| lang (Array&#124; String)  
 
| Array der verfügbaren Sprachen oder die aktive Sprache
 
| Array der verfügbaren Sprachen oder die aktive Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| Status der cPanel-Installation
 
| Status der cPanel-Installation
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort der cPanel-Installation oder null
 
| Passwort der cPanel-Installation oder null
 
|-
 
|-
| hostname (String)
+
| hostname (String)  
 
| Hostname der cPanel-Installation oder null
 
| Hostname der cPanel-Installation oder null
 
|}
 
|}
Zeile 2.720: Zeile 2.710:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/cpanel</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/cpanel</pre> <pre>{
<pre>{
+
 
   "cpanel": {
 
   "cpanel": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.746: Zeile 2.735:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== POST /boot/&lt;server-ip&gt;/cPanel  ==
 
== POST /boot/&lt;server-ip&gt;/cPanel  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Aktivieren der cPanel-Installation
+
Aktivieren der cPanel-Installation  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 2.757: Zeile 2.746:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| dist
+
| dist  
 
| Distribution
 
| Distribution
 
|-
 
|-
| arch
+
| arch  
 
| Architektur
 
| Architektur
 
|-
 
|-
| lang
+
| lang  
 
| Sprache
 
| Sprache
 
|-
 
|-
| hostname
+
| hostname  
 
| Hostname
 
| Hostname
 
|}
 
|}
Zeile 2.774: Zeile 2.763:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| cpanel (Object)
+
| cpanel (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (String)
+
| dist (String)  
 
| Distribution
 
| Distribution
 
|-
 
|-
| arch (Integer)
+
| arch (Integer)  
 
| Architektur
 
| Architektur
 
|-
 
|-
| lang (String)
+
| lang (String)  
 
| Sprache
 
| Sprache
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| true
 
| true
 
|-
 
|-
| password (String)
+
| password (String)  
 
| Passwort der cPanel-Installation
 
| Passwort der cPanel-Installation
 
|-
 
|-
| hostname (String)
+
| hostname (String)  
 
| Hostname der cPanel-Installation
 
| Hostname der cPanel-Installation
 
|}
 
|}
Zeile 2.806: Zeile 2.795:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 404
+
| 404  
| CPANEL_MISSING_ADDON
+
| CPANEL_MISSING_ADDON  
 
| Das cPanel-Addon fehlt
 
| Das cPanel-Addon fehlt
 
|-
 
|-
| 409
+
| 409  
| BOOT_ALREADY_ENABLED
+
| BOOT_ALREADY_ENABLED  
 
| Die cPanel-Installtion ist bereits aktiviert
 
| Die cPanel-Installtion ist bereits aktiviert
 
|-
 
|-
| 409
+
| 409  
| BOOT_BLOCKED
+
| BOOT_BLOCKED  
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, Plesk oder Windows)
 
| Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, Plesk oder Windows)
 
|-
 
|-
| 500
+
| 500  
| BOOT_ACTIVATION_FAILED
+
| BOOT_ACTIVATION_FAILED  
 
| Das Aktiveren der cPanel-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Aktiveren der cPanel-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
Zeile 2.841: Zeile 2.830:
 
==== Beispiel  ====
 
==== Beispiel  ====
 
<pre>curl -u login:password https://robot-ws.your-server.de/boot.yaml/123.123.123.123/cPanel -d 'dist=CentOS 5.6 + cPanel&amp;arch=64&amp;lang=en&amp;hostname=cpanel.testen.de'
 
<pre>curl -u login:password https://robot-ws.your-server.de/boot.yaml/123.123.123.123/cPanel -d 'dist=CentOS 5.6 + cPanel&amp;arch=64&amp;lang=en&amp;hostname=cpanel.testen.de'
</pre>
+
</pre> <pre>{
<pre>{
+
 
   "plesk": {
 
   "plesk": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.853: Zeile 2.841:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== DELETE /boot/&lt;server-ip&gt;/cpanel  ==
 
== DELETE /boot/&lt;server-ip&gt;/cpanel  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Deaktivieren der cPanel-Installation
+
Deaktivieren der cPanel-Installation  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 2.864: Zeile 2.852:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| cpanel (Object)
+
| cpanel (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| server_ip (String)
+
| server_ip (String)  
 
| Haupt-IP des Servers
 
| Haupt-IP des Servers
 
|-
 
|-
| dist (Array&#124;String)
+
| dist (Array&#124;String)  
 
| Array der verfügbaren Distributionen
 
| Array der verfügbaren Distributionen
 
|-
 
|-
| arch (Array&#124; Integer)
+
| arch (Array&#124; Integer)  
 
| Array der verfügbaren Architekturen
 
| Array der verfügbaren Architekturen
 
|-
 
|-
| lang (Array&#124; String)
+
| lang (Array&#124; String)  
 
| Array der verfügbaren Sprachen
 
| Array der verfügbaren Sprachen
 
|-
 
|-
| active (Boolean)
+
| active (Boolean)  
 
| false
 
| false
 
|-
 
|-
| password (String)
+
| password (String)  
 
| null
 
| null
 
|-
 
|-
| hostname (String)
+
| hostname (String)  
 
| null
 
| null
 
|}
 
|}
Zeile 2.896: Zeile 2.884:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| SERVER_NOT_FOUND
+
| SERVER_NOT_FOUND  
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
| Der Server mit der Haupt-IP &lt;server-ip&gt; konnte nicht gefunden werden
 
|-
 
|-
| 404
+
| 404  
| BOOT_NOT_AVAILABLE
+
| BOOT_NOT_AVAILABLE  
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
| Für diesen Server ist keine Boot-Konfiguration verfügbar
 
|-
 
|-
| 500
+
| 500  
| BOOT_DEACTIVATION_FAILED
+
| BOOT_DEACTIVATION_FAILED  
 
| Das Deaktivieren der cPanel-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
| Das Deaktivieren der cPanel-Installation ist wegen eines internen Fehlers fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/cpanel -X DELETE</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/cpanel -X DELETE</pre> <pre>{
<pre>{
+
 
   "cpanel": {
 
   "cpanel": {
 
     "server_ip": "123.123.123.123",
 
     "server_ip": "123.123.123.123",
Zeile 2.926: Zeile 2.913:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
= Reverse DNS  =
 
= Reverse DNS  =
  
Zeile 2.933: Zeile 2.920:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen aller gesetzten Reverse-DNS Einträge
+
Abfragen aller gesetzten Reverse-DNS Einträge  
  
 
==== Eingabe (optional)  ====
 
==== Eingabe (optional)  ====
Zeile 2.939: Zeile 2.926:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| server_ip
+
| server_ip  
 
| Server Haupt-IP. Bei Angabe werden nur Reverse-DNS Einträge angezeigt, die diesem Server zugeordnet sind
 
| Server Haupt-IP. Bei Angabe werden nur Reverse-DNS Einträge angezeigt, die diesem Server zugeordnet sind
 
|}
 
|}
Zeile 2.947: Zeile 2.934:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| (Array)
+
| (Array)  
|
+
|  
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| rdns (Object)
+
| rdns (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| IP-Adresse
 
| IP-Adresse
 
|-
 
|-
| ptr (String)
+
| ptr (String)  
 
| PTR Record
 
| PTR Record
 
|}
 
|}
Zeile 2.970: Zeile 2.957:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Es wurden keine Reverse-DNS Einträge gefunden
 
| Es wurden keine Reverse-DNS Einträge gefunden
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/rdns</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/rdns</pre> <pre>[
<pre>[
+
 
   {
 
   {
 
     "rdns": {
 
     "rdns": {
Zeile 2.995: Zeile 2.981:
 
   }
 
   }
 
]
 
]
</pre>
+
</pre>  
 
== GET /rdns/&lt;ip&gt;  ==
 
== GET /rdns/&lt;ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen des Reverse-DNS Eintrags für eine IP-Adresse.
+
Abfragen des Reverse-DNS Eintrags für eine IP-Adresse.  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
Zeile 3.006: Zeile 2.992:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| rdns (Object)
+
| rdns (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| IP-Adresse
 
| IP-Adresse
 
|-
 
|-
| ptr (String)
+
| ptr (String)  
 
| PTR Record
 
| PTR Record
 
|}
 
|}
Zeile 3.023: Zeile 3.009:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| IP_NOT_FOUND
+
| IP_NOT_FOUND  
 
| Die IP-Adresse &lt;ip&gt; wurde nicht gefunden
 
| Die IP-Adresse &lt;ip&gt; wurde nicht gefunden
 
|-
 
|-
| 404
+
| 404  
| RDNS_NOT_FOUND
+
| RDNS_NOT_FOUND  
 
| Für die IP-Adresse &lt;ip&gt; existiert noch kein DNS-Eintrag
 
| Für die IP-Adresse &lt;ip&gt; existiert noch kein DNS-Eintrag
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123</pre> <pre>{
<pre>{
+
 
   "rdns": {
 
   "rdns": {
 
     "ip": "123.123.123.123",
 
     "ip": "123.123.123.123",
Zeile 3.044: Zeile 3.029:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== PUT /rdns/&lt;ip&gt;  ==
 
== PUT /rdns/&lt;ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Erstellen eines neuen Reverse-DNS Eintrags für eine IP-Adresse. Wenn der neue Reverse-DNS Eintrag erfolgreich erstellt wurde, wird der HTTP Status Code 201 CREATED zurückgeliefert.
+
Erstellen eines neuen Reverse-DNS Eintrags für eine IP-Adresse. Wenn der neue Reverse-DNS Eintrag erfolgreich erstellt wurde, wird der HTTP Status Code 201 CREATED zurückgeliefert.  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 3.055: Zeile 3.040:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| ptr
+
| ptr  
 
| PTR Record
 
| PTR Record
 
|}
 
|}
Zeile 3.063: Zeile 3.048:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| rdns (Object)
+
| rdns (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| IP-Adresse
 
| IP-Adresse
 
|-
 
|-
| ptr (String)
+
| ptr (String)  
 
| PTR Record
 
| PTR Record
 
|}
 
|}
Zeile 3.080: Zeile 3.065:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| fehlerhafte Eingabeparameter
 
| fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| IP_NOT_FOUND
+
| IP_NOT_FOUND  
 
| Die IP-Adresse &lt;ip&gt; wurde nicht gefunden
 
| Die IP-Adresse &lt;ip&gt; wurde nicht gefunden
 
|-
 
|-
| 409
+
| 409  
| RDNS_ALREADY_EXISTS
+
| RDNS_ALREADY_EXISTS  
 
| Es existiert bereits ein Reverse-DNS Eintrag
 
| Es existiert bereits ein Reverse-DNS Eintrag
 
|-
 
|-
| 500
+
| 500  
| RDNS_CREATE_FAILED
+
| RDNS_CREATE_FAILED  
 
| Das Anlegen des Reverse-DNS Eintrags ist fehlgeschlagen
 
| Das Anlegen des Reverse-DNS Eintrags ist fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -d ptr=testen.de -X PUT</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -d ptr=testen.de -X PUT</pre> <pre>{
<pre>{
+
 
   "rdns": {
 
   "rdns": {
 
     "ip": "123.123.123.123",
 
     "ip": "123.123.123.123",
Zeile 3.109: Zeile 3.093:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== POST /rdns/&lt;ip&gt;  ==
 
== POST /rdns/&lt;ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Aktualisieren oder Anlegen eines Reverse-DNS Eintrags. Wenn der DNS-Eintrag neu angelegt wurde, wird der HTTP-Status 201 CREATED zurückgeliefert.
+
Aktualisieren oder Anlegen eines Reverse-DNS Eintrags. Wenn der DNS-Eintrag neu angelegt wurde, wird der HTTP-Status 201 CREATED zurückgeliefert.  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 3.120: Zeile 3.104:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| ptr
+
| ptr  
 
| PTR Record
 
| PTR Record
 
|}
 
|}
Zeile 3.128: Zeile 3.112:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| rdns (Object)
+
| rdns (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| ip (String)
+
| ip (String)  
 
| IP-Adresse
 
| IP-Adresse
 
|-
 
|-
| ptr (String)
+
| ptr (String)  
 
| PTR Record
 
| PTR Record
 
|}
 
|}
Zeile 3.145: Zeile 3.129:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| fehlerhafte Eingabeparameter
 
| fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| IP_NOT_FOUND
+
| IP_NOT_FOUND  
 
| Die IP-Adresse &lt;ip&gt; wurde nicht gefunden
 
| Die IP-Adresse &lt;ip&gt; wurde nicht gefunden
 
|-
 
|-
| 500
+
| 500  
| RDNS_CREATE_FAILED
+
| RDNS_CREATE_FAILED  
 
| Das Anlegen des Reverse-DNS Eintrags ist fehlgeschlagen
 
| Das Anlegen des Reverse-DNS Eintrags ist fehlgeschlagen
 
|-
 
|-
| 500
+
| 500  
| RDNS_UPDATE_FAILED
+
| RDNS_UPDATE_FAILED  
 
| Das Aktualisieren des Reverse-DNS Eintrags ist fehlgeschlagen
 
| Das Aktualisieren des Reverse-DNS Eintrags ist fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -d ptr=testen.de</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -d ptr=testen.de</pre> <pre>{
<pre>{
+
 
   "rdns": {
 
   "rdns": {
 
     "ip": "123.123.123.123",
 
     "ip": "123.123.123.123",
Zeile 3.174: Zeile 3.157:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
== DELETE /rdns/&lt;ip&gt;  ==
 
== DELETE /rdns/&lt;ip&gt;  ==
  
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Löschen des Reverse-DNS Eintrags für eine IP-Adresse
+
Löschen des Reverse-DNS Eintrags für eine IP-Adresse  
  
 
==== Ausgabe  ====
 
==== Ausgabe  ====
  
Keine Ausgabe
+
Keine Ausgabe  
  
 
==== Fehler  ====
 
==== Fehler  ====
Zeile 3.189: Zeile 3.172:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 404
+
| 404  
| IP_NOT_FOUND
+
| IP_NOT_FOUND  
 
| Die IP-Adresse &lt;ip&gt; wurde nicht gefunden
 
| Die IP-Adresse &lt;ip&gt; wurde nicht gefunden
 
|-
 
|-
| 500
+
| 500  
| RDNS_DELETE_FAILED
+
| RDNS_DELETE_FAILED  
 
| Das Löschen des Reverse-DNS Eintrags ist fehlgeschlagen
 
| Das Löschen des Reverse-DNS Eintrags ist fehlgeschlagen
 
|}
 
|}
  
 
==== Beispiel  ====
 
==== Beispiel  ====
<pre>curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -X DELETE</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -X DELETE</pre>  
<br>
+
<br>  
  
 
= Traffic  =
 
= Traffic  =
Zeile 3.212: Zeile 3.195:
 
==== Beschreibung  ====
 
==== Beschreibung  ====
  
Abfragen der Traffic-Daten für IP-Adressen und Subnetze
+
Abfragen der Traffic-Daten für IP-Adressen und Subnetze  
  
Es stehen drei Abfrage-Arten zur Verfügung: "day", "month" und "year" Mit diesen geben Sie an, ob sich die Trafficabfrage auf einen Zeitraum innerhalb eines Tages("day"), eines Monats("month") oder eines Jahres("year") bezieht. Möchten Sie zum Beispiel den Trafficverbrauch für eine oder mehrere Stunden innerhalb eines Tages abfragen, verwenden Sie "day". Möchten Sie die Tagessumme oder die Summe mehrerer Tage innerhalb eines Monats ermitteln, verwenden Sie "month". Und für die Abfrage von Monatssummen innerhalb eines Jahres ist "year" die richtige Abfrage-Art.
+
Es stehen drei Abfrage-Arten zur Verfügung: "day", "month" und "year" Mit diesen geben Sie an, ob sich die Trafficabfrage auf einen Zeitraum innerhalb eines Tages("day"), eines Monats("month") oder eines Jahres("year") bezieht. Möchten Sie zum Beispiel den Trafficverbrauch für eine oder mehrere Stunden innerhalb eines Tages abfragen, verwenden Sie "day". Möchten Sie die Tagessumme oder die Summe mehrerer Tage innerhalb eines Monats ermitteln, verwenden Sie "month". Und für die Abfrage von Monatssummen innerhalb eines Jahres ist "year" die richtige Abfrage-Art.  
  
Bitte beachten Sie, dass Stunden-, Tages- und Monatssummen erst nach Ablauf der/des entsprechenden Stunde, Tages bzw. Monats verfügbar sind.
+
Bitte beachten Sie, dass Stunden-, Tages- und Monatssummen erst nach Ablauf der/des entsprechenden Stunde, Tages bzw. Monats verfügbar sind.  
  
Das Abfrage-Intervall können sie mit den Parametern "from" und "to" angeben. Die Syntax dieser Paramater ist wie folgt:
+
Das Abfrage-Intervall können sie mit den Parametern "from" und "to" angeben. Die Syntax dieser Paramater ist wie folgt:  
 
<pre>* Abfrage-Typ "day":  [YYYY]-[MM]-[DD]T[H], z.B. 2010-09-01T00
 
<pre>* Abfrage-Typ "day":  [YYYY]-[MM]-[DD]T[H], z.B. 2010-09-01T00
 
* Abfrage-Typ "month": [YYYY]-[MM]-[DD], z.B. 2010-09-01
 
* Abfrage-Typ "month": [YYYY]-[MM]-[DD], z.B. 2010-09-01
 
* Abfrage-Typ "year":  [YYYY]-[MM], z.B. 2010-09
 
* Abfrage-Typ "year":  [YYYY]-[MM], z.B. 2010-09
</pre>
+
</pre>  
Bei dem Abfrage-Typ "day" wird das Datum zusammen mit der Stunde angegeben. Der Stundenwert wird vom Datum mit dem Buchstaben "T" getrennt. Beim Anfrage-Typ "month" darf der Stundenwert nicht mit angegeben werden, da Sie hier den Zeitraum nur tagesbasiert angeben können. Bei dem Typ "year" fällt zusätzlich noch der Tageswert weg, da Sie hier den Zeitraum innerhalb eines Jahres monatsbasiert angeben.
+
Bei dem Abfrage-Typ "day" wird das Datum zusammen mit der Stunde angegeben. Der Stundenwert wird vom Datum mit dem Buchstaben "T" getrennt. Beim Anfrage-Typ "month" darf der Stundenwert nicht mit angegeben werden, da Sie hier den Zeitraum nur tagesbasiert angeben können. Bei dem Typ "year" fällt zusätzlich noch der Tageswert weg, da Sie hier den Zeitraum innerhalb eines Jahres monatsbasiert angeben.  
  
Wenn für die ausgewählten IP-Adressen und Subnetze kein Traffic angefallen ist, werden diese in der Antwort nicht angezeigt.
+
Wenn für die ausgewählten IP-Adressen und Subnetze kein Traffic angefallen ist, werden diese in der Antwort nicht angezeigt.  
  
 
==== Eingabe  ====
 
==== Eingabe  ====
Zeile 3.231: Zeile 3.214:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| ip[]
+
| ip[]  
 
| Eine oder mehrere IP-Adressen
 
| Eine oder mehrere IP-Adressen
 
|-
 
|-
| subnet[]
+
| subnet[]  
 
| Eine oder mehrere Subnetz-Adressen
 
| Eine oder mehrere Subnetz-Adressen
 
|-
 
|-
| from
+
| from  
 
| Datum/Zeit von
 
| Datum/Zeit von
 
|-
 
|-
| to
+
| to  
 
| Datum/Zeit bis
 
| Datum/Zeit bis
 
|-
 
|-
| type
+
| type  
 
| Abfrage-Typ (day,month,year)
 
| Abfrage-Typ (day,month,year)
 
|}
 
|}
Zeile 3.251: Zeile 3.234:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| traffic (Object)
+
| traffic (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| type (String)
+
| type (String)  
 
| Abfrage-Typ
 
| Abfrage-Typ
 
|-
 
|-
| from (String)
+
| from (String)  
 
| Datum/Zeit von
 
| Datum/Zeit von
 
|-
 
|-
| to (String)
+
| to (String)  
 
| Datum/Zeit bis
 
| Datum/Zeit bis
 
|-
 
|-
| data (Object)
+
| data (Object)  
|
+
|  
{| align="top" width="100%" class="wikitable"
+
{| width="100%" align="top" class="wikitable"
 
|-
 
|-
| IP-Adresse (Object)
+
| IP-Adresse (Object)  
|
+
|  
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
| in
+
| in  
 
| Traffic eingehend (GB)
 
| Traffic eingehend (GB)
 
|-
 
|-
| out
+
| out  
 
| Traffic ausgehend (GB)
 
| Traffic ausgehend (GB)
 
|-
 
|-
| sum
+
| sum  
 
| Traffic Summe (GB)
 
| Traffic Summe (GB)
 
|}
 
|}
Zeile 3.292: Zeile 3.275:
 
{| width="100%" class="wikitable"
 
{| width="100%" class="wikitable"
 
|-
 
|-
! Status
+
! Status  
! Code
+
! Code  
 
! Beschreibung
 
! Beschreibung
 
|-
 
|-
| 400
+
| 400  
| INVALID_INPUT
+
| INVALID_INPUT  
 
| Fehlerhafte Eingabeparameter
 
| Fehlerhafte Eingabeparameter
 
|-
 
|-
| 404
+
| 404  
| NOT_FOUND
+
| NOT_FOUND  
 
| Keine IP-Adressen oder Subnetze gefunden
 
| Keine IP-Adressen oder Subnetze gefunden
 
|-
 
|-
| 500
+
| 500  
| INTERNAL_ERROR
+
| INTERNAL_ERROR  
 
| Das Abfragen des Traffic ist aufgrund eines internen Fehlers fehlgeschlagen
 
| Das Abfragen des Traffic ist aufgrund eines internen Fehlers fehlgeschlagen
 
|}
 
|}
Zeile 3.311: Zeile 3.294:
 
==== Beispiel  ====
 
==== Beispiel  ====
  
'''Abfragen der Traffic-Daten für eine IP-Adresse'''
+
'''Abfragen der Traffic-Daten für eine IP-Adresse'''  
<pre>curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&amp;from=2010-09-01&amp;to=2010-09-31&amp;ip=123.123.123.123'</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&amp;from=2010-09-01&amp;to=2010-09-31&amp;ip=123.123.123.123'</pre> <pre>{
<pre>{
+
 
   "traffic": {
 
   "traffic": {
 
     "type": "month",
 
     "type": "month",
Zeile 3.327: Zeile 3.309:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
'''Abfragen der Traffic-Daten für mehrere IP-Adressen'''
+
'''Abfragen der Traffic-Daten für mehrere IP-Adressen'''  
<pre>curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&amp;from=2010-09-01&amp;to=2010-09-31&amp;ip[]=123.123.123.123&amp;ip[]=124.124.124.124'</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&amp;from=2010-09-01&amp;to=2010-09-31&amp;ip[]=123.123.123.123&amp;ip[]=124.124.124.124'</pre> <pre>{
<pre>{
+
 
   "traffic": {
 
   "traffic": {
 
     "type": "month",
 
     "type": "month",
Zeile 3.349: Zeile 3.330:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
'''Abfragen der Traffic-Daten für ein Subnetz'''
+
'''Abfragen der Traffic-Daten für ein Subnetz'''  
<pre>curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&amp;from=2010-09-01&amp;to=2010-09-31&amp;subnet=2a01:4f8:61:41a2::'</pre>
+
<pre>curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&amp;from=2010-09-01&amp;to=2010-09-31&amp;subnet=2a01:4f8:61:41a2::'</pre> <pre>{
<pre>{
+
 
   "traffic": {
 
   "traffic": {
 
     "type": "month",
 
     "type": "month",
Zeile 3.371: Zeile 3.351:
 
   }
 
   }
 
}
 
}
</pre>
+
</pre>  
 
= PHP Client  =
 
= PHP Client  =
  
Unter https://robot.your-server.de/downloads/robot-client.zip steht eine PHP5-Klasse zum Herunterladen zur Verfügung. Die Klasse verwendet [http://www.php.net/curl libcurl].
+
Unter https://robot.your-server.de/downloads/robot-client.zip steht eine PHP5-Klasse zum Herunterladen zur Verfügung. Die Klasse verwendet [http://www.php.net/curl libcurl].  
  
 
==== Beispiel  ====
 
==== Beispiel  ====
Zeile 3.407: Zeile 3.387:
 
   echo $e-&gt;getMessage() . "\n";
 
   echo $e-&gt;getMessage() . "\n";
 
}
 
}
</pre>
+
</pre>  
 
+
[[Category:Robot]] [[Category:Dedi_Robot]]
[[Kategorie:Robot]] [[Category:Dedi Robot]]
+

Version vom 8. August 2011, 14:25 Uhr

Allgemein

Allgemeines

Die Schnittstelle setzt auf dem HTTP-Protokoll auf und kann somit mit jeder beliebigen HTTP-Library benutzt werden. Als einfacher Client für die Kommandozeile kann zum Beispiel curl verwendet werden.

Grundsätzlich gilt:

  • POST-Parameter werden im Format "application/x-www-form-urlencoded" übergeben
  • Das Rückgabeformat ist JSON, durch Anhängen von ".yaml" wird das Format auf YAML gesetzt
  • Wenn die Abfrage erfolgreich war, wird der HTTP-Status-Code 200 OK zurückgeliefert. Wenn eine neue Ressource erstellt wurde, wird der HTTP-Status-Code 201 CREATED zurückgegeben.
  • Im Fehlerfall wird der entsprechende HTTP-Error-Code gesetzt
  • Die Authentifizierung erfolgt über HTTP-Basic-Auth
  • Die Schnittstelle ist nur über HTTPS erreichbar
  • Für den Webservice kann ein eigener Benutzer angelegt werden, sie finden diese Option im Robot unter dem Menüpunkt "Einstellungen"

URL

https://robot-ws.your-server.de

Beispiel JSON

curl -u login:password https://robot-ws.your-server.de/reset

Ausgabe

[
  {
    "reset":
    {
      "server_ip": "123.123.123.123",
      "type": ["man","hw","sw"]
    }
  }
]

Beispiel YAML

curl -u login:password https://robot-ws.your-server.de/reset.yaml

Ausgabe

-
  reset: { server_ip: 123.123.123.123, type: [man, hw, sw] }

Fehler

Fehler-Format

error (Object)
status (Integer) HTTP Status Code
code (String) Spezifischer Error-Code
message (String) Spezifische Fehlermeldung

Beispiel:

{
  "error":
  {
    "status": 404,
    "code": "BOOT_NOT_AVAILABLE",
    "message": "No boot configuration available for this server"
  }
}

Fehler-Format bei falschen Eingabeparametern

error (Object)
status (Integer) 400
code (String) INVALID_INPUT
message (String) invalid input
missing (Array) Array der fehlenden Eingabeparameter oder null
invalid (Array) Array der fehlerhaften Eingabeparameter oder null

Authentifizierungsfehler

Bei falschem Login/Passwort wird der Status 401 - Unauthorized zurückgeliefert.

Limitierung

Wenn das Request-Limit erreicht wurde, wird der Status 403 - Forbidden gesetzt.

Nichterreichbarkeit aufgrund von Wartungsarbeiten

Wenn die Schnittstelle aufgrund von Wartungsarbeiten nicht erreichbar ist wird der Status 503 - Service Unavailable gesetzt.

Inhaltsverzeichnis


Server

GET /server

Beschreibung

Abragen aller Server

Ausgabe

(Array)
server (Object)
server_ip (String) Haupt-IP des Servers
server_name (String) Name des Servers
product (String) Produktname
dc (String) Rechenzentrum
traffic (String) Freitraffic
flatrate (Boolean) Zeigt an, ob Server eine Traffic-Flatrate hat (keine Bezahlung bei Traffic-Überschreitung, sondern Drosselung) oder nicht (Bezahlung bei Traffic-Überschreitung)
status (String) Bestellstatus (fertig oder in Bearbeitung)
throttled (Boolean) Zeigt an, ob der Server gedrosselt ist
cancelled (Boolean) Zeigt an, ob der Server zur Kündigung vorgemerkt ist
paid_until (String) Bezahlt-bis Datum

Fehler

Status Code Beschreibung
404 NOT_FOUND Es konnten keine Server gefunden werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/server
[
 {
  "server": {
    "server_ip": "123.123.123.123",
    "server_name": "Server1",
    "product": "DS 3000",
    "dc": "6",
    "traffic": "5 TB",
    "flaterate": true,
    "status": "ready",
    "throttled": true,
    "cancelled": false,
    "paid_until": "2010-09-02"
  }
},
{
  "server": {
    "server_ip": "123.123.123.124",
    "server_name": "Server2",
    "product": "X5",
    "dc": "5",
    "traffic": "2 TB",
    "flaterate": true,
    "status": "ready",
    "throttled": false,
    "cancelled": false,
    "paid_until": "2010-06-11"
  }
}


]


GET /server/<server-ip>

Beschreibung

Abfragen der Server-Daten für einen bestimmten Server

Ausgabe

server (Object)
server_ip (String) Haupt-IP des Servers
server_name (String) Name des Servers
product (String) Produktname
dc (String) Rechenzentrum
traffic (String) Freitraffic
flatrate (Boolean) Zeigt an, ob Server eine Traffic-Flatrate hat (keine Bezahlung bei Traffic-Überschreitung, sondern Drosselung) oder nicht (Bezahlung bei Traffic-Überschreitung)
status (String) Bestellstatus (fertig oder in Bearbeitung)
throttled (Boolean) Zeigt an, ob der Server gedrosselt ist
cancelled (Boolean) Zeigt an, ob der Server zur Kündigung vorgemerkt ist
paid_until (String) Bezahlt-bis Datum
ip (Array) Array aller zugehörigen Einzel-IPs
subnet (Array) Array aller zugehörigen Subnetze
reset (Boolean) Zeigt an, ob ein Reset möglich ist
rescue (Boolean) Zeigt an, ob das Rescuesystem verfügbar ist
vnc (Boolean) Zeigt an, ob die VNC-Installation verfügbar ist
windows (Boolean) Zeigt an, ob die Windows-Installation verfügbar ist
plesk (Boolean) Zeigt an, ob die Plesk-Installation verfügbar ist
cpanel (Boolean) Zeigt an, ob die cPanel-Installation verfügbar ist
wol (Boolean) Zeigt an, ob Wake on Lan verfügbar ist

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server konnte nicht gefunden werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/server/123.123.123.123
{
 "server": {
  "server_ip":" 123.132.123.123",
  "server_name": "Server1",
  "product": "EQ 8",
  "dc": "11",
  "traffic": "5 TB",
  "flatrate": true,
  "status": "ready",
  "throttled": false,
  "cancelled": false,
  "paid_until": "2010-08-04",
  "ip": ["124.124.124.124"],
  "subnet": [{"ip": "2a01:4f8:111:4221::", "mask": "64"}],
  "reset": true,
  "rescue": true,
  "vnc": true,
  "windows": true,
  "plesk": true,
  "cpanel": true,
  "wol": true
}


}


POST /server/<server-ip>

Beschreibung

Anpassen des Servernamens für einen bestimmten Server

Eingabe

server_name Name des Servers

Ausgabe

server (Object)
server_ip (String) Haupt-IP des Servers
server_name (String) Name des Servers
product (String) Produktname
dc (String) Rechenzentrum
traffic (String) Freitraffic
flatrate (Boolean) Zeigt an, ob Server eine Traffic-Flatrate hat (keine Bezahlung bei Traffic-Überschreitung, sondern Drosselung) oder nicht (Bezahlung bei Traffic-Überschreitung)
status (String) Bestellstatus (fertig oder in Bearbeitung)
throttled (Boolean) Zeigt an, ob der Server gedrosselt ist
cancelled (Boolean) Zeigt an, ob der Server zur Kündigung vorgemerkt ist
paid_until (String) Bezahlt-bis Datum
ip (Array) Array aller zugehörigen Einzel-IPs
subnet (Array) Array aller zugehörigen Subnetze
reset (Boolean) Zeigt an, ob ein Reset möglich ist
rescue (Boolean) Zeigt an, ob das Rescuesystem verfügbar ist
vnc (Boolean) Zeigt an, ob die VNC-Installation verfügbar ist
windows (Boolean) Zeigt an, ob die Windows-Installation verfügbar ist
plesk (Boolean) Zeigt an, ob die Plesk-Installation verfügbar ist
cpanel (Boolean) Zeigt an, ob die cPanel-Installation verfügbar ist
wol (Boolean) Zeigt an, ob Wake on Lan verfügbar ist

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server konnte nicht gefunden werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/server/123.123.123.123 -d server_name=Server1
{
 "server": {
  "server_ip":" 123.132.123.123",
  "server_name": "Server1",
  "product": "EQ 8",
  "dc": "11",
  "traffic": "5 TB",
  "flatrate": true,
  "status": "ready",
  "throttled": false,
  "cancelled": false,
  "paid_until": "2010-08-04",
  "ip": ["124.124.124.124"],
  "subnet": [{"ip": "2a01:4f8:111:4221::", "mask": "64"}],
  "reset": true,
  "rescue": true,
  "vnc": true,
  "windows": true,
  "plesk": true,
  "cpanel": true,
  "wol": true
}


}


IP

GET /ip

Beschreibung

Abfragen aller Einzel-IPs

Eingabe (optional)

server_ip Server Haupt-IP. Bei Angabe werden nur Ips angezeigt, die diesem Server zugeordnet sind

Ausgabe

(Array)
ip (Object)
ip (String) IP-Adresse
server_ip (String) Haupt-IP des zugehörigen Servers
locked (Boolean) Zeigt an, ob die IP gesperrt ist
traffic_warnings (Boolean) Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
traffic_hourly (Integer) Stündliches Trafficlimit in MB
traffic_daily (Integer) Tägliches Trafficlimit in MB
traffic_monthly (Integer) Monatliches Trafficlimit in MB

Fehler

Status Code Beschreibung
404 NOT_FOUND Keine Einzel-Ips gefunden

Beispiel

curl -u login:password https://robot-ws.your-server.de/ip
[
 {
   "ip": {
     "ip":"123.123.123.123",
     "server_ip": "123.123.123.123",
     "locked": false,
     "traffic_warnings": false,
     "traffic_hourly": 50,
     "traffic_daily": 50,
     "traffic_monthly":8
   }
 },
 {
   "ip": {
     "ip": "124.124.124.124",
     "server_ip": "123.123.123.123",
     "locked": false,
     "traffic_warnings": false,
     "traffic_hourly": 200,
     "traffic_daily": 2000,
     "traffic_monthly": 20
   }
 }

]

GET /ip/<ip>

Beschreibung

Abfragen der Daten für eine bestimme IP

Ausgabe

ip (Object)
ip (String) IP-Adresse
server_ip (String) Haupt-IP des zugehörigen Servers
locked (Boolean) Zeigt an, ob die IP gesperrt ist
traffic_warnings (Boolean) Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
traffic_hourly (Integer) Stündliches Trafficlimit in MB
traffic_daily (Integer) Tägliches Trafficlimit in MB
traffic_monthly (Integer) Monatliches Trafficlimit in MB

Fehler

Status Code Beschreibung
404 IP_NOT_FOUND Die IP-Adresse konnte nicht gefunden werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/ip/123.123.123.123
{
 "ip": {
   "ip":"123.123.123.123",
   "server_ip": "123.123.123.123",
   "locked": false,
   "traffic_warnings": false,
   "traffic_hourly": 50,
   "traffic_daily": 50,
   "traffic_monthly": 8
 }

}

POST /ip/<ip>

Beschreibung

Anpassen der Traffic-Warnungen eines IP

Eingabe

traffic_warnings Aktivieren/Deaktiveren der Traffic-Warnungen (true,false)
traffic_hourly Stündliches Trafficlimit in MB
traffic_daily Tägliches Trafficlimit in MB
traffic_monthly Monatliches Trafficlimit in GB

Ausgabe

ip (Object)
ip (String) IP-Adresse
server_ip (String) Haupt-IP des zugehörigen Servers
locked (Boolean) Zeigt an, ob die IP gesperrt ist
traffic_warnings (Boolean) Zeigt an, ob Traffic-Warnungen für die IP aktiviert sind
traffic_hourly (Integer) Stündliches Trafficlimit in MB
traffic_daily (Integer) Tägliches Trafficlimit in MB
traffic_monthly (Integer) Monatliches Trafficlimit in MB

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 IP_NOT_FOUND Die IP-Adresse konnte nicht gefunden werden
500 TRAFFIC_WARNING_UPDATE_FAILED Die Einstellungen konnten wegen eines internen Fehlers nicht vorgenommen werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/ip/123.123.123.123 -d traffic_warnings=true
{
 "ip": {
   "ip":"123.123.123.123",
   "server_ip": "123.123.123.123",
   "locked": false,
   "traffic_warnings": true,
   "traffic_hourly": 50,
   "traffic_daily": 50,
   "traffic_monthly":8
 }

}

Subnet

GET /subnet

Beschreibung

Abfragen aller Subnetze

Eingabe (optional)

server_ip Server Haupt-IP. Bei Angabe werden nur Subnetze angezeigt, die diesem Server zugeordnet sind

Ausgabe

(Array)
subnet (Object)
ip (String) Netz-Adresse
mask (Integer) Netzwerkmaske in CIDR Notation
gateway (String) Gateway des Subnetzes
server_ip (String) Haupt-IP des zugehörigen Servers
failover (Boolean) True, wenn das Netz ein Failover-Netz ist
locked (Boolean) Zeigt an, ob das Netz gesperrt ist
traffic_warnings (Boolean) Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
traffic_hourly (Integer) Stündliches Trafficlimit in MB
traffic_daily (Integer) Tägliches Trafficlimit in MB
traffic_monthly (Integer) Monatliches Trafficlimit in GB

Fehler

Status Code Beschreibung
404 NOT_FOUND Es wurden keine Subnetze gefunden

Beispiel

curl -u login:password https://robot-ws.your-server.de/subnet
[
 {
   "subnet": {
     "ip": "123.123.123.123",
     "mask": 29,
     "gateway": "123.123.123.123",
     "server_ip": "88.198.123.123",
     "failover": false,
     "locked": false,
     "traffic_warnings": false,
     "traffic_hourly": 100,
     "traffic_daily": 500,
     "traffic_monthly": 2
   }
 },
 {
   "subnet":{
     "ip": "178.63.123.123",
     "mask": 25,
     "gateway": "178.63.123.124",
     "server_ip": null,
     "failover": false,
     "locked": false,
     "traffic_warnings": false,
     "traffic_hourly": 100,
     "traffic_daily": 500,
     "traffic_monthly": 2
   }
 }

]

GET /subnet/<net-ip>

Beschreibung

Abfragen der Daten für ein bestimmtes Subnetz

Ausgabe

subnet (Object)
ip (String) Netz-Adresse
mask (Integer) Netzwerkmaske in CIDR Notation
gateway (String) Gateway des Subnetzes
server_ip (String) Haupt-IP des zugehörigen Servers
failover (Boolean) True, wenn das Netz ein Failover-Netz ist
locked (Boolean) Zeigt an, ob das Netz gesperrt ist
traffic_warnings (Boolean) Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
traffic_hourly (Integer) Stündliches Trafficlimit in MB
traffic_daily (Integer) Tägliches Trafficlimit in MB
traffic_monthly (Integer) Monatliches Trafficlimit in GB

Fehler

Status Code Beschreibung
404 SUBNET_NOT_FOUND Das Subnetz konnte nicht gefunden werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/subnet/123.123.123.123
{
 "subnet": {
   "ip": "123.123.123.123",
   "mask": 29,
   "gateway": "123.123.123.123",
   "server_ip": "88.198.123.123",
   "failover": false,
   "locked": false,
   "traffic_warnings": false,
   "traffic_hourly": 100,
   "traffic_daily": 500,
   "traffic_monthly": 2
 }

}

POST /subnet/<net-ip>

Beschreibung

Anpassen der Traffic-Warnungen eines Subnetzes

Eingabe

traffic_warnings Aktivieren/Deaktiveren der Traffic-Warnungen (true,false)
traffic_hourly Stündliches Trafficlimit in MB
traffic_daily Tägliches Trafficlimit in MB
traffic_monthly Monatliches Trafficlimit in GB

Ausgabe

subnet (Object)
ip (String) Netz-Adresse
mask (Integer) Netzwerkmaske in CIDR Notation
gateway (String) Gateway des Subnetzes
server_ip (String) Haupt-IP des zugehörigen Servers
failover (Boolean) True, wenn das Netz ein Failover-Netz ist
locked (Boolean) Zeigt an, ob das Netz gesperrt ist
traffic_warnings (Boolean) Zeigt an, ob Traffic-Warnungen für das Netz aktiviert sind
traffic_hourly (Integer) Stündliches Trafficlimit in MB
traffic_daily (Integer) Tägliches Trafficlimit in MB
traffic_monthly (Integer) Monatliches Trafficlimit in GB

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 SUBNET_NOT_FOUND Das Subnetz konnte nicht gefunden werden
500 TRAFFIC_WARNING_UPDATE_FAILED Die Einstellungen konnten wegen eines internen Fehlers nicht vorgenommen werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/subnet/123.123.123.123 -d traffic_warnings=true
{
 "subnet": {
   "ip": "123.123.123.123",
   "mask": 29,
   "gateway": "123.123.123.123",
   "server_ip": "88.198.123.123",
   "failover": false,
   "locked": false,
   "traffic_warnings": true,
   "traffic_hourly": 100,
   "traffic_daily": 500,
   "traffic_monthly": 2
 }

}


Reset

GET /reset

Beschreibung

Abfragen der Reset-Optionen für alle Server

Ausgabe

(Array)
reset (Object)
server_ip (String) Haupt-IP des Servers
type (Array) Mögliche Reset-Optionen

Fehler

Status Code Beschreibung
404 NOT_FOUND Keine Server mit Reset-Option gefunden

Beispiel

curl -u login:password https://robot-ws.your-server.de/reset
[
 {
   "reset":
   {
     "server_ip": "123.123.123.123",
     "type": ["man","hw","sw"]
   }
 },
 {
   "reset":
   {
     "server_ip": "111.111.111.111",
     "type": ["man"]
   }
 }

]

GET /reset/<server-ip>

Beschreibung

Abfragen der Reset-Optionen für einen bestimmten Server

Ausgabe

reset (Object)
server_ip (String) Haupt-IP des Servers
type (Array) Mögliche Reset-Optionen

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der IP <server-ip> konnte nicht gefunden werden
404 RESET_NOT_AVAILABLE Dieser Server hat keine Reset-Option

Beispiel

curl -u login:password https://robot-ws.your-server.de/reset/123.123.123.123
{
 "reset":
 {
   "server_ip": "123.123.123.123",
   "type": ["man","hw","sw"]
 }

}

POST /reset/<server-ip>

Beschreibung

Ausführen eines Reset für einen bestimmten Server

Eingabe

type Reset-Typ der ausgeführt werden soll

Ausgabe

reset (Object)
server_ip (String) Haupt-IP des Servers
type (String) Ausgeführte Reset-Option

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 SERVER_NOT_FOUND Der Server mit der IP <server-ip> konnte nicht gefunden werden
404 RESET_NOT_AVAILABLE Der Server hat keine Reset-Option
409 RESET_MANUAL_ACTIVE Es läuft bereits ein manueller Reset
500 RESET_FAILED Der Reset konnte wegen eines internen Fehlers nicht durchgeführt werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/reset/123.123.123.123 -d type=hw
{
 "reset":
 {
   "server_ip": "123.123.123.123",
   "type": "hw"
 }

}

Failover

WICHTIG: Für die reibungslose Nutzung der Failover-IP muß diese auf allen Servern konfiguriert sein, unabhängig davon, ob sie aktuell darauf geroutet wird.

GET /failover

Beschreibung

Abfragen der Failover-Daten aller Server

Ausgabe

(Array)
failover (Object)
ip (String) Failover Netz-Adresse
netmask (String) Failover Netzmaske
server_ip (String) Haupt-IP des zugehörigen Servers
active_server_ip (String) Haupt-IP des Servers, auf den das Netz zur Zeit geroutet wird

Fehler

Status Code Beschreibung
404 NOT_FOUND Es konnten keine Failover-IPs gefunden werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/failover
[
 {
   "failover":
   {
     "ip":"123.123.123.123",
     "netmask":"255.255.255.255",
     "server_ip": "78.46.1.93",
     "active_server_ip": "78.46.1.93"
   }
 }

]

GET /failover/<failover-ip>

Beschreibung

Abfragen der Failover-Daten für eine bestimmte Failover-IP

Ausgabe

failover (Object)
ip (String) Failover Netz-Adresse
netmask (String) Failover Netzmaske
server_ip (String) Haupt-IP des zugehörigen Servers
active_server_ip (String) Haupt-IP des Servers, auf den das Netz zur Zeit geroutet wird

Fehler

Status Code Beschreibung
404 NOT_FOUND Die Failover-IP konnte nicht gefunden werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/failover/123.123.123.123
{
 "failover":
{
  "ip": "123.123.123.123",
  "netmask": "255.255.255.255",
  "server_ip": "78.46.1.93",
  "active_server_ip": "78.46.1.93"
}


}


POST /failover/<failover-ip>

Beschreibung

Umrouten der Failover-IP

Eingabe

active_server_ip Haupt-IP des Server, auf den die Failover-IP geroutet werden soll

Ausgabe

failover (Object)
ip (String) Failover Netz-Adresse
netmask (String) Failover Netzmaske
server_ip (String) Haupt-IP des zugehörigen Servers
active_server_ip (String) Haupt-IP des Servers, auf den das Netz aktuell geroutet wird

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 NOT_FOUND Die Failover-IP konnte nicht gefunden werden
404 FAILOVER_NEW_SERVER_NOT_FOUND Der Server, auf den das Netz geroutet werden soll, konnte nicht gefunden werden
409 FAILOVER_ALREADY_ROUTED Die Failover-IP ist bereits auf den ausgewählten Server geroutet
409 FAILOVER_LOCKED Das Umrouten der Failover-IP ist gesperrt, da bereits eine Anfrage bearbeitet wird
500 FAILOVER_FAILED Aufgrund eines internen Fehlers konnte die Failover-IP nicht um-geroutet werden
500 FAILOVER_NOT_COMPLETE Aufgrund eines internen Fehlers konnte die Failover-IP nicht um-geroutet werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/failover/123.123.123.123 -d active_server_ip=124.124.124.124
{
 "failover":
 {
   "ip": "123.123.123.123",
   "netmask": "255.255.255.255",
   "server_ip": "78.46.1.93",
   "active_server_ip": "124.124.124.124"
 }

}

Wake on LAN

GET /wol/<server-ip>

Beschreibung

Abfragen der WOL-Daten eines Servers

Ausgabe

wol (Object)
server_ip (String) Haupt-IP des Servers

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server konnte nicht gefunden werden
404 WOL_NOT_AVAILABLE Wake On LAN ist bei diesem Server nicht verfügbar

Beispiel

curl -u login:password https://robot-ws.your-server.de/wol/123.123.123.123
{
 "wol":
 {
   "server_ip":"123.123.123.123"
 }

}


POST /wol/<server-ip>

Beschreibung

Versenden des WOL-Pakets an einen Server

Ausgabe

wol (Object)
server_ip (String) Haupt-IP des Servers

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server konnte nicht gefunden werden
404 WOL_NOT_AVAILABLE Wake On LAN ist bei diesem Server nicht verfügbar
500 WOL_FAILED Das senden des WOL-Pakets konnte aufgrund eines internen Fehlers nicht ausgeführt werden

Beispiel

curl -u login:password https://robot-ws.your-server.de/wol/123.123.123.123 -d foo
{
 "wol":
 {
   "server_ip":"123.123.123.123"
 }

}

Boot-Konfiguration

GET /boot/<server-ip>

Beschreibung

Abfragen der Boot-Konfiguration für einen Server. Es kann pro Server nur eine Konfiguration aktiv sein.

Ausgabe

boot (Object)
rescue (Object) siehe #GET_.2Fboot.2F.3Cserver-ip.3E.2Frescue
linux (Object) siehe #GET_.2Fboot.2F.3Cserver-ip.3E.2Flinux
vnc (Object) siehe #GET_.2Fboot.2F.3Cserver-ip.3E.2Fvnc
windows (Object) siehe #GET_.2Fboot.2F.3Cserver-ip.3E.2Fwindows
plesk (Object) siehe #GET_.2Fboot.2F.3Cserver-ip.3E.2Fplesk
cpanel (Object) siehe #GET_.2Fboot.2F.3Cserver-ip.3E.2Fcpanel

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123
{
 "boot": {
   "rescue": {
     "server_ip" : "123.123.123.123",
     "os": ["linux","freebsd","opensolaris","vkvm"],
     "arch": [64,32],
     "active": false,
     "password": null
   },
   "vnc": {
     "server_ip": "123.123.123.123",
     "dist": ["centOS-5.0","Fedora-6","openSUSE-10.2"],
     "arch": [64,32],
     "lang": ["de_DE","en_US"],
     "active": false,
     "password": null
   },
   "windows": {
     "server_ip": "123.123.123.123",
     "dist": null,
     "lang": null,
     "active": false,
     "password": null
   }
 }
}

GET /boot/<server-ip>/rescue

Beschreibung

Abfragen der Boot-Optionen für das Rescue-System

Ausgabe

rescue (Object)
server_ip (String) Haupt-IP des Servers
os (Array|String) Array der verfügbaren Betriebssysteme oder das aktive Betriebssystem
arch (Array| Integer) Array der verfügbaren Architekturen oder die aktive Architektur
active (Boolean) Status des Rescue-Systems
password (String) Aktuelles Passwort oder null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue
{
 "rescue": {
   "server_ip": "123.123.123.123",
   "os": ["linux","freebsd","opensolaris","vkvm"],
   "arch": [64,32],
   "active": false,
   "password": null
 }
}

POST /boot/<server-ip>/rescue

Beschreibung

Aktivieren des Rescue-Systens

Eingabe

os Betriebssystem
arch Architektur

Ausgabe

rescue (Object)
server_ip (String) Haupt-IP des Servers
os (String) Betriebssystem
arch (Integer) Architektur
active (Boolean) true
password (String) Passwort

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
409 BOOT_ALREADY_ENABLED Das Rescue-System ist bereits aktiviert
409 BOOT_BLOCKED Es ist bereits eine andere Boot-Konfiguration aktiv (Linux, VNC, Windows, cPanel oder Plesk)
500 BOOT_ACTIVATION_FAILED Das aktivieren des Rescue-Systems ist aufgrund eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue -d 'os=linux&arch=32'
{
 "rescue": {
   "server_ip": "123.123.123.123",
   "os": "linux",
   "arch": 32,
   "active": true,
   "password": "u7Ng5j43"
 }
}

DELETE /boot/<server-ip>/rescue

Beschreibung

Deaktivieren des Rescue-Systems

Ausgabe

rescue (Object)
server_ip (String) Haupt-IP des Servers
os (Array) Array der verfügbaren Betriebssysteme
arch (Array) Array der verfügbaren Architekturen
active (Boolean) false
password (String) null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
500 BOOT_DEACTIVATION_FAILED Das Deaktivieren des Rescue-Systems ist aufgrund eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/rescue -X DELETE
{
 "rescue": {
   "server_ip": "123.123.123.123",
   "os": ["linux","freebsd","opensolaris","vkvm"],
   "arch": [64,32],
   "active": false,
   "password": null
 }
}

GET /boot/<server-ip>/linux

Beschreibung

Abfrage der Boot-Optionen für die Linux-Installation

Ausgabe

linux (Object)
server_ip (String) Haupt-IP des Servers
dist (Array|String) Array der verfügbaren Distributionen oder die aktive Distribution
arch (Array| Integer) Array der verfügbaren Architekturen oder die aktive Architektur
lang (Array| String) Array der verfügbaren Sprachen oder die aktive Sprache
active (Boolean) Status der Linux-Installation
password (String) Passwort der Linux-Installtion oder null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux
{
 "linux": {
   "server_ip": "123.123.123.123",
   "dist": ["CentOS 5.5 minimal","Debian 5.0 minimal"],
   "arch": [64,32],
   "lang": ["en"],
   "active": false,
   "password": null
 }
}

POST /boot/<server-ip>/linux

Beschreibung

Aktivieren der Linux-Installation

Eingabe

dist Distribution
arch Architektur
lang Sprache

Ausgabe

linux (Object)
server_ip (String) Haupt-IP des Servers
dist (String) Distribution
arch (Integer) Architektur
lang (String) Sprache
active (Boolean) true
password (String) Passwort Linux-Installation

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
409 BOOT_ALREADY_ENABLED Die Linux-Installtion ist bereits aktiviert
409 BOOT_BLOCKED Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, VNC, Windows, cPanel oder Plesk)
500 BOOT_ACTIVATION_FAILED Das Aktiveren der Linux-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux -d 'dist=CentOS 5.5 minimal&arch=32&lang=en'
{
 "linux": {
   "server_ip": "123.123.123.123",
   "dist": "CentOS 5.5 minimal",
   "arch": 32,
   "lang" : "en"
   "active": true,
   "password": "u7Ng5j43"
 }
}

DELETE /boot/<server-ip>/linux

Beschreibung

Deaktivieren der Linux-Installation

Ausgabe

linux (Object)
server_ip (String) Haupt-IP des Servers
os (Array) Array der verfügbaren Distributionen
arch (Array) Array der verfügbaren Architekturen
lang (Array) Array der verfügbaren Sprachen
active (Boolean) false
password (String) null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
500 BOOT_DEACTIVATION_FAILED Das Deaktivieren der Linux-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/linux -X DELETE
{
 "linux": {
   "server_ip": "123.123.123.123",
   "dist": ["CentOS 5.5 minimal","Debian 5.0 minimal"],
   "arch": [64,32],
   "lang": ["en"],
   "active": false,
   "password": null
 }
}

GET /boot/<server-ip>/vnc

Beschreibung

Abfrage der Boot-Optionen für die VNC-Installation

Ausgabe

vnc (Object)
server_ip (String) Haupt-IP des Servers
dist (Array|String) Array der verfügbaren Distributionen oder die aktive Distribution
arch (Array| Integer) Array der verfügbaren Architekturen oder die aktive Architektur
lang (Array| String) Array der verfügbaren Sprachen oder die aktive Sprache
active (Boolean) Status der VNC-Installation
password (String) Passwort der VNC-Installtion oder null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc
{
 "vnc": {
   "server_ip": "123.123.123.123",
   "dist": ["centOS-5.0","Fedora-6","openSUSE-10.2"],
   "arch": [64,32],
   "lang": ["de_DE","en_US"],
   "active": false,
   "password": null
 }
}

POST /boot/<server-ip>/vnc

Beschreibung

Aktivieren der VNC-Installation

Eingabe

dist Distribution
arch Architektur
lang Sprache

Ausgabe

vnc (Object)
server_ip (String) Haupt-IP des Servers
dist (String) Distribution
arch (Integer) Architektur
lang (String) Sprache
active (Boolean) true
password (String) Passwort VNC-Installation

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
409 BOOT_ALREADY_ENABLED Die VNC-Installtion ist bereits aktiviert
409 BOOT_BLOCKED Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, Windows, cPanel oder Plesk)
500 BOOT_ACTIVATION_FAILED Das Aktiveren der VNC-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc -d 'dist=centOS-5.0&arch=32&lang=en_US'
{
 "vnc": {
   "server_ip": "123.123.123.123",
   "dist": "centOS-5.0",
   "arch": 32,
   "lang" : "en_US"
   "active": true,
   "password": "u7Ng5j43"
 }
}

DELETE /boot/<server-ip>/vnc

Beschreibung

Deaktivieren der VNC-Installation

Ausgabe

vnc (Object)
server_ip (String) Haupt-IP des Servers
os (Array) Array der verfügbaren Distributionen
arch (Array) Array der verfügbaren Architekturen
lang (Array) Array der verfügbaren Sprachen
active (Boolean) false
password (String) null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
500 BOOT_DEACTIVATION_FAILED Das Deaktivieren der VNC-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/vnc -X DELETE
{
 "vnc": {
   "server_ip": "123.123.123.123",
   "dist": ["centOS-5.0","Fedora-6","openSUSE-10.2"],
   "arch": [64,32],
   "lang": ["de_DE","en_US"],
   "active": false,
   "password": null
 }
}

GET /boot/<server-ip>/windows

Beschreibung

Abfragen der Boot-Optionen für die Windows-Installation

Ausgabe

windows (Object)
server_ip (String) Server main ip
dist (Array|String) Array of available windows distributions or the active distributon
arch (Array| String) Array of available languages or the active language
active (Boolean) Current windows installation status
password (String) Current windows installation password or null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows
{
 "windows": {
   "server_ip": "88.198.49.132",
   "dist": ["standard"],
   "lang": ["en","de"],
   "active": false,
   "password": null
 }
}

POST /boot/<server-ip>/windows

Beschreibung

Aktivieren der Windows-Installation. Dies ist nur möglich, wenn für den Server das Windows-Addon gebucht wurde. Nach dem Neustart des Servers wird die automatische Windows-Installation gestartet. Alle Daten auf dem Server werden bei der Installation gelöscht.

Eingabe

lang Sprache

Ausgabe

windows (Object)
server_ip (String) Haupt-IP des Servers
dist (String) Distribution
lang (String) Sprache
active (Boolean) true
password (String) Windows installation password

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
404 WINDOWS_MISSING_ADDON Das Windows-Addon fehlt
409 BOOT_ALREADY_ENABLED Die Windows-Installation ist für diesen Server bereits aktiv
409 BOOT_BLOCKED Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, cPanel oder Plesk)
500 BOOT_ACTIVATION_FAILED Das Aktivieren der Windows-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows -d 'lang=en'
{
 "windows": {
   "server_ip": "88.198.49.132",
   "dist": "standard",
   "lang": "en",
   "active": true,
   "password": "u7Ng5j43"
 }
}

DELETE /boot/<server-ip>/windows

Beschreibung

Deaktivieren der Windows-Installation

Ausgabe

windows (Object)
server_ip (String) Server main ip
os (Array) Array der verfügbaren Distributionen
lang (Array) Array der verfügbaren Sprachen
active (Boolean) false
password (String) null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
500 BOOT_DEACTIVATION_FAILED Das Deaktivieren der Windows-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/windows -X DELETE
{
 "windows": {
   "server_ip": "88.198.49.132",
   "dist": ["standard"],
   "lang": ["en","de"],
   "active": false,
   "password": null
 }
}

GET /boot/<server-ip>/plesk

Beschreibung

Abfragen der Boot-Optionen für die Plesk-Installation

Ausgabe

plesk (Object)
server_ip (String) Haupt-IP des Servers
dist (Array|String) Array der verfügbaren Distributionen oder die aktive Distribution
arch (Array| Integer) Array der verfügbaren Architekturen oder die aktive Architektur
lang (Array| String) Array der verfügbaren Sprachen oder die aktive Sprache
active (Boolean) Status der Plesk-Installation
password (String) Passwort der Plesk-Installation oder null
hostname (String) Hostname der Plesk-Installation oder null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/plesk
{
 "plesk": {
   "server_ip": "123.123.123.123",
   "dist": ["CentOS 5.4 minimal","Debian 5.0 minimal"],
   "arch": [64,32],
   "lang": ["en","de"],
   "active": false,
   "password": null,
   "hostname": null
 }

}

POST /boot/<server-ip>/plesk

Beschreibung

Aktivieren der Plesk-Installation

Eingabe

dist Distribution
arch Architektur
lang Sprache
hostname Hostname

Ausgabe

plesk (Object)
server_ip (String) Haupt-IP des Servers
dist (String) Distribution
arch (Integer) Architektur
lang (String) Sprache
active (Boolean) true
password (String) Passwort der Plesk-Installation
hostname (String) Hostname der Plesk-Installation

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
404 PLESK_MISSING_ADDON Das Plesk-Addon fehlt
409 BOOT_ALREADY_ENABLED Die Plesk-Installtion ist bereits aktiviert
409 BOOT_BLOCKED Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, cPanel oder Windows)
500 BOOT_ACTIVATION_FAILED Das Aktiveren der Plesk-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot.yaml/123.123.123.123/plesk -d 'dist=CentOS 5.4 minimal&arch=32&lang=de&hostname=plesk.testen.de'
{
 "plesk": {
   "server_ip": "123.123.123.123",
   "dist": "CentOS 5.4 minimal",
   "arch": 32,
   "lang": "de",
   "active": true,
   "password": "ie8Nhz6R",
   "hostname":"plesk.testen.de"
 }

}

DELETE /boot/<server-ip>/plesk

Beschreibung

Deaktivieren der Plesk-Installation

Ausgabe

plesk (Object)
server_ip (String) Haupt-IP des Servers
dist (Array|String) Array der verfügbaren Distributionen
arch (Array| Integer) Array der verfügbaren Architekturen
lang (Array| String) Array der verfügbaren Sprachen
active (Boolean) false
password (String) null
hostname (String) null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
500 BOOT_DEACTIVATION_FAILED Das Deaktivieren der Plesk-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/plesk -X DELETE
{
 "plesk": {
   "server_ip": "123.123.123.123",
   "dist": ["CentOS 5.4 minimal","Debian 5.0 minimal"],
   "arch": [64,32],
   "lang": ["en","de"],
   "active": false,
   "password": null,
   "hostname": null
 }

}

GET /boot/<server-ip>/cpanel

Beschreibung

Abfragen der Boot-Optionen für die cPanel-Installation

Ausgabe

cpanel (Object)
server_ip (String) Haupt-IP des Servers
dist (Array|String) Array der verfügbaren Distributionen oder die aktive Distribution
arch (Array| Integer) Array der verfügbaren Architekturen oder die aktive Architektur
lang (Array| String) Array der verfügbaren Sprachen oder die aktive Sprache
active (Boolean) Status der cPanel-Installation
password (String) Passwort der cPanel-Installation oder null
hostname (String) Hostname der cPanel-Installation oder null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/cpanel
{
 "cpanel": {
   "server_ip": "123.123.123.123",
   "dist": ["CentOS 5.6 + cPanel"],
   "arch": [64],
   "lang": ["en"],
   "active": false,
   "password": null,
   "hostname": null
 }

}

POST /boot/<server-ip>/cPanel

Beschreibung

Aktivieren der cPanel-Installation

Eingabe

dist Distribution
arch Architektur
lang Sprache
hostname Hostname

Ausgabe

cpanel (Object)
server_ip (String) Haupt-IP des Servers
dist (String) Distribution
arch (Integer) Architektur
lang (String) Sprache
active (Boolean) true
password (String) Passwort der cPanel-Installation
hostname (String) Hostname der cPanel-Installation

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
404 CPANEL_MISSING_ADDON Das cPanel-Addon fehlt
409 BOOT_ALREADY_ENABLED Die cPanel-Installtion ist bereits aktiviert
409 BOOT_BLOCKED Es ist bereits eine andere Boot-Konfiguration aktiv (Rescue, Linux, VNC, Plesk oder Windows)
500 BOOT_ACTIVATION_FAILED Das Aktiveren der cPanel-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot.yaml/123.123.123.123/cPanel -d 'dist=CentOS 5.6 + cPanel&arch=64&lang=en&hostname=cpanel.testen.de'
{
 "plesk": {
   "server_ip": "123.123.123.123",
   "dist": "CentOS 5.6 + cPanel",
   "arch": 64,
   "lang": "en",
   "active": true,
   "password": "ie8Nhz6R",
   "hostname":"cpanel.testen.de"
 }

}

DELETE /boot/<server-ip>/cpanel

Beschreibung

Deaktivieren der cPanel-Installation

Ausgabe

cpanel (Object)
server_ip (String) Haupt-IP des Servers
dist (Array|String) Array der verfügbaren Distributionen
arch (Array| Integer) Array der verfügbaren Architekturen
lang (Array| String) Array der verfügbaren Sprachen
active (Boolean) false
password (String) null
hostname (String) null

Fehler

Status Code Beschreibung
404 SERVER_NOT_FOUND Der Server mit der Haupt-IP <server-ip> konnte nicht gefunden werden
404 BOOT_NOT_AVAILABLE Für diesen Server ist keine Boot-Konfiguration verfügbar
500 BOOT_DEACTIVATION_FAILED Das Deaktivieren der cPanel-Installation ist wegen eines internen Fehlers fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/boot/123.123.123.123/cpanel -X DELETE
{
 "cpanel": {
   "server_ip": "123.123.123.123",
   "dist": ["CentOS 5.6 + cPanel"],
   "arch": [64],
   "lang": ["en"],
   "active": false,
   "password": null,
   "hostname": null
 }

}

Reverse DNS

GET /rdns

Beschreibung

Abfragen aller gesetzten Reverse-DNS Einträge

Eingabe (optional)

server_ip Server Haupt-IP. Bei Angabe werden nur Reverse-DNS Einträge angezeigt, die diesem Server zugeordnet sind

Ausgabe

(Array)
rdns (Object)
ip (String) IP-Adresse
ptr (String) PTR Record

Fehler

Status Code Beschreibung
404 NOT_FOUND Es wurden keine Reverse-DNS Einträge gefunden

Beispiel

curl -u login:password https://robot-ws.your-server.de/rdns
[
 {
   "rdns": {
     "ip": "123.123.123.123",
     "ptr": "testen.de"
   }
 },
 {
   "rdns": {
     "ip": "124.124.124.124",
     "ptr": "your-server.de"
   }
 }

]

GET /rdns/<ip>

Beschreibung

Abfragen des Reverse-DNS Eintrags für eine IP-Adresse.

Ausgabe

rdns (Object)
ip (String) IP-Adresse
ptr (String) PTR Record

Fehler

Status Code Beschreibung
404 IP_NOT_FOUND Die IP-Adresse <ip> wurde nicht gefunden
404 RDNS_NOT_FOUND Für die IP-Adresse <ip> existiert noch kein DNS-Eintrag

Beispiel

curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123
{
 "rdns": {
   "ip": "123.123.123.123",
   "ptr": "testen.de"
 }

}

PUT /rdns/<ip>

Beschreibung

Erstellen eines neuen Reverse-DNS Eintrags für eine IP-Adresse. Wenn der neue Reverse-DNS Eintrag erfolgreich erstellt wurde, wird der HTTP Status Code 201 CREATED zurückgeliefert.

Eingabe

ptr PTR Record

Ausgabe

rdns (Object)
ip (String) IP-Adresse
ptr (String) PTR Record

Fehler

Status Code Beschreibung
400 INVALID_INPUT fehlerhafte Eingabeparameter
404 IP_NOT_FOUND Die IP-Adresse <ip> wurde nicht gefunden
409 RDNS_ALREADY_EXISTS Es existiert bereits ein Reverse-DNS Eintrag
500 RDNS_CREATE_FAILED Das Anlegen des Reverse-DNS Eintrags ist fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -d ptr=testen.de -X PUT
{
 "rdns": {
   "ip": "123.123.123.123",
   "ptr": "testen.de"
 }

}

POST /rdns/<ip>

Beschreibung

Aktualisieren oder Anlegen eines Reverse-DNS Eintrags. Wenn der DNS-Eintrag neu angelegt wurde, wird der HTTP-Status 201 CREATED zurückgeliefert.

Eingabe

ptr PTR Record

Ausgabe

rdns (Object)
ip (String) IP-Adresse
ptr (String) PTR Record

Fehler

Status Code Beschreibung
400 INVALID_INPUT fehlerhafte Eingabeparameter
404 IP_NOT_FOUND Die IP-Adresse <ip> wurde nicht gefunden
500 RDNS_CREATE_FAILED Das Anlegen des Reverse-DNS Eintrags ist fehlgeschlagen
500 RDNS_UPDATE_FAILED Das Aktualisieren des Reverse-DNS Eintrags ist fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -d ptr=testen.de
{
 "rdns": {
   "ip": "123.123.123.123",
   "ptr": "testen.de"
 }

}

DELETE /rdns/<ip>

Beschreibung

Löschen des Reverse-DNS Eintrags für eine IP-Adresse

Ausgabe

Keine Ausgabe

Fehler

Status Code Beschreibung
404 IP_NOT_FOUND Die IP-Adresse <ip> wurde nicht gefunden
500 RDNS_DELETE_FAILED Das Löschen des Reverse-DNS Eintrags ist fehlgeschlagen

Beispiel

curl -u login:password https://robot-ws.your-server.de/rdns/123.123.123.123 -X DELETE


Traffic

POST /traffic

Beschreibung

Abfragen der Traffic-Daten für IP-Adressen und Subnetze

Es stehen drei Abfrage-Arten zur Verfügung: "day", "month" und "year" Mit diesen geben Sie an, ob sich die Trafficabfrage auf einen Zeitraum innerhalb eines Tages("day"), eines Monats("month") oder eines Jahres("year") bezieht. Möchten Sie zum Beispiel den Trafficverbrauch für eine oder mehrere Stunden innerhalb eines Tages abfragen, verwenden Sie "day". Möchten Sie die Tagessumme oder die Summe mehrerer Tage innerhalb eines Monats ermitteln, verwenden Sie "month". Und für die Abfrage von Monatssummen innerhalb eines Jahres ist "year" die richtige Abfrage-Art.

Bitte beachten Sie, dass Stunden-, Tages- und Monatssummen erst nach Ablauf der/des entsprechenden Stunde, Tages bzw. Monats verfügbar sind.

Das Abfrage-Intervall können sie mit den Parametern "from" und "to" angeben. Die Syntax dieser Paramater ist wie folgt:

* Abfrage-Typ "day":   [YYYY]-[MM]-[DD]T[H], z.B. 2010-09-01T00
* Abfrage-Typ "month": [YYYY]-[MM]-[DD], z.B. 2010-09-01
* Abfrage-Typ "year":  [YYYY]-[MM], z.B. 2010-09

Bei dem Abfrage-Typ "day" wird das Datum zusammen mit der Stunde angegeben. Der Stundenwert wird vom Datum mit dem Buchstaben "T" getrennt. Beim Anfrage-Typ "month" darf der Stundenwert nicht mit angegeben werden, da Sie hier den Zeitraum nur tagesbasiert angeben können. Bei dem Typ "year" fällt zusätzlich noch der Tageswert weg, da Sie hier den Zeitraum innerhalb eines Jahres monatsbasiert angeben.

Wenn für die ausgewählten IP-Adressen und Subnetze kein Traffic angefallen ist, werden diese in der Antwort nicht angezeigt.

Eingabe

ip[] Eine oder mehrere IP-Adressen
subnet[] Eine oder mehrere Subnetz-Adressen
from Datum/Zeit von
to Datum/Zeit bis
type Abfrage-Typ (day,month,year)

Ausgabe

traffic (Object)
type (String) Abfrage-Typ
from (String) Datum/Zeit von
to (String) Datum/Zeit bis
data (Object)
IP-Adresse (Object)
in Traffic eingehend (GB)
out Traffic ausgehend (GB)
sum Traffic Summe (GB)

Fehler

Status Code Beschreibung
400 INVALID_INPUT Fehlerhafte Eingabeparameter
404 NOT_FOUND Keine IP-Adressen oder Subnetze gefunden
500 INTERNAL_ERROR Das Abfragen des Traffic ist aufgrund eines internen Fehlers fehlgeschlagen

Beispiel

Abfragen der Traffic-Daten für eine IP-Adresse

curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&from=2010-09-01&to=2010-09-31&ip=123.123.123.123'
{
 "traffic": {
   "type": "month",
   "from": "2010-09-01",
   "to":"2010-09-31",
   "data": {
     "123.123.123.123": {
       "in":0.2874,
       "out":0.0481,
       "sum":0.3355
     }
   }
 }

}

Abfragen der Traffic-Daten für mehrere IP-Adressen

curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&from=2010-09-01&to=2010-09-31&ip[]=123.123.123.123&ip[]=124.124.124.124'
{
 "traffic": {
   "type": "month",
   "from": "2010-09-01",
   "to":"2010-09-31",
   "data": {
     "123.123.123.123": {
       "in":0.2874,
       "out":0.0481,
       "sum":0.3355
     },
     "124.124.124.124": {
       "in":0.2874,
       "out":0.0481,
       "sum":0.3355
     }
   }
 }

}

Abfragen der Traffic-Daten für ein Subnetz

curl -u login:password https://robot-ws.your-server.de/traffic -d 'type=month&from=2010-09-01&to=2010-09-31&subnet=2a01:4f8:61:41a2::'
{
 "traffic": {
   "type": "month",
   "from": "2010-09-01",
   "to":"2010-09-31",
   "data": {
     "2a01:4f8:61:41a2::2": {
       "in":0.2874,
       "out":0.0481,
       "sum":0.3355
     },
     "2a01:4f8:61:41a2::3": {
       "in":0.2874,
       "out":0.0481,
       "sum":0.3355
     }
   }
 }

}

PHP Client

Unter https://robot.your-server.de/downloads/robot-client.zip steht eine PHP5-Klasse zum Herunterladen zur Verfügung. Die Klasse verwendet libcurl.

Beispiel

require 'RobotClient.class.php';

$robot = new RobotClient('https://robot-ws.your-server.de', 'login', 'password');

// Abrufen aller Failover-IPs
$results = $robot->failoverGet();

foreach ($results as $result)
{
  echo $result->failover->ip . "\n";
  echo $result->failover->server_ip . "\n";
  echo $result->failover->active_server_ip . "\n";
}

// Abrufen einer bestimmten Failover-IP
$result = $robot->failoverGet('123.123.123.123');

echo $result->failover->ip . "\n";
echo $result->failover->server_ip . "\n";
echo $result->failover->active_server_ip . "\n";

// Umrouten einer Failover-IP
try
{
  $robot->failoverRoute('123.123.123.123', '213.133.104.190');
}
catch (RobotClientException $e)
{
  echo $e->getMessage() . "\n";
}


© 2020. Hetzner Online GmbH. Alle Rechte vorbehalten.