Query the event stream docs edit

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.2.0",
-            "regenerated": "2020-10-28 14:20:20.282987",
-            "spec_repo_commit": "2af7762"
+            "regenerated": "2020-10-29 18:17:18.356827",
+            "spec_repo_commit": "8433d9b"
         },
         "v2": {
             "apigentools_version": "1.2.0",
-            "regenerated": "2020-10-28 14:20:31.908334",
-            "spec_repo_commit": "2af7762"
+            "regenerated": "2020-10-29 18:17:29.955090",
+            "spec_repo_commit": "8433d9b"
         }
     }
 }

docs/v1/EventsApi.md

@@ -97,7 +97,7 @@ Name | Type | Description  | Notes
 
 Query the event stream
 
-The event stream can be queried and filtered by time, priority, sources and tags.  **Note**: If the event you’re querying contains markdown formatting of any kind, you may see characters such as %,\\,n in your output.
+The event stream can be queried and filtered by time, priority, sources and tags.  **Notes**:  - If the event you’re querying contains markdown formatting of any kind, you may see characters such as `%`,`\\`,`n` in your output.  - This endpoint returns a maximum of `1000` most recent results. To return additional results, identify the last timestamp of the last result and set that as the `end` query time to [paginate](https://gist.github.com/ericmustin/250feab4c3640c8bf80c9ade535e73da) the results.
 
 ### Example
 

docs/v1/Monitor.md

@@ -14,6 +14,7 @@ Name | Type | Description | Notes
 **name** | **str** | The monitor name. | [optional] 
 **options** | [**MonitorOptions**](MonitorOptions.md) |  | [optional] 
 **overall_state** | [**MonitorOverallStates**](MonitorOverallStates.md) |  | [optional] 
+**priority** | **int** | Integer from 1 (high) to 5 (low) indicating alert severity. | [optional] 
 **query** | **str** | The monitor query. | [optional] 
 **state** | [**MonitorState**](MonitorState.md) |  | [optional] 
 **tags** | **[str]** | Tags associated to your monitor. | [optional] 

docs/v1/MonitorUpdateRequest.md

@@ -14,6 +14,7 @@ Name | Type | Description | Notes
 **name** | **str** | The monitor name. | [optional] 
 **options** | [**MonitorOptions**](MonitorOptions.md) |  | [optional] 
 **overall_state** | [**MonitorOverallStates**](MonitorOverallStates.md) |  | [optional] 
+**priority** | **int** | Integer from 1 (high) to 5 (low) indicating alert severity. | [optional] 
 **query** | **str** | The monitor query. | [optional] 
 **state** | [**MonitorState**](MonitorState.md) |  | [optional] 
 **tags** | **[str]** | Tags associated to your monitor. | [optional] 

docs/v1/MonitorsApi.md

@@ -199,6 +199,7 @@ with datadog_api_client.v1.ApiClient(configuration) as api_client:
             timeout_h=1,
         ),
         overall_state=MonitorOverallStates("Alert"),
+        priority=1,
         query="query_example",
         state=MonitorState(
             groups={
@@ -647,6 +648,7 @@ with datadog_api_client.v1.ApiClient(configuration) as api_client:
             timeout_h=1,
         ),
         overall_state=MonitorOverallStates("Alert"),
+        priority=1,
         query="query_example",
         state=MonitorState(
             groups={
@@ -805,6 +807,7 @@ with datadog_api_client.v1.ApiClient(configuration) as api_client:
             timeout_h=1,
         ),
         overall_state=MonitorOverallStates("Alert"),
+        priority=1,
         query="query_example",
         state=MonitorState(
             groups={

src/datadog_api_client/v1/api/events_api.py

@@ -164,7 +164,7 @@ def __list_events(
         ):
             """Query the event stream  # noqa: E501
 
-            The event stream can be queried and filtered by time, priority, sources and tags.  **Note**: If the event you’re querying contains markdown formatting of any kind, you may see characters such as %,\\,n in your output.  # noqa: E501
+            The event stream can be queried and filtered by time, priority, sources and tags.  **Notes**:  - If the event you’re querying contains markdown formatting of any kind, you may see characters such as `%`,`\\`,`n` in your output.  - This endpoint returns a maximum of `1000` most recent results. To return additional results, identify the last timestamp of the last result and set that as the `end` query time to [paginate](https://gist.github.com/ericmustin/250feab4c3640c8bf80c9ade535e73da) the results.  # noqa: E501
             This method makes a synchronous HTTP request by default. To make an
             asynchronous HTTP request, please pass async_req=True
 

src/datadog_api_client/v1/model/monitor.py

@@ -66,6 +66,10 @@ class Monitor(ModelNormal):
     }
 
     validations = {
+        ('priority',): {
+            'inclusive_maximum': 5,
+            'inclusive_minimum': 1,
+        },
     }
 
     additional_properties_type = None
@@ -94,6 +98,7 @@ def openapi_types():
             'name': (str,),  # noqa: E501
             'options': (MonitorOptions,),  # noqa: E501
             'overall_state': (MonitorOverallStates,),  # noqa: E501
+            'priority': (int,),  # noqa: E501
             'query': (str,),  # noqa: E501
             'state': (MonitorState,),  # noqa: E501
             'tags': ([str],),  # noqa: E501
@@ -116,6 +121,7 @@ def discriminator():
         'name': 'name',  # noqa: E501
         'options': 'options',  # noqa: E501
         'overall_state': 'overall_state',  # noqa: E501
+        'priority': 'priority',  # noqa: E501
         'query': 'query',  # noqa: E501
         'state': 'state',  # noqa: E501
         'tags': 'tags',  # noqa: E501
@@ -178,6 +184,7 @@ def __init__(self, *args, **kwargs):  # noqa: E501
             name (str): The monitor name.. [optional]  # noqa: E501
             options (MonitorOptions): [optional]  # noqa: E501
             overall_state (MonitorOverallStates): [optional]  # noqa: E501
+            priority (int): Integer from 1 (high) to 5 (low) indicating alert severity.. [optional]  # noqa: E501
             query (str): The monitor query.. [optional]  # noqa: E501
             state (MonitorState): [optional]  # noqa: E501
             tags ([str]): Tags associated to your monitor.. [optional]  # noqa: E501

src/datadog_api_client/v1/model/monitor_update_request.py

@@ -66,6 +66,10 @@ class MonitorUpdateRequest(ModelNormal):
     }
 
     validations = {
+        ('priority',): {
+            'inclusive_maximum': 5,
+            'inclusive_minimum': 1,
+        },
     }
 
     additional_properties_type = None
@@ -94,6 +98,7 @@ def openapi_types():
             'name': (str,),  # noqa: E501
             'options': (MonitorOptions,),  # noqa: E501
             'overall_state': (MonitorOverallStates,),  # noqa: E501
+            'priority': (int,),  # noqa: E501
             'query': (str,),  # noqa: E501
             'state': (MonitorState,),  # noqa: E501
             'tags': ([str],),  # noqa: E501
@@ -116,6 +121,7 @@ def discriminator():
         'name': 'name',  # noqa: E501
         'options': 'options',  # noqa: E501
         'overall_state': 'overall_state',  # noqa: E501
+        'priority': 'priority',  # noqa: E501
         'query': 'query',  # noqa: E501
         'state': 'state',  # noqa: E501
         'tags': 'tags',  # noqa: E501
@@ -178,6 +184,7 @@ def __init__(self, *args, **kwargs):  # noqa: E501
             name (str): The monitor name.. [optional]  # noqa: E501
             options (MonitorOptions): [optional]  # noqa: E501
             overall_state (MonitorOverallStates): [optional]  # noqa: E501
+            priority (int): Integer from 1 (high) to 5 (low) indicating alert severity.. [optional]  # noqa: E501
             query (str): The monitor query.. [optional]  # noqa: E501
             state (MonitorState): [optional]  # noqa: E501
             tags ([str]): Tags associated to your monitor.. [optional]  # noqa: E501

src/datadog_api_client/v1/openapi.yaml

@@ -3746,6 +3746,12 @@ components:
           $ref: '#/components/schemas/MonitorOptions'
         overall_state:
           $ref: '#/components/schemas/MonitorOverallStates'
+        priority:
+          description: Integer from 1 (high) to 5 (low) indicating alert severity.
+          format: int64
+          maximum: 5
+          minimum: 1
+          type: integer
         query:
           description: The monitor query.
           type: string
@@ -4174,6 +4180,12 @@ components:
           $ref: '#/components/schemas/MonitorOptions'
         overall_state:
           $ref: '#/components/schemas/MonitorOverallStates'
+        priority:
+          description: Integer from 1 (high) to 5 (low) indicating alert severity.
+          format: int64
+          maximum: 5
+          minimum: 1
+          type: integer
         query:
           description: The monitor query.
           type: string
@@ -10149,9 +10161,12 @@ paths:
   /api/v1/events:
     get:
       description: "The event stream can be queried and filtered by time, priority,\
-        \ sources and tags.\n\n**Note**: If the event you\u2019re querying contains\
-        \ markdown formatting of any kind, you may see characters such as %,\\,n in\
-        \ your output."
+        \ sources and tags.\n\n**Notes**:\n\n- If the event you\u2019re querying contains\
+        \ markdown formatting of any kind,\nyou may see characters such as `%`,`\\\
+        `,`n` in your output.\n\n- This endpoint returns a maximum of `1000` most\
+        \ recent results. To return additional results,\nidentify the last timestamp\
+        \ of the last result and set that as the `end` query time to\n[paginate](https://gist.github.com/ericmustin/250feab4c3640c8bf80c9ade535e73da)\
+        \ the results."
       operationId: ListEvents
       parameters:
       - description: POSIX timestamp.