User GuidesDeveloper ReferenceSupport FAQsLog in

Retrieve In-Memory DB Restores

You can retrieve a list of In-Memory DB restores. The number of results displayed on each page depends on the limit and offset values. While limit limits the number of response elements, offset specifies the starting point within the collection of resource results returned from the server.

Additionally, you can also use a response filter (filter.name) to list only the In-Memory DB restores that contain the specified displayName.

Endpoint

Use a region-specific endpoint from the following list to retrieve a list of restores:

  • https://in-memory-db.de-txl.ionos.com/snapshots/{snapshotId}/restores

  • https://in-memory-db.de-fra.ionos.com/snapshots/{snapshotId}/restores

  • https://in-memory-db.es-vit.ionos.com/snapshots/{snapshotId}/restores

  • https://in-memory-db.gb-lhr.ionos.com/snapshots/{snapshotId}/restores

  • https://in-memory-db.us-ewr.ionos.com/snapshots/{snapshotId}/restores

  • https://in-memory-db.us-las.ionos.com/snapshots/{snapshotId}/restores

  • https://in-memory-db.us-mci.ionos.com/snapshots/{snapshotId}/restores

  • https://in-memory-db.fr-par.ionos.com/snapshots/{snapshotId}/restores

Note: Remember to replace the snapshotId with the relevant UUID. The sample snapshotId used in the example is a8784665-3d99-5464-af32-30a2967f58e7.

Request

curl -X 'GET' \
  'https://in-memory-db.de-fra.ionos.com/snapshots/a8784665-3d99-5464-af32-30a2967f58e7/restores?offset=0&limit=100' \
  -H 'accept: application/json'

To make authenticated requests to the API, the following fields are mandatory in the request header:

Header Parameters
Required
Type
Description

Authorization

yes

string

Provide a header value as Bearer followed by your token.

Content-Type

yes

string

Set this to application/json.

Response

Your values will differ from those in the sample code. It may contain different IDs, timestamps etc.

200 Successful operation

{
  "id": "534e6c-5e4a-5ff3-aa3c-d527f9d5",
  "type": "collection",
  "href": "/snapshots/{snapshotId}/restores",
  "items": [
    {
      "id": "39f0-552b-5182-8939-a3af94c",
      "type": "restore",
      "href": "/snapshots/{snapshotId}/restores/39fe0-552b-5182-8939-a3ac64c",
      "metadata": {
        "createdDate": "2020-12-10T13:37:50+01:00",
        "createdBy": "ionos:identity:::users/872e-b28d-49ed-9d04-fba2d3",
        "createdByUserId": "87fe-b28d-49ed-9d04-fba2cd3",
        "lastModifiedDate": "2020-12-11T13:37:50+01:00",
        "lastModifiedBy": "ionos:identity:::users/8a82e-b28d-49ed-9d04-fba259cd3",
        "lastModifiedByUserId": "87f9ae-b28d-49ed-9d04-fba2c9cd3",
        "resourceURN": "ionos:<product>:<location>:<contract>:<resource-path>",
        "state": "AVAILABLE",
        "message": "In progress.",
        "restoreTime": "2024-07-12T20:01:30.566Z",
        "restoredSnapshotId": "35f999964-5717-4562-b3fc-2c988866afa6"
      },
      "properties": {
        "replicasetId": "35f999964-5717-4562-b3fc-2c988866afa6",
        "displayName": "In-Memory DB snapshot",
        "description": "Snapshot of the In-Memory DB replica set."
      }
    }
  ],
  "offset": 0,
  "limit": 42,
  "_links": {
    "prev": "http://PREVIOUS-PAGE-URI",
    "self": "http://THIS-PAGE-URI",
    "next": "http://NEXT-PAGE-URI"
  }
}
PreviousRetrieve an In-Memory DB RestoreNextFAQs

Last updated