Health

The indexes/{index_name}/health endpoint provides information about the health of a Marqo index.

---

Get health

GET /indexes/{index_name}/health

Gets the health of a Marqo index.

Example

Marqo Open SourceMarqo Cloud

cURLPython

cURL -XGET http://localhost:8882/indexes/my-first-index/health

results = mq.index("my-first-index").health()

For Marqo Cloud, you will need to access the endpoint of your index and replace your_endpoint with this. To do this, visit Find Your Endpoint. You will also need your API Key. To obtain this key visit Find Your API Key.

cURLPython

cURL -XGET your_endpoint/indexes/my-first-index/health
-H 'x-api-key: XXXXXXXXXXXXXXX'

results = mq.index("my-first-index").health()

Response (Healthy Instance): 200 OK

{
  "status": "green",
  "inference": {
    "status": "green"
  },
  "backend": {
    "status": "green",
    "memoryIsAvailable": true,
    "storageIsAvailable": true
  }
}

Response (Full Storage): 200 OK

{
  "status": "yellow",
  "inference": {
    "status": "green"
  },
  "backend": {
    "status": "yellow",
    "memoryIsAvailable": false,
    "storageIsAvailable": false
  }
}