datadog_api_client 1.0.0.beta.3 → 1.0.0

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

@@ -326,6 +326,7 @@ module DatadogAPIClient::V1
     # Get a service level objective object.
     # @param slo_id [String] The ID of the service level objective object.
     # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :with_configured_alert_ids Get the IDs of SLO monitors that reference this SLO.
     # @return [SLOResponse]
     def get_slo(slo_id, opts = {})
       data, _status_code, _headers = get_slo_with_http_info(slo_id, opts)
@@ -336,6 +337,7 @@ module DatadogAPIClient::V1
     # Get a service level objective object.
     # @param slo_id [String] The ID of the service level objective object.
     # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :with_configured_alert_ids Get the IDs of SLO monitors that reference this SLO.
     # @return [Array<(SLOResponse, Integer, Hash)>] SLOResponse data, response status code and response headers
     def get_slo_with_http_info(slo_id, opts = {})
 
@@ -360,6 +362,7 @@ module DatadogAPIClient::V1
 
       # query parameters
       query_params = opts[:query_params] || {}
+      query_params[:'with_configured_alert_ids'] = opts[:'with_configured_alert_ids'] if !opts[:'with_configured_alert_ids'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

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

@@ -322,81 +322,6 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Create a test
-    # Create a Synthetic test.
-    # @param body [SyntheticsTestDetails] Details of the test to create.
-    # @param [Hash] opts the optional parameters
-    # @return [SyntheticsTestDetails]
-    def create_test(body, opts = {})
-      data, _status_code, _headers = create_test_with_http_info(body, opts)
-      data
-    end
-
-    # Create a test
-    # Create a Synthetic test.
-    # @param body [SyntheticsTestDetails] Details of the test to create.
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(SyntheticsTestDetails, Integer, Hash)>] SyntheticsTestDetails data, response status code and response headers
-    def create_test_with_http_info(body, opts = {})
-
-      if @api_client.config.unstable_operations.has_key?(:create_test)
-        unstable_enabled = @api_client.config.unstable_operations[:create_test]
-        if unstable_enabled
-          @api_client.config.logger.warn format("Using unstable operation '%s'", "create_test")
-        else
-          raise APIError.new(message: format("Unstable operation '%s' is disabled", "create_test"))
-        end
-      end
-
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: SyntheticsAPI.create_test ...'
-      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 SyntheticsAPI.create_test"
-      end
-      # resource path
-      local_var_path = '/api/v1/synthetics/tests'
-
-      # 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] || 'SyntheticsTestDetails'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
-
-      new_options = opts.merge(
-        :operation => :create_test,
-        :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: SyntheticsAPI#create_test\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # Delete a global variable
     # Delete a Synthetics global variable.
     # @param variable_id [String] The ID of the global variable.
@@ -772,7 +697,7 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Get the test's latest results summaries (API)
+    # Get an API test's latest results summaries
     # Get the last 50 test results summaries for a given Synthetics API test.
     # @param public_id [String] The public ID of the test for which to search results for.
     # @param [Hash] opts the optional parameters
@@ -785,7 +710,7 @@ module DatadogAPIClient::V1
       data
     end
 
-    # Get the test&#39;s latest results summaries (API)
+    # Get an API test&#39;s latest results summaries
     # Get the last 50 test results summaries for a given Synthetics API test.
     # @param public_id [String] The public ID of the test for which to search results for.
     # @param [Hash] opts the optional parameters
@@ -854,7 +779,7 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Get a test result (API)
+    # Get an API test result
     # Get a specific full result from a given (API) Synthetic test.
     # @param public_id [String] The public ID of the API test to which the target result belongs.
     # @param result_id [String] The ID of the result to get.
@@ -865,7 +790,7 @@ module DatadogAPIClient::V1
       data
     end
 
-    # Get a test result (API)
+    # Get an API test result
     # Get a specific full result from a given (API) Synthetic test.
     # @param public_id [String] The public ID of the API test to which the target result belongs.
     # @param result_id [String] The ID of the result to get.
@@ -933,7 +858,7 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Get a test configuration (browser)
+    # Get a browser test
     # Get the detailed configuration (including steps) associated with a Synthetic browser test.
     # @param public_id [String] The public ID of the test to get details from.
     # @param [Hash] opts the optional parameters
@@ -943,7 +868,7 @@ module DatadogAPIClient::V1
       data
     end
 
-    # Get a test configuration (browser)
+    # Get a browser test
     # Get the detailed configuration (including steps) associated with a Synthetic browser test.
     # @param public_id [String] The public ID of the test to get details from.
     # @param [Hash] opts the optional parameters
@@ -1006,7 +931,7 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Get the test's latest results summaries (browser)
+    # Get a browser test's latest results summaries
     # Get the last 50 test results summaries for a given Synthetics Browser test.
     # @param public_id [String] The public ID of the browser test for which to search results for.
     # @param [Hash] opts the optional parameters
@@ -1019,7 +944,7 @@ module DatadogAPIClient::V1
       data
     end
 
-    # Get the test&#39;s latest results summaries (browser)
+    # Get a browser test&#39;s latest results summaries
     # Get the last 50 test results summaries for a given Synthetics Browser test.
     # @param public_id [String] The public ID of the browser test for which to search results for.
     # @param [Hash] opts the optional parameters
@@ -1088,7 +1013,7 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Get a test result (browser)
+    # Get a browser test result
     # Get a specific full result from a given (browser) Synthetic test.
     # @param public_id [String] The public ID of the browser test to which the target result belongs.
     # @param result_id [String] The ID of the result to get.
@@ -1099,7 +1024,7 @@ module DatadogAPIClient::V1
       data
     end
 
-    # Get a test result (browser)
+    # Get a browser test result
     # Get a specific full result from a given (browser) Synthetic test.
     # @param public_id [String] The public ID of the browser test to which the target result belongs.
     # @param result_id [String] The ID of the result to get.
@@ -1313,7 +1238,7 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Get a test configuration (API)
+    # Get a test configuration
     # Get the detailed configuration associated with a Synthetics test.
     # @param public_id [String] The public ID of the test to get details from.
     # @param [Hash] opts the optional parameters
@@ -1323,7 +1248,7 @@ module DatadogAPIClient::V1
       data
     end
 
-    # Get a test configuration (API)
+    # Get a test configuration
     # Get the detailed configuration associated with a Synthetics test.
     # @param public_id [String] The public ID of the test to get details from.
     # @param [Hash] opts the optional parameters
@@ -1520,7 +1445,7 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Trigger some Synthetics tests for CI
+    # Trigger tests from CI/CD pipelines
     # Trigger a set of Synthetics tests for continuous integration.
     # @param body [SyntheticsCITestBody] Details of the test to trigger.
     # @param [Hash] opts the optional parameters
@@ -1530,7 +1455,7 @@ module DatadogAPIClient::V1
       data
     end
 
-    # Trigger some Synthetics tests for CI
+    # Trigger tests from CI/CD pipelines
     # Trigger a set of Synthetics tests for continuous integration.
     # @param body [SyntheticsCITestBody] Details of the test to trigger.
     # @param [Hash] opts the optional parameters
@@ -1838,87 +1763,6 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
-    # Edit a test
-    # Edit the configuration of a Synthetic test.
-    # @param public_id [String] The public ID of the test to get details from.
-    # @param body [SyntheticsTestDetails] New test details to be saved.
-    # @param [Hash] opts the optional parameters
-    # @return [SyntheticsTestDetails]
-    def update_test(public_id, body, opts = {})
-      data, _status_code, _headers = update_test_with_http_info(public_id, body, opts)
-      data
-    end
-
-    # Edit a test
-    # Edit the configuration of a Synthetic test.
-    # @param public_id [String] The public ID of the test to get details from.
-    # @param body [SyntheticsTestDetails] New test details to be saved.
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(SyntheticsTestDetails, Integer, Hash)>] SyntheticsTestDetails data, response status code and response headers
-    def update_test_with_http_info(public_id, body, opts = {})
-
-      if @api_client.config.unstable_operations.has_key?(:update_test)
-        unstable_enabled = @api_client.config.unstable_operations[:update_test]
-        if unstable_enabled
-          @api_client.config.logger.warn format("Using unstable operation '%s'", "update_test")
-        else
-          raise APIError.new(message: format("Unstable operation '%s' is disabled", "update_test"))
-        end
-      end
-
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: SyntheticsAPI.update_test ...'
-      end
-      # verify the required parameter 'public_id' is set
-      if @api_client.config.client_side_validation && public_id.nil?
-        fail ArgumentError, "Missing the required parameter 'public_id' when calling SyntheticsAPI.update_test"
-      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 SyntheticsAPI.update_test"
-      end
-      # resource path
-      local_var_path = '/api/v1/synthetics/tests/{public_id}'.sub('{' + 'public_id' + '}', CGI.escape(public_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] || 'SyntheticsTestDetails'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
-
-      new_options = opts.merge(
-        :operation => :update_test,
-        :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: SyntheticsAPI#update_test\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # Pause or start a test
     # Pause or start a Synthetics test by changing the status.
     # @param public_id [String] The public ID of the Synthetic test to update.

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

@@ -637,7 +637,7 @@ module DatadogAPIClient::V1
     # Get Usage Attribution
     # Get Usage Attribution.
     # @param start_month [Time] Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage beginning in this month. Maximum of 15 months ago.
-    # @param fields [String] The specified field to search results for.
+    # @param fields [UsageAttributionSupportedMetrics] Comma-separated list of usage types to return, or `*` for all usage types.
     # @param [Hash] opts the optional parameters
     # @option opts [Time] :end_month Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage ending this month.
     # @option opts [UsageSortDirection] :sort_direction The direction to sort by: `[desc, asc]`. (default to 'desc')
@@ -651,7 +651,7 @@ module DatadogAPIClient::V1
     # Get Usage Attribution
     # Get Usage Attribution.
     # @param start_month [Time] Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage beginning in this month. Maximum of 15 months ago.
-    # @param fields [String] The specified field to search results for.
+    # @param fields [UsageAttributionSupportedMetrics] Comma-separated list of usage types to return, or `*` for all usage types.
     # @param [Hash] opts the optional parameters
     # @option opts [Time] :end_month Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage ending this month.
     # @option opts [UsageSortDirection] :sort_direction The direction to sort by: `[desc, asc]`.
@@ -1413,6 +1413,83 @@ module DatadogAPIClient::V1
       return data, status_code, headers
     end
 
+    # Get hourly logs usage by retention
+    # Get hourly usage for indexed logs by retention period.
+    # @param start_hr [Time] Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage beginning at this hour.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Time] :end_hr Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage ending **before** this hour.
+    # @return [UsageLogsByRetentionResponse]
+    def get_usage_logs_by_retention(start_hr, opts = {})
+      data, _status_code, _headers = get_usage_logs_by_retention_with_http_info(start_hr, opts)
+      data
+    end
+
+    # Get hourly logs usage by retention
+    # Get hourly usage for indexed logs by retention period.
+    # @param start_hr [Time] Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage beginning at this hour.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Time] :end_hr Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage ending **before** this hour.
+    # @return [Array<(UsageLogsByRetentionResponse, Integer, Hash)>] UsageLogsByRetentionResponse data, response status code and response headers
+    def get_usage_logs_by_retention_with_http_info(start_hr, opts = {})
+
+      if @api_client.config.unstable_operations.has_key?(:get_usage_logs_by_retention)
+        unstable_enabled = @api_client.config.unstable_operations[:get_usage_logs_by_retention]
+        if unstable_enabled
+          @api_client.config.logger.warn format("Using unstable operation '%s'", "get_usage_logs_by_retention")
+        else
+          raise APIError.new(message: format("Unstable operation '%s' is disabled", "get_usage_logs_by_retention"))
+        end
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: UsageMeteringAPI.get_usage_logs_by_retention ...'
+      end
+      # verify the required parameter 'start_hr' is set
+      if @api_client.config.client_side_validation && start_hr.nil?
+        fail ArgumentError, "Missing the required parameter 'start_hr' when calling UsageMeteringAPI.get_usage_logs_by_retention"
+      end
+      # resource path
+      local_var_path = '/api/v1/usage/logs-by-retention'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'start_hr'] = start_hr
+      query_params[:'end_hr'] = opts[:'end_hr'] if !opts[:'end_hr'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json;datetime-format=rfc3339'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UsageLogsByRetentionResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_usage_logs_by_retention,
+        :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: UsageMeteringAPI#get_usage_logs_by_retention\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get hourly usage for Network Flows
     # Get hourly usage for network flows.
     # @param start_hr [Time] Datetime in ISO-8601 format, UTC, precise to hour: &#x60;[YYYY-MM-DDThh]&#x60; for usage beginning at this hour.

data/lib/datadog_api_client/v1/models/distribution_widget_definition.rb

@@ -19,13 +19,16 @@ require 'time'
 module DatadogAPIClient::V1
   # The Distribution visualization is another way of showing metrics aggregated across one or several tags, such as hosts. Unlike the heat map, a distribution graph’s x-axis is quantity rather than time.
   class DistributionWidgetDefinition
-    # Available legend sizes for a widget. Should be one of \"0\", \"2\", \"4\", \"8\", \"16\", or \"auto\".
+    # (Deprecated) The widget legend was replaced by a tooltip and sidebar.
     attr_accessor :legend_size
 
+    # List of markers.
+    attr_accessor :markers
+
     # Array of one request object to display in the widget.  See the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json)  to learn how to build the `REQUEST_SCHEMA`.
     attr_accessor :requests
 
-    # Whether or not to display the legend on this widget.
+    # (Deprecated) The widget legend was replaced by a tooltip and sidebar.
     attr_accessor :show_legend
 
     attr_accessor :time
@@ -40,17 +43,24 @@ module DatadogAPIClient::V1
 
     attr_accessor :type
 
+    attr_accessor :xaxis
+
+    attr_accessor :yaxis
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'legend_size' => :'legend_size',
+        :'markers' => :'markers',
         :'requests' => :'requests',
         :'show_legend' => :'show_legend',
         :'time' => :'time',
         :'title' => :'title',
         :'title_align' => :'title_align',
         :'title_size' => :'title_size',
-        :'type' => :'type'
+        :'type' => :'type',
+        :'xaxis' => :'xaxis',
+        :'yaxis' => :'yaxis'
       }
     end
 
@@ -63,13 +73,16 @@ module DatadogAPIClient::V1
     def self.openapi_types
       {
         :'legend_size' => :'String',
+        :'markers' => :'Array<WidgetMarker>',
         :'requests' => :'Array<DistributionWidgetRequest>',
         :'show_legend' => :'Boolean',
         :'time' => :'WidgetTime',
         :'title' => :'String',
         :'title_align' => :'WidgetTextAlign',
         :'title_size' => :'String',
-        :'type' => :'DistributionWidgetDefinitionType'
+        :'type' => :'DistributionWidgetDefinitionType',
+        :'xaxis' => :'DistributionWidgetXAxis',
+        :'yaxis' => :'DistributionWidgetYAxis'
       }
     end
 
@@ -98,6 +111,12 @@ module DatadogAPIClient::V1
         self.legend_size = attributes[:'legend_size']
       end
 
+      if attributes.key?(:'markers')
+        if (value = attributes[:'markers']).is_a?(Array)
+          self.markers = value
+        end
+      end
+
       if attributes.key?(:'requests')
         if (value = attributes[:'requests']).is_a?(Array)
           self.requests = value
@@ -129,6 +148,14 @@ module DatadogAPIClient::V1
       else
         self.type = 'distribution'
       end
+
+      if attributes.key?(:'xaxis')
+        self.xaxis = attributes[:'xaxis']
+      end
+
+      if attributes.key?(:'yaxis')
+        self.yaxis = attributes[:'yaxis']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -188,13 +215,16 @@ module DatadogAPIClient::V1
       return true if self.equal?(o)
       self.class == o.class &&
           legend_size == o.legend_size &&
+          markers == o.markers &&
           requests == o.requests &&
           show_legend == o.show_legend &&
           time == o.time &&
           title == o.title &&
           title_align == o.title_align &&
           title_size == o.title_size &&
-          type == o.type
+          type == o.type &&
+          xaxis == o.xaxis &&
+          yaxis == o.yaxis
     end
 
     # @see the `==` method
@@ -206,7 +236,7 @@ module DatadogAPIClient::V1
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [legend_size, requests, show_legend, time, title, title_align, title_size, type].hash
+      [legend_size, markers, requests, show_legend, time, title, title_align, title_size, type, xaxis, yaxis].hash
     end
 
     # Builds the object from hash