datadog_api_client 1.8.0 → 1.11.0

data/lib/datadog_api_client/v1/api/monitors_api.rb

@@ -23,18 +23,18 @@ module DatadogAPIClient::V1
       @api_client = api_client
     end
 
-    # Check if a monitor can be deleted
-    # Check if the given monitors can be deleted.
-    # @param monitor_ids [Array<Integer>] The IDs of the monitor to check.
-    # @param opts [Hash] the optional parameters
-    # @return [CheckCanDeleteMonitorResponse]
+    # Check if a monitor can be deleted.
+    #
+    # @see #check_can_delete_monitor_with_http_info
     def check_can_delete_monitor(monitor_ids, opts = {})
       data, _status_code, _headers = check_can_delete_monitor_with_http_info(monitor_ids, opts)
       data
     end
 
-    # Check if a monitor can be deleted
+    # Check if a monitor can be deleted.
+    #
     # Check if the given monitors can be deleted.
+    #
     # @param monitor_ids [Array<Integer>] The IDs of the monitor to check.
     # @param opts [Hash] the optional parameters
     # @return [Array<(CheckCanDeleteMonitorResponse, Integer, Hash)>] CheckCanDeleteMonitorResponse data, response status code and response headers
@@ -90,195 +90,23 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#check_can_delete_monitor\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Create a monitor
-    # Create a monitor using the specified options.
-    #
-    # #### Monitor Types
-    #
-    # The type of monitor chosen from:
-    #
-    # - anomaly: `query alert`
-    # - APM: `query alert` or `trace-analytics alert`
-    # - composite: `composite`
-    # - custom: `service check`
-    # - event: `event alert`
-    # - forecast: `query alert`
-    # - host: `service check`
-    # - integration: `query alert` or `service check`
-    # - live process: `process alert`
-    # - logs: `log alert`
-    # - metric: `query alert`
-    # - network: `service check`
-    # - outlier: `query alert`
-    # - process: `service check`
-    # - rum: `rum alert`
-    # - SLO: `slo alert`
-    # - watchdog: `event alert`
-    # - event-v2: `event-v2 alert`
-    # - audit: `audit alert`
-    # - error-tracking: `error-tracking alert`
-    #
-    # #### Query Types
-    #
-    # **Metric Alert Query**
-    #
-    # Example: `time_aggr(time_window):space_aggr:metric{tags} [by {key}] operator #`
-    #
-    # - `time_aggr`: avg, sum, max, min, change, or pct_change
-    # - `time_window`: `last_#m` (with `#` between 1 and 10080 depending on the monitor type) or `last_#h`(with `#` between 1 and 168 depending on the monitor type) or `last_1d`, or `last_1w`
-    # - `space_aggr`: avg, sum, min, or max
-    # - `tags`: one or more tags (comma-separated), or *
-    # - `key`: a 'key' in key:value tag syntax; defines a separate alert for each tag in the group (multi-alert)
-    # - `operator`: <, <=, >, >=, ==, or !=
-    # - `#`: an integer or decimal number used to set the threshold
-    #
-    # If you are using the `_change_` or `_pct_change_` time aggregator, instead use `change_aggr(time_aggr(time_window),
-    # timeshift):space_aggr:metric{tags} [by {key}] operator #` with:
-    #
-    # - `change_aggr` change, pct_change
-    # - `time_aggr` avg, sum, max, min [Learn more](https://docs.datadoghq.com/monitors/create/types/#define-the-conditions)
-    # - `time_window` last\_#m (between 1 and 2880 depending on the monitor type), last\_#h (between 1 and 48 depending on the monitor type), or last_#d (1 or 2)
-    # - `timeshift` #m_ago (5, 10, 15, or 30), #h_ago (1, 2, or 4), or 1d_ago
-    #
-    # Use this to create an outlier monitor using the following query:
-    # `avg(last_30m):outliers(avg:system.cpu.user{role:es-events-data} by {host}, 'dbscan', 7) > 0`
-    #
-    # **Service Check Query**
-    #
-    # Example: `"check".over(tags).last(count).by(group).count_by_status()`
+    # Create a monitor.
     #
-    # - **`check`** name of the check, for example `datadog.agent.up`
-    # - **`tags`** one or more quoted tags (comma-separated), or "*". for example: `.over("env:prod", "role:db")`; **`over`** cannot be blank.
-    # - **`count`** must be at greater than or equal to your max threshold (defined in the `options`). It is limited to 100.
-    # For example, if you've specified to notify on 1 critical, 3 ok, and 2 warn statuses, `count` should be at least 3.
-    # - **`group`** must be specified for check monitors. Per-check grouping is already explicitly known for some service checks.
-    # For example, Postgres integration monitors are tagged by `db`, `host`, and `port`, and Network monitors by `host`, `instance`, and `url`. See [Service Checks](https://docs.datadoghq.com/api/latest/service-checks/) documentation for more information.
-    #
-    # **Event Alert Query**
-    #
-    # Example: `events('sources:nagios status:error,warning priority:normal tags: "string query"').rollup("count").last("1h")"`
-    #
-    # - **`event`**, the event query string:
-    # - **`string_query`** free text query to match against event title and text.
-    # - **`sources`** event sources (comma-separated).
-    # - **`status`** event statuses (comma-separated). Valid options: error, warn, and info.
-    # - **`priority`** event priorities (comma-separated). Valid options: low, normal, all.
-    # - **`host`** event reporting host (comma-separated).
-    # - **`tags`** event tags (comma-separated).
-    # - **`excluded_tags`** excluded event tags (comma-separated).
-    # - **`rollup`** the stats roll-up method. `count` is the only supported method now.
-    # - **`last`** the timeframe to roll up the counts. Examples: 45m, 4h. Supported timeframes: m, h and d. This value should not exceed 48 hours.
-    #
-    # **NOTE** The Event Alert Query is being deprecated and replaced by the Event V2 Alert Query. For more information, see the [Event Migration guide](https://docs.datadoghq.com/events/guides/migrating_to_new_events_features/).
-    #
-    # **Event V2 Alert Query**
-    #
-    # Example: `events(query).rollup(rollup_method[, measure]).last(time_window) operator #`
-    #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg` and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
-    #
-    # **NOTE** Only available on US1-FED, US3, US5 and in closed beta on EU and US1.
-    #
-    # **Process Alert Query**
-    #
-    # Example: `processes(search).over(tags).rollup('count').last(timeframe) operator #`
-    #
-    # - **`search`** free text search string for querying processes.
-    # Matching processes match results on the [Live Processes](https://docs.datadoghq.com/infrastructure/process/?tab=linuxwindows) page.
-    # - **`tags`** one or more tags (comma-separated)
-    # - **`timeframe`** the timeframe to roll up the counts. Examples: 10m, 4h. Supported timeframes: s, m, h and d
-    # - **`operator`** <, <=, >, >=, ==, or !=
-    # - **`#`** an integer or decimal number used to set the threshold
-    #
-    # **Logs Alert Query**
-    #
-    # Example: `logs(query).index(index_name).rollup(rollup_method[, measure]).last(time_window) operator #`
-    #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`index_name`** For multi-index organizations, the log index in which the request is performed.
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg` and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
-    #
-    # **Composite Query**
-    #
-    # Example: `12345 && 67890`, where `12345` and `67890` are the IDs of non-composite monitors
-    #
-    # * **`name`** [*required*, *default* = **dynamic, based on query**]: The name of the alert.
-    # * **`message`** [*required*, *default* = **dynamic, based on query**]: A message to include with notifications for this monitor.
-    # Email notifications can be sent to specific users by using the same '@username' notation as events.
-    # * **`tags`** [*optional*, *default* = **empty list**]: A list of tags to associate with your monitor.
-    # When getting all monitor details via the API, use the `monitor_tags` argument to filter results by these tags.
-    # It is only available via the API and isn't visible or editable in the Datadog UI.
-    #
-    # **SLO Alert Query**
-    #
-    # Example: `error_budget("slo_id").over("time_window") operator #`
-    #
-    # - **`slo_id`**: The alphanumeric SLO ID of the SLO you are configuring the alert for.
-    # - **`time_window`**: The time window of the SLO target you wish to alert on. Valid options: `7d`, `30d`, `90d`.
-    # - **`operator`**: `>=` or `>`
-    #
-    # **Audit Alert Query**
-    #
-    # Example: `audits(query).rollup(rollup_method[, measure]).last(time_window) operator #`
-    #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg` and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
-    #
-    # **NOTE** Only available on US1-FED and in closed beta on US1, EU, US3, and US5.
-    #
-    # **CI Pipelines Alert Query**
-    #
-    # Example: `ci-pipelines(query).rollup(rollup_method[, measure]).last(time_window) operator #`
-    #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg`, and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
-    #
-    # **NOTE** Only available in closed beta on US1, EU, US3 and US5.
-    #
-    # **Error Tracking Alert Query**
-    #
-    # Example(RUM): `error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window) operator #`
-    # Example(APM Traces): `error-tracking-traces(query).rollup(rollup_method[, measure]).last(time_window) operator #`
-    #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg`, and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
-    # @param body [Monitor] Create a monitor request body.
-    # @param opts [Hash] the optional parameters
-    # @return [Monitor]
+    # @see #create_monitor_with_http_info
     def create_monitor(body, opts = {})
       data, _status_code, _headers = create_monitor_with_http_info(body, opts)
       data
     end
 
-    # Create a monitor
+    # Create a monitor.
+    #
     # Create a monitor using the specified options.
     #
     # #### Monitor Types
@@ -335,27 +163,27 @@ module DatadogAPIClient::V1
     #
     # Example: `"check".over(tags).last(count).by(group).count_by_status()`
     #
-    # - **`check`** name of the check, for example `datadog.agent.up`
-    # - **`tags`** one or more quoted tags (comma-separated), or "*". for example: `.over("env:prod", "role:db")`; **`over`** cannot be blank.
-    # - **`count`** must be at greater than or equal to your max threshold (defined in the `options`). It is limited to 100.
+    # - `check` name of the check, for example `datadog.agent.up`
+    # - `tags` one or more quoted tags (comma-separated), or "*". for example: `.over("env:prod", "role:db")`; `over` cannot be blank.
+    # - `count` must be at greater than or equal to your max threshold (defined in the `options`). It is limited to 100.
     # For example, if you've specified to notify on 1 critical, 3 ok, and 2 warn statuses, `count` should be at least 3.
-    # - **`group`** must be specified for check monitors. Per-check grouping is already explicitly known for some service checks.
+    # - `group` must be specified for check monitors. Per-check grouping is already explicitly known for some service checks.
     # For example, Postgres integration monitors are tagged by `db`, `host`, and `port`, and Network monitors by `host`, `instance`, and `url`. See [Service Checks](https://docs.datadoghq.com/api/latest/service-checks/) documentation for more information.
     #
     # **Event Alert Query**
     #
     # Example: `events('sources:nagios status:error,warning priority:normal tags: "string query"').rollup("count").last("1h")"`
     #
-    # - **`event`**, the event query string:
-    # - **`string_query`** free text query to match against event title and text.
-    # - **`sources`** event sources (comma-separated).
-    # - **`status`** event statuses (comma-separated). Valid options: error, warn, and info.
-    # - **`priority`** event priorities (comma-separated). Valid options: low, normal, all.
-    # - **`host`** event reporting host (comma-separated).
-    # - **`tags`** event tags (comma-separated).
-    # - **`excluded_tags`** excluded event tags (comma-separated).
-    # - **`rollup`** the stats roll-up method. `count` is the only supported method now.
-    # - **`last`** the timeframe to roll up the counts. Examples: 45m, 4h. Supported timeframes: m, h and d. This value should not exceed 48 hours.
+    # - `event`, the event query string:
+    # - `string_query` free text query to match against event title and text.
+    # - `sources` event sources (comma-separated).
+    # - `status` event statuses (comma-separated). Valid options: error, warn, and info.
+    # - `priority` event priorities (comma-separated). Valid options: low, normal, all.
+    # - `host` event reporting host (comma-separated).
+    # - `tags` event tags (comma-separated).
+    # - `excluded_tags` excluded event tags (comma-separated).
+    # - `rollup` the stats roll-up method. `count` is the only supported method now.
+    # - `last` the timeframe to roll up the counts. Examples: 45m, 4h. Supported timeframes: m, h and d. This value should not exceed 48 hours.
     #
     # **NOTE** The Event Alert Query is being deprecated and replaced by the Event V2 Alert Query. For more information, see the [Event Migration guide](https://docs.datadoghq.com/events/guides/migrating_to_new_events_features/).
     #
@@ -363,46 +191,44 @@ module DatadogAPIClient::V1
     #
     # Example: `events(query).rollup(rollup_method[, measure]).last(time_window) operator #`
     #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg` and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
-    #
-    # **NOTE** Only available on US1-FED, US3, US5 and in closed beta on EU and US1.
+    # - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
+    # - `rollup_method` The stats roll-up method - supports `count`, `avg` and `cardinality`.
+    # - `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
+    # - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
+    # - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.
+    # - `#` an integer or decimal number used to set the threshold.
     #
     # **Process Alert Query**
     #
     # Example: `processes(search).over(tags).rollup('count').last(timeframe) operator #`
     #
-    # - **`search`** free text search string for querying processes.
+    # - `search` free text search string for querying processes.
     # Matching processes match results on the [Live Processes](https://docs.datadoghq.com/infrastructure/process/?tab=linuxwindows) page.
-    # - **`tags`** one or more tags (comma-separated)
-    # - **`timeframe`** the timeframe to roll up the counts. Examples: 10m, 4h. Supported timeframes: s, m, h and d
-    # - **`operator`** <, <=, >, >=, ==, or !=
-    # - **`#`** an integer or decimal number used to set the threshold
+    # - `tags` one or more tags (comma-separated)
+    # - `timeframe` the timeframe to roll up the counts. Examples: 10m, 4h. Supported timeframes: s, m, h and d
+    # - `operator` <, <=, >, >=, ==, or !=
+    # - `#` an integer or decimal number used to set the threshold
     #
     # **Logs Alert Query**
     #
     # Example: `logs(query).index(index_name).rollup(rollup_method[, measure]).last(time_window) operator #`
     #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`index_name`** For multi-index organizations, the log index in which the request is performed.
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg` and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
+    # - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
+    # - `index_name` For multi-index organizations, the log index in which the request is performed.
+    # - `rollup_method` The stats roll-up method - supports `count`, `avg` and `cardinality`.
+    # - `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
+    # - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
+    # - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.
+    # - `#` an integer or decimal number used to set the threshold.
     #
     # **Composite Query**
     #
     # Example: `12345 && 67890`, where `12345` and `67890` are the IDs of non-composite monitors
     #
-    # * **`name`** [*required*, *default* = **dynamic, based on query**]: The name of the alert.
-    # * **`message`** [*required*, *default* = **dynamic, based on query**]: A message to include with notifications for this monitor.
+    # * `name` [*required*, *default* = **dynamic, based on query**]: The name of the alert.
+    # * `message` [*required*, *default* = **dynamic, based on query**]: A message to include with notifications for this monitor.
     # Email notifications can be sent to specific users by using the same '@username' notation as events.
-    # * **`tags`** [*optional*, *default* = **empty list**]: A list of tags to associate with your monitor.
+    # * `tags` [*optional*, *default* = **empty list**]: A list of tags to associate with your monitor.
     # When getting all monitor details via the API, use the `monitor_tags` argument to filter results by these tags.
     # It is only available via the API and isn't visible or editable in the Datadog UI.
     #
@@ -410,20 +236,20 @@ module DatadogAPIClient::V1
     #
     # Example: `error_budget("slo_id").over("time_window") operator #`
     #
-    # - **`slo_id`**: The alphanumeric SLO ID of the SLO you are configuring the alert for.
-    # - **`time_window`**: The time window of the SLO target you wish to alert on. Valid options: `7d`, `30d`, `90d`.
-    # - **`operator`**: `>=` or `>`
+    # - `slo_id`: The alphanumeric SLO ID of the SLO you are configuring the alert for.
+    # - `time_window`: The time window of the SLO target you wish to alert on. Valid options: `7d`, `30d`, `90d`.
+    # - `operator`: `>=` or `>`
     #
     # **Audit Alert Query**
     #
     # Example: `audits(query).rollup(rollup_method[, measure]).last(time_window) operator #`
     #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg` and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
+    # - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
+    # - `rollup_method` The stats roll-up method - supports `count`, `avg` and `cardinality`.
+    # - `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
+    # - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
+    # - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.
+    # - `#` an integer or decimal number used to set the threshold.
     #
     # **NOTE** Only available on US1-FED and in closed beta on US1, EU, US3, and US5.
     #
@@ -431,26 +257,40 @@ module DatadogAPIClient::V1
     #
     # Example: `ci-pipelines(query).rollup(rollup_method[, measure]).last(time_window) operator #`
     #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg`, and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
+    # - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
+    # - `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.
+    # - `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
+    # - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
+    # - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.
+    # - `#` an integer or decimal number used to set the threshold.
+    #
+    # **NOTE** CI Pipeline monitors are in alpha on US1, EU, US3 and US5.
+    #
+    # **CI Tests Alert Query**
+    #
+    # Example: `ci-tests(query).rollup(rollup_method[, measure]).last(time_window) operator #`
     #
-    # **NOTE** Only available in closed beta on US1, EU, US3 and US5.
+    # - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
+    # - `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.
+    # - `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
+    # - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
+    # - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.
+    # - `#` an integer or decimal number used to set the threshold.
+    #
+    # **NOTE** CI Test monitors are available only in closed beta on US1, EU, US3 and US5.
     #
     # **Error Tracking Alert Query**
     #
     # Example(RUM): `error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window) operator #`
     # Example(APM Traces): `error-tracking-traces(query).rollup(rollup_method[, measure]).last(time_window) operator #`
     #
-    # - **`query`** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
-    # - **`rollup_method`** The stats roll-up method - supports `count`, `avg`, and `cardinality`.
-    # - **`measure`** For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
-    # - **`time_window`** #m (between 1 and 2880), #h (between 1 and 48).
-    # - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`.
-    # - **`#`** an integer or decimal number used to set the threshold.
+    # - `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).
+    # - `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.
+    # - `measure` For `avg` and cardinality `rollup_method` - specify the measure or the facet name you want to use.
+    # - `time_window` #m (between 1 and 2880), #h (between 1 and 48).
+    # - `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.
+    # - `#` an integer or decimal number used to set the threshold.
+    #
     # @param body [Monitor] Create a monitor request body.
     # @param opts [Hash] the optional parameters
     # @return [Array<(Monitor, Integer, Hash)>] Monitor data, response status code and response headers
@@ -507,26 +347,25 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#create_monitor\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Delete a monitor
-    # Delete the specified monitor
-    # @param monitor_id [Integer] The ID of the monitor.
-    # @param opts [Hash] the optional parameters
-    # @option opts [String] :force Delete the monitor even if it's referenced by other resources (for example SLO, composite monitor).
-    # @return [DeletedMonitor]
+    # Delete a monitor.
+    #
+    # @see #delete_monitor_with_http_info
     def delete_monitor(monitor_id, opts = {})
       data, _status_code, _headers = delete_monitor_with_http_info(monitor_id, opts)
       data
     end
 
-    # Delete a monitor
+    # Delete a monitor.
+    #
     # Delete the specified monitor
+    #
     # @param monitor_id [Integer] The ID of the monitor.
     # @param opts [Hash] the optional parameters
     # @option opts [String] :force Delete the monitor even if it's referenced by other resources (for example SLO, composite monitor).
@@ -583,26 +422,25 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Delete, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#delete_monitor\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get a monitor's details
-    # Get details about the specified monitor from your organization.
-    # @param monitor_id [Integer] The ID of the monitor
-    # @param opts [Hash] the optional parameters
-    # @option opts [String] :group_states When specified, shows additional information about the group states. Choose one or more from `all`, `alert`, `warn`, and `no data`.
-    # @return [Monitor]
+    # Get a monitor's details.
+    #
+    # @see #get_monitor_with_http_info
     def get_monitor(monitor_id, opts = {})
       data, _status_code, _headers = get_monitor_with_http_info(monitor_id, opts)
       data
     end
 
-    # Get a monitor's details
+    # Get a monitor's details.
+    #
     # Get details about the specified monitor from your organization.
+    #
     # @param monitor_id [Integer] The ID of the monitor
     # @param opts [Hash] the optional parameters
     # @option opts [String] :group_states When specified, shows additional information about the group states. Choose one or more from `all`, `alert`, `warn`, and `no data`.
@@ -659,32 +497,25 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#get_monitor\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Get all monitor details
-    # Get details about the specified monitor from your organization.
-    # @param opts [Hash] the optional parameters
-    # @option opts [String] :group_states When specified, shows additional information about the group states. Choose one or more from `all`, `alert`, `warn`, and `no data`.
-    # @option opts [String] :name A string to filter monitors by name.
-    # @option opts [String] :tags A comma separated list indicating what tags, if any, should be used to filter the list of monitors by scope. For example, `host:host0`.
-    # @option opts [String] :monitor_tags A comma separated list indicating what service and/or custom tags, if any, should be used to filter the list of monitors. Tags created in the Datadog UI automatically have the service key prepended. For example, `service:my-app`.
-    # @option opts [Boolean] :with_downtimes If this argument is set to true, then the returned data includes all current active downtimes for each monitor.
-    # @option opts [Integer] :id_offset Use this parameter for paginating through large sets of monitors. Start with a value of zero, make a request, set the value to the last ID of result set, and then repeat until the response is empty.
-    # @option opts [Integer] :page The page to start paginating from. If this argument is not specified, the request returns all monitors without pagination.
-    # @option opts [Integer] :page_size The number of monitors to return per page. If the page argument is not specified, the default behavior returns all monitors without a `page_size` limit. However, if page is specified and `page_size` is not, the argument defaults to 100.
-    # @return [Array<Monitor>]
+    # Get all monitor details.
+    #
+    # @see #list_monitors_with_http_info
     def list_monitors(opts = {})
       data, _status_code, _headers = list_monitors_with_http_info(opts)
       data
     end
 
-    # Get all monitor details
+    # Get all monitor details.
+    #
     # Get details about the specified monitor from your organization.
+    #
     # @param opts [Hash] the optional parameters
     # @option opts [String] :group_states When specified, shows additional information about the group states. Choose one or more from `all`, `alert`, `warn`, and `no data`.
     # @option opts [String] :name A string to filter monitors by name.
@@ -753,28 +584,25 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#list_monitors\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Monitors group search
-    # Search and filter your monitor groups details.
-    # @param opts [Hash] the optional parameters
-    # @option opts [String] :query After entering a search query in your [Manage Monitor page][1] use the query parameter value in the URL of the page as value for this parameter. Consult the dedicated [manage monitor documentation][2] page to learn more.  The query can contain any number of space-separated monitor attributes, for instance `query="type:metric status:alert"`.  [1]: https://app.datadoghq.com/monitors/manage [2]: /monitors/manage/#find-the-monitors
-    # @option opts [Integer] :page Page to start paginating from.
-    # @option opts [Integer] :per_page Number of monitors to return per page.
-    # @option opts [String] :sort String for sort order, composed of field and sort order separate by a comma, for example `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields:  * `name` * `status` * `tags`
-    # @return [MonitorGroupSearchResponse]
+    # Monitors group search.
+    #
+    # @see #search_monitor_groups_with_http_info
     def search_monitor_groups(opts = {})
       data, _status_code, _headers = search_monitor_groups_with_http_info(opts)
       data
     end
 
-    # Monitors group search
+    # Monitors group search.
+    #
     # Search and filter your monitor groups details.
+    #
     # @param opts [Hash] the optional parameters
     # @option opts [String] :query After entering a search query in your [Manage Monitor page][1] use the query parameter value in the URL of the page as value for this parameter. Consult the dedicated [manage monitor documentation][2] page to learn more.  The query can contain any number of space-separated monitor attributes, for instance `query="type:metric status:alert"`.  [1]: https://app.datadoghq.com/monitors/manage [2]: /monitors/manage/#find-the-monitors
     # @option opts [Integer] :page Page to start paginating from.
@@ -832,28 +660,25 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#search_monitor_groups\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Monitors search
-    # Search and filter your monitors details.
-    # @param opts [Hash] the optional parameters
-    # @option opts [String] :query After entering a search query in your [Manage Monitor page][1] use the query parameter value in the URL of the page as value for this parameter. Consult the dedicated [manage monitor documentation][2] page to learn more.  The query can contain any number of space-separated monitor attributes, for instance `query="type:metric status:alert"`.  [1]: https://app.datadoghq.com/monitors/manage [2]: /monitors/manage/#find-the-monitors
-    # @option opts [Integer] :page Page to start paginating from.
-    # @option opts [Integer] :per_page Number of monitors to return per page.
-    # @option opts [String] :sort String for sort order, composed of field and sort order separate by a comma, for example `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields:  * `name` * `status` * `tags`
-    # @return [MonitorSearchResponse]
+    # Monitors search.
+    #
+    # @see #search_monitors_with_http_info
     def search_monitors(opts = {})
       data, _status_code, _headers = search_monitors_with_http_info(opts)
       data
     end
 
-    # Monitors search
+    # Monitors search.
+    #
     # Search and filter your monitors details.
+    #
     # @param opts [Hash] the optional parameters
     # @option opts [String] :query After entering a search query in your [Manage Monitor page][1] use the query parameter value in the URL of the page as value for this parameter. Consult the dedicated [manage monitor documentation][2] page to learn more.  The query can contain any number of space-separated monitor attributes, for instance `query="type:metric status:alert"`.  [1]: https://app.datadoghq.com/monitors/manage [2]: /monitors/manage/#find-the-monitors
     # @option opts [Integer] :page Page to start paginating from.
@@ -911,26 +736,25 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#search_monitors\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Edit a monitor
-    # Edit the specified monitor.
-    # @param monitor_id [Integer] The ID of the monitor.
-    # @param body [MonitorUpdateRequest] Edit a monitor request body.
-    # @param opts [Hash] the optional parameters
-    # @return [Monitor]
+    # Edit a monitor.
+    #
+    # @see #update_monitor_with_http_info
     def update_monitor(monitor_id, body, opts = {})
       data, _status_code, _headers = update_monitor_with_http_info(monitor_id, body, opts)
       data
     end
 
-    # Edit a monitor
+    # Edit a monitor.
+    #
     # Edit the specified monitor.
+    #
     # @param monitor_id [Integer] The ID of the monitor.
     # @param body [MonitorUpdateRequest] Edit a monitor request body.
     # @param opts [Hash] the optional parameters
@@ -992,25 +816,105 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Put, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#update_monitor\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Validate a monitor
+    # Validate an existing monitor.
+    #
+    # @see #validate_existing_monitor_with_http_info
+    def validate_existing_monitor(monitor_id, body, opts = {})
+      data, _status_code, _headers = validate_existing_monitor_with_http_info(monitor_id, body, opts)
+      data
+    end
+
+    # Validate an existing monitor.
+    #
     # Validate the monitor provided in the request.
+    #
+    # @param monitor_id [Integer] The ID of the monitor
     # @param body [Monitor] Monitor request object
     # @param opts [Hash] the optional parameters
-    # @return [Object]
+    # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
+    def validate_existing_monitor_with_http_info(monitor_id, body, opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:validate_existing_monitor)
+        unstable_enabled = @api_client.config.unstable_operations[:validate_existing_monitor]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "validate_existing_monitor")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "validate_existing_monitor"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MonitorsAPI.validate_existing_monitor ...'
+      end
+      # verify the required parameter 'monitor_id' is set
+      if @api_client.config.client_side_validation && monitor_id.nil?
+        fail ArgumentError, "Missing the required parameter 'monitor_id' when calling MonitorsAPI.validate_existing_monitor"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling MonitorsAPI.validate_existing_monitor"
+      end
+      # resource path
+      local_var_path = '/api/v1/monitor/{monitor_id}/validate'.sub('{monitor_id}', CGI.escape(monitor_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Object'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :validate_existing_monitor,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MonitorsAPI#validate_existing_monitor\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Validate a monitor.
+    #
+    # @see #validate_monitor_with_http_info
     def validate_monitor(body, opts = {})
       data, _status_code, _headers = validate_monitor_with_http_info(body, opts)
       data
     end
 
-    # Validate a monitor
+    # Validate a monitor.
+    #
     # Validate the monitor provided in the request.
+    #
     # @param body [Monitor] Monitor request object
     # @param opts [Hash] the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
@@ -1067,7 +971,7 @@ module DatadogAPIClient::V1
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: MonitorsAPI#validate_monitor\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end