datadog_api_client 2.1.0 → 2.3.0

data/.generator/src/generator/cli.py

@@ -66,6 +66,10 @@ def cli(specs, output):
         "inflector.rb": env.get_template("inflector.j2"),
     }
 
+    test_scenarios_files = {
+        "scenarios_model_mapping.rb": env.get_template("scenarios_model_mapping.j2")
+    }
+
     all_specs = {}
     all_apis = {}
     all_models = {}
@@ -115,3 +119,10 @@ def cli(specs, output):
         filename = common_output / name
         with filename.open("w") as fp:
             fp.write(template.render(all_apis=all_apis, all_specs=all_specs, all_models=all_models))
+
+    # Parameter mappings for bdd tests
+    scenarios_test_output = pathlib.Path("../features/")
+    for name, template in test_scenarios_files.items():
+        filename = scenarios_test_output / name
+        with filename.open("w") as fp:
+            fp.write(template.render(all_apis=all_apis))

data/.generator/src/generator/formatter.py

@@ -282,7 +282,7 @@ def format_data_with_schema_list(
                     replace_values=replace_values,
                     default_name=name,
                 )
-            except (KeyError, ValueError) as e:
+            except (KeyError, ValueError):
                 continue
             return value
         raise ValueError(f"{data} is not valid oneOf {schema}")
@@ -336,6 +336,8 @@ def format_data_with_schema_dict(
                 replace_values=replace_values,
             )
             parameters += f"{k}: {value}, "
+        if not has_properties:
+            name = None
 
     if not name and "oneOf" not in schema:
         if default_name and not schema.get("additionalProperties") and schema.get("properties"):
@@ -349,6 +351,8 @@ def format_data_with_schema_dict(
         parameters = _format_oneof(data, schema, name_prefix=name_prefix, replace_values=replace_values)
 
     if name == "dict":
+        if not parameters and data:
+            parameters = ", ".join(f"{k}: \"{v}\"" for k, v in data.items())
         return f"{{\n{parameters}}}"
     elif name:
         return f"{name_prefix}{name}.new({{\n{parameters}}})"

data/.generator/src/generator/templates/api.j2

@@ -31,6 +31,10 @@ module {{ module_name }}::{{ version|upper }}
     {{ operation.description|block_comment|indent(4) }}
     #
     {%- endif %}
+    {%- if operation.deprecated %}
+    # @deprecated This API is deprecated.
+    #
+    {%- endif %}
     {%- for name, parameter in operation|parameters if parameter.required %}
     # @param {{ name|attribute_name }} [{{ get_type_for_parameter(parameter) }}] {{ parameter.get("description", "").replace('\n', ' ') }}
     {%- endfor %}
@@ -40,6 +44,9 @@ module {{ module_name }}::{{ version|upper }}
     {%- endfor %}
     # @return [Array<({% if returnType %}{{ returnType }}{% else %}nil{% endif %}, Integer, Hash)>] {% if returnType %}{{ returnType }} data{% else %}nil{% endif %}, response status code and response headers
     def {{ operation.operationId|snake_case }}_with_http_info({% for name, parameter in operation|parameters if parameter.required %}{{ name|attribute_name }}, {% endfor %}opts = {})
+      {%- if operation.deprecated %}
+      warn "[DEPRECATION] `{{ operation.operationId }}` is deprecated."
+      {%- endif %}
       {%- if "x-unstable" in operation %}
       unstable_enabled = @api_client.config.unstable_operations["{{ version }}.{{ operation.operationId|snake_case }}".to_sym]
       if unstable_enabled

data/.generator/src/generator/templates/api_client.j2

@@ -134,11 +134,15 @@ module {{ module_name }}
       req_opts = {
         :method => http_method,
         :headers => header_params,
-        :query => query_params,
+        :query => transform_hash(query_params),
         :timeout => @config.timeout,
         :verify_peer => @config.verify_ssl,
         :verify => _verify_ssl_host,
-        :verbose => @config.debugging
+        :verbose => @config.debugging,
+        :http_proxyaddr => @config.http_proxyaddr,
+        :http_proxyport => @config.http_proxyport,
+        :http_proxyuser => @config.http_proxyuser,
+        :http_proxypass => @config.http_proxypass
       }
 
       req_opts[:pem] = File.read(@config.cert_file) if @config.cert_file
@@ -361,7 +365,32 @@ module {{ module_name }}
       else
         local_body = object_to_hash(model)
       end
-      local_body.to_json
+      transform_hash(local_body).to_json
+    end
+
+    # Transform object (array, hash, object, etc) to serializable object.
+    # @param [Object] obj to transform
+    # @return [Object]
+    def transform_hash(obj)
+      if obj.is_a?(Array)
+        obj.map { |m| transform_hash(m) }
+      elsif obj.is_a?(Hash)
+        obj.each do | k, v |
+          if v.class == Time
+            t = v.strftime("%FT%T")
+            if v.nsec > 0
+              t << v.strftime(".%3N")
+            end
+            t << (v.utc? ? 'Z' : v.strftime("%:z"))
+
+            obj[k] = t
+          else
+            obj[k] = transform_hash(v)
+          end
+        end
+      end
+
+      obj
     end
 
     # Convert object(non-array) to hash.

data/.generator/src/generator/templates/configuration.j2

@@ -125,6 +125,19 @@ module {{ module_name }}
     # Set this to add accept encoding header for compression
     attr_accessor :compress
 
+    ### Proxy settings
+    # Address of proxy server to use
+    attr_accessor :http_proxyaddr
+
+    # Port of proxy server to use
+    attr_accessor :http_proxyport
+
+    # User for proxy server authentication
+    attr_accessor :http_proxyuser
+
+    # Password for proxy server authentication
+    attr_accessor :http_proxypass
+
     def initialize
       {%- set default_server = openapi.servers[0]|format_server %}
       @scheme = '{{ default_server.scheme }}'
@@ -146,6 +159,10 @@ module {{ module_name }}
       @inject_format = false
       @force_ending_format = false
       @compress = true
+      @http_proxyaddr = nil
+      @http_proxyport = nil
+      @http_proxyuser = nil
+      @http_proxypass = nil
       @logger = defined?(Rails) ? Rails.logger : Logger.new(STDOUT)
       @unstable_operations = {
       {%- for version, apis in all_apis.items() %}

data/.generator/src/generator/templates/model.j2

@@ -7,6 +7,10 @@ require 'time'
 
 module {{ module_name }}::{{ version|upper }}
   # {{ model.description.rstrip()|replace('\n', '\n# ')|indent(2) }}
+{%- if model.deprecated %}
+  #
+  # @deprecated This model is deprecated.
+{%- endif %}
 {% if "enum" in model -%}
 {% include "model_enum.j2" %}
 {%- elif "oneOf" in model -%}

data/.generator/src/generator/templates/model_base.j2

@@ -47,7 +47,7 @@ module {{ module_name }}::{{ version|upper }}
     def build_from_hash(attributes)
       return nil unless attributes.is_a?(Hash)
       self.class.openapi_types.each_pair do |key, type|
-        if attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key)
+        if attributes.key?(self.class.attribute_map[key]) && attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key)
           self.send("#{key}=", nil)
         elsif type =~ /\AArray<(.*)>/i
           # check to ensure the input is an array given that the attribute
@@ -60,6 +60,14 @@ module {{ module_name }}::{{ version|upper }}
         end
       end
 
+      if self.respond_to?(:additional_properties)
+        attributes.each_with_object({}) { |(k, v), h|
+          if (!self.class.attribute_map.key?(k.to_sym))
+            self.additional_properties[k.to_sym] = v
+          end
+        }
+      end
+
       self
     end
 
@@ -226,7 +234,7 @@ module {{ module_name }}::{{ version|upper }}
             return model if model
           else
             # raise if data contains keys that are not known to the model
-            raise unless (data.keys - const.acceptable_attributes).empty?
+            raise unless (data.keys - const.attribute_map.values).empty?
             model = const.build_from_hash(data)
             return model if model && model.valid?
           end

data/.generator/src/generator/templates/model_generic.j2

@@ -24,12 +24,6 @@
       }
     end
 
-    # Returns all the JSON keys this model knows about{# TODO add parent #}
-    # @!visibility private
-    def self.acceptable_attributes
-      attribute_map.values
-    end
-
     # Attribute type mapping.
     # @!visibility private
     def self.openapi_types
@@ -54,6 +48,9 @@
     # @param attributes [Hash] Model attributes in the form of hash
     # @!visibility private
     def initialize(attributes = {})
+      {%- if model.deprecated %}
+      warn "[DEPRECATION] `{{ name }}` is deprecated."
+      {%- endif %}
       if (!attributes.is_a?(Hash))
         fail ArgumentError, "The input argument (attributes) must be a hash in `{{ module_name }}::{{ version|upper }}::{{ name }}` initialize method"
       end
@@ -85,10 +82,6 @@
         {%- else %}
         self.{{ attr|attribute_name }} = attributes[:'{{ attr|attribute_name }}']
         {%- endif %}
-{%- if "default" in definition and definition.default != None %}
-      else
-        self.{{ attr|attribute_name }} = {{ definition.default|format_value }}
-{%- endif %}
       end
 {%- endfor %}
     end
@@ -236,13 +229,6 @@
 {%- endif %}
     end
 
-    # @see the `==` method
-    # @param o [Object] Object to be compared
-    # @!visibility private
-    def eql?(o)
-      self == o
-    end
-
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     # @!visibility private

data/.generator/src/generator/templates/model_oneof.j2

@@ -39,7 +39,7 @@
       #}
       {%- endif %}
       # Builds the object
-      # @param [Mixed] Data to be matched against the list of oneOf items
+      # @param data [Mixed] Data to be matched against the list of oneOf items
       # @return [Object] Returns the model or the data itself
       def build(data)
       {%- if model.discriminator %}

data/.generator/src/generator/templates/scenarios_model_mapping.j2

@@ -0,0 +1,16 @@
+ScenariosModelMappings = {
+{%- for version, apis in all_apis.items() %}
+{%- for _, operations in apis.items() %}
+{%- for path, method, operation in operations %}
+{%- set operationParams = operation|parameters|list %}
+{%- if operationParams|length > 0 %}
+    "{{ version }}.{{ operation['operationId'] }}" => {
+        {%- for name, parameter in operation|parameters %}
+            "{{ name|attribute_name }}" => "{{ get_type_for_parameter(parameter) }}",
+        {%- endfor %}
+    },
+{%- endif %}
+{%- endfor %}
+{%- endfor %}
+{%- endfor %}
+}

data/.github/workflows/test.yml

@@ -32,6 +32,9 @@ jobs:
           fetch-depth: 0
           ref: ${{ github.event.pull_request.head.sha }}
           token: ${{ steps.get_token.outputs.token }}
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
       - name: Install pre-commit
         run: python -m pip install pre-commit
       - name: set PY

data/.pre-commit-config.yaml

@@ -4,7 +4,7 @@ repos:
   - id: generate
     name: Generate
     language: system
-    entry: make
+    entry: bash -c "./generate.sh"
     files: '^(\.generator/.*|\.pre-commit-config\.yaml|Makefile|\features/.*)'
     pass_filenames: false
   - id: format-examples

data/CHANGELOG.md

@@ -1,5 +1,51 @@
 # CHANGELOG
 
+## 2.3.0 / 2022-10-24
+
+### Fixed
+* Add Default Rule ID in SignalRuleResponseQuery by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1096
+* Remove incident's resolved attribute from update requests by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1098
+* Fix event monitor created_at by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1099
+* Fix spectral rules by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1102
+### Added
+* Add notify_by monitor option by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1089
+* Add support for service definitions APIs by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1103
+* Add support for confluent cloud integration by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1046
+### Changed
+* Validate models in BDD and cleanup serialization/deserialization of models by @skarimo in https://github.com/DataDog/datadog-api-client-ruby/pull/1045
+### Deprecated
+* Deprecate metric field of Security Monitoring Rules by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1107
+* Add deprecation warnings to API and models by @therve in https://github.com/DataDog/datadog-api-client-ruby/pull/1111
+
+
+**Full Changelog**: https://github.com/DataDog/datadog-api-client-ruby/compare/v2.2.0...v2.3.0
+
+## 2.2.0 / 2022-10-03
+
+### Fixed
+* Refactor RuleQuery models by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1082
+* Fix SearchSLO response structure by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1084
+### Added
+* Add ListActiveConfigurations endpoint and add new filter[queried] param to list tag configurations endpoint by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1017
+* Add doesNotExist to synthetics operator enum by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1059
+* Add TopologyMapWidget to dashboard schema by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1063
+* Add Overall Status support to SLO Search API by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1065
+* Add support for proxy usage by @skarimo in https://github.com/DataDog/datadog-api-client-ruby/pull/1069
+* Add APM Fargate to Usage Metering API by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1058
+* Add support for template variable multiselect in dashboards by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1068
+* Add storage option to widget query definitions by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1072
+* Add support for retrieving a security signal by ID by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1077
+* Add support for signal correlation API by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1073
+* Add support for SLO List widget by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1076
+* Add new historical_cost endpoint, and update estimate_cost by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1071
+* Add support for incident attachment APIs by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1083
+
+## New Contributors
+* @nkzou made their first contribution in https://github.com/DataDog/datadog-api-client-ruby/pull/1057
+* @dependabot made their first contribution in https://github.com/DataDog/datadog-api-client-ruby/pull/1091
+
+**Full Changelog**: https://github.com/DataDog/datadog-api-client-ruby/compare/v2.1.0...v2.2.0
+
 ## 2.1.0 / 2022-08-31
 
 ### Added

data/Gemfile

@@ -18,6 +18,7 @@ group :development, :test do
   gem 'vcr'
   gem 'webmock'
   gem 'zstandard'
+  gem 'pry'
 end
 
 group :docs do

data/README.md

@@ -138,6 +138,17 @@ config.debugging = true
 client = DatadogAPIClient::APIClient.new(config)
 ```
 
+### Configure proxy
+
+You can configure the client to use proxy by setting `http_proxyaddr` and `http_proxyport` keys on configuration object:
+
+```ruby
+config = DatadogAPIClient::Configuration.new
+config.http_proxyaddr = '127.0.0.1'
+config.http_proxyport = '3128'
+client = DatadogAPIClient::APIClient.new(config)
+```
+
 ### Pagination
 
 Several listing operations have a pagination method to help consume all the items available.

data/examples/v1/dashboards/CreateDashboard_1423904722.rb

@@ -0,0 +1,38 @@
+# Create a new dashboard with slo list widget
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::DashboardsAPI.new
+
+body = DatadogAPIClient::V1::Dashboard.new({
+  title: "Example-Create_a_new_dashboard_with_slo_list_widget",
+  description: "",
+  widgets: [
+    DatadogAPIClient::V1::Widget.new({
+      layout: DatadogAPIClient::V1::WidgetLayout.new({
+        x: 0,
+        y: 0,
+        width: 60,
+        height: 21,
+      }),
+      definition: DatadogAPIClient::V1::SLOListWidgetDefinition.new({
+        title_size: "16",
+        title_align: DatadogAPIClient::V1::WidgetTextAlign::LEFT,
+        type: DatadogAPIClient::V1::SLOListWidgetDefinitionType::SLO_LIST,
+        requests: [
+          DatadogAPIClient::V1::SLOListWidgetRequest.new({
+            query: DatadogAPIClient::V1::SLOListWidgetQuery.new({
+              query_string: "env:prod AND service:my-app",
+              limit: 75,
+            }),
+            request_type: DatadogAPIClient::V1::SLOListWidgetRequestType::SLO_LIST,
+          }),
+        ],
+      }),
+    }),
+  ],
+  template_variables: [],
+  layout_type: DatadogAPIClient::V1::DashboardLayoutType::FREE,
+  is_read_only: false,
+  notify_list: [],
+})
+p api_instance.create_dashboard(body)

data/examples/v1/dashboards/CreateDashboard_2652180930.rb

@@ -0,0 +1,43 @@
+# Create a new dashboard with topology_map widget
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::DashboardsAPI.new
+
+body = DatadogAPIClient::V1::Dashboard.new({
+  title: "Example-Create_a_new_dashboard_with_topology_map_widget",
+  description: "",
+  widgets: [
+    DatadogAPIClient::V1::Widget.new({
+      layout: DatadogAPIClient::V1::WidgetLayout.new({
+        x: 0,
+        y: 0,
+        width: 47,
+        height: 15,
+      }),
+      definition: DatadogAPIClient::V1::TopologyMapWidgetDefinition.new({
+        title: "",
+        title_size: "16",
+        title_align: DatadogAPIClient::V1::WidgetTextAlign::LEFT,
+        type: DatadogAPIClient::V1::TopologyMapWidgetDefinitionType::TOPOLOGY_MAP,
+        requests: [
+          DatadogAPIClient::V1::TopologyRequest.new({
+            request_type: DatadogAPIClient::V1::TopologyRequestType::TOPOLOGY,
+            query: DatadogAPIClient::V1::TopologyQuery.new({
+              data_source: DatadogAPIClient::V1::TopologyQueryDataSource::SERVICE_MAP,
+              service: "",
+              filters: [
+                "env:none",
+                "environment:*",
+              ],
+            }),
+          }),
+        ],
+      }),
+    }),
+  ],
+  template_variables: [],
+  layout_type: DatadogAPIClient::V1::DashboardLayoutType::FREE,
+  is_read_only: false,
+  notify_list: [],
+})
+p api_instance.create_dashboard(body)

data/examples/v1/dashboards/CreateDashboard_2850365602.rb

@@ -0,0 +1,55 @@
+# Create a new dashboard with template variable presets using values returns "OK" response
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::DashboardsAPI.new
+
+body = DatadogAPIClient::V1::Dashboard.new({
+  description: nil,
+  is_read_only: false,
+  layout_type: DatadogAPIClient::V1::DashboardLayoutType::ORDERED,
+  notify_list: [],
+  reflow_type: DatadogAPIClient::V1::DashboardReflowType::AUTO,
+  restricted_roles: [],
+  template_variable_presets: [
+    DatadogAPIClient::V1::DashboardTemplateVariablePreset.new({
+      name: "my saved view",
+      template_variables: [
+        DatadogAPIClient::V1::DashboardTemplateVariablePresetValue.new({
+          name: "datacenter",
+          values: [
+            "*",
+            "my-host",
+          ],
+        }),
+      ],
+    }),
+  ],
+  template_variables: [
+    DatadogAPIClient::V1::DashboardTemplateVariable.new({
+      available_values: [
+        "my-host",
+        "host1",
+        "host2",
+      ],
+      defaults: [
+        "my-host",
+      ],
+      name: "host1",
+      prefix: "host",
+    }),
+  ],
+  title: "",
+  widgets: [
+    DatadogAPIClient::V1::Widget.new({
+      definition: DatadogAPIClient::V1::HostMapWidgetDefinition.new({
+        requests: DatadogAPIClient::V1::HostMapWidgetDefinitionRequests.new({
+          fill: DatadogAPIClient::V1::HostMapRequest.new({
+            q: "avg:system.cpu.user{*}",
+          }),
+        }),
+        type: DatadogAPIClient::V1::HostMapWidgetDefinitionType::HOSTMAP,
+      }),
+    }),
+  ],
+})
+p api_instance.create_dashboard(body)

data/examples/v1/dashboards/CreateDashboard_3117424216.rb

@@ -0,0 +1,33 @@
+# Create a new dashboard with logs_stream list_stream widget and storage parameter
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::DashboardsAPI.new
+
+body = DatadogAPIClient::V1::Dashboard.new({
+  layout_type: DatadogAPIClient::V1::DashboardLayoutType::ORDERED,
+  title: "Example-Create_a_new_dashboard_with_logs_stream_list_stream_widget_and_storage_parameter with list_stream widget",
+  widgets: [
+    DatadogAPIClient::V1::Widget.new({
+      definition: DatadogAPIClient::V1::ListStreamWidgetDefinition.new({
+        type: DatadogAPIClient::V1::ListStreamWidgetDefinitionType::LIST_STREAM,
+        requests: [
+          DatadogAPIClient::V1::ListStreamWidgetRequest.new({
+            columns: [
+              DatadogAPIClient::V1::ListStreamColumn.new({
+                width: DatadogAPIClient::V1::ListStreamColumnWidth::AUTO,
+                field: "timestamp",
+              }),
+            ],
+            query: DatadogAPIClient::V1::ListStreamQuery.new({
+              data_source: DatadogAPIClient::V1::ListStreamSource::LOGS_STREAM,
+              query_string: "",
+              storage: "hot",
+            }),
+            response_format: DatadogAPIClient::V1::ListStreamResponseFormat::EVENT_LIST,
+          }),
+        ],
+      }),
+    }),
+  ],
+})
+p api_instance.create_dashboard(body)

data/examples/v1/dashboards/CreateDashboard_3669695268.rb

@@ -0,0 +1,50 @@
+# Create a new dashboard with logs query table widget and storage parameter
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::DashboardsAPI.new
+
+body = DatadogAPIClient::V1::Dashboard.new({
+  layout_type: DatadogAPIClient::V1::DashboardLayoutType::ORDERED,
+  title: "Example-Create_a_new_dashboard_with_logs_query_table_widget_and_storage_parameter with query table widget and storage parameter",
+  widgets: [
+    DatadogAPIClient::V1::Widget.new({
+      definition: DatadogAPIClient::V1::TableWidgetDefinition.new({
+        type: DatadogAPIClient::V1::TableWidgetDefinitionType::QUERY_TABLE,
+        requests: [
+          DatadogAPIClient::V1::TableWidgetRequest.new({
+            queries: [
+              DatadogAPIClient::V1::FormulaAndFunctionEventQueryDefinition.new({
+                data_source: DatadogAPIClient::V1::FormulaAndFunctionEventsDataSource::LOGS,
+                name: "query1",
+                search: DatadogAPIClient::V1::FormulaAndFunctionEventQueryDefinitionSearch.new({
+                  query: "",
+                }),
+                indexes: [
+                  "*",
+                ],
+                compute: DatadogAPIClient::V1::FormulaAndFunctionEventQueryDefinitionCompute.new({
+                  aggregation: DatadogAPIClient::V1::FormulaAndFunctionEventAggregation::COUNT,
+                }),
+                group_by: [],
+                storage: "online_archives",
+              }),
+            ],
+            formulas: [
+              DatadogAPIClient::V1::WidgetFormula.new({
+                conditional_formats: [],
+                cell_display_mode: DatadogAPIClient::V1::TableWidgetCellDisplayMode::BAR,
+                formula: "query1",
+                limit: DatadogAPIClient::V1::WidgetFormulaLimit.new({
+                  count: 50,
+                  order: DatadogAPIClient::V1::QuerySortOrder::DESC,
+                }),
+              }),
+            ],
+            response_format: DatadogAPIClient::V1::FormulaAndFunctionResponseFormat::SCALAR,
+          }),
+        ],
+      }),
+    }),
+  ],
+})
+p api_instance.create_dashboard(body)

data/examples/v1/dashboards/CreateDashboard_858397694.rb

@@ -0,0 +1,41 @@
+# Create a new dashboard with template variable defaults returns "OK" response
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::DashboardsAPI.new
+
+body = DatadogAPIClient::V1::Dashboard.new({
+  description: nil,
+  is_read_only: false,
+  layout_type: DatadogAPIClient::V1::DashboardLayoutType::ORDERED,
+  notify_list: [],
+  reflow_type: DatadogAPIClient::V1::DashboardReflowType::AUTO,
+  restricted_roles: [],
+  template_variables: [
+    DatadogAPIClient::V1::DashboardTemplateVariable.new({
+      available_values: [
+        "my-host",
+        "host1",
+        "host2",
+      ],
+      defaults: [
+        "my-host",
+      ],
+      name: "host1",
+      prefix: "host",
+    }),
+  ],
+  title: "",
+  widgets: [
+    DatadogAPIClient::V1::Widget.new({
+      definition: DatadogAPIClient::V1::HostMapWidgetDefinition.new({
+        requests: DatadogAPIClient::V1::HostMapWidgetDefinitionRequests.new({
+          fill: DatadogAPIClient::V1::HostMapRequest.new({
+            q: "avg:system.cpu.user{*}",
+          }),
+        }),
+        type: DatadogAPIClient::V1::HostMapWidgetDefinitionType::HOSTMAP,
+      }),
+    }),
+  ],
+})
+p api_instance.create_dashboard(body)

data/examples/v1/monitors/ValidateMonitor_4247196452.rb

@@ -6,7 +6,7 @@ api_instance = DatadogAPIClient::V1::MonitorsAPI.new
 body = DatadogAPIClient::V1::Monitor.new({
   name: "Example-Validate_a_multi_alert_monitor_returns_OK_response",
   type: DatadogAPIClient::V1::MonitorType::LOG_ALERT,
-  query: 'logs("service:foo AND type:error").index("main").rollup("count").by("source").last("5m") > 2',
+  query: 'logs("service:foo AND type:error").index("main").rollup("count").by("source,status").last("5m") > 2',
   message: "some message Notify: @hipchat-channel",
   tags: [
     "test:examplevalidateamultialertmonitorreturnsokresponse",
@@ -24,6 +24,9 @@ body = DatadogAPIClient::V1::Monitor.new({
     new_host_delay: 600,
     no_data_timeframe: nil,
     notify_audit: false,
+    notify_by: [
+      "status",
+    ],
     notify_no_data: false,
     on_missing_data: DatadogAPIClient::V1::OnMissingDataOption::SHOW_AND_NOTIFY_NO_DATA,
     renotify_interval: 60,