{
  "id": "replica_sources-alerts",
  "title": "Database replica sources alerts requests",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/requests/bdbs/replica_sources-alerts/",
  "summary": "Replica source alert requests",
  "content": "\n| Method | Path | Description |\n|--------|------|-------------|\n| [GET](#get-all-bdbs-replica-sources-alerts) | `/v1/bdbs/replica_sources/alerts` | Get all replica sources alert states for all BDBs |\n| [GET](#get-bdbs-replica-sources-alerts) | `/v1/bdbs/replica_sources/alerts/{uid}` | Get all replica sources alert states for a BDB |\n| [GET](#get-bdbs-replica_source-all-alerts) | `/v1/bdbs/replica_sources/alerts/{uid}/{replica_src_id}` | Get all alert states for a replica source |\n| [GET](#get-bdbs-replica-source-alert) | `/v1/bdbs/replica_sources/alerts/{uid}/{replica_src_id}/{alert}` | Get a replica source alert state |\n\n## Get all DBs replica sources alert states {#get-all-bdbs-replica-sources-alerts}\n\n\tGET /v1/bdbs/replica_sources/alerts\n\nGet all alert states for all replica sources of all BDBs.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_all_bdbs_alerts]() |\n\n### Request {#get-all-request} \n\n#### Example HTTP request\n\n\tGET /v1/bdbs/replica_sources/alerts \n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n### Response {#get-all-response} \n\nReturns a hash of alert UIDs and the alerts states for each BDB.\n\nSee [REST API alerts overview]() for a description of the alert state object.\n\n#### Example JSON body\n\n```json\n{\n    \"1\": {\n        \"replica_src_syncer_connection_error\": {\n            \"enabled\": true,\n            \"state\": true,\n            \"threshold\": \"80\",\n            \"change_time\": \"2014-08-29T11:19:49Z\",\n            \"severity\": \"WARNING\",\n            \"change_value\": {\n                \"state\": true,\n                \"threshold\": \"80\",\n                \"memory_util\": 81.2\n            }\n        },\n        \"...\"\n    },\n    \"...\"\n}\n```\n\n### Status codes {#get-all-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n\n## Get DB replica source alert states {#get-bdbs-replica-sources-alerts}\n\n\tGET /v1/bdbs/replica_sources/alerts/{int: uid}\n\nGet all alert states for all replica sources of a specific bdb.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_bdb_alerts]() |\n\n### Request {#get-request-all-replica-alerts} \n\n#### Example HTTP request\n\n\tGET /v1/bdbs/replica_sources/alerts/1 \n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n#### URL parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| uid | integer | The unique ID of the database |\n\n### Response {#get-response-all-replica-alerts} \n\nReturns a hash of [alert objects]() and their states.\n\n#### Example JSON body\n\n```json\n{\n    \"replica_src_syncer_connection_error\": {\n        \"enabled\": true,\n        \"state\": true,\n        \"threshold\": \"80\",\n        \"severity\": \"WARNING\",\n        \"change_time\": \"2014-08-29T11:19:49Z\",\n        \"change_value\": {\n            \"state\": true,\n            \"threshold\": \"80\",\n            \"memory_util\": 81.2\n        }\n    },\n    \"...\"\n}\n```\n\n### Status codes {#get-status-codes-all-replica-alerts} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | Specified bdb does not exist |\n\n## Get replica source alert states {#get-bdbs-replica_source-all-alerts}\n\n\tGET /v1/bdbs/replica_sources/alerts/{int: uid}/{int: replica_src_id}\n\nGet all alert states for a specific replica source of a bdb.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_bdb_alerts]() |\n\n### Request {#get-request-replica-alerts} \n\n#### Example HTTP request\n\n\tGET /v1/bdbs/replica_sources/alerts/1/2 \n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n#### URL parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| uid | integer | The unique ID of the database |\n| replica_src_id | integer | The ID of the replica source in this BDB |\n\n### Response {#get-response-replica-alerts} \n\nReturns a hash of [alert objects]() and their states.\n\n#### Example JSON body\n\n```json\n{\n    \"replica_src_syncer_connection_error\": {\n        \"enabled\": true,\n        \"state\": true,\n        \"threshold\": \"80\",\n        \"severity\": \"WARNING\",\n        \"change_time\": \"2014-08-29T11:19:49Z\",\n        \"change_value\": {\n            \"state\": true,\n            \"threshold\": \"80\",\n            \"memory_util\": 81.2\n        }\n    },\n    \"...\"\n}\n```\n\n### Status codes {#get-status-codes-replica-alerts} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | Specified bdb does not exist |\n\n## Get replica source alert state {#get-bdbs-replica-source-alert}\n\n\tGET /v1/bdbs/replica_sources/alerts/{int: uid}/{int: replica_src_id}/{alert}\n\nGet a replica source alert state of a specific bdb.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_bdb_alerts]() |\n\n### Request {#get-request-alert} \n\n#### Example HTTP request\n\n\tGET /v1/bdbs/replica_sources/alerts/1/2/replica_src_syncer_connection_error \n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n\n#### URL parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| uid | integer | The unique ID of the database |\n| replica_src_id | integer | The ID of the replica source in this BDB |\n| alert | string | The alert name |\n\n### Response {#get-response-alert} \n\nReturns an [alert state object]().\n\n#### Example JSON body\n\n```json\n{\n    \"enabled\": true,\n    \"state\": true,\n    \"threshold\": \"80\",\n    \"severity\": \"WARNING\",\n    \"change_time\": \"2014-08-29T11:19:49Z\",\n    \"change_value\": {\n        \"state\": true,\n        \"threshold\": \"80\",\n        \"memory_util\": 81.2\n    }\n}\n```\n\n### Status codes {#get-status-codes-alert} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n| [400 Bad Request](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1) | Bad request |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | Specified alert or bdb does not exist |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}