added GetSensorUsageHourly as this allows you to pull hourly for Cloud based; added it to test sensor; tested it in production and works since the endpoint does work and provides hourly usage billing that is used for Cloud (reserved hourly) usage

Author: Adam Taveras

src/falconpy/_endpoint/_sensor_usage.py

@@ -58,5 +58,27 @@
         "in": "query"
       }
     ]
+  ],
+  [
+    "GetSensorUsageHourly",
+    "GET",
+    "/billing-dashboards-usage/aggregates/hourly-average/v1",
+    "Fetches hourly average. Each data point represents the average of how many unique AIDs were seen per week "
+    "for the previous 28 days.",
+    "sensor_usage",
+    [
+      {
+        "type": "string",
+        "description": "The FQL search filter. Allowed fields:\n\"event_date\" : A specified date that will be "
+        " final date of the results returned. Specified date cannot be after the default.\n\tFormat: "
+        "'2024-06-11'\n\tDefault: the current date, minus 2 days, in UTC\n\"period\" : An integer surrounded by single "
+        "quotes representing the number of days to return.\n\tFormat: '30'\n\tDefault: '28'\n\tMinimum: '1'\n\tMaximum: "
+        " '395'\n\"selected_cids\" : A comma separated list of CIDs to return data for. Caller must be a parent CID or "
+        "have special access enabled.\n\tFormat: 'cid_1,cid_2,cid_3'\n\tDefault: for parent CIDs the default is the "
+        "parent and all children, otherwise the current CID",
+        "name": "filter",
+        "in": "query"
+      }
+    ]
   ]
 ]

src/falconpy/sensor_usage.py

@@ -97,4 +97,48 @@ def get_weekly_usage(self: object, parameters: dict = None, **kwargs) -> Union[D
             params=parameters
             )
 
+    @force_default(defaults=["parameters"], default_types=["dict"])
+    def get_hourly_usage(self: object, parameters: dict = None, **kwargs) -> Union[Dict[str, Union[int, dict]], Result]:
+        """Fetch hourly sensor usage average used to measure cloud usage.
+
+        Each data point represents the average of how many unique AIDs were seen per week for the previous 28 days.
+
+        Keyword arguments:
+        filter -- The FQL search filter.
+                  Allowed fields:
+                    event_date - A specified date that will be final date of the results returned.
+                                 Specified date cannot be after the default.
+                                 Format: '2024-06-11'
+                                 Default: the current date, minus 2 days, in UTC
+                    period - An integer surrounded by single quotes representing the number of days to return.
+                             Format: '30'
+                             Default: '28'
+                             Minimum: '1'
+                             Maximum: '395'
+                    selected_cids - A comma delimited list of CIDs to return data for.
+                                    Caller must be a parent CID or have special access enabled.
+                                    Format: 'cid_1,cid_2,cid_3'
+                                    Default: for parent CIDs the default is the parent and all children,
+                                             otherwise the current CID
+        parameters -- Full parameters payload dictionary. Not required if using other keywords.
+
+        This method only supports keywords for providing arguments.
+
+        Returns: dict object containing API response.
+
+        HTTP Method: GET
+
+        Swagger URL
+        https://assets.falcon.crowdstrike.com/support/api/swagger.html#/sensor-usage-api/GetSensorUsageWeekly
+        Endpoint is not in Swagger file, but allows you to pull `hourly` usage which is used to determine cloud usage
+        """
+        return process_service_request(
+            calling_object=self,
+            endpoints=Endpoints,
+            operation_id="GetSensorUsageHourly",
+            keywords=kwargs,
+            params=parameters
+            )
+
     GetSensorUsageWeekly = get_weekly_usage
+    GetSensorUsageHourly = get_hourly_usage

tests/test_sensor_usage.py

@@ -23,7 +23,8 @@ class TestSensorUsage:
     def test_all_code_paths(self):
         error_checks = True
         tests = {
-            "GetWeeklySensorUsage": falcon.get_weekly_usage()
+            "GetWeeklySensorUsage": falcon.get_weekly_usage(),
+            "GetHourlySensorUsage": falcon.get_hourly_usage()
         }
         for key in tests:
             if tests[key]["status_code"] not in AllowedResponses: