datadog_api_client 1.0.0.beta.3 → 1.0.0

data/docs/v1/WidgetMarker.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **display_type** | **String** | Combination of:   - A severity error, warning, ok, or info   - A line type: dashed, solid, or bold  | [optional] |
+| **display_type** | **String** | Combination of:   - A severity error, warning, ok, or info   - A line type: dashed, solid, or bold In this case of a Distribution widget, this can be set to be `x_axis_percentile`.  | [optional] |
 | **label** | **String** | Label to display over the marker. | [optional] |
 | **time** | **String** | Timestamp for the widget. | [optional] |
 | **value** | **String** | Value to apply. Can be a single value y = 15 or a range of values 0 < y < 10. |  |

data/docs/v1/WidgetVerticalAlign.md

@@ -0,0 +1,15 @@
+# DatadogAPIClient::V1::WidgetVerticalAlign
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'datadog_api_client/v1'
+
+instance = DatadogAPIClient::V1::WidgetVerticalAlign.new()
+```
+

data/docs/v2/IncidentServiceUpdateData.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **attributes** | [**IncidentServiceUpdateAttributes**](IncidentServiceUpdateAttributes.md) |  | [optional] |
-| **id** | **String** | The incident service's ID. |  |
+| **id** | **String** | The incident service's ID. | [optional] |
 | **relationships** | [**IncidentServiceRelationships**](IncidentServiceRelationships.md) |  | [optional] |
 | **type** | [**IncidentServiceType**](IncidentServiceType.md) |  | [default to 'services'] |
 

data/docs/v2/IncidentServicesAPI.md

@@ -309,7 +309,7 @@ end
 
 api_instance = DatadogAPIClient::V2::IncidentServicesAPI.new
 service_id = 'service_id_example' # String | The ID of the incident service.
-body = DatadogAPIClient::V2::IncidentServiceUpdateRequest.new({data: DatadogAPIClient::V2::IncidentServiceUpdateData.new({id: '00000000-0000-0000-0000-000000000000', type: DatadogAPIClient::V2::IncidentServiceType::SERVICES})}) # IncidentServiceUpdateRequest | Incident Service Payload.
+body = DatadogAPIClient::V2::IncidentServiceUpdateRequest.new({data: DatadogAPIClient::V2::IncidentServiceUpdateData.new({type: DatadogAPIClient::V2::IncidentServiceType::SERVICES})}) # IncidentServiceUpdateRequest | Incident Service Payload.
 
 begin
   # Update an existing incident service

data/docs/v2/IncidentTeamUpdateData.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **attributes** | [**IncidentTeamUpdateAttributes**](IncidentTeamUpdateAttributes.md) |  | [optional] |
-| **id** | **String** | The incident team's ID. |  |
+| **id** | **String** | The incident team's ID. | [optional] |
 | **relationships** | [**IncidentTeamRelationships**](IncidentTeamRelationships.md) |  | [optional] |
 | **type** | [**IncidentTeamType**](IncidentTeamType.md) |  | [default to 'teams'] |
 

data/docs/v2/IncidentTeamsAPI.md

@@ -309,7 +309,7 @@ end
 
 api_instance = DatadogAPIClient::V2::IncidentTeamsAPI.new
 team_id = 'team_id_example' # String | The ID of the incident team.
-body = DatadogAPIClient::V2::IncidentTeamUpdateRequest.new({data: DatadogAPIClient::V2::IncidentTeamUpdateData.new({id: '00000000-0000-0000-0000-000000000000', type: DatadogAPIClient::V2::IncidentTeamType::TEAMS})}) # IncidentTeamUpdateRequest | Incident Team Payload.
+body = DatadogAPIClient::V2::IncidentTeamUpdateRequest.new({data: DatadogAPIClient::V2::IncidentTeamUpdateData.new({type: DatadogAPIClient::V2::IncidentTeamType::TEAMS})}) # IncidentTeamUpdateRequest | Incident Team Payload.
 
 begin
   # Update an existing incident team

data/docs/v2/MetricsAPI.md

@@ -19,7 +19,7 @@ All URIs are relative to *https://api.datadoghq.com*
 
 Create a tag configuration
 
-Create and define a list of queryable tag keys for a count/gauge/rate/distribution metric. Optionally, include percentile aggregations on any distribution metric. Can only be used with application keys of users with the `Manage Tags for Metrics` permission.
+Create and define a list of queryable tag keys for an existing count/gauge/rate/distribution metric. Optionally, include percentile aggregations on any distribution metric. Can only be used with application keys of users with the `Manage Tags for Metrics` permission.
 
 ### Examples
 
@@ -306,11 +306,6 @@ View indexed tag key-value pairs for a given metric name.
 
 ```ruby
 require 'datadog_api_client'
-
-DatadogAPIClient::V2.configure do |config|
-  config.unstable_operations[:list_tags_by_metric_name] = true
-end
-
 api_instance = DatadogAPIClient::V2::MetricsAPI.new
 metric_name = 'dist.http.endpoint.request' # String | The name of the metric.
 
@@ -373,11 +368,6 @@ View distinct metrics volumes for the given metric name.  Custom distribution me
 
 ```ruby
 require 'datadog_api_client'
-
-DatadogAPIClient::V2.configure do |config|
-  config.unstable_operations[:list_volumes_by_metric_name] = true
-end
-
 api_instance = DatadogAPIClient::V2::MetricsAPI.new
 metric_name = 'dist.http.endpoint.request' # String | The name of the metric.
 

data/extract-code-blocks.sh

@@ -1,8 +1,12 @@
 #!/usr/bin/env bash
 
 OUTPUT=${1:-examples}
+VERSIONS=${2:-v1,v2}
 
 cd ${0%/*}
 
-ls docs/v1/*API.md | xargs -n1 ./extract-code-blocks.awk -v output="${OUTPUT}/v1"
-ls docs/v2/*API.md | xargs -n1 ./extract-code-blocks.awk -v output="${OUTPUT}/v2"
+VERSIONS=(${VERSIONS//,/ })
+
+for version in "${VERSIONS[@]}"; do
+    ls docs/$version/*API.md | grep -v IPPrefixesAPI.md | xargs -n1 ./extract-code-blocks.awk -v output="${OUTPUT}/$version"
+done

data/lib/datadog_api_client/v1.rb

@@ -81,6 +81,8 @@ require 'datadog_api_client/v1/models/deleted_monitor'
 require 'datadog_api_client/v1/models/distribution_widget_definition'
 require 'datadog_api_client/v1/models/distribution_widget_definition_type'
 require 'datadog_api_client/v1/models/distribution_widget_request'
+require 'datadog_api_client/v1/models/distribution_widget_x_axis'
+require 'datadog_api_client/v1/models/distribution_widget_y_axis'
 require 'datadog_api_client/v1/models/downtime'
 require 'datadog_api_client/v1/models/downtime_recurrence'
 require 'datadog_api_client/v1/models/event'
@@ -168,6 +170,10 @@ require 'datadog_api_client/v1/models/logs_arithmetic_processor'
 require 'datadog_api_client/v1/models/logs_arithmetic_processor_type'
 require 'datadog_api_client/v1/models/logs_attribute_remapper'
 require 'datadog_api_client/v1/models/logs_attribute_remapper_type'
+require 'datadog_api_client/v1/models/logs_by_retention'
+require 'datadog_api_client/v1/models/logs_by_retention_monthly_usage'
+require 'datadog_api_client/v1/models/logs_by_retention_org_usage'
+require 'datadog_api_client/v1/models/logs_by_retention_orgs'
 require 'datadog_api_client/v1/models/logs_category_processor'
 require 'datadog_api_client/v1/models/logs_category_processor_category'
 require 'datadog_api_client/v1/models/logs_category_processor_type'
@@ -198,6 +204,8 @@ require 'datadog_api_client/v1/models/logs_pipeline_processor_type'
 require 'datadog_api_client/v1/models/logs_pipelines_order'
 require 'datadog_api_client/v1/models/logs_processor'
 require 'datadog_api_client/v1/models/logs_query_compute'
+require 'datadog_api_client/v1/models/logs_retention_agg_sum_usage'
+require 'datadog_api_client/v1/models/logs_retention_sum_usage'
 require 'datadog_api_client/v1/models/logs_service_remapper'
 require 'datadog_api_client/v1/models/logs_service_remapper_type'
 require 'datadog_api_client/v1/models/logs_sort'
@@ -234,6 +242,43 @@ require 'datadog_api_client/v1/models/monitor_type'
 require 'datadog_api_client/v1/models/monitor_update_request'
 require 'datadog_api_client/v1/models/note_widget_definition'
 require 'datadog_api_client/v1/models/note_widget_definition_type'
+require 'datadog_api_client/v1/models/notebook_absolute_time'
+require 'datadog_api_client/v1/models/notebook_author'
+require 'datadog_api_client/v1/models/notebook_cell_create_request'
+require 'datadog_api_client/v1/models/notebook_cell_create_request_attributes'
+require 'datadog_api_client/v1/models/notebook_cell_resource_type'
+require 'datadog_api_client/v1/models/notebook_cell_response'
+require 'datadog_api_client/v1/models/notebook_cell_response_attributes'
+require 'datadog_api_client/v1/models/notebook_cell_time'
+require 'datadog_api_client/v1/models/notebook_cell_update_request'
+require 'datadog_api_client/v1/models/notebook_cell_update_request_attributes'
+require 'datadog_api_client/v1/models/notebook_create_data'
+require 'datadog_api_client/v1/models/notebook_create_data_attributes'
+require 'datadog_api_client/v1/models/notebook_create_request'
+require 'datadog_api_client/v1/models/notebook_distribution_cell_attributes'
+require 'datadog_api_client/v1/models/notebook_global_time'
+require 'datadog_api_client/v1/models/notebook_graph_size'
+require 'datadog_api_client/v1/models/notebook_heat_map_cell_attributes'
+require 'datadog_api_client/v1/models/notebook_log_stream_cell_attributes'
+require 'datadog_api_client/v1/models/notebook_markdown_cell_attributes'
+require 'datadog_api_client/v1/models/notebook_markdown_cell_definition'
+require 'datadog_api_client/v1/models/notebook_markdown_cell_definition_type'
+require 'datadog_api_client/v1/models/notebook_relative_time'
+require 'datadog_api_client/v1/models/notebook_resource_type'
+require 'datadog_api_client/v1/models/notebook_response'
+require 'datadog_api_client/v1/models/notebook_response_data'
+require 'datadog_api_client/v1/models/notebook_response_data_attributes'
+require 'datadog_api_client/v1/models/notebook_split_by'
+require 'datadog_api_client/v1/models/notebook_status'
+require 'datadog_api_client/v1/models/notebook_timeseries_cell_attributes'
+require 'datadog_api_client/v1/models/notebook_toplist_cell_attributes'
+require 'datadog_api_client/v1/models/notebook_update_cell'
+require 'datadog_api_client/v1/models/notebook_update_data'
+require 'datadog_api_client/v1/models/notebook_update_data_attributes'
+require 'datadog_api_client/v1/models/notebook_update_request'
+require 'datadog_api_client/v1/models/notebooks_response'
+require 'datadog_api_client/v1/models/notebooks_response_meta'
+require 'datadog_api_client/v1/models/notebooks_response_page'
 require 'datadog_api_client/v1/models/organization'
 require 'datadog_api_client/v1/models/organization_billing'
 require 'datadog_api_client/v1/models/organization_create_body'
@@ -280,7 +325,10 @@ require 'datadog_api_client/v1/models/slo_history_response_data'
 require 'datadog_api_client/v1/models/slo_history_response_error'
 require 'datadog_api_client/v1/models/slo_history_sli_data'
 require 'datadog_api_client/v1/models/slo_list_response'
+require 'datadog_api_client/v1/models/slo_list_response_metadata'
+require 'datadog_api_client/v1/models/slo_list_response_metadata_page'
 require 'datadog_api_client/v1/models/slo_response'
+require 'datadog_api_client/v1/models/slo_response_data'
 require 'datadog_api_client/v1/models/slo_threshold'
 require 'datadog_api_client/v1/models/slo_timeframe'
 require 'datadog_api_client/v1/models/slo_type'
@@ -418,6 +466,7 @@ require 'datadog_api_client/v1/models/usage_attribution_metadata'
 require 'datadog_api_client/v1/models/usage_attribution_pagination'
 require 'datadog_api_client/v1/models/usage_attribution_response'
 require 'datadog_api_client/v1/models/usage_attribution_sort'
+require 'datadog_api_client/v1/models/usage_attribution_supported_metrics'
 require 'datadog_api_client/v1/models/usage_attribution_values'
 require 'datadog_api_client/v1/models/usage_billable_summary_body'
 require 'datadog_api_client/v1/models/usage_billable_summary_hour'
@@ -446,6 +495,8 @@ require 'datadog_api_client/v1/models/usage_lambda_hour'
 require 'datadog_api_client/v1/models/usage_lambda_response'
 require 'datadog_api_client/v1/models/usage_logs_by_index_hour'
 require 'datadog_api_client/v1/models/usage_logs_by_index_response'
+require 'datadog_api_client/v1/models/usage_logs_by_retention_hour'
+require 'datadog_api_client/v1/models/usage_logs_by_retention_response'
 require 'datadog_api_client/v1/models/usage_logs_hour'
 require 'datadog_api_client/v1/models/usage_logs_response'
 require 'datadog_api_client/v1/models/usage_metric_category'
@@ -506,6 +557,7 @@ require 'datadog_api_client/v1/models/widget_field_sort'
 require 'datadog_api_client/v1/models/widget_formula'
 require 'datadog_api_client/v1/models/widget_formula_limit'
 require 'datadog_api_client/v1/models/widget_grouping'
+require 'datadog_api_client/v1/models/widget_horizontal_align'
 require 'datadog_api_client/v1/models/widget_image_sizing'
 require 'datadog_api_client/v1/models/widget_layout'
 require 'datadog_api_client/v1/models/widget_layout_type'
@@ -530,6 +582,7 @@ require 'datadog_api_client/v1/models/widget_text_align'
 require 'datadog_api_client/v1/models/widget_tick_edge'
 require 'datadog_api_client/v1/models/widget_time'
 require 'datadog_api_client/v1/models/widget_time_windows'
+require 'datadog_api_client/v1/models/widget_vertical_align'
 require 'datadog_api_client/v1/models/widget_view_mode'
 require 'datadog_api_client/v1/models/widget_viz_type'
 
@@ -551,6 +604,7 @@ require 'datadog_api_client/v1/api/logs_indexes_api'
 require 'datadog_api_client/v1/api/logs_pipelines_api'
 require 'datadog_api_client/v1/api/metrics_api'
 require 'datadog_api_client/v1/api/monitors_api'
+require 'datadog_api_client/v1/api/notebooks_api'
 require 'datadog_api_client/v1/api/organizations_api'
 require 'datadog_api_client/v1/api/pager_duty_integration_api'
 require 'datadog_api_client/v1/api/service_checks_api'

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

@@ -246,6 +246,7 @@ module DatadogAPIClient::V1
     # Get all dashboards
     # Get all dashboards.  **Note**: This query will only return custom created or cloned dashboards. This query will not return preset dashboards.
     # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :filter_shared When `true`, this query only returns shared custom created or cloned dashboards.
     # @return [DashboardSummary]
     def list_dashboards(opts = {})
       data, _status_code, _headers = list_dashboards_with_http_info(opts)
@@ -255,6 +256,7 @@ module DatadogAPIClient::V1
     # Get all dashboards
     # Get all dashboards.  **Note**: This query will only return custom created or cloned dashboards. This query will not return preset dashboards.
     # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :filter_shared When `true`, this query only returns shared custom created or cloned dashboards.
     # @return [Array<(DashboardSummary, Integer, Hash)>] DashboardSummary data, response status code and response headers
     def list_dashboards_with_http_info(opts = {})
 
@@ -275,6 +277,7 @@ module DatadogAPIClient::V1
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'filter[shared]'] = opts[:'filter_shared'] if !opts[:'filter_shared'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

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

@@ -171,14 +171,16 @@ module DatadogAPIClient::V1
     end
 
     # Query the event stream
-    # 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 the results.
+    # 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 the results. You can also use the page parameter to specify which set of `1000` results to return.
     # @param start [Integer] POSIX timestamp.
     # @param _end [Integer] POSIX timestamp.
     # @param [Hash] opts the optional parameters
     # @option opts [EventPriority] :priority Priority of your events, either `low` or `normal`.
     # @option opts [String] :sources A comma separated string of sources.
     # @option opts [String] :tags A comma separated list indicating what tags, if any, should be used to filter the list of monitors by scope.
-    # @option opts [Boolean] :unaggregated Set unaggregated to `true` to return all events within the specified [`start`,`end`] timeframe. Otherwise if an event is aggregated to a parent event with a timestamp outside of the timeframe, it won't be available in the output.
+    # @option opts [Boolean] :unaggregated Set unaggregated to `true` to return all events within the specified [`start`,`end`] timeframe. Otherwise if an event is aggregated to a parent event with a timestamp outside of the timeframe, it won't be available in the output. Aggregated events with `is_aggregate=true` in the response will still be returned unless exclude_aggregate is set to `true.`
+    # @option opts [Boolean] :exclude_aggregate Set `exclude_aggregate` to `true` to only return unaggregated events where `is_aggregate=false` in the response. If the `exclude_aggregate` parameter is set to `true`, then the unaggregated parameter is ignored and will be `true` by default.
+    # @option opts [Integer] :page By default 1000 results are returned per request. Set page to the number of the page to return with `0` being the first page. The page parameter can only be used when either unaggregated or exclude_aggregate is set to `true.`
     # @return [EventListResponse]
     def list_events(start, _end, opts = {})
       data, _status_code, _headers = list_events_with_http_info(start, _end, opts)
@@ -186,14 +188,16 @@ module DatadogAPIClient::V1
     end
 
     # Query the event stream
-    # 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 the results.
+    # 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 the results. You can also use the page parameter to specify which set of `1000` results to return.
     # @param start [Integer] POSIX timestamp.
     # @param _end [Integer] POSIX timestamp.
     # @param [Hash] opts the optional parameters
     # @option opts [EventPriority] :priority Priority of your events, either `low` or `normal`.
     # @option opts [String] :sources A comma separated string of sources.
     # @option opts [String] :tags A comma separated list indicating what tags, if any, should be used to filter the list of monitors by scope.
-    # @option opts [Boolean] :unaggregated Set unaggregated to `true` to return all events within the specified [`start`,`end`] timeframe. Otherwise if an event is aggregated to a parent event with a timestamp outside of the timeframe, it won't be available in the output.
+    # @option opts [Boolean] :unaggregated Set unaggregated to `true` to return all events within the specified [`start`,`end`] timeframe. Otherwise if an event is aggregated to a parent event with a timestamp outside of the timeframe, it won't be available in the output. Aggregated events with `is_aggregate=true` in the response will still be returned unless exclude_aggregate is set to `true.`
+    # @option opts [Boolean] :exclude_aggregate Set `exclude_aggregate` to `true` to only return unaggregated events where `is_aggregate=false` in the response. If the `exclude_aggregate` parameter is set to `true`, then the unaggregated parameter is ignored and will be `true` by default.
+    # @option opts [Integer] :page By default 1000 results are returned per request. Set page to the number of the page to return with `0` being the first page. The page parameter can only be used when either unaggregated or exclude_aggregate is set to `true.`
     # @return [Array<(EventListResponse, Integer, Hash)>] EventListResponse data, response status code and response headers
     def list_events_with_http_info(start, _end, opts = {})
 
@@ -217,6 +221,10 @@ module DatadogAPIClient::V1
       if @api_client.config.client_side_validation && _end.nil?
         fail ArgumentError, "Missing the required parameter '_end' when calling EventsAPI.list_events"
       end
+      if @api_client.config.client_side_validation && !opts[:'page'].nil? && opts[:'page'] > 2147483647
+        fail ArgumentError, 'invalid value for "opts[:"page"]" when calling EventsAPI.list_events, must be smaller than or equal to 2147483647.'
+      end
+
       # resource path
       local_var_path = '/api/v1/events'
 
@@ -228,6 +236,8 @@ module DatadogAPIClient::V1
       query_params[:'sources'] = opts[:'sources'] if !opts[:'sources'].nil?
       query_params[:'tags'] = opts[:'tags'] if !opts[:'tags'].nil?
       query_params[:'unaggregated'] = opts[:'unaggregated'] if !opts[:'unaggregated'].nil?
+      query_params[:'exclude_aggregate'] = opts[:'exclude_aggregate'] if !opts[:'exclude_aggregate'].nil?
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

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

@@ -97,7 +97,7 @@ module DatadogAPIClient::V1
     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: `metric alert` - network: `service check` - outlier: `query alert` - process: `service check` - rum: `rum alert` - watchdog: `event alert` - event-v2: `event-v2 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 2880 depending on the monitor type) or `last_#h`(with `#` between 1 and 48 depending on the monitor type), or `last_1d` - `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/monitor_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).count_by_status()`  - **`check`** name of the check, e.g. `datadog.agent.up` - **`tags`** one or more quoted tags (comma-separated), or \"*\". e.g.: `.over(\"env:prod\", \"role:db\")` - **`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 3.  **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** Only available on US1 and EU.  **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 (5, 10, 15, or 30), #h (1, 2, or 4, 24). - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`. - **`#`** an integer or decimal number used to set the threshold.  **NOTE** Only available on US1-FED, US3, 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.
+    # 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: `metric alert` - network: `service check` - outlier: `query alert` - process: `service check` - rum: `rum alert` - SLO: `slo alert` - watchdog: `event alert` - event-v2: `event-v2 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 2880 depending on the monitor type) or `last_#h`(with `#` between 1 and 48 depending on the monitor type), or `last_1d` - `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/monitor_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).count_by_status()`  - **`check`** name of the check, e.g. `datadog.agent.up` - **`tags`** one or more quoted tags (comma-separated), or \"*\". e.g.: `.over(\"env:prod\", \"role:db\")` - **`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 3.  **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** Only available on US1 and EU.  **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 (5, 10, 15, or 30), #h (1, 2, or 4, 24). - **`operator`** `<`, `<=`, `>`, `>=`, `==`, or `!=`. - **`#`** an integer or decimal number used to set the threshold.  **NOTE** Only available on US1-FED, US3, 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 `>`
     # @param body [Monitor] Create a monitor request body.
     # @param [Hash] opts the optional parameters
     # @return [Monitor]
@@ -107,7 +107,7 @@ module DatadogAPIClient::V1
     end
 
     # Create a monitor
-    # Create a monitor using the specified options.  #### Monitor Types  The type of monitor chosen from:  - anomaly: &#x60;query alert&#x60; - APM: &#x60;query alert&#x60; or &#x60;trace-analytics alert&#x60; - composite: &#x60;composite&#x60; - custom: &#x60;service check&#x60; - event: &#x60;event alert&#x60; - forecast: &#x60;query alert&#x60; - host: &#x60;service check&#x60; - integration: &#x60;query alert&#x60; or &#x60;service check&#x60; - live process: &#x60;process alert&#x60; - logs: &#x60;log alert&#x60; - metric: &#x60;metric alert&#x60; - network: &#x60;service check&#x60; - outlier: &#x60;query alert&#x60; - process: &#x60;service check&#x60; - rum: &#x60;rum alert&#x60; - watchdog: &#x60;event alert&#x60; - event-v2: &#x60;event-v2 alert&#x60;  #### Query Types  **Metric Alert Query**  Example: &#x60;time_aggr(time_window):space_aggr:metric{tags} [by {key}] operator #&#x60;  - &#x60;time_aggr&#x60;: avg, sum, max, min, change, or pct_change - &#x60;time_window&#x60;: &#x60;last_#m&#x60; (with &#x60;#&#x60; between 1 and 2880 depending on the monitor type) or &#x60;last_#h&#x60;(with &#x60;#&#x60; between 1 and 48 depending on the monitor type), or &#x60;last_1d&#x60; - &#x60;space_aggr&#x60;: avg, sum, min, or max - &#x60;tags&#x60;: one or more tags (comma-separated), or * - &#x60;key&#x60;: a &#39;key&#39; in key:value tag syntax; defines a separate alert for each tag in the group (multi-alert) - &#x60;operator&#x60;: &lt;, &lt;&#x3D;, &gt;, &gt;&#x3D;, &#x3D;&#x3D;, or !&#x3D; - &#x60;#&#x60;: an integer or decimal number used to set the threshold  If you are using the &#x60;_change_&#x60; or &#x60;_pct_change_&#x60; time aggregator, instead use &#x60;change_aggr(time_aggr(time_window), timeshift):space_aggr:metric{tags} [by {key}] operator #&#x60; with:  - &#x60;change_aggr&#x60; change, pct_change - &#x60;time_aggr&#x60; avg, sum, max, min [Learn more](https://docs.datadoghq.com/monitors/monitor_types/#define-the-conditions) - &#x60;time_window&#x60; 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) - &#x60;timeshift&#x60; #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: &#x60;avg(last_30m):outliers(avg:system.cpu.user{role:es-events-data} by {host}, &#39;dbscan&#39;, 7) &gt; 0&#x60;  **Service Check Query**  Example: &#x60;\&quot;check\&quot;.over(tags).last(count).count_by_status()&#x60;  - **&#x60;check&#x60;** name of the check, e.g. &#x60;datadog.agent.up&#x60; - **&#x60;tags&#x60;** one or more quoted tags (comma-separated), or \&quot;*\&quot;. e.g.: &#x60;.over(\&quot;env:prod\&quot;, \&quot;role:db\&quot;)&#x60; - **&#x60;count&#x60;** must be at greater than or equal to your max threshold (defined in the &#x60;options&#x60;). It is limited to 100. For example, if you&#39;ve specified to notify on 1 critical, 3 ok, and 2 warn statuses, &#x60;count&#x60; should be 3.  **Event Alert Query**  Example: &#x60;events(&#39;sources:nagios status:error,warning priority:normal tags: \&quot;string query\&quot;&#39;).rollup(\&quot;count\&quot;).last(\&quot;1h\&quot;)\&quot;&#x60;  - **&#x60;event&#x60;**, the event query string: - **&#x60;string_query&#x60;** free text query to match against event title and text. - **&#x60;sources&#x60;** event sources (comma-separated). - **&#x60;status&#x60;** event statuses (comma-separated). Valid options: error, warn, and info. - **&#x60;priority&#x60;** event priorities (comma-separated). Valid options: low, normal, all. - **&#x60;host&#x60;** event reporting host (comma-separated). - **&#x60;tags&#x60;** event tags (comma-separated). - **&#x60;excluded_tags&#x60;** excluded event tags (comma-separated). - **&#x60;rollup&#x60;** the stats roll-up method. &#x60;count&#x60; is the only supported method now. - **&#x60;last&#x60;** the timeframe to roll up the counts. Examples: 45m, 4h. Supported timeframes: m, h and d. This value should not exceed 48 hours.  **NOTE** Only available on US1 and EU.  **Event V2 Alert Query**  Example: &#x60;events(query).rollup(rollup_method[, measure]).last(time_window) operator #&#x60;  - **&#x60;query&#x60;** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/). - **&#x60;rollup_method&#x60;** The stats roll-up method - supports &#x60;count&#x60;, &#x60;avg&#x60; and &#x60;cardinality&#x60;. - **&#x60;measure&#x60;** For &#x60;avg&#x60; and cardinality &#x60;rollup_method&#x60; - specify the measure or the facet name you want to use. - **&#x60;time_window&#x60;** #m (5, 10, 15, or 30), #h (1, 2, or 4, 24). - **&#x60;operator&#x60;** &#x60;&lt;&#x60;, &#x60;&lt;&#x3D;&#x60;, &#x60;&gt;&#x60;, &#x60;&gt;&#x3D;&#x60;, &#x60;&#x3D;&#x3D;&#x60;, or &#x60;!&#x3D;&#x60;. - **&#x60;#&#x60;** an integer or decimal number used to set the threshold.  **NOTE** Only available on US1-FED, US3, and in closed beta on EU and US1.  **Process Alert Query**  Example: &#x60;processes(search).over(tags).rollup(&#39;count&#39;).last(timeframe) operator #&#x60;  - **&#x60;search&#x60;** free text search string for querying processes. Matching processes match results on the [Live Processes](https://docs.datadoghq.com/infrastructure/process/?tab&#x3D;linuxwindows) page. - **&#x60;tags&#x60;** one or more tags (comma-separated) - **&#x60;timeframe&#x60;** the timeframe to roll up the counts. Examples: 10m, 4h. Supported timeframes: s, m, h and d - **&#x60;operator&#x60;** &lt;, &lt;&#x3D;, &gt;, &gt;&#x3D;, &#x3D;&#x3D;, or !&#x3D; - **&#x60;#&#x60;** an integer or decimal number used to set the threshold  **Logs Alert Query**  Example: &#x60;logs(query).index(index_name).rollup(rollup_method[, measure]).last(time_window) operator #&#x60;  - **&#x60;query&#x60;** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/). - **&#x60;index_name&#x60;** For multi-index organizations, the log index in which the request is performed. - **&#x60;rollup_method&#x60;** The stats roll-up method - supports &#x60;count&#x60;, &#x60;avg&#x60; and &#x60;cardinality&#x60;. - **&#x60;measure&#x60;** For &#x60;avg&#x60; and cardinality &#x60;rollup_method&#x60; - specify the measure or the facet name you want to use. - **&#x60;time_window&#x60;** #m (between 1 and 2880), #h (between 1 and 48) - **&#x60;operator&#x60;** &#x60;&lt;&#x60;, &#x60;&lt;&#x3D;&#x60;, &#x60;&gt;&#x60;, &#x60;&gt;&#x3D;&#x60;, &#x60;&#x3D;&#x3D;&#x60;, or &#x60;!&#x3D;&#x60;. - **&#x60;#&#x60;** an integer or decimal number used to set the threshold.  **Composite Query**  Example: &#x60;12345 &amp;&amp; 67890&#x60;, where &#x60;12345&#x60; and &#x60;67890&#x60; are the IDs of non-composite monitors  * **&#x60;name&#x60;** [*required*, *default* &#x3D; **dynamic, based on query**]: The name of the alert. * **&#x60;message&#x60;** [*required*, *default* &#x3D; **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 &#39;@username&#39; notation as events. * **&#x60;tags&#x60;** [*optional*, *default* &#x3D; **empty list**]: A list of tags to associate with your monitor. When getting all monitor details via the API, use the &#x60;monitor_tags&#x60; argument to filter results by these tags. It is only available via the API and isn&#39;t visible or editable in the Datadog UI.
+    # Create a monitor using the specified options.  #### Monitor Types  The type of monitor chosen from:  - anomaly: &#x60;query alert&#x60; - APM: &#x60;query alert&#x60; or &#x60;trace-analytics alert&#x60; - composite: &#x60;composite&#x60; - custom: &#x60;service check&#x60; - event: &#x60;event alert&#x60; - forecast: &#x60;query alert&#x60; - host: &#x60;service check&#x60; - integration: &#x60;query alert&#x60; or &#x60;service check&#x60; - live process: &#x60;process alert&#x60; - logs: &#x60;log alert&#x60; - metric: &#x60;metric alert&#x60; - network: &#x60;service check&#x60; - outlier: &#x60;query alert&#x60; - process: &#x60;service check&#x60; - rum: &#x60;rum alert&#x60; - SLO: &#x60;slo alert&#x60; - watchdog: &#x60;event alert&#x60; - event-v2: &#x60;event-v2 alert&#x60;  #### Query Types  **Metric Alert Query**  Example: &#x60;time_aggr(time_window):space_aggr:metric{tags} [by {key}] operator #&#x60;  - &#x60;time_aggr&#x60;: avg, sum, max, min, change, or pct_change - &#x60;time_window&#x60;: &#x60;last_#m&#x60; (with &#x60;#&#x60; between 1 and 2880 depending on the monitor type) or &#x60;last_#h&#x60;(with &#x60;#&#x60; between 1 and 48 depending on the monitor type), or &#x60;last_1d&#x60; - &#x60;space_aggr&#x60;: avg, sum, min, or max - &#x60;tags&#x60;: one or more tags (comma-separated), or * - &#x60;key&#x60;: a &#39;key&#39; in key:value tag syntax; defines a separate alert for each tag in the group (multi-alert) - &#x60;operator&#x60;: &lt;, &lt;&#x3D;, &gt;, &gt;&#x3D;, &#x3D;&#x3D;, or !&#x3D; - &#x60;#&#x60;: an integer or decimal number used to set the threshold  If you are using the &#x60;_change_&#x60; or &#x60;_pct_change_&#x60; time aggregator, instead use &#x60;change_aggr(time_aggr(time_window), timeshift):space_aggr:metric{tags} [by {key}] operator #&#x60; with:  - &#x60;change_aggr&#x60; change, pct_change - &#x60;time_aggr&#x60; avg, sum, max, min [Learn more](https://docs.datadoghq.com/monitors/monitor_types/#define-the-conditions) - &#x60;time_window&#x60; 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) - &#x60;timeshift&#x60; #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: &#x60;avg(last_30m):outliers(avg:system.cpu.user{role:es-events-data} by {host}, &#39;dbscan&#39;, 7) &gt; 0&#x60;  **Service Check Query**  Example: &#x60;\&quot;check\&quot;.over(tags).last(count).count_by_status()&#x60;  - **&#x60;check&#x60;** name of the check, e.g. &#x60;datadog.agent.up&#x60; - **&#x60;tags&#x60;** one or more quoted tags (comma-separated), or \&quot;*\&quot;. e.g.: &#x60;.over(\&quot;env:prod\&quot;, \&quot;role:db\&quot;)&#x60; - **&#x60;count&#x60;** must be at greater than or equal to your max threshold (defined in the &#x60;options&#x60;). It is limited to 100. For example, if you&#39;ve specified to notify on 1 critical, 3 ok, and 2 warn statuses, &#x60;count&#x60; should be 3.  **Event Alert Query**  Example: &#x60;events(&#39;sources:nagios status:error,warning priority:normal tags: \&quot;string query\&quot;&#39;).rollup(\&quot;count\&quot;).last(\&quot;1h\&quot;)\&quot;&#x60;  - **&#x60;event&#x60;**, the event query string: - **&#x60;string_query&#x60;** free text query to match against event title and text. - **&#x60;sources&#x60;** event sources (comma-separated). - **&#x60;status&#x60;** event statuses (comma-separated). Valid options: error, warn, and info. - **&#x60;priority&#x60;** event priorities (comma-separated). Valid options: low, normal, all. - **&#x60;host&#x60;** event reporting host (comma-separated). - **&#x60;tags&#x60;** event tags (comma-separated). - **&#x60;excluded_tags&#x60;** excluded event tags (comma-separated). - **&#x60;rollup&#x60;** the stats roll-up method. &#x60;count&#x60; is the only supported method now. - **&#x60;last&#x60;** the timeframe to roll up the counts. Examples: 45m, 4h. Supported timeframes: m, h and d. This value should not exceed 48 hours.  **NOTE** Only available on US1 and EU.  **Event V2 Alert Query**  Example: &#x60;events(query).rollup(rollup_method[, measure]).last(time_window) operator #&#x60;  - **&#x60;query&#x60;** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/). - **&#x60;rollup_method&#x60;** The stats roll-up method - supports &#x60;count&#x60;, &#x60;avg&#x60; and &#x60;cardinality&#x60;. - **&#x60;measure&#x60;** For &#x60;avg&#x60; and cardinality &#x60;rollup_method&#x60; - specify the measure or the facet name you want to use. - **&#x60;time_window&#x60;** #m (5, 10, 15, or 30), #h (1, 2, or 4, 24). - **&#x60;operator&#x60;** &#x60;&lt;&#x60;, &#x60;&lt;&#x3D;&#x60;, &#x60;&gt;&#x60;, &#x60;&gt;&#x3D;&#x60;, &#x60;&#x3D;&#x3D;&#x60;, or &#x60;!&#x3D;&#x60;. - **&#x60;#&#x60;** an integer or decimal number used to set the threshold.  **NOTE** Only available on US1-FED, US3, and in closed beta on EU and US1.  **Process Alert Query**  Example: &#x60;processes(search).over(tags).rollup(&#39;count&#39;).last(timeframe) operator #&#x60;  - **&#x60;search&#x60;** free text search string for querying processes. Matching processes match results on the [Live Processes](https://docs.datadoghq.com/infrastructure/process/?tab&#x3D;linuxwindows) page. - **&#x60;tags&#x60;** one or more tags (comma-separated) - **&#x60;timeframe&#x60;** the timeframe to roll up the counts. Examples: 10m, 4h. Supported timeframes: s, m, h and d - **&#x60;operator&#x60;** &lt;, &lt;&#x3D;, &gt;, &gt;&#x3D;, &#x3D;&#x3D;, or !&#x3D; - **&#x60;#&#x60;** an integer or decimal number used to set the threshold  **Logs Alert Query**  Example: &#x60;logs(query).index(index_name).rollup(rollup_method[, measure]).last(time_window) operator #&#x60;  - **&#x60;query&#x60;** The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/). - **&#x60;index_name&#x60;** For multi-index organizations, the log index in which the request is performed. - **&#x60;rollup_method&#x60;** The stats roll-up method - supports &#x60;count&#x60;, &#x60;avg&#x60; and &#x60;cardinality&#x60;. - **&#x60;measure&#x60;** For &#x60;avg&#x60; and cardinality &#x60;rollup_method&#x60; - specify the measure or the facet name you want to use. - **&#x60;time_window&#x60;** #m (between 1 and 2880), #h (between 1 and 48) - **&#x60;operator&#x60;** &#x60;&lt;&#x60;, &#x60;&lt;&#x3D;&#x60;, &#x60;&gt;&#x60;, &#x60;&gt;&#x3D;&#x60;, &#x60;&#x3D;&#x3D;&#x60;, or &#x60;!&#x3D;&#x60;. - **&#x60;#&#x60;** an integer or decimal number used to set the threshold.  **Composite Query**  Example: &#x60;12345 &amp;&amp; 67890&#x60;, where &#x60;12345&#x60; and &#x60;67890&#x60; are the IDs of non-composite monitors  * **&#x60;name&#x60;** [*required*, *default* &#x3D; **dynamic, based on query**]: The name of the alert. * **&#x60;message&#x60;** [*required*, *default* &#x3D; **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 &#39;@username&#39; notation as events. * **&#x60;tags&#x60;** [*optional*, *default* &#x3D; **empty list**]: A list of tags to associate with your monitor. When getting all monitor details via the API, use the &#x60;monitor_tags&#x60; argument to filter results by these tags. It is only available via the API and isn&#39;t visible or editable in the Datadog UI.  **SLO Alert Query**  Example: &#x60;error_budget(\&quot;slo_id\&quot;).over(\&quot;time_window\&quot;) operator #&#x60;  - **&#x60;slo_id&#x60;**: The alphanumeric SLO ID of the SLO you are configuring the alert for. - **&#x60;time_window&#x60;**: The time window of the SLO target you wish to alert on. Valid options: &#x60;7d&#x60;, &#x60;30d&#x60;, &#x60;90d&#x60;. - **&#x60;operator&#x60;**: &#x60;&gt;&#x3D;&#x60; or &#x60;&gt;&#x60;
     # @param body [Monitor] Create a monitor request body.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Monitor, Integer, Hash)>] Monitor data, response status code and response headers

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

@@ -0,0 +1,418 @@
+=begin
+#Datadog API V1 Collection
+
+#Collection of all Datadog Public endpoints.
+
+The version of the OpenAPI document: 1.0
+Contact: support@datadoghq.com
+Generated by: https://openapi-generator.tech
+
+ Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+ This product includes software developed at Datadog (https://www.datadoghq.com/).
+ Copyright 2020-Present Datadog, Inc.
+
+=end
+
+require 'cgi'
+
+module DatadogAPIClient::V1
+  class NotebooksAPI
+    attr_accessor :api_client
+
+    def initialize(api_client = APIClient.default)
+      @api_client = api_client
+    end
+    # Create a notebook
+    # Create a notebook using the specified options.
+    # @param body [NotebookCreateRequest] The JSON description of the notebook you want to create.
+    # @param [Hash] opts the optional parameters
+    # @return [NotebookResponse]
+    def create_notebook(body, opts = {})
+      data, _status_code, _headers = create_notebook_with_http_info(body, opts)
+      data
+    end
+
+    # Create a notebook
+    # Create a notebook using the specified options.
+    # @param body [NotebookCreateRequest] The JSON description of the notebook you want to create.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(NotebookResponse, Integer, Hash)>] NotebookResponse data, response status code and response headers
+    def create_notebook_with_http_info(body, opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:create_notebook)
+        unstable_enabled = @api_client.config.unstable_operations[:create_notebook]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "create_notebook")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "create_notebook"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NotebooksAPI.create_notebook ...'
+      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 NotebooksAPI.create_notebook"
+      end
+      # resource path
+      local_var_path = '/api/v1/notebooks'
+
+      # 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] || 'NotebookResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :create_notebook,
+        :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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NotebooksAPI#create_notebook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete a notebook
+    # Delete a notebook using the specified ID.
+    # @param notebook_id [Integer] Unique ID, assigned when you create the notebook.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_notebook(notebook_id, opts = {})
+      delete_notebook_with_http_info(notebook_id, opts)
+      nil
+    end
+
+    # Delete a notebook
+    # Delete a notebook using the specified ID.
+    # @param notebook_id [Integer] Unique ID, assigned when you create the notebook.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_notebook_with_http_info(notebook_id, opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:delete_notebook)
+        unstable_enabled = @api_client.config.unstable_operations[:delete_notebook]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "delete_notebook")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "delete_notebook"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NotebooksAPI.delete_notebook ...'
+      end
+      # verify the required parameter 'notebook_id' is set
+      if @api_client.config.client_side_validation && notebook_id.nil?
+        fail ArgumentError, "Missing the required parameter 'notebook_id' when calling NotebooksAPI.delete_notebook"
+      end
+      # resource path
+      local_var_path = '/api/v1/notebooks/{notebook_id}'.sub('{' + 'notebook_id' + '}', CGI.escape(notebook_id.to_s))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :delete_notebook,
+        :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(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NotebooksAPI#delete_notebook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a notebook
+    # Get a notebook using the specified notebook ID.
+    # @param notebook_id [Integer] Unique ID, assigned when you create the notebook.
+    # @param [Hash] opts the optional parameters
+    # @return [NotebookResponse]
+    def get_notebook(notebook_id, opts = {})
+      data, _status_code, _headers = get_notebook_with_http_info(notebook_id, opts)
+      data
+    end
+
+    # Get a notebook
+    # Get a notebook using the specified notebook ID.
+    # @param notebook_id [Integer] Unique ID, assigned when you create the notebook.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(NotebookResponse, Integer, Hash)>] NotebookResponse data, response status code and response headers
+    def get_notebook_with_http_info(notebook_id, opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:get_notebook)
+        unstable_enabled = @api_client.config.unstable_operations[:get_notebook]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "get_notebook")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "get_notebook"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NotebooksAPI.get_notebook ...'
+      end
+      # verify the required parameter 'notebook_id' is set
+      if @api_client.config.client_side_validation && notebook_id.nil?
+        fail ArgumentError, "Missing the required parameter 'notebook_id' when calling NotebooksAPI.get_notebook"
+      end
+      # resource path
+      local_var_path = '/api/v1/notebooks/{notebook_id}'.sub('{' + 'notebook_id' + '}', CGI.escape(notebook_id.to_s))
+
+      # 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'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'NotebookResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_notebook,
+        :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(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NotebooksAPI#get_notebook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get all notebooks
+    # Get all notebooks. This can also be used to search for notebooks with a particular `query` in the notebook `name` or author `handle`.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :author_handle Return notebooks created by the given &#x60;author_handle&#x60;.
+    # @option opts [String] :exclude_author_handle Return notebooks not created by the given &#x60;author_handle&#x60;.
+    # @option opts [Integer] :start The index of the first notebook you want returned.
+    # @option opts [Integer] :count The number of notebooks to be returned.
+    # @option opts [String] :sort_field Sort by field &#x60;modified&#x60; or &#x60;name&#x60;. (default to 'modified')
+    # @option opts [String] :sort_dir Sort by direction &#x60;asc&#x60; or &#x60;desc&#x60;. (default to 'desc')
+    # @option opts [String] :query Return only notebooks with &#x60;query&#x60; string in notebook name or author handle.
+    # @option opts [Boolean] :include_cells Value of &#x60;false&#x60; excludes the &#x60;cells&#x60; and global &#x60;time&#x60; for each notebook. (default to true)
+    # @return [NotebooksResponse]
+    def list_notebooks(opts = {})
+      data, _status_code, _headers = list_notebooks_with_http_info(opts)
+      data
+    end
+
+    # Get all notebooks
+    # Get all notebooks. This can also be used to search for notebooks with a particular &#x60;query&#x60; in the notebook &#x60;name&#x60; or author &#x60;handle&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :author_handle Return notebooks created by the given &#x60;author_handle&#x60;.
+    # @option opts [String] :exclude_author_handle Return notebooks not created by the given &#x60;author_handle&#x60;.
+    # @option opts [Integer] :start The index of the first notebook you want returned.
+    # @option opts [Integer] :count The number of notebooks to be returned.
+    # @option opts [String] :sort_field Sort by field &#x60;modified&#x60; or &#x60;name&#x60;.
+    # @option opts [String] :sort_dir Sort by direction &#x60;asc&#x60; or &#x60;desc&#x60;.
+    # @option opts [String] :query Return only notebooks with &#x60;query&#x60; string in notebook name or author handle.
+    # @option opts [Boolean] :include_cells Value of &#x60;false&#x60; excludes the &#x60;cells&#x60; and global &#x60;time&#x60; for each notebook.
+    # @return [Array<(NotebooksResponse, Integer, Hash)>] NotebooksResponse data, response status code and response headers
+    def list_notebooks_with_http_info(opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:list_notebooks)
+        unstable_enabled = @api_client.config.unstable_operations[:list_notebooks]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "list_notebooks")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "list_notebooks"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NotebooksAPI.list_notebooks ...'
+      end
+      # resource path
+      local_var_path = '/api/v1/notebooks'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'author_handle'] = opts[:'author_handle'] if !opts[:'author_handle'].nil?
+      query_params[:'exclude_author_handle'] = opts[:'exclude_author_handle'] if !opts[:'exclude_author_handle'].nil?
+      query_params[:'start'] = opts[:'start'] if !opts[:'start'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'sort_field'] = opts[:'sort_field'] if !opts[:'sort_field'].nil?
+      query_params[:'sort_dir'] = opts[:'sort_dir'] if !opts[:'sort_dir'].nil?
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
+      query_params[:'include_cells'] = opts[:'include_cells'] if !opts[:'include_cells'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'NotebooksResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_notebooks,
+        :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(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NotebooksAPI#list_notebooks\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update a notebook
+    # Update a notebook using the specified ID.
+    # @param notebook_id [Integer] Unique ID, assigned when you create the notebook.
+    # @param body [NotebookUpdateRequest] Update notebook request body.
+    # @param [Hash] opts the optional parameters
+    # @return [NotebookResponse]
+    def update_notebook(notebook_id, body, opts = {})
+      data, _status_code, _headers = update_notebook_with_http_info(notebook_id, body, opts)
+      data
+    end
+
+    # Update a notebook
+    # Update a notebook using the specified ID.
+    # @param notebook_id [Integer] Unique ID, assigned when you create the notebook.
+    # @param body [NotebookUpdateRequest] Update notebook request body.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(NotebookResponse, Integer, Hash)>] NotebookResponse data, response status code and response headers
+    def update_notebook_with_http_info(notebook_id, body, opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:update_notebook)
+        unstable_enabled = @api_client.config.unstable_operations[:update_notebook]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "update_notebook")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "update_notebook"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NotebooksAPI.update_notebook ...'
+      end
+      # verify the required parameter 'notebook_id' is set
+      if @api_client.config.client_side_validation && notebook_id.nil?
+        fail ArgumentError, "Missing the required parameter 'notebook_id' when calling NotebooksAPI.update_notebook"
+      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 NotebooksAPI.update_notebook"
+      end
+      # resource path
+      local_var_path = '/api/v1/notebooks/{notebook_id}'.sub('{' + 'notebook_id' + '}', CGI.escape(notebook_id.to_s))
+
+      # 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] || 'NotebookResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :update_notebook,
+        :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(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NotebooksAPI#update_notebook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end