new: get /_admin/support-info (#311)

* new: `Database.support_info()`

* remove `host` assertion

* fix lint

Author: aMahanna

arango/database.py

@@ -32,6 +32,7 @@
     DatabaseDeleteError,
     DatabaseListError,
     DatabasePropertiesError,
+    DatabaseSupportInfoError,
     GraphCreateError,
     GraphDeleteError,
     GraphListError,
@@ -2859,6 +2860,38 @@ def response_handler(resp: Response) -> bool:
 
         return self._execute(request, response_handler)
 
+    ###########
+    # Support #
+    ###########
+
+    def support_info(self) -> Result[Json]:
+        """Return information about the deployment.
+
+        Retrieves deployment information for support purposes.
+        The endpoint returns data about the ArangoDB version used,
+        the host (operating system, server ID, CPU and storage capacity,
+        current utilization, a few metrics) and the other servers in the
+        deployment (in case of Active Failover or cluster deployments).
+
+        NOTE: This method can only be accessed from inside the **_system** database.
+        The is a policy control startup option `--server.support-info-api` that controls
+        if and to whom the API is made available.
+
+        :return: Deployment information.
+        :rtype: dict
+        :raise arango.exceptions.DatabaseSupportInfoError: If retrieval fails.
+        """
+        request = Request(method="get", endpoint="/_admin/support-info")
+
+        def response_handler(resp: Response) -> Json:
+            if resp.is_success:
+                result: Json = resp.body
+                return result
+
+            raise DatabaseSupportInfoError(resp, request)
+
+        return self._execute(request, response_handler)
+
 
 class StandardDatabase(Database):
     """Standard database API wrapper."""

arango/exceptions.py

@@ -360,6 +360,10 @@ class DatabaseDeleteError(ArangoServerError):
     """Failed to delete database."""
 
 
+class DatabaseSupportInfoError(ArangoServerError):
+    """Failed to retrieve support info for deployment."""
+
+
 class DatabaseCompactError(ArangoServerError):
     """Failed to compact databases."""
 

tests/test_database.py

@@ -18,6 +18,7 @@
     DatabaseDeleteError,
     DatabaseListError,
     DatabasePropertiesError,
+    DatabaseSupportInfoError,
     ServerDetailsError,
     ServerEchoError,
     ServerEngineError,
@@ -305,6 +306,14 @@ def test_database_misc_methods(client, sys_db, db, bad_db, cluster, secret):
         bad_db.engine()
     assert err.value.error_code in {11, 1228}
 
+    with assert_raises(DatabaseSupportInfoError) as err:
+        db.support_info()
+
+    info = sys_db.support_info()
+    assert isinstance(info, dict)
+    assert "deployment" in info
+    assert "date" in info
+
     # Test execute JavaScript code
     assert db.execute(1) is None
     assert db.execute(None) == {"error": False, "code": 200}