Merge pull request #3295 from aleksandrychev/ENT-8001

Updated Hosts and Health diagnostics APIs documentations
cfengine · Jul 18, 2024 · db69c70 · db69c70
2 parents 30d51cf + b9b151a
commit db69c70
Show file tree

Hide file tree

Showing 2 changed files with 57 additions and 0 deletions.
diff --git a/api/enterprise-api-ref/health-diagnostic.markdown b/api/enterprise-api-ref/health-diagnostic.markdown
@@ -17,6 +17,7 @@ This API provides access to health diagnostic information.
 ```
 {
     "hostsNeverCollected": 1,
+    "deletedHostsReport": 1,
     "hostNotRecentlyCollected": 0,
     "hostsUsingSameIdentity": 0,
     "agentNotRunRecently": 2,
@@ -37,6 +38,7 @@ This API provides access to health diagnostic information.
 ```
 [
     "hostsNeverCollected",
+    "deletedHostsReport",
     "notRecentlyCollected",
     "hostsUsingSameIdentity",
     "agentNotRunRecently",

diff --git a/api/enterprise-api-ref/host.markdown b/api/enterprise-api-ref/host.markdown
@@ -295,6 +295,61 @@ HTTP 200 Ok
 }
 ```
 
+## Restore deleted hosts entry
+
+**URI:** https://hub.cfengine.com/api/hosts/restore-deleted/:host-id
+
+**Method:** POST
+
+Restore host entry in reporting database.
+
+Note: to be able to perform this action related RBAC rule (alias `hosts-undelete.post`) should be enabled.
+
+**Responses:**
+
+| HTTP response code        | Description                |
+|---------------------------|----------------------------|
+| 200 OK                    | Host is found and restored |
+| 404 NOT FOUND             | Host is not found          |
+| 500 Internal server error | Internal server error      |
+
+**Example request (curl):**
+```
+curl -k --user <username>:<password> -X POST https://hub.example.com/api/hosts/restore-deleted/SHA=2123f85b38189008ae12be159fb961584dda1249c94efed43fec2c70f233975d
+```
+**Example response:**
+
+```
+HTTP 200 Ok
+```
+
+## Permanently delete host entry
+
+**URI:** https://hub.cfengine.com/api/hosts/delete-permanently/:host-id
+
+**Method:** POST
+
+Permanently deletes host entry from the reporting database.
+
+Note: to be able to perform this action related RBAC rule (alias `hosts-delete-permanently.delete`) should be enabled.
+
+**Responses:**
+
+| HTTP response code        | Description                                   |
+|---------------------------|-----------------------------------------------|
+| 200 OK                    | Deleted host is found and removed permanently |
+| 404 NOT FOUND             | Host is not found                             |
+| 500 Internal server error | Internal server error                         |
+
+**Example request (curl):**
+```
+curl -k --user <username>:<password> -X DELETE https://hub.example.com/api/hosts/delete-permanently/SHA=2123f85b38189008ae12be159fb961584dda1249c94efed43fec2c70f233975d
+```
+**Example response:**
+
+```
+HTTP 200 Ok
+```
 
 ## List monitoring attributes for host