Fehler, Formate und Limits

Manchmal sind Anfragen an die API nicht erfolgreich. Jedes Mal gibt die API einen HTTP-Statuscode zurück, der die Art des Fehlers angibt, sowie einen Antwortkörper im JSON-Format mit zusätzlichen Informationen.

HTTP Status Errors

	Meaning	How to interpret
200	Success	The request has succeeded.
400	Bad Request	Request has missing arguments or is malformed.
401	Unauthorized	Check your authorization credentials.
403	Forbidden	Request is authenticated but has insufficient permissions.
404	Not Found	Wrong URL or parameters.
422	Unprocessable Entity	May be: wrong validation, wrong parameter, out of range, wrong input.
500	Internal Server Error	The server encountered an unexpected condition that prevented it from fulfilling the request. Most likely, you don't have enough permissions.

API Limitations

Rate Limiting

Es sind bis zu 500 API-Aufrufe pro Minute für POST-Anfragen möglich. Zu den beliebtesten Anfragen, bei denen Sie das Limit erreichen können, gehören:

persistentStorage
dns/{tenantIdentifier}
dns/records/{tenantIdentifier}
tenants/store
templates/addtemplate
vmlist/create
kubernetes/cluster
{tenantIdentifier}/loadBalancer
cluster/database
{tenantIdentifier}/firewall

Device Storage Adding

Instance	Limitation
`ramvalue`	Min: 1; Max: 12
`cpuvalue`	Min: 1; Max: 128

Formate

Für Datumsparameter (wie zum Beispiel startDate und endDate) verwenden wir das ISO8601-Format: YYYY-MM-DD. Beispiel: 2022-02-21.