Zum Hauptinhalt springen

List Servers belonging to the executing user

GET/servers/
v2
GET
project-list-servers

Request

Responses

Response-Header

  • X-Pagination-Limitinteger

    The limit used to select the resources for the response

  • X-Pagination-Skipinteger

    The number of skipped items

  • X-Pagination-Pagenumber

    The calculate page of the list response. Refer to parameters to learn more.

  • X-Pagination-TotalCountinteger

    The total amount of items available in the remote ressource. Use this value in combination with the limit to calculate the available pages.

application/json

OK

  • Array[
  • *object
    • clusterNamestring
      required
    • createdAtstring (date-time)
      required
    • customerIdstring
      required
    • descriptionstring
      required
    • disabledReason"suspended"
    • idstring (uuid)
      required
    • imageRefIdstring (uuid)
    • isReadyboolean
      deprecated
      required

      deprecated by property status

    • machineTypeobject
      required
      • cpustring
        required
      • memorystring
        required
      • namestring
        required
    • readinessstring (one of: creating, ready, unready)
      deprecated
      required

      deprecated by property status

    • shortIdstring
      required
    • statisticsBaseDomainstring (hostname)
    • statusstring (one of: pending, ready, unready, suspended)
      required
    • storagestring
      required
  • ]

Usage examples

$ curl \
--fail \
--location \
-H "Authorization: Bearer $MITTWALD_API_TOKEN" \
https://api.mittwald.de/v2/servers?customerId=string&searchTerm=string&limit=50&page=1&sort=createdAt&order=asc