datadog_api_client 2.12.0 → 2.14.0

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

@@ -2,7 +2,6 @@
 import pathlib
 import json
 import re
-import warnings
 from functools import singledispatch
 
 
@@ -185,6 +184,8 @@ def _format_oneof(data, schema, name_prefix=None, replace_values=None):
     matched = 0
     for sub_schema in schema["oneOf"]:
         try:
+            if "items" in sub_schema and not isinstance(data, list):
+                continue
             formatted = format_data_with_schema(
                 data,
                 sub_schema,
@@ -196,13 +197,11 @@ def _format_oneof(data, schema, name_prefix=None, replace_values=None):
                 # parameters += formatted
                 parameters = formatted
             matched += 1
-        except (KeyError, ValueError):
+        except (KeyError, ValueError, TypeError):
             pass
 
-    if matched == 0:
+    if matched != 1:
         raise ValueError(f"[{matched}] {data} is not valid for schema")
-    elif matched > 1:
-        warnings.warn(f"[{matched}] {data} is not valid for schema")
 
     return parameters
 
@@ -216,9 +215,13 @@ def format_data_with_schema(
     default_name=None,
 ):
     name = get_name(schema)
+    nullable = schema.get("nullable", False)
 
-    if "enum" in schema and data not in schema["enum"]:
-        raise ValueError(f"{data} is not valid enum value {schema['enum']}")
+    if "enum" in schema:
+        if nullable and data is None:
+            pass
+        elif data not in schema["enum"]:
+            raise ValueError(f"{data} is not valid enum value {schema['enum']}")
 
     if replace_values and data in replace_values:
         parameters = replace_values[data]
@@ -227,9 +230,11 @@ def format_data_with_schema(
         elif schema.get("type") == "number":
             parameters = f"{parameters}.to_f"
     elif "enum" in schema:
+        if nullable and data is None:
+            return "nil"
         parameters = schema["x-enum-varnames"][schema["enum"].index(data)]
     else:
-        if schema.get("nullable") and data is None:
+        if nullable and data is None:
             return "nil"
         else:
             if "oneOf" in schema:
@@ -240,11 +245,28 @@ def format_data_with_schema(
                 def open_file(x):
                     return f"File.open({repr(x)}, 'r')"
 
+                def format_number(x):
+                    if isinstance(x, (bool, str)):
+                        raise TypeError(f"{x} is not supported type {schema}")
+                    return str(x)
+
+                def format_string(x):
+                    if isinstance(x, bool):
+                        raise TypeError(f"{x} is not supported type {schema}")
+                    if schema.get("format") == "binary":
+                        return open_file(x)
+                    return repr(x)
+
+                def format_boolean(x):
+                    if not isinstance(x, bool):
+                        raise TypeError(f"{x} is not supported type {schema}")
+                    return "true" if x else "false"
+
                 formatter = {
-                    "number": str,
-                    "integer": str,
-                    "boolean": lambda x: "true" if x else "false",
-                    "string": open_file if schema.get("format") == "binary" else repr,
+                    "number": format_number,
+                    "integer": format_number,
+                    "boolean": format_boolean,
+                    "string": format_string,
                     None: repr,
                 }[schema.get("type")]
 
@@ -275,18 +297,7 @@ def format_data_with_schema_list(
     name = get_name(schema)
 
     if "oneOf" in schema:
-        for sub_schema in schema["oneOf"]:
-            try:
-                value = format_data_with_schema(
-                    data,
-                    sub_schema,
-                    replace_values=replace_values,
-                    default_name=name,
-                )
-            except (KeyError, ValueError):
-                continue
-            return value
-        raise ValueError(f"{data} is not valid oneOf {schema}")
+        return _format_oneof(data, schema, name_prefix=name_prefix, replace_values=replace_values)
 
     parameters = ""
     for d in data:
@@ -318,7 +329,7 @@ def format_data_with_schema_dict(
         missing = required_properties - set(data.keys())
         if missing:
             raise ValueError(f"missing required properties: {missing}")
-        
+
         for k, v in data.items():
             if k not in schema["properties"]:
                 continue
@@ -349,18 +360,18 @@ def format_data_with_schema_dict(
         if default_name and not schema.get("additionalProperties") and schema.get("properties"):
             name = default_name
         else:
-            name = "dict"
-            warnings.warn(f"Unnamed schema {schema} for {data}")
+            if not parameters and data:
+                parameters = ", ".join(f"\"{k}\": \"{v}\"" for k, v in data.items())
+            return f"{{\n{parameters}}}"
 
     if "oneOf" in schema:
         name = None
         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:
+    if parameters == "" and schema.get("type") == "string":
+        raise ValueError(f"No schema matched for {data}")
+
+    if name:
         return f"{name_prefix}{name}.new({{\n{parameters}}})"
 
     return parameters

data/.generator/src/generator/openapi.py

@@ -461,8 +461,10 @@ def get_default(operation, attribute_path):
 
 
 def get_container(operation, attribute_path, with_type=False):
-    def get_type(parameter):
+    def get_type(parameter, attribute=None):
         if with_type:
+            if attribute:
+                return ", {}".format(type_to_ruby(parameter_schema(parameter)["properties"][attribute]))
             return f", {get_type_for_parameter(parameter)}"
         return ""
 
@@ -473,7 +475,7 @@ def get_container(operation, attribute_path, with_type=False):
                 return '{}, "{}"{}'.format(
                     name,
                     ".".join(formatter.attribute_name(a) for a in attribute_path.split(".")[1:]),
-                    get_type(parameter),
+                    get_type(parameter, attribute_path.split(".")[1]),
                 )
     return f'opts, "{formatter.attribute_path(attribute_path)}"{get_type(parameter)}'
 

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

@@ -44,71 +44,99 @@ module {{ module_name }}
     #   the data deserialized from response body (could be nil), response status code and response headers.
     def call_api(http_method, path, opts = {})
       request = build_request(http_method, path, opts)
-      if opts[:stream_body]
-        tempfile = nil
-        encoding = nil
-
-        response = request.perform do | chunk |
-          unless tempfile
-            content_disposition = chunk.http_response.header['Content-Disposition']
-            if content_disposition && content_disposition =~ /filename=/i
-              filename = content_disposition[/filename=['"]?([^'"\s]+)['"]?/, 1]
-              prefix = sanitize_filename(filename)
-            else
-              prefix = 'download-'
-            end
-            prefix = prefix + '-' unless prefix.end_with?('-')
-            unless encoding
-              encoding = chunk.encoding
+      attempt = 0
+      loop do
+        if opts[:stream_body]
+          tempfile = nil
+          encoding = nil
+
+          response = request.perform do | chunk |
+            unless tempfile
+              content_disposition = chunk.http_response.header['Content-Disposition']
+              if content_disposition && content_disposition =~ /filename=/i
+                filename = content_disposition[/filename=['"]?([^'"\s]+)['"]?/, 1]
+                prefix = sanitize_filename(filename)
+              else
+                prefix = 'download-'
+              end
+              prefix = prefix + '-' unless prefix.end_with?('-')
+              unless encoding
+                encoding = chunk.encoding
+              end
+              tempfile = Tempfile.open(prefix, @config.temp_folder_path, encoding: encoding)
+              @tempfile = tempfile
             end
-            tempfile = Tempfile.open(prefix, @config.temp_folder_path, encoding: encoding)
-            @tempfile = tempfile
+            chunk.force_encoding(encoding)
+            tempfile.write(chunk)
+          end
+          if tempfile
+            tempfile.close
+            @config.logger.info "Temp file written to #{tempfile.path}, please copy the file to a proper folder "\
+                              "with e.g. `FileUtils.cp(tempfile.path, '/new/file/path')` otherwise the temp file "\
+                              "will be deleted automatically with GC. It's also recommended to delete the temp file "\
+                              "explicitly with `tempfile.delete`"
           end
-          chunk.force_encoding(encoding)
-          tempfile.write(chunk)
+        else
+          response = request.perform
         end
-        if tempfile
-          tempfile.close
-          @config.logger.info "Temp file written to #{tempfile.path}, please copy the file to a proper folder "\
-                            "with e.g. `FileUtils.cp(tempfile.path, '/new/file/path')` otherwise the temp file "\
-                            "will be deleted automatically with GC. It's also recommended to delete the temp file "\
-                            "explicitly with `tempfile.delete`"
+
+        if @config.debugging
+          @config.logger.debug "HTTP response body ~BEGIN~\n#{response.body}\n~END~\n"
         end
-      else
-        response = request.perform
-      end
 
-      if @config.debugging
-        @config.logger.debug "HTTP response body ~BEGIN~\n#{response.body}\n~END~\n"
-      end
+        unless response.success?
+          if response.request_timeout?
+            fail APIError.new('Connection timed out')
+          elsif response.code == 0
+            # Errors from libcurl will be made visible here
+            fail APIError.new(:code => 0,
+                              :message => response.return_message)
+          else
+            body = response.body
+            if response.headers['Content-Encoding'].eql?('gzip') && !(body.nil? || body.empty?) then
+              gzip = Zlib::Inflate.new(Zlib::MAX_WBITS + 16)
+              body = gzip.inflate(body)
+              gzip.close
+            end
+            if should_retry(attempt, @config.max_retries, response.code, @config.enable_retry)
+              sleep calculate_retry_interval(response, @config.backoff_base, @config.backoff_multiplier, attempt, @config.timeout)
+              attempt = attempt + 1
+              next
+            else
+              fail APIError.new(:code => response.code,
+                :response_headers => response.headers,
+                :response_body => body),
+              response.message
+            end
+          end
+        end
 
-      unless response.success?
-        if response.request_timeout?
-          fail APIError.new('Connection timed out')
-        elsif response.code == 0
-          # Errors from libcurl will be made visible here
-          fail APIError.new(:code => 0,
-                            :message => response.return_message)
+        if opts[:return_type]
+          data = deserialize(opts[:api_version], response, opts[:return_type])
         else
-          body = response.body
-          if response.headers['Content-Encoding'].eql?('gzip') && !(body.nil? || body.empty?) then
-            gzip = Zlib::Inflate.new(Zlib::MAX_WBITS + 16)
-            body = gzip.inflate(body)
-            gzip.close
-          end
-          fail APIError.new(:code => response.code,
-                            :response_headers => response.headers,
-                            :response_body => body),
-               response.message
+          data = nil
         end
+        return data, response.code, response.headers
       end
+    end
+
+    # Check if an http request should be retried
+    def should_retry(attempt, max_retries, http_code, enable_retry)
+      (http_code == 429 || http_code >= 500) && max_retries > attempt && enable_retry
+    end
 
-      if opts[:return_type]
-        data = deserialize(opts[:api_version], response, opts[:return_type])
+    # Calculate the sleep interval between 2 retry attempts
+    def calculate_retry_interval(response, backoff_base, backoff_multiplier, attempt, timeout)
+      reset_header = response.headers['X-Ratelimit-Reset']
+      if  !reset_header.nil? && !reset_header.empty?
+        sleep_time = reset_header.to_i
       else
-        data = nil
+        sleep_time = (backoff_multiplier**attempt) * backoff_base
+        if timeout && timeout > 0
+          sleep_time = [timeout, sleep_time].min
+        end
       end
-      return data, response.code, response.headers
+      sleep_time
     end
 
     # Build the HTTP request

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

@@ -138,6 +138,16 @@ module {{ module_name }}
     # Password for proxy server authentication
     attr_accessor :http_proxypass
 
+    # Enable retry when rate limited
+    attr_accessor :enable_retry
+
+    # Retry backoff calculation parameters
+    attr_accessor :backoff_base
+    attr_accessor :backoff_multiplier
+
+    # Maximum number of retry attempts allowed
+    attr_accessor :max_retries
+
     def initialize
       {%- set default_server = openapi.servers[0]|format_server %}
       @scheme = '{{ default_server.scheme }}'
@@ -149,6 +159,10 @@ module {{ module_name }}
       @server_operation_variables = {}
       @api_key = {}
       @api_key_prefix = {}
+      @enable_retry = false
+      @backoff_base = 2
+      @backoff_multiplier = 2
+      @max_retries = 3
       @timeout = nil
       @client_side_validation = true
       @verify_ssl = true
@@ -188,6 +202,13 @@ module {{ module_name }}
       @@default ||= Configuration.new
     end
 
+    def backoff_base=(value)
+      if value < 2
+        raise ArgumentError, 'backoff_base cannot be smaller than 2'
+      end
+      @backoff_base = value
+    end
+
     def configure
       yield(self) if block_given?
     end

data/.github/workflows/test_integration.yml

@@ -2,7 +2,13 @@ name: Run Integration Tests
 
 on:
   pull_request:
-    types: [opened, synchronize, reopened, ready_for_review]
+    types:
+      - opened
+      - reopened
+      - ready_for_review
+      - synchronize
+      - labeled
+      - unlabeled
     branches:
       - master
   schedule:

data/.pre-commit-config.yaml

@@ -19,7 +19,7 @@ repos:
     name: Format documentation
     stages: [manual]
     language: node
-    language_version: 14.12.0
+    language_version: 20.5.0
     entry: prettier --write --list-different --ignore-unknown README.md
     "types": [text]
     files: 'README.md'
@@ -27,11 +27,11 @@ repos:
     additional_dependencies:
       # When updating the version of prettier, make sure to check the  pre-commit file
       # And keep the `entry` here up to date https://github.com/pre-commit/mirrors-prettier/blob/master/.pre-commit-hooks.yaml
-      - prettier@2.5.1
+      - prettier@3.0.0
   - id: generator
     name: generator
     language: python
-    entry: bash -c "unset VIRTUAL_ENV && cd .generator && poetry install && poetry run python -m generator ./schemas/v1/openapi.yaml ./schemas/v2/openapi.yaml -o ../lib/"
+    entry: bash -c "cd .generator && poetry install && poetry run python -m generator ./schemas/v1/openapi.yaml ./schemas/v2/openapi.yaml -o ../lib/"
     files: "^.generator/(config|schemas/v1|src|poetry.lock|pyproject.toml)"
     stages: [manual]
     pass_filenames: false
@@ -40,7 +40,7 @@ repos:
   - id: examples
     name: examples
     language: python
-    entry: bash -c "unset VIRTUAL_ENV && cd .generator && poetry install && poetry run pytest"
+    entry: bash -c "cd .generator && poetry install && poetry run pytest"
     files: "^.generator/"
     stages: [manual]
     pass_filenames: false

data/CHANGELOG.md

@@ -1,5 +1,67 @@
 # CHANGELOG
 
+## 2.14.0 / 2023-08-23
+
+### Fixed
+* Update team schemas by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1470
+* Mark downtime v2 start response as required by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1482
+* Document new properties and fix security monitoring schemas by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1469
+* Add missing CI App fields `page` and `test_level` by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1448
+### Added
+* Update stated limit for api/v2/metrics from 14 days to 30 days by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1476
+* Add missing sensitive data scanner fields by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1466
+* Add Workflow Executions to usage metering API by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1478
+* Add missing `type` field for OnDemandConcurrencyCap response by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1468
+* Add CI Visibility Intelligent Test Runner to usage metering API by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1477
+* Add custom_links to distribution widget schema by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1485
+* Add usage field `region` by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1486
+* Add `message` field to audit logs response by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1488
+* Add `tags` field to dashboard list response by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1487
+* API specs for user team memberships by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1495
+* Document `EQUAL` comparator by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1498
+* Add persistCookies option synthetics test request by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1497
+* Expose sds_scanned_bytes_usage in usage attribution API by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1501
+* Add support in azure integration endpoint for app service plan filters/cspm/custom metrics by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1496
+* Add APM and USM usage attribution type by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1494
+* Document new attributes for team models by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1492
+* Add retry support  by @HantingZhang2 in https://github.com/DataDog/datadog-api-client-ruby/pull/1502
+
+## New Contributors
+* @HantingZhang2 made their first contribution in https://github.com/DataDog/datadog-api-client-ruby/pull/1502
+
+**Full Changelog**: https://github.com/DataDog/datadog-api-client-ruby/compare/v2.13.0...v2.14.0
+
+## 2.13.0 / 2023-07-20
+
+### Fixed
+* Set the right object creation in pagination by @therve in https://github.com/DataDog/datadog-api-client-ruby/pull/1437
+* Spans API docs update by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1442
+* Fix filter indexes parameter in logs search by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1447
+* Fix Spans endpoint schemas by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1462
+### Added
+* Add support for geomap widget using response_type `event_list` by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1427
+* Add support for the spans API endpoints by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1431
+* Add a new field additional_query_filters to formula and function slo query by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1443
+* Add support for `enable_custom_metrics` in Confluent Account by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1440
+* Add missing `id` attribute for Confluent Account Response by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1446
+* Fix downtimes v2 schema and add missing field `canceled` by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1451
+* Add cloud_cost data source and query definition to dashboards by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1452
+* Add missing cloud workload security fields by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1457
+* Add `integration_id` field for dashboard list item by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1461
+* Add events response fields `message` and `status` by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1459
+* Add missing `GetRUMApplications` response field `id` by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1458
+* Add missing service definition fields by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1460
+* Add overlay type to Dashboards WidgetDisplayType by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1463
+* Update IP ranges with remote configuration section by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1465
+* Add missing `relationships` to UsersInvitations response by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1467
+* Added optional field filters when creating a cloud configuration rule by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1471
+### Changed
+* Add downtime v2 API in private beta by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1388
+* Mark `access_role` as nullable by @api-clients-generation-pipeline in https://github.com/DataDog/datadog-api-client-ruby/pull/1449
+
+
+**Full Changelog**: https://github.com/DataDog/datadog-api-client-ruby/compare/v2.12.0...v2.13.0
+
 ## 2.12.0 / 2023-06-27
 
 ### Fixed

data/README.md

@@ -165,6 +165,29 @@ api_instance.list_incidents_with_pagination() do |incident|
 end
 ```
 
+### Retry
+
+To enable the client to retry when rate limited (status 429) or status 500 and above:
+
+```ruby
+config = DatadogAPIClient::Configuration.new
+config.enable_retry = true
+client = DatadogAPIClient::APIClient.new(config)
+```
+
+The interval between 2 retry attempts will be the value of the `x-ratelimit-reset` response header when available.
+If not, it will be :
+
+```ruby
+(config.backoffMultiplier ** current_retry_count) * config.backoffBase
+```
+
+The maximum number of retry attempts is `3` by default and can be modified with
+
+```ruby
+config.maxRetries
+```
+
 ## Documentation
 
 If you are interested in general documentation for all public Datadog API endpoints, checkout the [general documentation site][api docs].

data/examples/v1/azure-integration/CreateAzureIntegration.rb

@@ -4,9 +4,12 @@ require "datadog_api_client"
 api_instance = DatadogAPIClient::V1::AzureIntegrationAPI.new
 
 body = DatadogAPIClient::V1::AzureAccount.new({
+  app_service_plan_filters: "key:value,filter:example",
   automute: true,
   client_id: "testc7f6-1234-5678-9101-3fcbf464test",
   client_secret: "testingx./Sw*g/Y33t..R1cH+hScMDt",
+  cspm_enabled: true,
+  custom_metrics_enabled: true,
   errors: [
     "*",
   ],

data/examples/v1/azure-integration/DeleteAzureIntegration.rb

@@ -4,9 +4,12 @@ require "datadog_api_client"
 api_instance = DatadogAPIClient::V1::AzureIntegrationAPI.new
 
 body = DatadogAPIClient::V1::AzureAccount.new({
+  app_service_plan_filters: "key:value,filter:example",
   automute: true,
   client_id: "testc7f6-1234-5678-9101-3fcbf464test",
   client_secret: "testingx./Sw*g/Y33t..R1cH+hScMDt",
+  cspm_enabled: true,
+  custom_metrics_enabled: true,
   errors: [
     "*",
   ],

data/examples/v1/azure-integration/UpdateAzureHostFilters.rb

@@ -4,9 +4,12 @@ require "datadog_api_client"
 api_instance = DatadogAPIClient::V1::AzureIntegrationAPI.new
 
 body = DatadogAPIClient::V1::AzureAccount.new({
+  app_service_plan_filters: "key:value,filter:example",
   automute: true,
   client_id: "testc7f6-1234-5678-9101-3fcbf464test",
   client_secret: "testingx./Sw*g/Y33t..R1cH+hScMDt",
+  cspm_enabled: true,
+  custom_metrics_enabled: true,
   errors: [
     "*",
   ],

data/examples/v1/azure-integration/UpdateAzureIntegration.rb

@@ -4,9 +4,12 @@ require "datadog_api_client"
 api_instance = DatadogAPIClient::V1::AzureIntegrationAPI.new
 
 body = DatadogAPIClient::V1::AzureAccount.new({
+  app_service_plan_filters: "key:value,filter:example",
   automute: true,
   client_id: "testc7f6-1234-5678-9101-3fcbf464test",
   client_secret: "testingx./Sw*g/Y33t..R1cH+hScMDt",
+  cspm_enabled: true,
+  custom_metrics_enabled: true,
   errors: [
     "*",
   ],

data/examples/v1/dashboards/CreateDashboard_1284514532.rb

@@ -0,0 +1,43 @@
+# Create a new dashboard with a timeseries widget using formulas and functions cloud cost query
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::DashboardsAPI.new
+
+body = DatadogAPIClient::V1::Dashboard.new({
+  title: "Example-Dashboard",
+  widgets: [
+    DatadogAPIClient::V1::Widget.new({
+      definition: DatadogAPIClient::V1::TimeseriesWidgetDefinition.new({
+        title: "Example Cloud Cost Query",
+        title_size: "16",
+        title_align: DatadogAPIClient::V1::WidgetTextAlign::LEFT,
+        type: DatadogAPIClient::V1::TimeseriesWidgetDefinitionType::TIMESERIES,
+        requests: [
+          DatadogAPIClient::V1::TimeseriesWidgetRequest.new({
+            formulas: [
+              DatadogAPIClient::V1::WidgetFormula.new({
+                formula: "query1",
+              }),
+            ],
+            queries: [
+              DatadogAPIClient::V1::FormulaAndFunctionCloudCostQueryDefinition.new({
+                data_source: DatadogAPIClient::V1::FormulaAndFunctionCloudCostDataSource::CLOUD_COST,
+                name: "query1",
+                query: "sum:aws.cost.amortized{*} by {aws_product}.rollup(sum, monthly)",
+              }),
+            ],
+            response_format: DatadogAPIClient::V1::FormulaAndFunctionResponseFormat::TIMESERIES,
+            style: DatadogAPIClient::V1::WidgetRequestStyle.new({
+              palette: "dog_classic",
+              line_type: DatadogAPIClient::V1::WidgetLineType::SOLID,
+              line_width: DatadogAPIClient::V1::WidgetLineWidth::NORMAL,
+            }),
+            display_type: DatadogAPIClient::V1::WidgetDisplayType::BARS,
+          }),
+        ],
+      }),
+    }),
+  ],
+  layout_type: DatadogAPIClient::V1::DashboardLayoutType::ORDERED,
+})
+p api_instance.create_dashboard(body)