API Reference

Die ccloud Customer API steuert Server, Netzwerk, Snapshots und mehr — programmatisch über REST. Wählen Sie oben rechts in den Code-Blöcken Ihre Sprache.

Hinweis

Base URL: https://ccenter.centron.de/api/v1 — Authentifizierung per OAuth2 Client Credentials (Token-URL: /oauth/token).

Alle 110 Endpunkte in 31 Sektionen sind vollständig dokumentiert — mit Code-Beispielen in vier Sprachen, Parametern, Beispiel-Responses und Response-Übersichten. Die 80 Datenmodelle finden Sie aufklappbar unter Schemas.

OAuth

Neues Token generieren #

POST/oauth/token

curl --request POST \
  --url https://ccenter.centron.de/api/v1/oauth/token \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"grant_type": "client_credentials", "client_id": "90f63c80-bd90-89a3-4632-b16c4ab909ae", "client_secret": "GsqCDfjYUCceU8dTq1vQWxLnnRaf6UySWP7GAgI", "scope": "*"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"grant_type\": \"client_credentials\", \"client_id\": \"90f63c80-bd90-89a3-4632-b16c4ab909ae\", \"client_secret\": \"GsqCDfjYUCceU8dTq1vQWxLnnRaf6UySWP7GAgI\", \"scope\": \"*\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/oauth/token", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/oauth/token",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"grant_type\": \"client_credentials\", \"client_id\": \"90f63c80-bd90-89a3-4632-b16c4ab909ae\", \"client_secret\": \"GsqCDfjYUCceU8dTq1vQWxLnnRaf6UySWP7GAgI\", \"scope\": \"*\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/oauth/token' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"grant_type": "client_credentials", "client_id": "90f63c80-bd90-89a3-4632-b16c4ab909ae", "client_secret": "GsqCDfjYUCceU8dTq1vQWxLnnRaf6UySWP7GAgI", "scope": "*"}'

Body-Parameter

JSON

{
  "grant_type": "client_credentials",
  "client_id": "90f63c80-bd90-89a3-4632-b16c4ab909ae",
  "client_secret": "GsqCDfjYUCceU8dTq1vQWxLnnRaf6UySWP7GAgI",
  "scope": "*"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
body	body	OAuth	ja	–

Beispiel-Response 200

JSON

{
  "token_type": "Bearer",
  "expires_in": 31536000,
  "access_token": "eyJhbGciOiJIUzI1…"
}

Responses

Status	Beschreibung	Schema
200	Success	`OAuthResponse`
400	Invalid parameters	`OAuthBadRequestResponse`
401	Unauthorized	`OAuthUnauthorizedResponse`

Authentifizierung: oAuth2ClientCredentials

Servers

Alle Server des Kunden abrufen #

GET/ccloud/servers

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
tag	query	string	nein	Nur Server mit diesem Tag
limit	query	integer	nein	Max. Anzahl Ergebnisse
page	query	integer	nein	Seite (Pagination)
search	query	string	nein	Suche über hostname, os_name, ip_addresses, tags
build_in_progress	query	boolean	nein	Nur Server im Aufbau
deletion_in_progress	query	boolean	nein	Nur Server in Löschung
sort	query	string	nein	Spalten zum Sortieren (Komma-Liste)
order	query	string	nein	Sortierreihenfolge (Komma-Liste)

Beispiel-Response 200

JSON

{
  "data": [
    {
      "id": 0,
      "customer_id": "string",
      "project_id": 0,
      "hostname": "string",
      "generation": 0,
      "created_at": "2019-08-24",
      "tags": [
        "string"
      ],
      "location": "string",
      "custom_name": "string",
      "credentials_available": true,
      "deletion_in_progress": true,
      "build_in_progress": true,
      "rootaccess": true,
      "network_adapters": [
        {
          "id": "497f6eca-…",
          "vlan_number": 0,
          "bandwidth": 0,
          "mac_address": "string",
          "ip_addresses": [
            {
              "ip": "string",
              "subnet": {
                "type": "IPv4",
                "network": "string",
                "gateway": "string",
                "mask_bits": 0
              }
            }
          ]
        }
      ],
      "data": {
        "cores": 0,
        "memory": 0,
        "disk": 0,
        "pool": "string",
        "type": "unmanaged",
        "os_name": "string",
        "ostype": "Windows",
        "addons": [
          {
            "name": "string",
            "count": 0
          }
        ]
      }
    }
  ]
}

Responses

Status	Beschreibung	Schema
200	Success	`Server[]`

Authentifizierung: oAuth2ClientCredentials

Neuen Server erstellen #

POST/ccloud/servers

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"project_id": 0, "pool": "string", "hostname": "string", "description": "string", "cores": 0, "memory": 0, "disks": [0], "image": "string", "custom_name": "string", "password": "string", "ssh_keys": ["ssh-ed25519 AAAAC3NzaC1lZ..."], "user_data": "#cloud-config\nruncmd:\n- [touch, /root/cloud-init-worked]\n", "type": "managed", "addons": [{"name": "string", "count": 0}], "subnets": [0], "subnets_intern": [0], "tags": ["string"], "rollouts": ["string"]}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"project_id\": 0, \"pool\": \"string\", \"hostname\": \"string\", \"description\": \"string\", \"cores\": 0, \"memory\": 0, \"disks\": [0], \"image\": \"string\", \"custom_name\": \"string\", \"password\": \"string\", \"ssh_keys\": [\"ssh-ed25519 AAAAC3NzaC1lZ...\"], \"user_data\": \"#cloud-config\nruncmd:\n- [touch, /root/cloud-init-worked]\n\", \"type\": \"managed\", \"addons\": [{\"name\": \"string\", \"count\": 0}], \"subnets\": [0], \"subnets_intern\": [0], \"tags\": [\"string\"], \"rollouts\": [\"string\"]}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/servers", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"project_id\": 0, \"pool\": \"string\", \"hostname\": \"string\", \"description\": \"string\", \"cores\": 0, \"memory\": 0, \"disks\": [0], \"image\": \"string\", \"custom_name\": \"string\", \"password\": \"string\", \"ssh_keys\": [\"ssh-ed25519 AAAAC3NzaC1lZ...\"], \"user_data\": \"#cloud-config\nruncmd:\n- [touch, /root/cloud-init-worked]\n\", \"type\": \"managed\", \"addons\": [{\"name\": \"string\", \"count\": 0}], \"subnets\": [0], \"subnets_intern\": [0], \"tags\": [\"string\"], \"rollouts\": [\"string\"]}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"project_id": 0, "pool": "string", "hostname": "string", "description": "string", "cores": 0, "memory": 0, "disks": [0], "image": "string", "custom_name": "string", "password": "string", "ssh_keys": ["ssh-ed25519 AAAAC3NzaC1lZ..."], "user_data": "#cloud-config\nruncmd:\n- [touch, /root/cloud-init-worked]\n", "type": "managed", "addons": [{"name": "string", "count": 0}], "subnets": [0], "subnets_intern": [0], "tags": ["string"], "rollouts": ["string"]}'

Body-Parameter

JSON

{
  "project_id": 0,
  "pool": "string",
  "hostname": "string",
  "description": "string",
  "cores": 0,
  "memory": 0,
  "disks": [
    0
  ],
  "image": "string",
  "custom_name": "string",
  "password": "string",
  "ssh_keys": [
    "ssh-ed25519 AAAAC3NzaC1lZ..."
  ],
  "user_data": "#cloud-config\nruncmd:\n- [touch, /root/cloud-init-worked]\n",
  "type": "managed",
  "addons": [
    {
      "name": "string",
      "count": 0
    }
  ],
  "subnets": [
    0
  ],
  "subnets_intern": [
    0
  ],
  "tags": [
    "string"
  ],
  "rollouts": [
    "string"
  ]
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
body	body	DeploymentCreateRequest	ja	–

Beispiel-Response 200

JSON

{
  "id": 0
}

Responses

Status	Beschreibung	Schema
200	OK	`DeploymentCreateRequestSuccess`
422	Validation-Failure	`–`

Authentifizierung: oAuth2ClientCredentials

Server-Details per Hostname #

GET/ccloud/servers/{hostname}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers

Beispiel-Response 200

JSON

{
  "id": 0,
  "hostname": "string",
  "custom_name": "string",
  "tags": [
    "string"
  ],
  "location": "string",
  "rootaccess": true,
  "data": {
    "cores": 0,
    "memory": 0,
    "disk": 0,
    "pool": "string",
    "os_name": "string"
  },
  "custom_price": true
}

Responses

Status	Beschreibung	Schema
200	Success	`ServerDetailInclCustomPriceFlag`

Authentifizierung: oAuth2ClientCredentials

Virtuelle Maschine löschen #

DELETE/ccloud/servers/{hostname}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"hostname": "string"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"hostname\": \"string\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("DELETE", "/api/v1/ccloud/servers/vs10000", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => "{\"hostname\": \"string\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000' -Method DELETE -Headers $headers -ContentType 'application/json' -Body '{"hostname": "string"}'

Body-Parameter

JSON

{
  "hostname": "string"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
body	body	DeleteRequest	ja	–

Beispiel-Response 200

JSON

{
  "id": 0
}

Responses

Status	Beschreibung	Schema
200	Task-ID des Lösch-Tasks	`TaskID`
422	Validation-Failure	`–`

Authentifizierung: oAuth2ClientCredentials

Alle Tasks eines Servers #

GET/ccloud/servers/{hostname}/tasks

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/tasks \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/tasks", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/tasks' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
action	query	string	nein	Nach Aktion filtern
status	query	string	nein	Nach Status filtern (processing, failed, done)
search	query	string	nein	Wildcard-Suche
limit	query	integer	nein	Max. Anzahl
page	query	integer	nein	Seite
sort	query	string	nein	Sortierspalten
order	query	string	nein	Sortierreihenfolge

Beispiel-Response 200

JSON

[
  {
    "id": 0,
    "action": "create-server",
    "customer_id": "string",
    "username": "string",
    "hostname": "string",
    "status": "processing",
    "error_message": "string",
    "created_at": "2019-08-24T14:15:22Z"
  }
]

Responses

Status	Beschreibung	Schema
200	Task-Liste des Servers	`TasksGetStatus[]`

Authentifizierung: oAuth2ClientCredentials

Server-Passwort abrufen #

GET/ccloud/servers/{hostname}/password

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/password \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/password", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/password",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/password' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers

Beispiel-Response 200

JSON

[
  {
    "username": "string",
    "password": "string"
  }
]

Responses

Status	Beschreibung	Schema
200	Zugangsdaten des Servers	`getPassword[]`

Authentifizierung: oAuth2ClientCredentials

Server Actions

Server neu installieren #

POST/ccloud/servers/{hostname}/redeploy

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/redeploy \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"image": "string", "password": "string", "ssh_keys": ["ssh-ed25519 AAAAC3NzaC1lZ..."]}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"image\": \"string\", \"password\": \"string\", \"ssh_keys\": [\"ssh-ed25519 AAAAC3NzaC1lZ...\"]}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/servers/vs10000/redeploy", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/redeploy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"image\": \"string\", \"password\": \"string\", \"ssh_keys\": [\"ssh-ed25519 AAAAC3NzaC1lZ...\"]}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/redeploy' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"image": "string", "password": "string", "ssh_keys": ["ssh-ed25519 AAAAC3NzaC1lZ..."]}'

Body-Parameter

JSON

{
  "image": "string",
  "password": "string",
  "ssh_keys": [
    "ssh-ed25519 AAAAC3NzaC1lZ..."
  ]
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
body	body	RedeployRequest	ja	–

Beispiel-Response 200

JSON

{
  "id": 0,
  "job_id": "string",
  "action": "string"
}

Responses

Status	Beschreibung	Schema
200	OK	`TaskResponse`
422	Validation-Failure	`ValidationFailure`

Authentifizierung: oAuth2ClientCredentials

Custom Name setzen #

PUT/ccloud/servers/{hostname}/customname

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/customname \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/customname", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/customname",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/customname' -Method PUT -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
name	body	string	nein	Custom Name (leer = vorhandenen Namen löschen)

Responses

Status	Beschreibung	Schema
204	Custom Name erfolgreich gesetzt	`–`

Authentifizierung: oAuth2ClientCredentials

Server Resize

RAM eines Servers ändern #

PUT/ccloud/servers/{hostname}/memory

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/memory \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"memory": 0}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"memory\": 0}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/memory", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/memory",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"memory\": 0}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/memory' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"memory": 0}'

Body-Parameter

JSON

{
  "memory": 0
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
body	body	ServerResizeMemoryRequest	ja	–

Beispiel-Response 200

JSON

{
  "id": 0
}

Responses

Status	Beschreibung	Schema
200	Task-ID des Resize-Tasks	`TaskID`

Authentifizierung: oAuth2ClientCredentials

Cores eines Servers ändern #

PUT/ccloud/servers/{hostname}/cores

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/cores \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"cores": 0}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"cores\": 0}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/cores", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/cores",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"cores\": 0}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/cores' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"cores": 0}'

Body-Parameter

JSON

{
  "cores": 0
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
body	body	ServerResizeCoresRequest	ja	–

Beispiel-Response 200

JSON

{
  "id": 0
}

Responses

Status	Beschreibung	Schema
200	Task-ID des Resize-Tasks	`TasksGetCoresStatus`

Authentifizierung: oAuth2ClientCredentials

Server Addons

Addon für Server einrichten #

PUT/ccloud/servers/{hostname}/addons/{addon}

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/addons/cprotect \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"count": 0, "description": null}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"count\": 0, \"description\": null}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/addons/cprotect", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/addons/cprotect",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"count\": 0, \"description\": null}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/addons/cprotect' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"count": 0, "description": null}'

Body-Parameter

JSON

{
  "count": 0,
  "description": null
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
addon	path	string	ja	Name des Addons (z. B. cprotect)
count	body	integer	nein	Anzahl

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

Addon eines Servers löschen #

DELETE/ccloud/servers/{hostname}/addons/{addon}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/addons/cprotect \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/servers/vs10000/addons/cprotect", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/addons/cprotect",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/addons/cprotect' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
addon	path	string	ja	Name des Addons

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

Server ISO

Verfügbare ISOs des Servers #

GET/ccloud/servers/{hostname}/isos

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/isos \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/isos", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/isos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/isos' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers

Beispiel-Response 200

JSON

{
  "name": "string",
  "fullName": "string",
  "customer": "string",
  "size": 0
}

Responses

Status	Beschreibung	Schema
200	Alle ISOs	`GetISOs`

Authentifizierung: oAuth2ClientCredentials

Server State

Zustand eines Servers abrufen #

GET/ccloud/servers/{hostname}/state

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/state \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/state", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/state",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/state' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers

Beispiel-Response 200

JSON

{
  "state": "Running"
}

Responses

Status	Beschreibung	Schema
200	OK (Running, Paused, Reset, Saved, Off, Critical)	`–`

Authentifizierung: oAuth2ClientCredentials

Zustand eines Servers ändern #

POST/ccloud/servers/{hostname}/state/{action}

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/state/start \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("POST", "/api/v1/ccloud/servers/vs10000/state/start", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/state/start",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/state/start' -Method POST -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
action	path	string	ja	start, stop, shutdown, shutdown-force, reset

Beispiel-Response 200

JSON

{
  "id": 32
}

Responses

Status	Beschreibung	Schema
200	Task-ID	`–`

Authentifizierung: oAuth2ClientCredentials

Console

Konsolen-URL eines Servers #

GET/ccloud/servers/{hostname}/console

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/console \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/console", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/console",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/console' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
layout	query	string	nein	Tastaturlayout für die Konsole

Beispiel-Response 200

JSON

{
  "url": "string"
}

Responses

Status	Beschreibung	Schema
200	Neu generierte Konsolen-URL	`Console`

Authentifizierung: oAuth2ClientCredentials

Server DVD Drives

DVD-Laufwerke abrufen #

GET/ccloud/servers/{hostname}/dvds

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/dvds", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers

Beispiel-Response 200

JSON

[
  {
    "id": "string",
    "path": "string"
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`VMDVDModel[]`

Authentifizierung: oAuth2ClientCredentials

Neues DVD-Laufwerk hinzufügen #

POST/ccloud/servers/{hostname}/dvds

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("POST", "/api/v1/ccloud/servers/vs10000/dvds", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds' -Method POST -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
name	body	string	ja	Dateiname des ISO-Images

Beispiel-Response 200

JSON

[]

Responses

Status	Beschreibung	Schema
200	OK	`–`

Authentifizierung: oAuth2ClientCredentials

DVD-Laufwerk aktualisieren #

PUT/ccloud/servers/{hostname}/dvds/{id}

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds/sc0s1 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/dvds/sc0s1", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds/sc0s1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds/sc0s1' -Method PUT -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
id	path	string	ja	ID des DVD-Laufwerks
name	body	string	ja	Dateiname des ISO-Images

Beispiel-Response 200

JSON

[
  {
    "id": 0,
    "data": [
      {
        "id": "string",
        "name": "string",
        "path": "string",
        "hostname": "string"
      }
    ]
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`UpdateDVDTaskResponse[]`

Authentifizierung: oAuth2ClientCredentials

DVD-Laufwerk löschen #

DELETE/ccloud/servers/{hostname}/dvds/{id}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds/sc0s0 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/servers/vs10000/dvds/sc0s0", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds/sc0s0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/dvds/sc0s0' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
id	path	string	ja	ID des DVD-Laufwerks

Beispiel-Response 200

JSON

{
  "id": 0
}

Responses

Status	Beschreibung	Schema
200	OK	`DeleteDVDTaskResponse`

Authentifizierung: oAuth2ClientCredentials

Server Disks

Disks eines Servers abrufen #

GET/ccloud/servers/{hostname}/disks

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/disks", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers

Beispiel-Response 200

JSON

[
  {
    "id": "string",
    "size": 0,
    "perfCounterInstancename": "string"
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`VMDiskModel[]`

Authentifizierung: oAuth2ClientCredentials

Neue Disk hinzufügen #

POST/ccloud/servers/{hostname}/disks

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"size": 0}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"size\": 0}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/servers/vs10000/disks", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"size\": 0}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"size": 0}'

Body-Parameter

JSON

{
  "size": 0
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
size	body	integer	ja	Größe in Bytes

Beispiel-Response 200

JSON

{
  "id": 0,
  "job_id": "string",
  "action": "string"
}

Responses

Status	Beschreibung	Schema
200	OK	`TaskResponse`

Authentifizierung: oAuth2ClientCredentials

Disk aktualisieren #

PUT/ccloud/servers/{hostname}/disks/{id}

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks/sc0s0 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"size": 50}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"size\": 50}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/disks/sc0s0", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks/sc0s0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"size\": 50}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks/sc0s0' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"size": 50}'

Body-Parameter

JSON

{
  "size": 50
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
id	path	string	ja	ID der Disk
body	body	VMDiskUpdateModel	ja	–

Beispiel-Response 200

JSON

{
  "id": 0
}

Responses

Status	Beschreibung	Schema
200	OK	`UpdateTaskResponse`

Authentifizierung: oAuth2ClientCredentials

Disk löschen #

DELETE/ccloud/servers/{hostname}/disks/{id}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks/sc0s0 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/servers/vs10000/disks/sc0s0", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks/sc0s0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/disks/sc0s0' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
id	path	string	ja	ID der Disk

Beispiel-Response 200

JSON

{
  "id": 0,
  "job_id": "string",
  "action": "string"
}

Responses

Status	Beschreibung	Schema
200	OK	`TaskResponse`
422	Validation-Failure	`ValidationFailure`

Authentifizierung: oAuth2ClientCredentials

Network

Subnetze des Kunden #

GET/ccloud/network/subnets

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/network/subnets \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/network/subnets", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/network/subnets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/network/subnets' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "id": 2,
    "type": "IPv4",
    "name": "string",
    "network": "192.168.232.0",
    "gateway": "192.168.232.1",
    "mask_bits": 24,
    "nameservers": [
      [
        "192.168.232.1"
      ]
    ]
  }
]

Responses

Status	Beschreibung	Schema
200	Liste der Subnetze	`NetworkSubnets`

Authentifizierung: oAuth2ClientCredentials

IPs eines Subnetzes #

GET/ccloud/network/subnets/{id}/ips

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/network/subnets/2/ips \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/network/subnets/2/ips", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/network/subnets/2/ips",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/network/subnets/2/ips' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	string	ja	ID des Subnetzes

Beispiel-Response 200

JSON

[
  {
    "id": 0,
    "server_id": 0,
    "subnet_id": 0,
    "ip": "255.255.255.0",
    "hostname": "string",
    "created_at": "2019-08-24T14:15:22Z"
  }
]

Responses

Status	Beschreibung	Schema
200	IPs des Subnetzes	`NetworkIP[]`

Authentifizierung: oAuth2ClientCredentials

Alle IPs des Kunden #

GET/ccloud/network/ips

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/network/ips \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/network/ips", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/network/ips",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/network/ips' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "hostname": "ts1000",
    "ip": "1.1.1.1",
    "subnetname": "VLAN_1"
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`NetworkIPs[]`

Authentifizierung: oAuth2ClientCredentials

VPCs des Kunden #

GET/ccloud/network/vpcs

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/network/vpcs \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/network/vpcs", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/network/vpcs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/network/vpcs' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "id": "string",
    "type": "public",
    "name": "string",
    "subnets": [
      {
        "id": 2,
        "type": "IPv4",
        "network": "192.168.232.0",
        "gateway": "192.168.232.1",
        "mask_bits": 24
      }
    ]
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`NetworkVPC[]`

Authentifizierung: oAuth2ClientCredentials

Netzwerk-Adapter eines Servers #

GET/ccloud/servers/{hostname}/network

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/network \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/network", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/network",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/network' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers

Beispiel-Response 200

JSON

[
  {
    "id": "string",
    "switch": "string",
    "vlan": 0,
    "mac_spoofing": true,
    "bandwith": 0,
    "ipAdresse": [
      "string"
    ]
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`VMNetModel[]`

Authentifizierung: oAuth2ClientCredentials

Neue IP zum Adapter hinzufügen #

POST/ccloud/servers/{hostname}/network/{adapter_id}/ip

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/network/a1b2/ip \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"protocol": "IPv4"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"protocol\": \"IPv4\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/servers/vs10000/network/a1b2/ip", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/network/a1b2/ip",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"protocol\": \"IPv4\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/network/a1b2/ip' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"protocol": "IPv4"}'

Body-Parameter

JSON

{
  "protocol": "IPv4"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname des Servers
adapter_id	path	string	ja	ID des Netzwerk-Adapters
body	body	VMNetworkAddIPRequest	ja	–

Beispiel-Response 200

JSON

{
  "type": "IPv6",
  "ip_address": "2a00:6140:a000:72::b",
  "network": "2a00:6140:a000:72::",
  "mask_bits": 64,
  "nameservers": [
    "2a00:6140:a000:72::1"
  ],
  "gateway": "2a00:6140:a000:72::1",
  "vlan": 708
}

Responses

Status	Beschreibung	Schema
200	Neue IP-Zuweisung	`VMNetworkAddIPResponse`

Authentifizierung: oAuth2ClientCredentials

Scheduled Snapshots

Get scheduled Snapshots #

GET/ccloud/servers/{hostname}/snapshots/scheduled

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/snapshots/scheduled", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.

Beispiel-Response 200

JSON

{
  "frequency": 3,
  "next_run": "2023-11-30 15:00"
}

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Creates a scheduler for automatic snapshots #

POST/ccloud/servers/{hostname}/snapshots/scheduled

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"frequency": 3, "next_run": "2023-11-30 15:00"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"frequency\": 3, \"next_run\": \"2023-11-30 15:00\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/servers/vs10000/snapshots/scheduled", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"frequency\": 3, \"next_run\": \"2023-11-30 15:00\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"frequency": 3, "next_run": "2023-11-30 15:00"}'

Body-Parameter

JSON

{
  "frequency": 3,
  "next_run": "2023-11-30 15:00"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.
body	body	#/paths/~1ccloud~1servers~1%7Bhostname%7D~1snapshots~1scheduled/get/responses/200/content/application~1json/schema	ja	–

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

Delete Scheduler for automatic snapshots #

DELETE/ccloud/servers/{hostname}/snapshots/scheduled

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/servers/vs10000/snapshots/scheduled", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/scheduled' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

Snapshots

Get the snapshots of a server by its hostname. #

GET/ccloud/servers/{hostname}/snapshots

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/snapshots", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.

Beispiel-Response 200

JSON

[
  {
    "id": "string",
    "name": "string",
    "active": true,
    "creationTime": "2019-08-24T14:15:22Z",
    "parentSnapshotId": "string"
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Create a new Snapshot #

POST/ccloud/servers/{hostname}/snapshots

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"name": "string"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"name\": \"string\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/servers/vs10000/snapshots", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"name\": \"string\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"name": "string"}'

Body-Parameter

JSON

{
  "name": "string"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.
body	body	ServerCreateSnapshotRequest	ja	–

Beispiel-Response 200

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 0
  },
  "data": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "string"
        },
        "hostname": {
          "type": "string",
          "example": "string",
          "description": "Hostname of the Server"
        },
        "customer_id": {
          "type": "string",
          "example": "string",
          "description": "Customer ID submitting the request."
        },
        "username": {
          "type": "string",
          "example": "string",
          "description": "Username submitting the request."
        }
      }
    }
  }
}

Responses

Status	Beschreibung	Schema
200	Task ID of Create Snapshots Task	`AddedSnapshotTaskResponse`

Authentifizierung: oAuth2ClientCredentials

Restore (apply) a snapshot on the Server #

POST/ccloud/servers/{hostname}/snapshots/{id}

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("POST", "/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099' -Method POST -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.
id	path	string	ja	id of the snapshot

Beispiel-Response 200

JSON

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": null,
    "id": {
      "type": "integer",
      "example": 0
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "string"
          },
          "hostname": {
            "type": "string",
            "example": "string",
            "description": "Hostname of the Server"
          },
          "customer_id": {
            "type": "string",
            "example": "string",
            "description": "Customer ID submitting the request."
          },
          "username": {
            "type": "string",
            "example": "string",
            "description": "Username submitting the request."
          }
        }
      }
    }
  }
}

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Rename a Snapshot #

PUT/ccloud/servers/{hostname}/snapshots/{id}

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"name": "string"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"name\": \"string\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"name\": \"string\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"name": "string"}'

Body-Parameter

JSON

{
  "name": "string"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.
id	path	string	ja	id of the snapshot
body	body	ServerRenameSnapshotRequest	ja	–

Beispiel-Response 200

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 0
  },
  "data": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "example": "string"
        },
        "name": {
          "type": "string",
          "example": "string"
        },
        "hostname": {
          "type": "string",
          "example": "string",
          "description": "Hostname of the Server"
        },
        "customer_id": {
          "type": "string",
          "example": "string",
          "description": "Customer ID submitting the request."
        },
        "username": {
          "type": "string",
          "example": "string",
          "description": "Username submitting the request."
        }
      }
    }
  }
}

Responses

Status	Beschreibung	Schema
200	Task ID of rename Snapshots Task	`RenameSnapshotTaskResponse`

Authentifizierung: oAuth2ClientCredentials

Delete a snapshot on the Server #

DELETE/ccloud/servers/{hostname}/snapshots/{id}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/snapshots/51c1d831-784b-4550-8c54-a2ced31b5099' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.
id	path	string	ja	id of the snapshot

Beispiel-Response 200

JSON

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": null,
    "id": {
      "type": "integer",
      "example": 0
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "string"
          },
          "hostname": {
            "type": "string",
            "example": "string",
            "description": "Hostname of the Server"
          },
          "customer_id": {
            "type": "string",
            "example": "string",
            "description": "Customer ID submitting the request."
          },
          "username": {
            "type": "string",
            "example": "string",
            "description": "Username submitting the request."
          }
        }
      }
    }
  }
}

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Performance

Get the Performance Data of a server by its hostname. #

GET/ccloud/servers/{hostname}/performance/{resource}/{period}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/performance/mem/year \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/performance/mem/year", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/performance/mem/year",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/performance/mem/year' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.
resource	path	string	ja	Type of the Resource to get performance Data
period	path	string	ja	Time period to get performance data for.

Beispiel-Response 200

JSON

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": null,
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "units": {
            "type": "integer",
            "format": "string",
            "example": "Byte/s",
            "description": "The Units of the Performance Data given back"
          },
          "perfdata": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "send_persec": {
                  "type": "integer",
                  "example": 54,
                  "description": "Example of Performance Data given back, this elements can change depending on what data is requested"
                }
              }
            }
          }
        }
      }
    }
  }
}

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Bootorder

Get the Bootorder of a server by its hostname. #

GET/ccloud/servers/{hostname}/bootorder

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/bootorder \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/bootorder", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/bootorder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/bootorder' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.

Beispiel-Response 200

JSON

[
  {
    "id": 1,
    "type": "DVD",
    "bootDevice": "sc0s1"
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Change the Bootorder of a server by its hostname. #

PUT/ccloud/servers/{hostname}/bootorder

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/bootorder \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"type": "object", "properties": null, "id": {"type": "integer", "example": 2}}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"type\": \"object\", \"properties\": null, \"id\": {\"type\": \"integer\", \"example\": 2}}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/bootorder", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/bootorder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"type\": \"object\", \"properties\": null, \"id\": {\"type\": \"integer\", \"example\": 2}}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/bootorder' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"type": "object", "properties": null, "id": {"type": "integer", "example": 2}}'

Body-Parameter

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 2
  }
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.
body	body	changeBootOrderRequest	ja	–

Beispiel-Response 200

JSON

{
  "id": 0,
  "job_id": "string",
  "action": "string"
}

Responses

Status	Beschreibung	Schema
200	OK	`TaskResponse`

Authentifizierung: oAuth2ClientCredentials

Server Notes

Notes for this Server #

PUT/ccloud/servers/{hostname}/notes

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/notes \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"notes": "This is my Database Server"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"notes\": \"This is my Database Server\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/servers/vs10000/notes", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/notes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"notes\": \"This is my Database Server\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/notes' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"notes": "This is my Database Server"}'

Body-Parameter

JSON

{
  "notes": "This is my Database Server"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.
body	body	ServerNotesRequest	ja	–

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

delete Notes for this Server #

DELETE/ccloud/servers/{hostname}/notes

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/notes \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/servers/vs10000/notes", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/notes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/notes' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

GPUs

Get all GPU Models with its current availability. #

GET/ccloud/gpus

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/gpus \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/gpus", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/gpus",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/gpus' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "id": 1,
    "name": "AMD Barco MXRT 5450 1024 MB BIOS",
    "addon_name": "gpu_amd_barco_mxrt_5450_1024mb_bios",
    "pools": [
      "pool_iw3_ssd_gpu"
    ],
    "desc_de": "AMD Barco MXRT 5450 1024 MB BIOS",
    "desc_en": "AMD Barco MXRT 5450 1024 MB BIOS"
  }
]

Responses

Status	Beschreibung	Schema
200	Success	`Inline`

Authentifizierung: oAuth2ClientCredentials

Get all available GPU Models for a server. #

GET/ccloud/servers/{hostname}/gpus

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/gpus \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/servers/vs10000/gpus", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/gpus",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/servers/vs10000/gpus' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
hostname	path	string	ja	Hostname of the server.

Beispiel-Response 200

JSON

[
  {
    "name": "AMD Barco MXRT 5450 1024 MB BIOS",
    "addon_name": "gpu_amd_barco_mxrt_5450_1024mb_bios",
    "desc_de": "AMD Barco MXRT 5450 1024 MB BIOS",
    "desc_en": "AMD Barco MXRT 5450 1024 MB BIOS",
    "count": 1
  }
]

Responses

Status	Beschreibung	Schema
200	Success	`Inline`

Authentifizierung: oAuth2ClientCredentials

Tasks

Get all tasks for the given customer. #

GET/ccloud/tasks

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/tasks \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/tasks", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/tasks' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
action	query	string	nein	Filter by action
status	query	string	nein	Filter by status
search	query	string	nein	Search for server by hostname or error_message
limit	query	integer	nein	Limit results
page	query	integer	nein	Page Number for Pagination
sort	query	string	nein	Comma-separated list of the columns to sort by.
order	query	string	nein	Comma-separated list of order instructions.

Beispiel-Response 200

JSON

[
  {
    "id": 0,
    "action": "create-server",
    "customer_id": "string",
    "username": "string",
    "hostname": "string",
    "status": "processing",
    "error_message": "string",
    "created_at": "2019-08-24T14:15:22Z"
  }
]

Responses

Status	Beschreibung	Schema
200	Array of tasks belonging to the given customer.	`Inline`

Authentifizierung: oAuth2ClientCredentials

Get a Task by id. #

GET/ccloud/tasks/{id}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/tasks/1 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/tasks/1", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/tasks/1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/tasks/1' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	id of the Task.

Beispiel-Response 200

JSON

{
  "id": 0,
  "action": "create-server",
  "customer_id": "string",
  "username": "string",
  "hostname": "string",
  "status": "processing",
  "error_message": "string",
  "created_at": "2019-08-24T14:15:22Z"
}

Responses

Status	Beschreibung	Schema
200	Status of Task with details.	`TasksGetStatus`

Authentifizierung: oAuth2ClientCredentials

Pools

Get a list of all public pools and your personal pools. #

GET/ccloud/pools

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/pools \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/pools", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/pools",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/pools' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
inactive	query	boolean	nein	Inaktive Pools mit einbeziehen.

Beispiel-Response 200

JSON

[
  {
    "gpu_supported": true,
    "tag": "string",
    "name": "string",
    "desc_de": "string",
    "desc_en": "string"
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Get a single pool by its tag. #

GET/ccloud/pools/{tag}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/pools/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/pools/", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/pools/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/pools/' -Method GET -Headers $headers

Beispiel-Response 200

JSON

{
  "gpu_supported": true,
  "tag": "string",
  "name": "string",
  "desc_de": "string",
  "desc_en": "string"
}

Responses

Status	Beschreibung	Schema
200	OK	`Pool`

Authentifizierung: oAuth2ClientCredentials

Get a list of all Tiers. #

GET/ccloud/tiers

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/tiers \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/tiers", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/tiers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/tiers' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
inactive	query	boolean	nein	Inaktive Pools mit einbeziehen.

Beispiel-Response 200

JSON

[
  {
    "active": true,
    "name": "string",
    "tag": "string",
    "gpu_supported": true
  }
]

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Subscription

Returns all subscriptions of a customer #

GET/ccloud/customers/subscriptions

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/subscriptions \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/customers/subscriptions", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/subscriptions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/subscriptions' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
limit	query	integer	nein	Limits results to the specified amount
page	query	integer	nein	Page Number for Pagination
search	query	string	nein	wildcard search filter
sort	query	string	nein	Comma-separated list of the columns to sort by.
order	query	string	nein	Comma-separated list of order instructions.
include	query	string	nein	Include additional information in response.

Beispiel-Response 200

JSON

{
  "data": [
    {
      "id": 2,
      "customer_id": 328100,
      "project_id": 1,
      "pool": "pool_aw2_ssd",
      "tier": "Worker",
      "name": "S328100-001",
      "display_name": "My Subscription",
      "confirmed": false,
      "runtime": 12,
      "discount": 10,
      "monthly_price": 500,
      "setup_fee": 50,
      "setup_fee_charged": true,
      "valid_to": "2024-06-01",
      "start_date": "2024-06-01",
      "end_date": "2025-06-01",
      "renew": true,
      "data": {
        "cores": 30,
        "memory": 64,
        "disk": 500,
        "support_hours": 6,
        "full_backup": 100,
        "licenses": [
          {
            "id": 12708,
            "count": 4
          }
        ],
        "addons": [
          {
            "name": "monitoring",
            "count": 4
          }
        ]
      },
      "replacement": 1,
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "deleted_at": "2019-08-24T14:15:22Z",
      "tags": [
        "string"
      ],
      "resources": {
        "available_resources": {
          "cores": 2,
          "memory": 2,
          "disk": 100,
          "addons": [
            {
              "name": "string",
              "count": 0
            }
          ]
        }
      }
    }
  ]
}

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Update display name for the Subscription. #

PUT/ccloud/subscriptions/{id}/customname

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/customname \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"display_name": "Test"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"display_name\": \"Test\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/subscriptions/0/customname", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/customname",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"display_name\": \"Test\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/customname' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"display_name": "Test"}'

Body-Parameter

JSON

{
  "display_name": "Test"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID of the Subscription
body	body	object	ja	–
» display_name	body	string	nein	–

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

Returns the Details for a Subscription #

GET/ccloud/subscriptions/name/{name}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/subscriptions/name/0 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/subscriptions/name/0", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/subscriptions/name/0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/subscriptions/name/0' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
name	path	integer	ja	Name of the Subscription
include	query	string	nein	Include additional information in response.

Beispiel-Response 200

JSON

{
  "id": 2,
  "customer_id": 328100,
  "project_id": 1,
  "pool": "pool_aw2_ssd",
  "tier": "Worker",
  "name": "S328100-001",
  "display_name": "My Subscription",
  "confirmed": false,
  "runtime": 12,
  "discount": 10,
  "monthly_price": 500,
  "setup_fee": 50,
  "setup_fee_charged": true,
  "valid_to": "2024-06-01",
  "start_date": "2024-06-01",
  "end_date": "2025-06-01",
  "renew": true,
  "data": {
    "cores": 30,
    "memory": 64,
    "disk": 500,
    "support_hours": 6,
    "full_backup": 100,
    "licenses": [
      {
        "id": 12708,
        "count": 4
      }
    ],
    "addons": [
      {
        "name": "monitoring",
        "count": 4
      }
    ]
  },
  "replacement": 1,
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted_at": "2019-08-24T14:15:22Z",
  "tags": [
    "string"
  ],
  "resources": {
    "available_resources": {
      "cores": 2,
      "memory": 2,
      "disk": 100,
      "addons": [
        {
          "name": "string",
          "count": 0
        }
      ]
    }
  }
}

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Import VM to a subscription #

POST/ccloud/subscriptions/{id}/import

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/import \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"hostname": "ts12345"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"hostname\": \"ts12345\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/subscriptions/0/import", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/import",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"hostname\": \"ts12345\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/import' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"hostname": "ts12345"}'

Body-Parameter

JSON

{
  "hostname": "ts12345"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID of the Subscription
body	body	SubscriptionImportRequest	ja	–

Responses

Status	Beschreibung	Schema
204	VM imported to subscription	`–`

Authentifizierung: oAuth2ClientCredentials

Export one server of a Subscription into its pool #

POST/ccloud/subscriptions/{id}/export/{hostname}/pool

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/export/string/pool \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("POST", "/api/v1/ccloud/subscriptions/0/export/string/pool", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/export/string/pool",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/export/string/pool' -Method POST -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID of the Subscription
hostname	path	string	ja	Hostname of the Server to export

Responses

Status	Beschreibung	Schema
204	VM exported into pool	`–`

Authentifizierung: oAuth2ClientCredentials

Export all servers of a Subscription to another Subscription #

POST/ccloud/subscriptions/{id}/export/all

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/export/all \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"target_subscription": "S328100-001"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"target_subscription\": \"S328100-001\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/subscriptions/0/export/all", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/export/all",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"target_subscription\": \"S328100-001\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/subscriptions/0/export/all' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"target_subscription": "S328100-001"}'

Body-Parameter

JSON

{
  "target_subscription": "S328100-001"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID of the Subscription
body	body	SubscriptionExportAllRequest	ja	–

Responses

Status	Beschreibung	Schema
204	All VMs exported to other subscription	`–`

Authentifizierung: oAuth2ClientCredentials

Customers

Get the price of a pool for the given customer. #

GET/ccloud/customers/prices/{pool}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/prices/pool_iw_ssd \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/customers/prices/pool_iw_ssd", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/prices/pool_iw_ssd",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/prices/pool_iw_ssd' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
pool	path	string	ja	Tag of the pool

Beispiel-Response 200

JSON

{
  "cores": 0.1,
  "memory": 0.1,
  "disk": 0.1
}

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Get a quote for a server with the given resources. #

POST/ccloud/customers/quotes

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/quotes \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"pool": "pool_iw_ssd", "tier": "Worker", "cores": 0, "memory": 0, "disk": 0, "addons": [{"name": "string", "count": 0}], "ostype": "windows"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"pool\": \"pool_iw_ssd\", \"tier\": \"Worker\", \"cores\": 0, \"memory\": 0, \"disk\": 0, \"addons\": [{\"name\": \"string\", \"count\": 0}], \"ostype\": \"windows\"}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/customers/quotes", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/quotes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"pool\": \"pool_iw_ssd\", \"tier\": \"Worker\", \"cores\": 0, \"memory\": 0, \"disk\": 0, \"addons\": [{\"name\": \"string\", \"count\": 0}], \"ostype\": \"windows\"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/quotes' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"pool": "pool_iw_ssd", "tier": "Worker", "cores": 0, "memory": 0, "disk": 0, "addons": [{"name": "string", "count": 0}], "ostype": "windows"}'

Body-Parameter

JSON

{
  "pool": "pool_iw_ssd",
  "tier": "Worker",
  "cores": 0,
  "memory": 0,
  "disk": 0,
  "addons": [
    {
      "name": "string",
      "count": 0
    }
  ],
  "ostype": "windows"
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
body	body	object	ja	–
» pool	body	string	nein	Provide either pool or tier parameter.
» tier	body	string	nein	Provide either pool or tier parameter.
» cores	body	integer	nein	–
» memory	body	integer	nein	–
» disk	body	integer	nein	–
» addons	body	[object]	nein	–
»» name	body	string	nein	–
»» count	body	integer	nein	–
» ostype	body	string	nein	OSType as given back from the os list

Beispiel-Response 200

JSON

{
  "resources": {
    "cores": 0.1,
    "memory": 0.1,
    "disk": 0.1
  },
  "addons": {
    "additionalProperties": {
      "category": "string",
      "monthly_price": 0.1,
      "setup_fee": 0.1
    }
  },
  "licenses": {
    "additionalProperties": 0.1
  },
  "setup_fee_total": 0.1,
  "monthly_total": 0.1
}

Responses

Status	Beschreibung	Schema
200	OK	`Inline`

Authentifizierung: oAuth2ClientCredentials

Get all scheduled servers. #

GET/ccloud/customers/scheduled

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/scheduled \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/customers/scheduled", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/scheduled",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/scheduled' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "hostname": "ts10000",
    "frequency": "1",
    "next_run": "2019-08-24T14:15:22Z"
  }
]

Responses

Status	Beschreibung	Schema
200	Scheduled Summary	`Inline`

Authentifizierung: oAuth2ClientCredentials

Get all customer addons #

GET/ccloud/customers/addons

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/addons \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/customers/addons", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/addons",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/addons' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  [
    {
      "name": "string",
      "count": 1
    }
  ]
]

Responses

Status	Beschreibung	Schema
200	Customer Addons	`Inline`

Authentifizierung: oAuth2ClientCredentials

Setup the given addon for the customer. #

PUT/ccloud/customers/addons/{addon}

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/addons/report \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"count": 0}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"count\": 0}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/customers/addons/report", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/addons/report",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"count\": 0}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/addons/report' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"count": 0}'

Body-Parameter

JSON

{
  "count": 0
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
addon	path	string	ja	Name of the addon to add.
body	body	object	nein	–
» count	body	integer	nein	Amount to book for the addon. Defaults to 1 if not given.

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

Delete the given addon for the customer. #

DELETE/ccloud/customers/addons/{addon}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/addons/report \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/customers/addons/report", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/addons/report",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/addons/report' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
addon	path	string	ja	Name of the addon to delete.

Responses

Status	Beschreibung	Schema
204	No-Content	`–`

Authentifizierung: oAuth2ClientCredentials

Get all available reports #

GET/ccloud/customers/reports

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/reports \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/customers/reports", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/reports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/reports' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  [
    "2023-09"
  ]
]

Responses

Status	Beschreibung	Schema
200	Customer Addon Report	`Inline`

Authentifizierung: oAuth2ClientCredentials

Get report PDF by date #

GET/ccloud/customers/reports/{date}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/reports/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/customers/reports/", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/reports/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/reports/' -Method GET -Headers $headers

Responses

Status	Beschreibung	Schema
200	Customer Addon Report	`file`

Authentifizierung: oAuth2ClientCredentials

Get all projects #

GET/ccloud/customers/projects

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/customers/projects \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/customers/projects", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/customers/projects",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/customers/projects' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "id": 1,
    "customer_id": 328100,
    "name": "My Project",
    "description": "This project is a test project",
    "purpose": "production",
    "color": "#208CBC",
    "is_default": false
  }
]

Responses

Status	Beschreibung	Schema
200	–	`Inline`

Authentifizierung: oAuth2ClientCredentials

Projects

Create a new project #

POST/ccloud/projects

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/projects \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"customer_id": 328100, "name": "My Project", "description": "This project is a test project", "purpose": "production", "color": "#208CBC", "is_default": false}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"customer_id\": 328100, \"name\": \"My Project\", \"description\": \"This project is a test project\", \"purpose\": \"production\", \"color\": \"#208CBC\", \"is_default\": false}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/ccloud/projects", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/projects",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"customer_id\": 328100, \"name\": \"My Project\", \"description\": \"This project is a test project\", \"purpose\": \"production\", \"color\": \"#208CBC\", \"is_default\": false}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/projects' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"customer_id": 328100, "name": "My Project", "description": "This project is a test project", "purpose": "production", "color": "#208CBC", "is_default": false}'

Body-Parameter

JSON

{
  "customer_id": 328100,
  "name": "My Project",
  "description": "This project is a test project",
  "purpose": "production",
  "color": "#208CBC",
  "is_default": false
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
body	body	#/paths/~1ccloud~1projects/post/requestBody/content/application~1json/schema	ja	–

Beispiel-Response 200

JSON

{
  "id": 1,
  "customer_id": 328100,
  "name": "My Project",
  "description": "This project is a test project",
  "purpose": "production",
  "color": "#208CBC",
  "is_default": false
}

Responses

Status	Beschreibung	Schema
201	Project created successfully	`Inline`

Authentifizierung: oAuth2ClientCredentials

Get a project #

GET/ccloud/projects/{id}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/projects/0 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/projects/0", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/projects/0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/projects/0' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	Project ID

Beispiel-Response 200

JSON

{
  "id": 1,
  "customer_id": 328100,
  "name": "My Project",
  "description": "This project is a test project",
  "purpose": "production",
  "color": "#208CBC",
  "is_default": false
}

Responses

Status	Beschreibung	Schema
200	Project found	`Inline`
404	Project not found	`Inline`

Authentifizierung: oAuth2ClientCredentials

Update a project #

PUT/ccloud/projects/{id}

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/projects/0 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"customer_id": 328100, "name": "My Project", "description": "This project is a test project", "purpose": "production", "color": "#208CBC", "is_default": false}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"customer_id\": 328100, \"name\": \"My Project\", \"description\": \"This project is a test project\", \"purpose\": \"production\", \"color\": \"#208CBC\", \"is_default\": false}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/projects/0", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/projects/0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"customer_id\": 328100, \"name\": \"My Project\", \"description\": \"This project is a test project\", \"purpose\": \"production\", \"color\": \"#208CBC\", \"is_default\": false}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/projects/0' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"customer_id": 328100, "name": "My Project", "description": "This project is a test project", "purpose": "production", "color": "#208CBC", "is_default": false}'

Body-Parameter

JSON

{
  "customer_id": 328100,
  "name": "My Project",
  "description": "This project is a test project",
  "purpose": "production",
  "color": "#208CBC",
  "is_default": false
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	Project ID
body	body	#/paths/~1ccloud~1projects/post/requestBody/content/application~1json/schema	ja	–

Beispiel-Response 200

JSON

{
  "id": 1,
  "customer_id": 328100,
  "name": "My Project",
  "description": "This project is a test project",
  "purpose": "production",
  "color": "#208CBC",
  "is_default": false
}

Responses

Status	Beschreibung	Schema
200	Project updated successfully	`Inline`
404	Project not found	`Inline`

Authentifizierung: oAuth2ClientCredentials

Delete a project #

DELETE/ccloud/projects/{id}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/projects/0 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/projects/0", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/projects/0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/projects/0' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	Project ID

Beispiel-Response 200

JSON

{
  "error": {
    "code": 403,
    "msg": "Last project can't be deleted",
    "errors": [
      "Last project can't be deleted"
    ]
  }
}

Responses

Status	Beschreibung	Schema
204	Project deleted successfully	`–`
403	Last project can't be deleted	`Inline`
404	Project not found	`Inline`

Authentifizierung: oAuth2ClientCredentials

Assign the resources to the project #

PUT/ccloud/projects/{id}/resources

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/projects/0/resources \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"resources": [{"id": "string", "type": "server"}]}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "{\"resources\": [{\"id\": \"string\", \"type\": \"server\"}]}"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("PUT", "/api/v1/ccloud/projects/0/resources", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/projects/0/resources",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"resources\": [{\"id\": \"string\", \"type\": \"server\"}]}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/projects/0/resources' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{"resources": [{"id": "string", "type": "server"}]}'

Body-Parameter

JSON

{
  "resources": [
    {
      "id": "string",
      "type": "server"
    }
  ]
}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	Project ID
body	body	ProjectAssignment	ja	–

Beispiel-Response 200

JSON

[
  {
    "id": "string",
    "type": "server",
    "status": "success",
    "message": "string"
  }
]

Responses

Status	Beschreibung	Schema
200	–	`ProjectAssignmentResult`

Authentifizierung: oAuth2ClientCredentials

Various

Get a list of available os configuration #

GET/ccloud/os

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/os \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/os", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/os",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/os' -Method GET -Headers $headers

Beispiel-Response 200

JSON

{
  "name": "Linux Debian 11",
  "image": "stretch_uefi",
  "min_disk": "5",
  "language": "en-US",
  "ostype": "Windows",
  "cloud_init_support": true
}

Responses

Status	Beschreibung	Schema
200	Success	`OSConfiguration`

Authentifizierung: oAuth2ClientCredentials

Get a list of available Addons #

GET/ccloud/addons

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/addons \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/addons", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/addons",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/addons' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "id": 1,
    "name": "cprotect",
    "supported_os": [
      "ubuntu-22"
    ],
    "addable": true,
    "deletable": true,
    "desc_de": "Dieses Addon bietet eine Hochverfügbarkeit der VM",
    "desc_en": "This addon provides high availability of the VM",
    "price": 9.99,
    "setup_fee": 9.99
  }
]

Responses

Status	Beschreibung	Schema
200	Success	`AddonsList`

Authentifizierung: oAuth2ClientCredentials

Domain Contacts

Alle Domain-Kontakte abrufen #

GET/ccloud/domain-contacts

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/domain-contacts \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/domain-contacts", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domain-contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domain-contacts' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
page	query	integer	nein	Seite der Ergebnisliste
limit	query	integer	nein	Anzahl der Einträge je Seite
search	query	string	nein	Suchbegriff zum Filtern der Ergebnisse

Beispiel-Response 200

JSON

{
  "data": [
    {
      "id": 1,
      "firstname": "Max",
      "lastname": "Mustermann",
      "email": "kontakt@example.com",
      "street": "Musterstraße 1",
      "city": "Musterstadt",
      "country": "DE",
      "postalcode": "00000",
      "organisation": "Beispiel GmbH"
    }
  ],
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "per_page": 25,
    "to": 1,
    "total": 1
  }
}

Responses

Status	Beschreibung	Schema
200	Liste der Kontakte des Teams	DomainContact[]
default	Unerwarteter Fehler	DomainError

Domain-Kontakt anlegen #

POST/ccloud/domain-contacts

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/domain-contacts \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"firstname": "Max", "lastname": "Mustermann", "email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"firstname": "Max", "lastname": "Mustermann", "email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}"

conn.request("POST", "/api/v1/ccloud/domain-contacts", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domain-contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{"firstname": "Max", "lastname": "Mustermann", "email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domain-contacts' -Method POST -Headers $headers -Body '{"firstname": "Max", "lastname": "Mustermann", "email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}'

Body-Parameter

JSON

{"firstname": "Max", "lastname": "Mustermann", "email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}

Beispiel-Response 201

JSON

{
  "id": 1,
  "firstname": "Max",
  "lastname": "Mustermann",
  "email": "kontakt@example.com",
  "street": "Musterstraße 1",
  "city": "Musterstadt",
  "country": "DE",
  "postalcode": "00000",
  "organisation": "Beispiel GmbH",
  "state": null,
  "phone": null,
  "fax": null,
  "remarks": null,
  "created_at": "2026-01-15T09:00:00+00:00",
  "updated_at": "2026-01-15T09:00:00+00:00"
}

Responses

Status	Beschreibung	Schema
201	Kontakt wurde angelegt	DomainContact-Handle
default	Unerwarteter Fehler	DomainError

Domain-Kontakt per ID abrufen #

GET/ccloud/domain-contacts/{id}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/domain-contacts/{id}", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id}' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Kontakts

Beispiel-Response 200

JSON

{
  "id": 1,
  "firstname": "Max",
  "lastname": "Mustermann",
  "email": "kontakt@example.com",
  "street": "Musterstraße 1",
  "city": "Musterstadt",
  "country": "DE",
  "postalcode": "00000",
  "organisation": "Beispiel GmbH",
  "state": null,
  "phone": null,
  "fax": null,
  "remarks": null,
  "created_at": "2026-01-15T09:00:00+00:00",
  "updated_at": "2026-01-15T09:00:00+00:00"
}

Responses

Status	Beschreibung	Schema
200	Details des Kontakts	DomainContact-Handle
default	Unerwarteter Fehler	DomainError

Domain-Kontakt aktualisieren #

PUT/ccloud/domain-contacts/{id}

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}"

conn.request("PUT", "/api/v1/ccloud/domain-contacts/{id}", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{"email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id}' -Method PUT -Headers $headers -Body '{"email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}'

Body-Parameter

JSON

{"email": "kontakt@example.com", "street": "Musterstraße 1", "city": "Musterstadt", "country": "DE", "postalcode": "00000"}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Kontakts

Beispiel-Response 200

JSON

{
  "id": 1,
  "firstname": "Max",
  "lastname": "Mustermann",
  "email": "kontakt@example.com",
  "street": "Musterstraße 1",
  "city": "Musterstadt",
  "country": "DE",
  "postalcode": "00000",
  "organisation": "Beispiel GmbH",
  "state": null,
  "phone": null,
  "fax": null,
  "remarks": null,
  "created_at": "2026-01-15T09:00:00+00:00",
  "updated_at": "2026-01-15T09:00:00+00:00"
}

Responses

Status	Beschreibung	Schema
200	Kontakt wurde aktualisiert. Vor- und Nachname lassen sich nicht ändern.	DomainContact-Handle
default	Unerwarteter Fehler	DomainError

Domain-Kontakt löschen #

DELETE/ccloud/domain-contacts/{id}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/domain-contacts/{id}", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domain-contacts/{id}' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Kontakts

Responses

Status	Beschreibung	Schema
204	Kontakt wurde gelöscht	–
default	Unerwarteter Fehler	DomainError

Domains

Verfügbare TLDs abrufen #

GET/ccloud/tlds

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/tlds \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/tlds", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/tlds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/tlds' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "id": 1,
    "registry_id": 1,
    "orderable": true,
    "name": "de",
    "premium_allowed": false,
    "preack_allowed": true,
    "authinfo_delete_allowed": true,
    "authinfo_create_allowed": true,
    "created_at": "2026-01-15T09:00:00+00:00",
    "updated_at": "2026-01-15T09:00:00+00:00"
  }
]

Responses

Status	Beschreibung	Schema
200	Liste der verfügbaren Top-Level-Domains	TLD[]
default	Unerwarteter Fehler	DomainError

Alle Domains abrufen #

GET/ccloud/domains

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/domains \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/domains", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
page	query	integer	nein	Seite der Ergebnisliste
limit	query	integer	nein	Anzahl der Einträge je Seite
search	query	string	nein	Suchbegriff zum Filtern der Ergebnisse
filter	query	string	nein	Nach Status filtern
project_id	query	integer	nein	Nur Domains dieses Projekts

Beispiel-Response 200

JSON

{
  "data": [
  {
    "id": 1,
    "customer_id": 100000,
    "project_id": 1,
    "tld_id": 1,
    "registry_id": 1,
    "name": "beispiel.de",
    "name_idn": "beispiel.de",
    "is_transfer_in": false,
    "authcode": null,
    "authcode_valid": null,
    "delete_date": null,
    "status": "active",
    "created_at": "2026-01-15T09:00:00+00:00",
    "updated_at": "2026-01-15T09:00:00+00:00",
    "deleted_at": null
  }
  ],
  "meta": { "current_page": 1, "per_page": 25, "total": 1 }
}

Responses

Status	Beschreibung	Schema
200	Liste der Domains des Teams	Domain[]
default	Unerwarteter Fehler	DomainError

Domain registrieren #

POST/ccloud/domains

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/domains \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"name": "beispiel.de", "contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"name": "beispiel.de", "contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}"

conn.request("POST", "/api/v1/ccloud/domains", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{"name": "beispiel.de", "contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains' -Method POST -Headers $headers -Body '{"name": "beispiel.de", "contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}'

Body-Parameter

JSON

{"name": "beispiel.de", "contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}

Beispiel-Response 201

JSON

{
  "id": 1,
  "customer_id": 100000,
  "project_id": 1,
  "tld_id": 1,
  "registry_id": 1,
  "name": "beispiel.de",
  "name_idn": "beispiel.de",
  "is_transfer_in": false,
  "authcode": null,
  "authcode_valid": null,
  "delete_date": null,
  "status": "active",
  "created_at": "2026-01-15T09:00:00+00:00",
  "updated_at": "2026-01-15T09:00:00+00:00",
  "deleted_at": null
}

Responses

Status	Beschreibung	Schema
201	Domain wurde angelegt	Domain-Dependencies
default	Unerwarteter Fehler	DomainError

Domain per ID abrufen #

GET/ccloud/domains/{id}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/domains/{id}", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Beispiel-Response 200

JSON

{
  "id": 1,
  "customer_id": 100000,
  "project_id": 1,
  "name": "beispiel.de",
  "name_idn": "beispiel.de",
  "status": "active",
  "tld": "de",
  "name_servers": [
    { "id": 1, "name": "ns.internet1.de" },
    { "id": 2, "name": "ns2.internet1.de" }
  ],
  "contacts": {
    "owner": { "id": 1, "firstname": "Max", "lastname": "Mustermann" },
    "admin": { "id": 1, "firstname": "Max", "lastname": "Mustermann" },
    "tech":  { "id": 1, "firstname": "Max", "lastname": "Mustermann" },
    "zone":  { "id": 1, "firstname": "Max", "lastname": "Mustermann" }
  }
}

Responses

Status	Beschreibung	Schema
200	Details der Domain inklusive Nameserver und Kontakte	Domain-Dependencies
default	Unerwarteter Fehler	DomainError

Domain aktualisieren #

PATCH/ccloud/domains/{id}

curl --request PATCH \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}"

conn.request("PATCH", "/api/v1/ccloud/domains/{id}", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => "{"contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}' -Method PATCH -Headers $headers -Body '{"contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}'

Body-Parameter

JSON

{"contact": 1, "name_servers": ["ns.internet1.de", "ns2.internet1.de"]}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Beispiel-Response 200

JSON

{
  "id": 1,
  "customer_id": 100000,
  "project_id": 1,
  "name": "beispiel.de",
  "name_idn": "beispiel.de",
  "status": "active",
  "tld": "de",
  "name_servers": [
    { "id": 1, "name": "ns.internet1.de" },
    { "id": 2, "name": "ns2.internet1.de" }
  ],
  "contacts": {
    "owner": { "id": 1, "firstname": "Max", "lastname": "Mustermann" },
    "admin": { "id": 1, "firstname": "Max", "lastname": "Mustermann" },
    "tech":  { "id": 1, "firstname": "Max", "lastname": "Mustermann" },
    "zone":  { "id": 1, "firstname": "Max", "lastname": "Mustermann" }
  }
}

Responses

Status	Beschreibung	Schema
200	Domain wurde aktualisiert	Domain-Dependencies
default	Unerwarteter Fehler	DomainError

Domain kündigen #

DELETE/ccloud/domains/{id}

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"date": "2026-08-12"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"date": "2026-08-12"}"

conn.request("DELETE", "/api/v1/ccloud/domains/{id}", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => "{"date": "2026-08-12"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}' -Method DELETE -Headers $headers -Body '{"date": "2026-08-12"}'

Body-Parameter

JSON

{"date": "2026-08-12"}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	Domain wurde zur Kündigung vorgemerkt	–
default	Unerwarteter Fehler	DomainError

Kündigungsstatus abrufen #

GET/ccloud/domains/{id}/preack

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/preack \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/domains/{id}/preack", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/preack",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/preack' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Beispiel-Response 200

JSON

{
  "cancelationStatus": "PREACK_EXPIRE"
}

Responses

Status	Beschreibung	Schema
200	Aktueller Kündigungsstatus. Nur für bestimmte TLDs verfügbar.	–
default	Unerwarteter Fehler	DomainError

Transfer-Freigabe setzen #

POST/ccloud/domains/{id}/preack

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/preack \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("POST", "/api/v1/ccloud/domains/{id}/preack", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/preack",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/preack' -Method POST -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	Freigabe wurde gesetzt	–
500	Für diese Domain nicht unterstützt	–
default	Unerwarteter Fehler	DomainError

AuthInfo1 erzeugen #

POST/ccloud/domains/{id}/authinfo

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/authinfo \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("POST", "/api/v1/ccloud/domains/{id}/authinfo", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/authinfo",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/authinfo' -Method POST -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Beispiel-Response 201

JSON

{
  "domain": "beispiel.de",
  "authcode": "aB3-xY9-kL2",
  "authcode_valid": "2026-03-01T00:00:00+00:00"
}

Responses

Status	Beschreibung	Schema
201	AuthInfo1 wurde erzeugt. Nur für bestimmte TLDs verfügbar.	AuthInfo1
default	Unerwarteter Fehler	DomainError

AuthInfo1 löschen #

DELETE/ccloud/domains/{id}/authinfo

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/authinfo \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("DELETE", "/api/v1/ccloud/domains/{id}/authinfo", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/authinfo",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/authinfo' -Method DELETE -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	AuthInfo1 wurde gelöscht	–
default	Unerwarteter Fehler	DomainError

Kündigung zurücknehmen #

PUT/ccloud/domains/{id}/revert

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/revert \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("PUT", "/api/v1/ccloud/domains/{id}/revert", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/revert",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/revert' -Method PUT -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	Kündigung wurde zurückgenommen	–
default	Unerwarteter Fehler	DomainError

Domain wiederherstellen #

PUT/ccloud/domains/{id}/restore

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/restore \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("PUT", "/api/v1/ccloud/domains/{id}/restore", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/restore",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/restore' -Method PUT -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	Domain wurde wiederhergestellt	–
default	Unerwarteter Fehler	DomainError

Wiederherstellbare Domains abrufen #

GET/ccloud/domains/restore

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/restore \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/domains/restore", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/restore",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/restore' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
page	query	integer	nein	Seite der Ergebnisliste
limit	query	integer	nein	Anzahl der Einträge je Seite
search	query	string	nein	Suchbegriff zum Filtern der Ergebnisse

Beispiel-Response 200

JSON

{
  "data": [
    {
      "id": 1,
      "registry_id": 2,
      "customer_id": 100000,
      "project_id": 1,
      "name": "beispiel.com",
      "name_idn": "beispiel.com",
      "created_at": "2026-01-15T09:00:00+00:00",
      "deleted_at": "2026-02-01T09:00:00+00:00",
      "action": "RESTORE"
    }
  ],
  "links": { "first": "…", "last": "…", "prev": null, "next": null }
}

Responses

Status	Beschreibung	Schema
200	Liste der wiederherstellbaren Domains	RestoreableDomain[]
default	Unerwarteter Fehler	DomainError

AuthInfo2 anfordern #

POST/ccloud/domains/authinfo2

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/authinfo2 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"name": "beispiel.de"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"name": "beispiel.de"}"

conn.request("POST", "/api/v1/ccloud/domains/authinfo2", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/authinfo2",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{"name": "beispiel.de"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/authinfo2' -Method POST -Headers $headers -Body '{"name": "beispiel.de"}'

Body-Parameter

JSON

{"name": "beispiel.de"}

Responses

Status	Beschreibung	Schema
204	AuthInfo2 wurde angefordert. Nur für bestimmte TLDs verfügbar.	–
default	Unerwarteter Fehler	DomainError

DNS

DNS-Zone anlegen #

POST/ccloud/domains/{id}/zones

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/zones \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("POST", "/api/v1/ccloud/domains/{id}/zones", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/zones",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/zones' -Method POST -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	Zone wurde angelegt	–

DNS-Einträge abrufen #

GET/ccloud/domains/{id}/records

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/domains/{id}/records", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Beispiel-Response 200

JSON

{
  "id": "beispiel.de.",
  "name": "beispiel.de.",
  "kind": "Native",
  "serial": 2026052001,
  "edited_serial": 2026052101,
  "dnssec": false,
  "rrsets": [
    {
      "name": "beispiel.de.",
      "type": "A",
      "ttl": 3600,
      "records": [ { "content": "192.0.2.1", "disabled": false } ],
      "comments": []
    }
  ]
}

Responses

Status	Beschreibung	Schema
200	Zone mit allen Einträgen	Zone
default	Unerwarteter Fehler	DomainError

DNS-Eintrag anlegen #

POST/ccloud/domains/{id}/records

curl --request POST \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"name": "www", "type": "A", "ttl": 1800, "records": [{"content": "192.0.2.1", "disabled": false}]}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"name": "www", "type": "A", "ttl": 1800, "records": [{"content": "192.0.2.1", "disabled": false}]}"

conn.request("POST", "/api/v1/ccloud/domains/{id}/records", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{"name": "www", "type": "A", "ttl": 1800, "records": [{"content": "192.0.2.1", "disabled": false}]}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records' -Method POST -Headers $headers -Body '{"name": "www", "type": "A", "ttl": 1800, "records": [{"content": "192.0.2.1", "disabled": false}]}'

Body-Parameter

JSON

{"name": "www", "type": "A", "ttl": 1800, "records": [{"content": "192.0.2.1", "disabled": false}]}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	Eintrag wurde angelegt	–
default	Unerwarteter Fehler	DomainError

DNS-Eintrag ersetzen #

PUT/ccloud/domains/{id}/records

curl --request PUT \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"name": "www", "type": "A", "ttl": 1300, "records": [{"current_content": "192.0.2.1", "target_content": "192.0.2.2", "disabled": false}]}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"name": "www", "type": "A", "ttl": 1300, "records": [{"current_content": "192.0.2.1", "target_content": "192.0.2.2", "disabled": false}]}"

conn.request("PUT", "/api/v1/ccloud/domains/{id}/records", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{"name": "www", "type": "A", "ttl": 1300, "records": [{"current_content": "192.0.2.1", "target_content": "192.0.2.2", "disabled": false}]}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records' -Method PUT -Headers $headers -Body '{"name": "www", "type": "A", "ttl": 1300, "records": [{"current_content": "192.0.2.1", "target_content": "192.0.2.2", "disabled": false}]}'

Body-Parameter

JSON

{"name": "www", "type": "A", "ttl": 1300, "records": [{"current_content": "192.0.2.1", "target_content": "192.0.2.2", "disabled": false}]}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	Eintrag wurde ersetzt	–
default	Unerwarteter Fehler	DomainError

DNS-Eintrag löschen #

DELETE/ccloud/domains/{id}/records

curl --request DELETE \
  --url https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data '{"name": "www", "type": "A", "content": "192.0.2.1"}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

payload = "{"name": "www", "type": "A", "content": "192.0.2.1"}"

conn.request("DELETE", "/api/v1/ccloud/domains/{id}/records", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => "{"name": "www", "type": "A", "content": "192.0.2.1"}",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/domains/{id}/records' -Method DELETE -Headers $headers -Body '{"name": "www", "type": "A", "content": "192.0.2.1"}'

Body-Parameter

JSON

{"name": "www", "type": "A", "content": "192.0.2.1"}

Parameter

Name	In	Typ	Pflicht	Beschreibung
id	path	integer	ja	ID des Domain

Responses

Status	Beschreibung	Schema
204	Eintrag wurde gelöscht	–
default	Unerwarteter Fehler	DomainError

Misc

Get resource infos for deploying a new VM. #

GET/ccloud/resource-info

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/resource-info \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/resource-info", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/resource-info",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/resource-info' -Method GET -Headers $headers

Beispiel-Response 200

JSON

{
  "resources_limited": true,
  "usage": {
    "cores": 2,
    "memory": 2,
    "disk": 100
  },
  "limits": {
    "cores": 2,
    "memory": 2,
    "disk": 100
  }
}

Responses

Status	Beschreibung	Schema
200	Resource Infos	`ResourceInfo`

Authentifizierung: oAuth2ClientCredentials

Licenses

Get all available license products. #

GET/ccloud/licenses

curl --request GET \
  --url https://ccenter.centron.de/api/v1/ccloud/licenses \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/ccloud/licenses", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/ccloud/licenses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/ccloud/licenses' -Method GET -Headers $headers

Beispiel-Response 200

JSON

[
  {
    "id": 999,
    "title": "Microsoft SQL Server 2017 Standard",
    "price": 9.99
  }
]

Responses

Status	Beschreibung	Schema
200	Ok	`Licenses`

Authentifizierung: oAuth2ClientCredentials

Support

Get all available ticket categories #

GET/support/categories

curl --request GET \
  --url https://ccenter.centron.de/api/v1/support/categories \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/support/categories", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/support/categories",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/support/categories' -Method GET -Headers $headers

Beispiel-Response 200

JSON

{
  "categories": {
    "technical": {
      "subcategories": [
        "string"
      ]
    },
    "billing": {
      "subcategories": [
        "string"
      ]
    },
    "misc": {
      "subcategories": [
        "string"
      ]
    }
  }
}

Responses

Status	Beschreibung	Schema
200	Ok	`TicketCategory`

Authentifizierung: oAuth2ClientCredentials

Get all available Tickets for Customer #

GET/support/tickets

curl --request GET \
  --url https://ccenter.centron.de/api/v1/support/tickets \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/support/tickets", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/support/tickets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/support/tickets' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
state	query	string	nein	State of the ticket

Beispiel-Response 200

JSON

[
  {
    "ticket_id": 17178383,
    "ticket_number": "108751337",
    "title": "Usage Report vs50000",
    "state": "new",
    "create_time": "2025-12-02 12:04:09",
    "changed": "2025-12-02 12:04:10"
  }
]

Responses

Status	Beschreibung	Schema
200	Ok	`TicketsList`

Authentifizierung: oAuth2ClientCredentials

Create Ticket #

POST/support/tickets

curl --request POST \
  --url https://ccenter.centron.de/api/v1/support/tickets \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data 'category: technical subcategory: ccloud3 subject: string message: string product: xv10000 attachments: - string'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "category: technical subcategory: ccloud3 subject: string message: string product: xv10000 attachments: - string"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/support/tickets", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/support/tickets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "category: technical subcategory: ccloud3 subject: string message: string product: xv10000 attachments: - string",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/support/tickets' -Method POST -Headers $headers -ContentType 'application/json' -Body 'category: technical subcategory: ccloud3 subject: string message: string product: xv10000 attachments: - string'

Body-Parameter

JSON

category: technical
subcategory: ccloud3
subject: string
message: string
product: xv10000
attachments:
  - string

Parameter

Name	In	Typ	Pflicht	Beschreibung
body	body	CreateTicketRequest	ja	–

Beispiel-Response 200

JSON

{
  "article_id": 3917754,
  "ticket_number": "10813994",
  "ticket_id": "1656740"
}

Responses

Status	Beschreibung	Schema
200	Ticket successfully created	`TicketCreateResponse`

Authentifizierung: oAuth2ClientCredentials

Get Ticket #

GET/support/tickets/{ticket_id}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/support/tickets/34443224 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/support/tickets/34443224", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/support/tickets/34443224",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/support/tickets/34443224' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
ticket_id	path	integer	ja	id of the ticket

Beispiel-Response 200

JSON

{
  "ticket_id": 22222222,
  "ticket_number": "111111111",
  "title": "Usage Report vs111111",
  "state": "new",
  "articles": [
    {
      "article_id": 444444,
      "create_time": "2025-12-02 05:04:09",
      "from": "technik@centron.de",
      "subject": "Usage Report vs111111",
      "body": "Ticket details here",
      "sender_type": "agent",
      "attachments": []
    }
  ]
}

Responses

Status	Beschreibung	Schema
200	Ok	`Ticketdetails`

Authentifizierung: oAuth2ClientCredentials

Close Ticket #

POST/support/tickets/{ticket_id}/close

curl --request POST \
  --url https://ccenter.centron.de/api/v1/support/tickets/34443224/close \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("POST", "/api/v1/support/tickets/34443224/close", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/support/tickets/34443224/close",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/support/tickets/34443224/close' -Method POST -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
ticket_id	path	integer	ja	id of the ticket

Beispiel-Response 200

JSON

{
  "ticket_number": "10813981",
  "ticket_id": "1656727"
}

Responses

Status	Beschreibung	Schema
200	Ok	`TicketCloseResponse`

Authentifizierung: oAuth2ClientCredentials

Reply to Ticket #

POST/support/tickets/{ticket_id}/articles

curl --request POST \
  --url https://ccenter.centron.de/api/v1/support/tickets/{ticket_id}/articles \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --data 'subject: string body: string attachments: - string'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

payload = "subject: string body: string attachments: - string"

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}",
    'Content-Type': "application/json"
}

conn.request("POST", "/api/v1/support/tickets/{ticket_id}/articles", payload, headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/support/tickets/{ticket_id}/articles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "subject: string body: string attachments: - string",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}",
    "Content-Type: application/json"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/support/tickets/{ticket_id}/articles' -Method POST -Headers $headers -ContentType 'application/json' -Body 'subject: string body: string attachments: - string'

Body-Parameter

JSON

subject: string
body: string
attachments:
  - string

Parameter

Name	In	Typ	Pflicht	Beschreibung
ticket_id	path	integer	ja	id of the ticket
body	body	ReplyTicketRequest	ja	–

Beispiel-Response 200

JSON

{
  "article_id": 3917754,
  "ticket_number": "10813994",
  "ticket_id": "1656740"
}

Responses

Status	Beschreibung	Schema
200	Ok	`TicketCreateResponse`

Authentifizierung: oAuth2ClientCredentials

Download Ticket Attachment #

GET/support/tickets/{ticket_id}/articles/{article_id}/attachments/{attachment_id}

curl --request GET \
  --url https://ccenter.centron.de/api/v1/support/tickets/34443224/articles/123456/attachments/654321 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access-token}'

import http.client

conn = http.client.HTTPSConnection("ccenter.centron.de")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer {access-token}"
}

conn.request("GET", "/api/v1/support/tickets/34443224/articles/123456/attachments/654321", headers=headers)

res = conn.getresponse()
print(res.read().decode("utf-8"))

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ccenter.centron.de/api/v1/support/tickets/34443224/articles/123456/attachments/654321",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Bearer {access-token}"
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Bearer {access-token}")
$response = Invoke-WebRequest -Uri 'https://ccenter.centron.de/api/v1/support/tickets/34443224/articles/123456/attachments/654321' -Method GET -Headers $headers

Parameter

Name	In	Typ	Pflicht	Beschreibung
ticket_id	path	integer	ja	id of the ticket
article_id	path	integer	ja	id of the article
attachment_id	path	integer	ja	id of the attachment

Responses

Status	Beschreibung	Schema
200	Ok	`string`

Authentifizierung: oAuth2ClientCredentials

Schemas

OAuth

JSON

{
  "grant_type": "client_credentials",
  "client_id": "90f63c80-bd90-89a3-4632-b16c4ab909ae",
  "client_secret": "GsqCDfjYUCceU8dTq1vQWxLnnRaf6UySWP7GAgI",
  "scope": "*"
}

OSConfiguration

JSON

{
  "name": "Linux Debian 11",
  "image": "stretch_uefi",
  "min_disk": "5",
  "language": "en-US",
  "ostype": "Windows",
  "cloud_init_support": true
}

Addon

JSON

{
  "name": "string",
  "count": 0
}

AddonsList

JSON

[
  {
    "id": 1,
    "name": "cprotect",
    "supported_os": [
      "ubuntu-22"
    ],
    "addable": true,
    "deletable": true,
    "desc_de": "Dieses Addon bietet eine Hochverfügbarkeit der VM",
    "desc_en": "This addon provides high availability of the VM",
    "price": 9.99,
    "setup_fee": 9.99
  }
]

getPassword

JSON

{
  "username": "string",
  "password": "string"
}

OAuthResponse

JSON

{
  "token_type": "Bearer",
  "expires_in": 31536000,
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

VMDVDModel

JSON

{
  "id": "string",
  "path": "string"
}

DeleteDVDTaskResponse

JSON

{
  "id": 0
}

UpdateDVDTaskResponse

JSON

{
  "id": 0,
  "data": [
    {
      "id": "string",
      "name": "string",
      "path": "string",
      "hostname": "string",
      "customer_id": "string",
      "username": "string"
    }
  ]
}

VMNetModel

JSON

{
  "id": "string",
  "switch": "string",
  "vlan": 0,
  "mac_spoofing": true,
  "bandwith": 0,
  "ipAdresse": [
    "string"
  ]
}

VMNetworkAddIPRequest

JSON

{
  "protocol": "IPv4"
}

VMNetworkAddIPResponse

JSON

{
  "type": "IPv6",
  "ip_address": "2a00:6140:a000:72::b",
  "network": "2a00:6140:a000:72::",
  "mask_bits": 64,
  "nameservers": [
    "2a00:6140:a000:72::1"
  ],
  "gateway": "2a00:6140:a000:72::1",
  "vlan": 708
}

VMDVDAddModel

JSON

{
  "name": "string"
}

OAuthFailure

JSON

{
  "error": "string",
  "error_description": "string",
  "hint": "string",
  "message": "string"
}

OAuthBadRequestResponse

JSON

{
  "error": "unsupported_grant_type",
  "error_description": "The authorization grant type is not supported by the authorization server.",
  "hint": "Check that all required parameters have been provided",
  "message": "The authorization grant type is not supported by the authorization server."
}

OAuthUnauthorizedResponse

JSON

{
  "error": "invalid_client",
  "error_description": "Client authentication failed",
  "message": "Client authentication failed"
}

PaginationLinks

JSON

{
  "first": "http://example.com",
  "last": "http://example.com",
  "prev": "http://example.com",
  "next": "http://example.com"
}

PaginationMetadata

JSON

{
  "current_page": 0,
  "from": 0,
  "last_page": 0,
  "path": "http://example.com",
  "per_page": 0,
  "to": 0,
  "total": 0
}

DeploymentCreateRequest

JSON

{
  "project_id": 0,
  "pool": "string",
  "hostname": "string",
  "description": "string",
  "cores": 0,
  "memory": 0,
  "disks": [
    0
  ],
  "image": "string",
  "custom_name": "string",
  "password": "string",
  "sshkey": "string",
  "ssh_keys": [
    "ssh-ed25519 AAAAC3NzaC1lZ..."
  ],
  "user_data": "#cloud-config\nruncmd:\n- [touch, /root/cloud-init-worked]\n",
  "type": "managed",
  "addons": [
    {
      "name": "string",
      "count": 0
    }
  ],
  "subnets": [
    0
  ],
  "subnets_intern": [
    0
  ],
  "tags": [
    "string"
  ],
  "rollouts": [
    "string"
  ]
}

Pool

JSON

{
  "gpu_supported": true,
  "tag": "string",
  "name": "string",
  "desc_de": "string",
  "desc_en": "string"
}

DeploymentCreateRequestSuccess

JSON

{
  "id": 0
}

ValidationFailure

JSON

{
  "errors": {
    "property1": "string",
    "property2": "string"
  },
  "message": "string"
}

Error

JSON

{
  "error": {
    "errors": {},
    "code": 0,
    "msg": "string"
  }
}

SubError

JSON

{}

TasksGetStatus

JSON

{
  "id": 0,
  "action": "create-server",
  "customer_id": "string",
  "username": "string",
  "hostname": "string",
  "status": "processing",
  "error_message": "string",
  "created_at": "2019-08-24T14:15:22Z"
}

TasksGetCoresStatus

JSON

{
  "id": 0
}

TaskID

JSON

{
  "id": 0
}

GetISOs

JSON

{
  "name": "string",
  "fullName": "string",
  "customer": "string",
  "size": 0
}

TaskResponse

JSON

{
  "id": 0,
  "job_id": "string",
  "action": "string"
}

ServerAddons

JSON

{
  "id": 0,
  "name": "string"
}

ServerCreateSnapshotRequest

JSON

{
  "name": "string"
}

ServerResizeMemoryRequest

JSON

{
  "memory": 0
}

ServerResizeCoresRequest

JSON

{
  "cores": 0
}

Server

JSON

{
  "id": 0,
  "customer_id": "string",
  "project_id": 0,
  "hostname": "string",
  "generation": 0,
  "created_at": "2019-08-24",
  "tags": [
    "string"
  ],
  "location": "string",
  "custom_name": "string",
  "credentials_available": true,
  "deletion_in_progress": true,
  "build_in_progress": true,
  "rootaccess": true,
  "network_adapters": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "server_id": 0,
      "vlan_number": 0,
      "bandwidth": 0,
      "switch": "string",
      "mac_address": "string",
      "mac_spoofing": true,
      "perf_counter_instance_name": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "ip_addresses": [
        {
          "id": 0,
          "server_id": 0,
          "network_adapter_id": "08e934e8-2799-4546-ac08-238367e755eb",
          "subnet_id": 0,
          "customer_id": "string",
          "ip": "string",
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z",
          "subnet": {
            "id": 0,
            "customer_id": "string",
            "type": "IPv4",
            "network": "string",
            "gateway": "string",
            "mask_bits": 0,
            "nameservers": [
              "string"
            ],
            "created_at": "2019-08-24T14:15:22Z",
            "updated_at": "2019-08-24T14:15:22Z"
          }
        }
      ]
    }
  ]
}

ServerDetail

JSON

{
  "id": 0,
  "customer_id": "string",
  "project_id": 0,
  "hostname": "string",
  "generation": 0,
  "created_at": "2019-08-24",
  "tags": [
    "string"
  ],
  "location": "string",
  "custom_name": "string",
  "credentials_available": true,
  "deletion_in_progress": true,
  "build_in_progress": true,
  "rootaccess": true,
  "network_adapters": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "server_id": 0,
      "vlan_number": 0,
      "bandwidth": 0,
      "switch": "string",
      "mac_address": "string",
      "mac_spoofing": true,
      "perf_counter_instance_name": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "ip_addresses": [
        {
          "id": 0,
          "server_id": 0,
          "network_adapter_id": "08e934e8-2799-4546-ac08-238367e755eb",
          "subnet_id": 0,
          "customer_id": "string",
          "ip": "string",
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z",
          "subnet": {
            "id": 0,
            "customer_id": "string",
            "type": "IPv4",
            "network": "string",
            "gateway": "string",
            "mask_bits": 0,
            "nameservers": [
              "string"
            ],
            "created_at": "2019-08-24T14:15:22Z",
            "updated_at": "2019-08-24T14:15:22Z"
          }
        }
      ]
    }
  ],
  "data": {
    "cores": 0,
    "memory": 0,
    "disk": 0,
    "pool": "string",
    "type": "unmanaged",
    "os_name": "string",
    "ostype": "Windows",
    "hostname": "string",
    "username": "user@example.com",
    "customer_id": "string",
    "description": "string",
    "notes": "string",
    "addons": [
      {
        "name": "string",
        "count": 0
      }
    ]
  }
}

ServerDetailInclCustomPriceFlag

JSON

{
  "id": 0,
  "customer_id": "string",
  "project_id": 0,
  "hostname": "string",
  "generation": 0,
  "created_at": "2019-08-24",
  "tags": [
    "string"
  ],
  "location": "string",
  "custom_name": "string",
  "credentials_available": true,
  "deletion_in_progress": true,
  "build_in_progress": true,
  "rootaccess": true,
  "network_adapters": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "server_id": 0,
      "vlan_number": 0,
      "bandwidth": 0,
      "switch": "string",
      "mac_address": "string",
      "mac_spoofing": true,
      "perf_counter_instance_name": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "ip_addresses": [
        {
          "id": 0,
          "server_id": 0,
          "network_adapter_id": "08e934e8-2799-4546-ac08-238367e755eb",
          "subnet_id": 0,
          "customer_id": "string",
          "ip": "string",
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z",
          "subnet": {
            "id": 0,
            "customer_id": "string",
            "type": "IPv4",
            "network": "string",
            "gateway": "string",
            "mask_bits": 0,
            "nameservers": [
              "string"
            ],
            "created_at": "2019-08-24T14:15:22Z",
            "updated_at": "2019-08-24T14:15:22Z"
          }
        }
      ]
    }
  ],
  "data": {
    "cores": 0,
    "memory": 0,
    "disk": 0,
    "pool": "string",
    "type": "unmanaged",
    "os_name": "string",
    "ostype": "Windows",
    "hostname": "string",
    "username": "user@example.com",
    "customer_id": "string",
    "description": "string",
    "notes": "string",
    "addons": [
      {
        "name": "string",
        "count": 0
      }
    ]
  },
  "custom_price": true
}

AddedSnapshotTaskResponse

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 0
  },
  "data": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "string"
        },
        "hostname": {
          "type": "string",
          "example": "string",
          "description": "Hostname of the Server"
        },
        "customer_id": {
          "type": "string",
          "example": "string",
          "description": "Customer ID submitting the request."
        },
        "username": {
          "type": "string",
          "example": "string",
          "description": "Username submitting the request."
        }
      }
    }
  }
}

RenameSnapshotTaskResponse

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 0
  },
  "data": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "example": "string"
        },
        "name": {
          "type": "string",
          "example": "string"
        },
        "hostname": {
          "type": "string",
          "example": "string",
          "description": "Hostname of the Server"
        },
        "customer_id": {
          "type": "string",
          "example": "string",
          "description": "Customer ID submitting the request."
        },
        "username": {
          "type": "string",
          "example": "string",
          "description": "Username submitting the request."
        }
      }
    }
  }
}

DeleteSnapshotTaskResponse

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 0
  },
  "data": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "example": "string"
        },
        "hostname": {
          "type": "string",
          "example": "string",
          "description": "Hostname of the Server"
        },
        "customer_id": {
          "type": "string",
          "example": "string",
          "description": "Customer ID submitting the request."
        },
        "username": {
          "type": "string",
          "example": "string",
          "description": "Username submitting the request."
        }
      }
    }
  }
}

RestoreSnapshotTaskResponse

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 0
  },
  "data": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "example": "string"
        },
        "hostname": {
          "type": "string",
          "example": "string",
          "description": "Hostname of the Server"
        },
        "customer_id": {
          "type": "string",
          "example": "string",
          "description": "Customer ID submitting the request."
        },
        "username": {
          "type": "string",
          "example": "string",
          "description": "Username submitting the request."
        }
      }
    }
  }
}

ServerRenameSnapshotRequest

JSON

{
  "name": "string"
}

ServerData

JSON

{
  "cores": 0,
  "memory": 0,
  "disk": 0,
  "pool": "string",
  "type": "unmanaged",
  "os_name": "string",
  "ostype": "Windows",
  "hostname": "string",
  "username": "user@example.com",
  "customer_id": "string",
  "description": "string",
  "notes": "string",
  "addons": [
    {
      "name": "string",
      "count": 0
    }
  ]
}

TagsForCustomer

JSON

[
  "development",
  "production"
]

ServerTags

JSON

[
  "development",
  "production"
]

Console

JSON

{
  "url": "string"
}

VMDiskUpdateModel

JSON

{
  "size": 50
}

UpdateTaskResponse

JSON

{
  "id": 0
}

PerfomanceDataModel

JSON

{
  "type": "object",
  "properties": null,
  "data": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "units": {
          "type": "integer",
          "format": "string",
          "example": "Byte/s",
          "description": "The Units of the Performance Data given back"
        },
        "perfdata": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "send_persec": {
                "type": "integer",
                "example": 54,
                "description": "Example of Performance Data given back, this elements can change depending on what data is requested"
              }
            }
          }
        }
      }
    }
  }
}

VMDiskModel

JSON

{
  "id": "string",
  "size": 0,
  "perfCounterInstancename": "string"
}

ServerNotesRequest

JSON

{
  "notes": "This is my Database Server"
}

UpdateBootOrderResponse

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 1554
  },
  "data": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "Order ID of the Device"
        },
        "hostname": {
          "type": "string",
          "example": "ts123454",
          "description": "Hostname of the Server"
        },
        "customer_id": {
          "type": "string",
          "example": "328100",
          "description": "Customer ID submitting the request."
        },
        "username": {
          "type": "string",
          "example": "entwickler@centron.de",
          "description": "Username submitting the request."
        }
      }
    }
  }
}

changeBootOrderRequest

JSON

{
  "type": "object",
  "properties": null,
  "id": {
    "type": "integer",
    "example": 2
  }
}

BootOrderModel

JSON

{
  "id": 1,
  "type": "DVD",
  "bootDevice": "sc0s1"
}

ResourceInfo

JSON

{
  "resources_limited": true,
  "usage": {
    "cores": 2,
    "memory": 2,
    "disk": 100
  },
  "limits": {
    "cores": 2,
    "memory": 2,
    "disk": 100
  }
}

Subnet

JSON

{
  "id": 0,
  "customer_id": "string",
  "type": "IPv4",
  "network": "string",
  "gateway": "string",
  "mask_bits": 0,
  "nameservers": [
    "string"
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

NetworkVPC

JSON

{
  "id": "string",
  "type": "string",
  "name": "string",
  "subnets": [
    [
      {
        "id": 2,
        "type": "IPv4",
        "name": "string",
        "network": "192.168.232.0",
        "gateway": "192.168.232.1",
        "mask_bits": 24,
        "nameservers": [
          [
            "192.168.232.1"
          ]
        ]
      }
    ]
  ]
}

NetworkSubnets

JSON

[
  {
    "id": 2,
    "type": "IPv4",
    "name": "string",
    "network": "192.168.232.0",
    "gateway": "192.168.232.1",
    "mask_bits": 24,
    "nameservers": [
      [
        "192.168.232.1"
      ]
    ]
  }
]

NetworkIPs

JSON

{
  "hostname": "ts1000",
  "ip": "1.1.1.1",
  "subnetname": "VLAN_1"
}

NetworkIP

JSON

{
  "id": 0,
  "server_id": 0,
  "network_adapter_id": 0,
  "subnet_id": 0,
  "ip": "255.255.255.0",
  "hostname": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

SubscriptionImportRequest

JSON

{
  "hostname": "ts12345"
}

SubscriptionExportAllRequest

JSON

{
  "target_subscription": "S328100-001"
}

ServerRollouts

JSON

{
  "type": "ansible",
  "rollout": "app_apache",
  "name": "Apache2 Webserver",
  "desc_de": "Der Apache HTTP Server ist ein quelloffenes und freies Produkt der Apache Software Foundation und einer der meistbenutzten Webserver im Internet.",
  "desc_en": "The Apache HTTP Server is an open source and free product from the Apache Software Foundation and one of the most widely used web servers on the Internet.",
  "valid_for": [
    "buster_uefi"
  ],
  "depends_on": [
    "base_rollout"
  ],
  "managed_only": true
}

CustomerInvoice

JSON

{
  "id": 0,
  "month": 0,
  "year": 0,
  "total": 0,
  "customer_id": 0,
  "details": {
    "pools": {
      "worker": {
        "servers": {
          "property1": "string",
          "property2": "string"
        },
        "total": "string"
      },
      "performance": {
        "servers": {
          "property1": "string",
          "property2": "string"
        },
        "total": "string"
      },
      "total": "string"
    },
    "subscriptions": {
      "S328100-001": {
        "total": "string"
      },
      "S328100-002": {
        "total": "string"
      },
      "total": "string"
    },
    "total": "string"
  }
}

GPUModel

JSON

{
  "id": 1,
  "name": "AMD Barco MXRT 5450 1024 MB BIOS",
  "addon_name": "gpu_amd_barco_mxrt_5450_1024mb_bios",
  "pools": [
    "pool_iw3_ssd_gpu"
  ],
  "desc_de": "AMD Barco MXRT 5450 1024 MB BIOS",
  "desc_en": "AMD Barco MXRT 5450 1024 MB BIOS"
}

AvailableGPU

JSON

{
  "name": "AMD Barco MXRT 5450 1024 MB BIOS",
  "addon_name": "gpu_amd_barco_mxrt_5450_1024mb_bios",
  "desc_de": "AMD Barco MXRT 5450 1024 MB BIOS",
  "desc_en": "AMD Barco MXRT 5450 1024 MB BIOS",
  "count": 1
}

RedeployRequest

JSON

{
  "image": "string",
  "password": "string",
  "sshkey": "string",
  "ssh_keys": [
    "ssh-ed25519 AAAAC3NzaC1lZ..."
  ]
}

Licenses

JSON

[
  {
    "id": 999,
    "title": "Microsoft SQL Server 2017 Standard",
    "price": 9.99
  }
]

DeleteRequest

JSON

{
  "hostname": "string"
}

Tier

JSON

{
  "active": true,
  "name": "string",
  "tag": "string",
  "gpu_supported": true
}

TicketCategory

JSON

{
  "categories": {
    "technical": {
      "subcategories": [
        "string"
      ]
    },
    "billing": {
      "subcategories": [
        "string"
      ]
    },
    "misc": {
      "subcategories": [
        "string"
      ]
    }
  }
}

Ticket

JSON

{
  "ticket_id": 17178383,
  "ticket_number": "108751337",
  "title": "Usage Report vs50000",
  "state": "new",
  "create_time": "2025-12-02 12:04:09",
  "changed": "2025-12-02 12:04:10"
}

TicketsList

JSON

[
  {
    "ticket_id": 17178383,
    "ticket_number": "108751337",
    "title": "Usage Report vs50000",
    "state": "new",
    "create_time": "2025-12-02 12:04:09",
    "changed": "2025-12-02 12:04:10"
  }
]

Article

JSON

{
  "article_id": 444444,
  "create_time": "2025-12-02 05:04:09",
  "from": "technik@centron.de",
  "subject": "Usage Report vs111111",
  "body": "Ticket details here",
  "sender_type": "agent",
  "attachments": []
}

ProjectAssignment

JSON

{
  "resources": [
    {
      "id": "string",
      "type": "server"
    }
  ]
}

ProjectAssignmentResult

JSON

[
  {
    "id": "string",
    "type": "server",
    "status": "success",
    "message": "string"
  }
]

ReplyTicketRequest

JSON

{
  "subject": "string",
  "body": "string",
  "attachments": [
    "string"
  ]
}

TicketCloseResponse

JSON

{
  "ticket_number": "10813981",
  "ticket_id": "1656727"
}

CreateTicketRequest

JSON

{
  "category": "technical",
  "subcategory": "ccloud3",
  "subject": "string",
  "message": "string",
  "product": "xv10000",
  "attachments": [
    "string"
  ]
}

TicketCreateResponse

JSON

{
  "article_id": 3917754,
  "ticket_number": "10813994",
  "ticket_id": "1656740"
}

Ticketdetails

JSON

{
  "ticket_id": 22222222,
  "ticket_number": "111111111",
  "title": "Usage Report vs111111",
  "state": "new",
  "articles": [
    {
      "article_id": 444444,
      "create_time": "2025-12-02 05:04:09",
      "from": "technik@centron.de",
      "subject": "Usage Report vs111111",
      "body": "Ticket details here",
      "sender_type": "agent",
      "attachments": []
    }
  ]
}

Status	Beschreibung	Schema
204	The server tags were successfully updated.	`–`
422	–	`–`

API Reference

OAuth

Neues Token generieren #

Servers

Alle Server des Kunden abrufen #

Neuen Server erstellen #

Server-Details per Hostname #

Virtuelle Maschine löschen #

Alle Tasks eines Servers #

Server-Passwort abrufen #

Server Actions

Server neu installieren #

Custom Name setzen #

Server Resize

RAM eines Servers ändern #

Cores eines Servers ändern #

Server Addons

Addon für Server einrichten #

Addon eines Servers löschen #

Server ISO

Verfügbare ISOs des Servers #

Server State

Zustand eines Servers abrufen #

Zustand eines Servers ändern #

Console

Konsolen-URL eines Servers #

Server DVD Drives

DVD-Laufwerke abrufen #

Neues DVD-Laufwerk hinzufügen #

DVD-Laufwerk aktualisieren #

DVD-Laufwerk löschen #

Server Disks

Disks eines Servers abrufen #

Neue Disk hinzufügen #

Disk aktualisieren #

Disk löschen #

Network

Subnetze des Kunden #

IPs eines Subnetzes #

Alle IPs des Kunden #

VPCs des Kunden #

Netzwerk-Adapter eines Servers #

Neue IP zum Adapter hinzufügen #

Scheduled Snapshots

Get scheduled Snapshots #

Creates a scheduler for automatic snapshots #

Delete Scheduler for automatic snapshots #

Snapshots

Get the snapshots of a server by its hostname. #

Create a new Snapshot #

Restore (apply) a snapshot on the Server #

Rename a Snapshot #

Delete a snapshot on the Server #

Performance

Get the Performance Data of a server by its hostname. #

Bootorder

Get the Bootorder of a server by its hostname. #

Change the Bootorder of a server by its hostname. #

Server Notes

Notes for this Server #

delete Notes for this Server #

Tags

Get all Tags for the given customer. #

Get tags for a server by its hostname. #

Update tags for the server. #

Delete all tags for the server. #

GPUs

Get all GPU Models with its current availability. #

Get all available GPU Models for a server. #

Tasks

Get all tasks for the given customer. #

Get a Task by id. #

Pools

Get a list of all public pools and your personal pools. #

Get a single pool by its tag. #

Get a list of all Tiers. #

Subscription

Returns all subscriptions of a customer #

Update display name for the Subscription. #

Returns the Details for a Subscription #