catocli 3.0.14__py3-none-any.whl → 3.0.22__py3-none-any.whl

catocli/parsers/mutation_site/__init__.py

@@ -114,21 +114,6 @@ def mutation_site_parse(mutation_subparsers):
     mutation_site_addSocketSite_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
     mutation_site_addSocketSite_parser.set_defaults(func=createRequest,operation_name='mutation.site.addSocketSite')
 
-    mutation_site_updateSiteGeneralDetails_parser = mutation_site_subparsers.add_parser('updateSiteGeneralDetails', 
-            help='updateSiteGeneralDetails() site operation', 
-            usage=get_help("mutation_site_updateSiteGeneralDetails"))
-
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('json', nargs='?', default='{}', help='Variables in JSON format (defaults to empty object if not provided).')
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('-accountID', help='The cato account ID to use for this operation. Overrides the account_id value in the profile setting.  This is use for reseller and MSP accounts to run queries against cato sub accounts from the parent account.')
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('-t', const=True, default=False, nargs='?', help='Print GraphQL query without sending API call')
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('-v', const=True, default=False, nargs='?', help='Verbose output')
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('-p', const=True, default=False, nargs='?', help='Pretty print')
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('-n', '--stream-events', dest='stream_events', help='Send events over network to host:port TCP')
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('-z', '--sentinel', dest='sentinel', help='Send events to Sentinel customerid:sharedkey')
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('-H', '--header', action='append', dest='headers', help='Add custom headers in "Key: Value" format. Can be used multiple times.')
-    mutation_site_updateSiteGeneralDetails_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
-    mutation_site_updateSiteGeneralDetails_parser.set_defaults(func=createRequest,operation_name='mutation.site.updateSiteGeneralDetails')
-
     mutation_site_removeSite_parser = mutation_site_subparsers.add_parser('removeSite', 
             help='removeSite() site operation', 
             usage=get_help("mutation_site_removeSite"))
@@ -519,6 +504,21 @@ def mutation_site_parse(mutation_subparsers):
     mutation_site_removeSiteBwLicense_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
     mutation_site_removeSiteBwLicense_parser.set_defaults(func=createRequest,operation_name='mutation.site.removeSiteBwLicense')
 
+    mutation_site_updateSiteGeneralDetails_parser = mutation_site_subparsers.add_parser('updateSiteGeneralDetails', 
+            help='updateSiteGeneralDetails() site operation', 
+            usage=get_help("mutation_site_updateSiteGeneralDetails"))
+
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('json', nargs='?', default='{}', help='Variables in JSON format (defaults to empty object if not provided).')
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('-accountID', help='The cato account ID to use for this operation. Overrides the account_id value in the profile setting.  This is use for reseller and MSP accounts to run queries against cato sub accounts from the parent account.')
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('-t', const=True, default=False, nargs='?', help='Print GraphQL query without sending API call')
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('-v', const=True, default=False, nargs='?', help='Verbose output')
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('-p', const=True, default=False, nargs='?', help='Pretty print')
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('-n', '--stream-events', dest='stream_events', help='Send events over network to host:port TCP')
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('-z', '--sentinel', dest='sentinel', help='Send events to Sentinel customerid:sharedkey')
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('-H', '--header', action='append', dest='headers', help='Add custom headers in "Key: Value" format. Can be used multiple times.')
+    mutation_site_updateSiteGeneralDetails_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
+    mutation_site_updateSiteGeneralDetails_parser.set_defaults(func=createRequest,operation_name='mutation.site.updateSiteGeneralDetails')
+
     mutation_site_addSocketAddOnCard_parser = mutation_site_subparsers.add_parser('addSocketAddOnCard', 
             help='addSocketAddOnCard() site operation', 
             usage=get_help("mutation_site_addSocketAddOnCard"))

catocli/parsers/mutation_sites/__init__.py

@@ -114,21 +114,6 @@ def mutation_sites_parse(mutation_subparsers):
     mutation_sites_addSocketSite_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
     mutation_sites_addSocketSite_parser.set_defaults(func=createRequest,operation_name='mutation.sites.addSocketSite')
 
-    mutation_sites_updateSiteGeneralDetails_parser = mutation_sites_subparsers.add_parser('updateSiteGeneralDetails', 
-            help='updateSiteGeneralDetails() sites operation', 
-            usage=get_help("mutation_sites_updateSiteGeneralDetails"))
-
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('json', nargs='?', default='{}', help='Variables in JSON format (defaults to empty object if not provided).')
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-accountID', help='The cato account ID to use for this operation. Overrides the account_id value in the profile setting.  This is use for reseller and MSP accounts to run queries against cato sub accounts from the parent account.')
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-t', const=True, default=False, nargs='?', help='Print GraphQL query without sending API call')
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-v', const=True, default=False, nargs='?', help='Verbose output')
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-p', const=True, default=False, nargs='?', help='Pretty print')
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-n', '--stream-events', dest='stream_events', help='Send events over network to host:port TCP')
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-z', '--sentinel', dest='sentinel', help='Send events to Sentinel customerid:sharedkey')
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-H', '--header', action='append', dest='headers', help='Add custom headers in "Key: Value" format. Can be used multiple times.')
-    mutation_sites_updateSiteGeneralDetails_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
-    mutation_sites_updateSiteGeneralDetails_parser.set_defaults(func=createRequest,operation_name='mutation.sites.updateSiteGeneralDetails')
-
     mutation_sites_removeSite_parser = mutation_sites_subparsers.add_parser('removeSite', 
             help='removeSite() sites operation', 
             usage=get_help("mutation_sites_removeSite"))
@@ -519,6 +504,21 @@ def mutation_sites_parse(mutation_subparsers):
     mutation_sites_removeSiteBwLicense_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
     mutation_sites_removeSiteBwLicense_parser.set_defaults(func=createRequest,operation_name='mutation.sites.removeSiteBwLicense')
 
+    mutation_sites_updateSiteGeneralDetails_parser = mutation_sites_subparsers.add_parser('updateSiteGeneralDetails', 
+            help='updateSiteGeneralDetails() sites operation', 
+            usage=get_help("mutation_sites_updateSiteGeneralDetails"))
+
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('json', nargs='?', default='{}', help='Variables in JSON format (defaults to empty object if not provided).')
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-accountID', help='The cato account ID to use for this operation. Overrides the account_id value in the profile setting.  This is use for reseller and MSP accounts to run queries against cato sub accounts from the parent account.')
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-t', const=True, default=False, nargs='?', help='Print GraphQL query without sending API call')
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-v', const=True, default=False, nargs='?', help='Verbose output')
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-p', const=True, default=False, nargs='?', help='Pretty print')
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-n', '--stream-events', dest='stream_events', help='Send events over network to host:port TCP')
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-z', '--sentinel', dest='sentinel', help='Send events to Sentinel customerid:sharedkey')
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('-H', '--header', action='append', dest='headers', help='Add custom headers in "Key: Value" format. Can be used multiple times.')
+    mutation_sites_updateSiteGeneralDetails_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
+    mutation_sites_updateSiteGeneralDetails_parser.set_defaults(func=createRequest,operation_name='mutation.sites.updateSiteGeneralDetails')
+
     mutation_sites_addSocketAddOnCard_parser = mutation_sites_subparsers.add_parser('addSocketAddOnCard', 
             help='addSocketAddOnCard() sites operation', 
             usage=get_help("mutation_sites_addSocketAddOnCard"))

catocli/parsers/query_accountMetrics/README.md

@@ -38,25 +38,115 @@ catocli query accountMetrics '{
 }'
 ```
 
+## Advanced Usage
+### Additional Examples
+- Example all values and lables
+- Example all values and lables for a single account
+- Example all values and lables for a single user
+- Last hour no filters
+
+# Example all values and lables
+
+```bash
+# Example all values and lables for a single account
+catocli query accountMetrics '{
+    "buckets": 24,
+    "groupDevices": true,
+    "groupInterfaces": true,
+    "labels": [
+        "bytesDownstream",
+        "bytesDownstreamMax",
+        "bytesTotal",
+        "bytesUpstream",
+        "bytesUpstreamMax",
+        "health",
+        "jitterDownstream",
+        "jitterUpstream",
+        "lastMileLatency",
+        "lastMilePacketLoss",
+        "lostDownstream",
+        "lostDownstreamPcnt",
+        "lostUpstream",
+        "lostUpstreamPcnt",
+        "packetsDiscardedDownstream",
+        "packetsDiscardedDownstreamPcnt",
+        "packetsDiscardedUpstream",
+        "packetsDiscardedUpstreamPcnt",
+        "packetsDownstream",
+        "packetsUpstream",
+        "rtt",
+        "tunnelAge"
+    ],
+    "perSecond": true,
+    "siteIDs": [
+        "132814"
+    ],
+    "timeFrame": "last.P1D",
+    "toRate": true,
+    "useDefaultSizeBucket": true,
+    "withMissingData": true
+}' 
+```
+
+# Example all values and lables for a single user
+
+```bash
+# Example all values and lables for a single user
+catocli query accountMetrics '{
+    "buckets": 24,
+    "labels": [
+        "health",
+        "jitterDownstream",
+        "jitterUpstream",
+        "lastMileLatency",
+        "lastMilePacketLoss",
+        "lostDownstream",
+        "lostDownstreamPcnt",
+        "lostUpstream",
+        "lostUpstreamPcnt",
+        "packetsDiscardedDownstream",
+        "packetsDiscardedDownstreamPcnt",
+        "packetsDiscardedUpstream",
+        "packetsDiscardedUpstreamPcnt",
+        "packetsDownstream",
+        "packetsUpstream"
+    ],
+    "timeFrame": "last.PT1H",
+    "userIDs": [
+        "0"
+    ]
+}'
+```
+
+# Last hour no filters
+
+```bash
+# Last hour no filters
+catocli query accountMetrics '{ 
+    "timeFrame":"last.PT1H"
+}'
+```
+
+
 
 #### TimeFrame Parameter Examples
 
 The `timeFrame` parameter supports both relative time ranges and absolute date ranges:
 
 **Relative Time Ranges:**
-- `"last.PT5M"` = Previous 5 minutes
-- `"last.PT1H"` = Previous 1 hour  
-- `"last.P1D"` = Previous 1 day
-- `"last.P14D"` = Previous 14 days
-- `"last.P1M"` = Previous 1 month
+- "last.PT5M" = Previous 5 minutes
+- "last.PT1H" = Previous 1 hour  
+- "last.P1D" = Previous 1 day
+- "last.P14D" = Previous 14 days
+- "last.P1M" = Previous 1 month
 
 **Absolute Date Ranges:**
 Format: `"utc.YYYY-MM-{DD/HH:MM:SS--DD/HH:MM:SS}"`
 
-- Single day: `"utc.2023-02-{28/00:00:00--28/23:59:59}"`
-- Multiple days: `"utc.2023-02-{25/00:00:00--28/23:59:59}"`  
-- Specific hours: `"utc.2023-02-{28/09:00:00--28/17:00:00}"`
-- Across months: `"utc.2023-{01-28/00:00:00--02-03/23:59:59}"`
+- Single day: "utc.2023-02-{28/00:00:00--28/23:59:59}"  
+- Multiple days: "utc.2023-02-{25/00:00:00--28/23:59:59}"  
+- Specific hours: "utc.2023-02-{28/09:00:00--28/17:00:00}"
+- Across months: "utc.2023-{01-28/00:00:00--02-03/23:59:59}"
 
 
 #### Operation Arguments for query.accountMetrics ####

catocli/parsers/query_accountMetrics/__init__.py

@@ -16,4 +16,10 @@ def query_accountMetrics_parse(query_subparsers):
     query_accountMetrics_parser.add_argument('-z', '--sentinel', dest='sentinel', help='Send events to Sentinel customerid:sharedkey')
     query_accountMetrics_parser.add_argument('-H', '--header', action='append', dest='headers', help='Add custom headers in "Key: Value" format. Can be used multiple times.')
     query_accountMetrics_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
+
+
+    query_accountMetrics_parser.add_argument('-f', '--format', choices=['json', 'csv'], help='Output format (default: formatted json, use -raw for original json)')
+    query_accountMetrics_parser.add_argument('-raw', '--raw', dest='raw_output', action='store_true', help='Return raw/original JSON format (bypasses default formatting)')
+    query_accountMetrics_parser.add_argument('--csv-filename', dest='csv_filename', help='Override CSV file name (default: accountmetrics.csv)')
+    query_accountMetrics_parser.add_argument('--append-timestamp', dest='append_timestamp', action='store_true', help='Append timestamp to the CSV file name')
     query_accountMetrics_parser.set_defaults(func=createRequest,operation_name='query.accountMetrics')

catocli/parsers/query_appStats/README.md

@@ -74,7 +74,7 @@ catocli query appStats '{
 # Query to export application_name, user_name and risk_score with traffic sum(upstream, downstream, trafffic) for last day
 
 ```bash
-## Query to export application_name, user_name and risk_score with traffic sum(upstream, downstream, trafffic) for last day
+## Query to export application_name, user_name and risk_score with traffic sum(upstream, downstream, trafffic) for last day exported to csv format
 catocli query appStats '{
     "appStatsFilter": [],
     "appStatsSort": [],
@@ -104,7 +104,7 @@ catocli query appStats '{
         }
     ],
     "timeFrame": "last.P1D"
-}' -f csv
+}' -f csv --csv-filename app_user_account_metrics_report.csv
 ```
 
 
@@ -115,19 +115,19 @@ catocli query appStats '{
 The `timeFrame` parameter supports both relative time ranges and absolute date ranges:
 
 **Relative Time Ranges:**
-- `"last.PT5M"` = Previous 5 minutes
-- `"last.PT1H"` = Previous 1 hour  
-- `"last.P1D"` = Previous 1 day
-- `"last.P14D"` = Previous 14 days
-- `"last.P1M"` = Previous 1 month
+- "last.PT5M" = Previous 5 minutes
+- "last.PT1H" = Previous 1 hour  
+- "last.P1D" = Previous 1 day
+- "last.P14D" = Previous 14 days
+- "last.P1M" = Previous 1 month
 
 **Absolute Date Ranges:**
 Format: `"utc.YYYY-MM-{DD/HH:MM:SS--DD/HH:MM:SS}"`
 
-- Single day: `"utc.2023-02-{28/00:00:00--28/23:59:59}"`
-- Multiple days: `"utc.2023-02-{25/00:00:00--28/23:59:59}"`  
-- Specific hours: `"utc.2023-02-{28/09:00:00--28/17:00:00}"`
-- Across months: `"utc.2023-{01-28/00:00:00--02-03/23:59:59}"`
+- Single day: "utc.2023-02-{28/00:00:00--28/23:59:59}"  
+- Multiple days: "utc.2023-02-{25/00:00:00--28/23:59:59}"  
+- Specific hours: "utc.2023-02-{28/09:00:00--28/17:00:00}"
+- Across months: "utc.2023-{01-28/00:00:00--02-03/23:59:59}"
 
 
 #### Operation Arguments for query.appStats ####

catocli/parsers/query_appStats/__init__.py

@@ -17,7 +17,9 @@ def query_appStats_parse(query_subparsers):
     query_appStats_parser.add_argument('-H', '--header', action='append', dest='headers', help='Add custom headers in "Key: Value" format. Can be used multiple times.')
     query_appStats_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
 
-    query_appStats_parser.add_argument('-f', '--format', choices=['json', 'csv'], default='json', help='Output format (default: json)')
-    query_appStats_parser.add_argument('--csv-filename', dest='csv_filename', help='Override CSV file name (default: accountmetrics.csv)')
+
+    query_appStats_parser.add_argument('-f', '--format', choices=['json', 'csv'], help='Output format (default: formatted json, use -raw for original json)')
+    query_appStats_parser.add_argument('-raw', '--raw', dest='raw_output', action='store_true', help='Return raw/original JSON format (bypasses default formatting)')
+    query_appStats_parser.add_argument('--csv-filename', dest='csv_filename', help='Override CSV file name (default: appstats.csv)')
     query_appStats_parser.add_argument('--append-timestamp', dest='append_timestamp', action='store_true', help='Append timestamp to the CSV file name')
     query_appStats_parser.set_defaults(func=createRequest,operation_name='query.appStats')

catocli/parsers/query_appStatsTimeSeries/README.md

@@ -72,7 +72,7 @@ catocli query appStatsTimeSeries '{
             "fieldName": "traffic"
         }
     ],
-    "timeFrame": "last.PT1H"
+    "timeFrame": "last.P1D"
 }'
 ```
 
@@ -124,19 +124,19 @@ catocli query appStatsTimeSeries '{
 The `timeFrame` parameter supports both relative time ranges and absolute date ranges:
 
 **Relative Time Ranges:**
-- `"last.PT5M"` = Previous 5 minutes
-- `"last.PT1H"` = Previous 1 hour  
-- `"last.P1D"` = Previous 1 day
-- `"last.P14D"` = Previous 14 days
-- `"last.P1M"` = Previous 1 month
+- "last.PT5M" = Previous 5 minutes
+- "last.PT1H" = Previous 1 hour  
+- "last.P1D" = Previous 1 day
+- "last.P14D" = Previous 14 days
+- "last.P1M" = Previous 1 month
 
 **Absolute Date Ranges:**
 Format: `"utc.YYYY-MM-{DD/HH:MM:SS--DD/HH:MM:SS}"`
 
-- Single day: `"utc.2023-02-{28/00:00:00--28/23:59:59}"`
-- Multiple days: `"utc.2023-02-{25/00:00:00--28/23:59:59}"`  
-- Specific hours: `"utc.2023-02-{28/09:00:00--28/17:00:00}"`
-- Across months: `"utc.2023-{01-28/00:00:00--02-03/23:59:59}"`
+- Single day: "utc.2023-02-{28/00:00:00--28/23:59:59}"  
+- Multiple days: "utc.2023-02-{25/00:00:00--28/23:59:59}"  
+- Specific hours: "utc.2023-02-{28/09:00:00--28/17:00:00}"
+- Across months: "utc.2023-{01-28/00:00:00--02-03/23:59:59}"
 
 
 #### Operation Arguments for query.appStatsTimeSeries ####

catocli/parsers/query_appStatsTimeSeries/__init__.py

@@ -17,7 +17,9 @@ def query_appStatsTimeSeries_parse(query_subparsers):
     query_appStatsTimeSeries_parser.add_argument('-H', '--header', action='append', dest='headers', help='Add custom headers in "Key: Value" format. Can be used multiple times.')
     query_appStatsTimeSeries_parser.add_argument('--headers-file', dest='headers_file', help='Load headers from a file. Each line should contain a header in "Key: Value" format.')
 
-    query_appStatsTimeSeries_parser.add_argument('-f', '--format', choices=['json', 'csv'], default='json', help='Output format (default: json)')
-    query_appStatsTimeSeries_parser.add_argument('--csv-filename', dest='csv_filename', help='Override CSV file name (default: accountmetrics.csv)')
+
+    query_appStatsTimeSeries_parser.add_argument('-f', '--format', choices=['json', 'csv'], help='Output format (default: formatted json, use -raw for original json)')
+    query_appStatsTimeSeries_parser.add_argument('-raw', '--raw', dest='raw_output', action='store_true', help='Return raw/original JSON format (bypasses default formatting)')
+    query_appStatsTimeSeries_parser.add_argument('--csv-filename', dest='csv_filename', help='Override CSV file name (default: appstatstimeseries.csv)')
     query_appStatsTimeSeries_parser.add_argument('--append-timestamp', dest='append_timestamp', action='store_true', help='Append timestamp to the CSV file name')
     query_appStatsTimeSeries_parser.set_defaults(func=createRequest,operation_name='query.appStatsTimeSeries')

catocli/parsers/query_auditFeed/README.md

@@ -40,19 +40,19 @@ catocli query auditFeed '{
 The `timeFrame` parameter supports both relative time ranges and absolute date ranges:
 
 **Relative Time Ranges:**
-- `"last.PT5M"` = Previous 5 minutes
-- `"last.PT1H"` = Previous 1 hour  
-- `"last.P1D"` = Previous 1 day
-- `"last.P14D"` = Previous 14 days
-- `"last.P1M"` = Previous 1 month
+- "last.PT5M" = Previous 5 minutes
+- "last.PT1H" = Previous 1 hour  
+- "last.P1D" = Previous 1 day
+- "last.P14D" = Previous 14 days
+- "last.P1M" = Previous 1 month
 
 **Absolute Date Ranges:**
 Format: `"utc.YYYY-MM-{DD/HH:MM:SS--DD/HH:MM:SS}"`
 
-- Single day: `"utc.2023-02-{28/00:00:00--28/23:59:59}"`
-- Multiple days: `"utc.2023-02-{25/00:00:00--28/23:59:59}"`  
-- Specific hours: `"utc.2023-02-{28/09:00:00--28/17:00:00}"`
-- Across months: `"utc.2023-{01-28/00:00:00--02-03/23:59:59}"`
+- Single day: "utc.2023-02-{28/00:00:00--28/23:59:59}"  
+- Multiple days: "utc.2023-02-{25/00:00:00--28/23:59:59}"  
+- Specific hours: "utc.2023-02-{28/09:00:00--28/17:00:00}"
+- Across months: "utc.2023-{01-28/00:00:00--02-03/23:59:59}"
 
 
 #### Operation Arguments for query.auditFeed ####

catocli/parsers/query_events/README.md

@@ -46,19 +46,19 @@ catocli query events '{
 The `timeFrame` parameter supports both relative time ranges and absolute date ranges:
 
 **Relative Time Ranges:**
-- `"last.PT5M"` = Previous 5 minutes
-- `"last.PT1H"` = Previous 1 hour  
-- `"last.P1D"` = Previous 1 day
-- `"last.P14D"` = Previous 14 days
-- `"last.P1M"` = Previous 1 month
+- "last.PT5M" = Previous 5 minutes
+- "last.PT1H" = Previous 1 hour  
+- "last.P1D" = Previous 1 day
+- "last.P14D" = Previous 14 days
+- "last.P1M" = Previous 1 month
 
 **Absolute Date Ranges:**
 Format: `"utc.YYYY-MM-{DD/HH:MM:SS--DD/HH:MM:SS}"`
 
-- Single day: `"utc.2023-02-{28/00:00:00--28/23:59:59}"`
-- Multiple days: `"utc.2023-02-{25/00:00:00--28/23:59:59}"`  
-- Specific hours: `"utc.2023-02-{28/09:00:00--28/17:00:00}"`
-- Across months: `"utc.2023-{01-28/00:00:00--02-03/23:59:59}"`
+- Single day: "utc.2023-02-{28/00:00:00--28/23:59:59}"  
+- Multiple days: "utc.2023-02-{25/00:00:00--28/23:59:59}"  
+- Specific hours: "utc.2023-02-{28/09:00:00--28/17:00:00}"
+- Across months: "utc.2023-{01-28/00:00:00--02-03/23:59:59}"
 
 
 #### Operation Arguments for query.events ####