Retrieve all Clusters

This endpoint enables retrieving all Clusters using pagination and optional filters.

get

/clusters

Authorizations

AuthorizationstringRequired

The token can be generated using the Authentication API.

Query parameters

offsetinteger · int32Optional

The first element (of the total list of elements) to include in the response. Use this parameter together with the limit for pagination.

Default: 0Example: 0

limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of elements to return. Use this parameter together with the offset for pagination.

Default: 100Example: 100

filter.namestring · min: 2 · max: 63Optional

The name of the In-Memory DB cluster. Must be 2-63 characters and must begin and end with an alphanumeric character ([A-Za-z0-9]), with dashes (-), underscores (_), and dots (.) allowed in between.

Example: my-clusterPattern: ^[A-Za-z0-9][-A-Za-z0-9_.]*[A-Za-z0-9]$

filter.statestring · enumOptional

The current lifecycle state of the cluster.

• PROVISIONING: The system is actively applying the changes.
• AVAILABLE: The resource is fully operational with no pending changes.
• UPDATING: A modification is in progress.
• DESTROYING: The resource is being deleted.
• FAILED: A terminal lifecycle error occurred. See statusMessage for details.

Example: AVAILABLEPossible values:

Responses

200

Returned all requested Clusters successfully.

application/json

Pagination information. The offset and limit parameters are used to navigate the list of elements. The _links object contains URLs to navigate the different pages.

idstring · uuidRequired

ID of the list of Cluster resources.

Example: ed17eb1f-ac43-5670-9e63-8be33c475449

typestring · enumRequired

The type of the resource.

Possible values:

hrefstringRequired

The URL of the list of Cluster resources.

Example: /clusters

offsetintegerRead-onlyRequired

The offset specified in the request (if none was specified, the default offset is 0).

Example: 0

limitintegerRead-onlyRequired

The limit specified in the request (if none was specified, use the endpoint's default pagination limit).

Example: 42

400

Bad Request

The request send to the API was malformed.

application/json

401

Unauthorized

The request is missing authorization information or the authorization information provided are expired.

application/json

403

Not Allowed

The user issuing the request does not have the needed permissions.

application/json

429

Too Many Requests

The user has sent too many requests in a given amount of time.

application/json

500

Internal Server Error

An internal error occurred. We apologize for the inconvenience!

application/json

503

Service Unavailable

The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.

application/json

default

Unexpected Internal Server Error

An unexpected internal error occurred. We apologize for the inconvenience!

application/json

get/clusters

GET /v2/clusters HTTP/1.1
Host: in-memory-db.de-fra.ionos.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "ed17eb1f-ac43-5670-9e63-8be33c475449",
  "type": "collection",
  "href": "/clusters",
  "items": [
    {
      "id": "e69b22a5-8fee-56b1-b6fb-4a07e4205ead",
      "type": "cluster",
      "href": "/clusters/e69b22a5-8fee-56b1-b6fb-4a07e4205ead",
      "metadata": {
        "createdDate": "2020-12-10T13:37:50+01:00",
        "createdBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "createdByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "lastModifiedDate": "2020-12-11T13:37:50+01:00",
        "lastModifiedBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "lastModifiedByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "resourceURN": "ionos:<product>:<location>:<contract>:<resource-path>",
        "state": "AVAILABLE",
        "statusMessage": "Provisioning failed: insufficient quota.",
        "dnsName": "59348c25-2d4b-4870-a5b6-33c48fce1c58.in-memory-db.de-txl.ionos.com"
      },
      "properties": {
        "name": "my-cluster",
        "description": "Production cache cluster for the CMS platform.",
        "version": "9.0",
        "instances": {
          "count": 1,
          "cores": 4,
          "ram": 8
        },
        "connection": {
          "datacenterId": "5a029f4a-72e5-11ec-90d6-0242ac120003",
          "lanId": "2",
          "primaryInstanceAddress": "192.168.2.101/24"
        },
        "persistenceMode": "RDB",
        "evictionPolicy": "allkeys-lru",
        "snapshot": {
          "location": "eu-central-3",
          "retentionDays": 14,
          "snapshotHours": [
            0,
            6,
            12,
            18
          ]
        },
        "maintenanceWindow": {
          "time": "16:30:59",
          "dayOfTheWeek": "Monday"
        },
        "credentials": {
          "username": "cache_admin"
        },
        "logsEnabled": false,
        "metricsEnabled": false
      }
    }
  ],
  "offset": 0,
  "limit": 42,
  "_links": {
    "prev": "http://PREVIOUS-PAGE-URI",
    "self": "http://THIS-PAGE-URI",
    "next": "http://NEXT-PAGE-URI"
  }
}