datadog_api_client 2.34.0 → 2.35.0

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

@@ -101,7 +101,7 @@ module DatadogAPIClient::V1
     # new `cluster` violating the alert conditions by setting `notify_by` to `["cluster"]`. Tags mentioned
     # in `notify_by` must be a subset of the grouping tags in the query.
     # For example, a query grouped by `cluster` and `namespace` cannot notify on `region`.
-    # Setting `notify_by` to `[*]` configures the monitor to notify as a simple-alert.
+    # Setting `notify_by` to `["*"]` configures the monitor to notify as a simple-alert.
     attr_accessor :notify_by
 
     # A Boolean indicating whether this monitor notifies when data stops reporting. Defaults to `false`.

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

@@ -30,6 +30,15 @@ module DatadogAPIClient::V1
     # Whether or not the monitor is deleted. (Always `null`)
     attr_accessor :deleted
 
+    # Indicates whether the monitor is in a draft or published state.
+    #
+    # `draft`: The monitor appears as Draft and does not send notifications.
+    # `published`: The monitor is active and evaluates conditions and notify as configured.
+    #
+    # This field is in preview. The draft value is only available to customers with the feature enabled.
+    #
+    attr_accessor :draft_status
+
     # ID of this monitor.
     attr_accessor :id
 
@@ -78,6 +87,7 @@ module DatadogAPIClient::V1
         :'created' => :'created',
         :'creator' => :'creator',
         :'deleted' => :'deleted',
+        :'draft_status' => :'draft_status',
         :'id' => :'id',
         :'message' => :'message',
         :'modified' => :'modified',
@@ -101,6 +111,7 @@ module DatadogAPIClient::V1
         :'created' => :'Time',
         :'creator' => :'Creator',
         :'deleted' => :'Time',
+        :'draft_status' => :'MonitorDraftStatus',
         :'id' => :'Integer',
         :'message' => :'String',
         :'modified' => :'Time',
@@ -157,6 +168,10 @@ module DatadogAPIClient::V1
         self.deleted = attributes[:'deleted']
       end
 
+      if attributes.key?(:'draft_status')
+        self.draft_status = attributes[:'draft_status']
+      end
+
       if attributes.key?(:'id')
         self.id = attributes[:'id']
       end
@@ -243,6 +258,7 @@ module DatadogAPIClient::V1
           created == o.created &&
           creator == o.creator &&
           deleted == o.deleted &&
+          draft_status == o.draft_status &&
           id == o.id &&
           message == o.message &&
           modified == o.modified &&
@@ -263,7 +279,7 @@ module DatadogAPIClient::V1
     # @return [Integer] Hash code
     # @!visibility private
     def hash
-      [created, creator, deleted, id, message, modified, multi, name, options, overall_state, priority, query, restricted_roles, state, tags, type, additional_properties].hash
+      [created, creator, deleted, draft_status, id, message, modified, multi, name, options, overall_state, priority, query, restricted_roles, state, tags, type, additional_properties].hash
     end
   end
 end

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

@@ -23,5 +23,11 @@ module DatadogAPIClient::V1
 
     HTTP = "http".freeze
     GRPC = "grpc".freeze
+    SSL = "ssl".freeze
+    DNS = "dns".freeze
+    TCP = "tcp".freeze
+    UDP = "udp".freeze
+    ICMP = "icmp".freeze
+    WEBSOCKET = "websocket".freeze
   end
 end

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

@@ -42,6 +42,9 @@ module DatadogAPIClient::V1
     # By default, the client certificate is applied on the domain of the starting URL for browser tests. If you want your client certificate to be applied on other domains instead, add them in `certificateDomains`.
     attr_accessor :certificate_domains
 
+    # Check for certificate revocation.
+    attr_accessor :check_certificate_revocation
+
     # A protobuf JSON descriptor that needs to be gzipped first then base64 encoded.
     attr_accessor :compressed_json_descriptor
 
@@ -54,12 +57,15 @@ module DatadogAPIClient::V1
     # DNS server port to use for DNS tests.
     attr_accessor :dns_server_port
 
-    # Files to be used as part of the request in the test.
+    # Files to be used as part of the request in the test. Only valid if `bodyType` is `multipart/form-data`.
     attr_accessor :files
 
     # Specifies whether or not the request follows redirects.
     attr_accessor :follow_redirects
 
+    # Form to be used as part of the request in the test. Only valid if `bodyType` is `multipart/form-data`.
+    attr_accessor :form
+
     # Headers to include when performing the test.
     attr_accessor :headers
 
@@ -69,6 +75,9 @@ module DatadogAPIClient::V1
     # HTTP version to use for a Synthetic test.
     attr_accessor :http_version
 
+    # Whether the message is base64 encoded.
+    attr_accessor :is_message_base64_encoded
+
     # Message to send for UDP or WebSocket tests.
     attr_accessor :message
 
@@ -126,15 +135,18 @@ module DatadogAPIClient::V1
         :'call_type' => :'callType',
         :'certificate' => :'certificate',
         :'certificate_domains' => :'certificateDomains',
+        :'check_certificate_revocation' => :'checkCertificateRevocation',
         :'compressed_json_descriptor' => :'compressedJsonDescriptor',
         :'compressed_proto_file' => :'compressedProtoFile',
         :'dns_server' => :'dnsServer',
         :'dns_server_port' => :'dnsServerPort',
         :'files' => :'files',
         :'follow_redirects' => :'follow_redirects',
+        :'form' => :'form',
         :'headers' => :'headers',
         :'host' => :'host',
         :'http_version' => :'httpVersion',
+        :'is_message_base64_encoded' => :'isMessageBase64Encoded',
         :'message' => :'message',
         :'metadata' => :'metadata',
         :'method' => :'method',
@@ -163,15 +175,18 @@ module DatadogAPIClient::V1
         :'call_type' => :'SyntheticsTestCallType',
         :'certificate' => :'SyntheticsTestRequestCertificate',
         :'certificate_domains' => :'Array<String>',
+        :'check_certificate_revocation' => :'Boolean',
         :'compressed_json_descriptor' => :'String',
         :'compressed_proto_file' => :'String',
         :'dns_server' => :'String',
         :'dns_server_port' => :'String',
         :'files' => :'Array<SyntheticsTestRequestBodyFile>',
         :'follow_redirects' => :'Boolean',
+        :'form' => :'Hash<String, String>',
         :'headers' => :'Hash<String, String>',
         :'host' => :'String',
         :'http_version' => :'SyntheticsTestOptionsHTTPVersion',
+        :'is_message_base64_encoded' => :'Boolean',
         :'message' => :'String',
         :'metadata' => :'Hash<String, String>',
         :'method' => :'String',
@@ -237,6 +252,10 @@ module DatadogAPIClient::V1
         end
       end
 
+      if attributes.key?(:'check_certificate_revocation')
+        self.check_certificate_revocation = attributes[:'check_certificate_revocation']
+      end
+
       if attributes.key?(:'compressed_json_descriptor')
         self.compressed_json_descriptor = attributes[:'compressed_json_descriptor']
       end
@@ -263,6 +282,10 @@ module DatadogAPIClient::V1
         self.follow_redirects = attributes[:'follow_redirects']
       end
 
+      if attributes.key?(:'form')
+        self.form = attributes[:'form']
+      end
+
       if attributes.key?(:'headers')
         self.headers = attributes[:'headers']
       end
@@ -275,6 +298,10 @@ module DatadogAPIClient::V1
         self.http_version = attributes[:'http_version']
       end
 
+      if attributes.key?(:'is_message_base64_encoded')
+        self.is_message_base64_encoded = attributes[:'is_message_base64_encoded']
+      end
+
       if attributes.key?(:'message')
         self.message = attributes[:'message']
       end
@@ -387,15 +414,18 @@ module DatadogAPIClient::V1
           call_type == o.call_type &&
           certificate == o.certificate &&
           certificate_domains == o.certificate_domains &&
+          check_certificate_revocation == o.check_certificate_revocation &&
           compressed_json_descriptor == o.compressed_json_descriptor &&
           compressed_proto_file == o.compressed_proto_file &&
           dns_server == o.dns_server &&
           dns_server_port == o.dns_server_port &&
           files == o.files &&
           follow_redirects == o.follow_redirects &&
+          form == o.form &&
           headers == o.headers &&
           host == o.host &&
           http_version == o.http_version &&
+          is_message_base64_encoded == o.is_message_base64_encoded &&
           message == o.message &&
           metadata == o.metadata &&
           method == o.method &&
@@ -417,7 +447,7 @@ module DatadogAPIClient::V1
     # @return [Integer] Hash code
     # @!visibility private
     def hash
-      [allow_insecure, basic_auth, body, body_type, call_type, certificate, certificate_domains, compressed_json_descriptor, compressed_proto_file, dns_server, dns_server_port, files, follow_redirects, headers, host, http_version, message, metadata, method, no_saving_response_body, number_of_packets, persist_cookies, port, proxy, query, servername, service, should_track_hops, timeout, url, additional_properties].hash
+      [allow_insecure, basic_auth, body, body_type, call_type, certificate, certificate_domains, check_certificate_revocation, compressed_json_descriptor, compressed_proto_file, dns_server, dns_server_port, files, follow_redirects, form, headers, host, http_version, is_message_base64_encoded, message, metadata, method, no_saving_response_body, number_of_packets, persist_cookies, port, proxy, query, servername, service, should_track_hops, timeout, url, additional_properties].hash
     end
   end
 end

data/lib/datadog_api_client/v2/api/dora_metrics_api.rb

@@ -44,12 +44,6 @@ module DatadogAPIClient::V2
     # @param opts [Hash] the optional parameters
     # @return [Array<(DORADeploymentResponse, Integer, Hash)>] DORADeploymentResponse data, response status code and response headers
     def create_dora_deployment_with_http_info(body, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.create_dora_deployment".to_sym]
-      if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_dora_deployment")
-      else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_dora_deployment"))
-      end
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: DORAMetricsAPI.create_dora_deployment ...'
@@ -101,6 +95,77 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Send a failure event for DORA Metrics.
+    #
+    # @see #create_dora_failure_with_http_info
+    def create_dora_failure(body, opts = {})
+      data, _status_code, _headers = create_dora_failure_with_http_info(body, opts)
+      data
+    end
+
+    # Send a failure event for DORA Metrics.
+    #
+    # Use this API endpoint to provide failure data for DORA metrics.
+    #
+    # This is necessary for:
+    # - Change Failure Rate
+    # - Time to Restore
+    #
+    # @param body [DORAFailureRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(DORAFailureResponse, Integer, Hash)>] DORAFailureResponse data, response status code and response headers
+    def create_dora_failure_with_http_info(body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DORAMetricsAPI.create_dora_failure ...'
+      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 DORAMetricsAPI.create_dora_failure"
+      end
+      # resource path
+      local_var_path = '/api/v2/dora/failure'
+
+      # 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] || 'DORAFailureResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :create_dora_failure,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DORAMetricsAPI#create_dora_failure\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Send an incident event for DORA Metrics.
     #
     # @see #create_dora_incident_with_http_info
@@ -111,22 +176,21 @@ module DatadogAPIClient::V2
 
     # Send an incident event for DORA Metrics.
     #
+    # **Note**: This endpoint is deprecated. Please use `/api/v2/dora/failure` instead.
+    #
     # Use this API endpoint to provide failure data for DORA metrics.
     #
     # This is necessary for:
     # - Change Failure Rate
     # - Time to Restore
     #
-    # @param body [DORAIncidentRequest] 
+    # @deprecated This API is deprecated.
+    #
+    # @param body [DORAFailureRequest] 
     # @param opts [Hash] the optional parameters
-    # @return [Array<(DORAIncidentResponse, Integer, Hash)>] DORAIncidentResponse data, response status code and response headers
+    # @return [Array<(DORAFailureResponse, Integer, Hash)>] DORAFailureResponse data, response status code and response headers
     def create_dora_incident_with_http_info(body, opts = {})
-      unstable_enabled = @api_client.config.unstable_operations["v2.create_dora_incident".to_sym]
-      if unstable_enabled
-        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_dora_incident")
-      else
-        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_dora_incident"))
-      end
+      warn "[DEPRECATION] `CreateDORAIncident` is deprecated."
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: DORAMetricsAPI.create_dora_incident ...'
@@ -155,7 +219,7 @@ module DatadogAPIClient::V2
       post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'DORAIncidentResponse'
+      return_type = opts[:debug_return_type] || 'DORAFailureResponse'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || [:apiKeyAuth]

data/lib/datadog_api_client/v2/api/on_call_api.rb

@@ -561,6 +561,73 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Get team on-call users.
+    #
+    # @see #get_team_on_call_users_with_http_info
+    def get_team_on_call_users(team_id, opts = {})
+      data, _status_code, _headers = get_team_on_call_users_with_http_info(team_id, opts)
+      data
+    end
+
+    # Get team on-call users.
+    #
+    # Get a team's on-call users at a given time
+    #
+    # @param team_id [String] The team ID
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :include Comma-separated list of included relationships to be returned. Allowed values: `responders`, `escalations`, `escalations.responders`.
+    # @return [Array<(TeamOnCallResponders, Integer, Hash)>] TeamOnCallResponders data, response status code and response headers
+    def get_team_on_call_users_with_http_info(team_id, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: OnCallAPI.get_team_on_call_users ...'
+      end
+      # verify the required parameter 'team_id' is set
+      if @api_client.config.client_side_validation && team_id.nil?
+        fail ArgumentError, "Missing the required parameter 'team_id' when calling OnCallAPI.get_team_on_call_users"
+      end
+      # resource path
+      local_var_path = '/api/v2/on-call/teams/{team_id}/on-call'.sub('{team_id}', CGI.escape(team_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'include'] = opts[:'include'] if !opts[:'include'].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] || 'TeamOnCallResponders'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_team_on_call_users,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: OnCallAPI#get_team_on_call_users\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Set On-Call team routing rules.
     #
     # @see #set_on_call_team_routing_rules_with_http_info

data/lib/datadog_api_client/v2/api/restriction_policies_api.rb

@@ -35,7 +35,7 @@ module DatadogAPIClient::V2
     #
     # Deletes the restriction policy associated with a specified resource.
     #
-    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `integration-account`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`.
+    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `integration-account`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`.
     # @param opts [Hash] the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def delete_restriction_policy_with_http_info(resource_id, opts = {})
@@ -100,7 +100,7 @@ module DatadogAPIClient::V2
     #
     # Retrieves the restriction policy associated with a specified resource.
     #
-    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `integration-account`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`.
+    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `integration-account`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`.
     # @param opts [Hash] the optional parameters
     # @return [Array<(RestrictionPolicyResponse, Integer, Hash)>] RestrictionPolicyResponse data, response status code and response headers
     def get_restriction_policy_with_http_info(resource_id, opts = {})
@@ -184,6 +184,7 @@ module DatadogAPIClient::V2
     # - App Builder Apps: `app-builder-app`
     # - Connections: `connection`
     # - Connection Groups: `connection-group`
+    # - RUM Applications: `rum-application`
     #
     # #### Supported relations for resources
     # Resource Type               | Supported Relations
@@ -205,8 +206,9 @@ module DatadogAPIClient::V2
     # App Builder Apps            | `viewer`, `editor`
     # Connections                 | `viewer`, `resolver`, `editor`
     # Connection Groups           | `viewer`, `editor`
+    # RUM Application             | `viewer`, `editor`
     #
-    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `integration-account`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`.
+    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `integration-account`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`.
     # @param body [RestrictionPolicyUpdateRequest] Restriction policy payload
     # @param opts [Hash] the optional parameters
     # @option opts [Boolean] :allow_self_lockout Allows admins (users with the `user_access_manage` permission) to remove their own access from the resource if set to `true`. By default, this is set to `false`, preventing admins from locking themselves out.

data/lib/datadog_api_client/v2/api/security_monitoring_api.rb

@@ -2376,6 +2376,17 @@ module DatadogAPIClient::V2
     #
     # Query parameters must be only among the documented ones and with values of correct types. Duplicated query parameters (e.g. `filter[status]=low&filter[status]=info`) are not allowed.
     #
+    # ### Additional extension fields
+    #
+    # Additional extension fields are available for some findings.
+    #
+    # The data is available when you include the query parameter `?detailed_findings=true` in the request.
+    #
+    # The following fields are available for findings:
+    # - `external_id`: The resource external ID related to the finding.
+    # - `description`: The description and remediation steps for the finding.
+    # - `datadog_link`: The Datadog relative link for the finding.
+    #
     # ### Response
     #
     # The response includes an array of finding objects, pagination metadata, and a count of items that match the query.
@@ -2402,6 +2413,7 @@ module DatadogAPIClient::V2
     # @option opts [FindingEvaluation] :filter_evaluation Return only `pass` or `fail` findings.
     # @option opts [FindingStatus] :filter_status Return only findings with the specified status.
     # @option opts [Array<FindingVulnerabilityType>] :filter_vulnerability_type Return findings that match the selected vulnerability types (repeatable).
+    # @option opts [Boolean] :detailed_findings Return additional fields for some findings.
     # @return [Array<(ListFindingsResponse, Integer, Hash)>] ListFindingsResponse data, response status code and response headers
     def list_findings_with_http_info(opts = {})
       unstable_enabled = @api_client.config.unstable_operations["v2.list_findings".to_sym]
@@ -2449,6 +2461,7 @@ module DatadogAPIClient::V2
       query_params[:'filter[evaluation]'] = opts[:'filter_evaluation'] if !opts[:'filter_evaluation'].nil?
       query_params[:'filter[status]'] = opts[:'filter_status'] if !opts[:'filter_status'].nil?
       query_params[:'filter[vulnerability_type]'] = @api_client.build_collection_param(opts[:'filter_vulnerability_type'], :multi) if !opts[:'filter_vulnerability_type'].nil?
+      query_params[:'detailed_findings'] = opts[:'detailed_findings'] if !opts[:'detailed_findings'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}