datadog_api_client 2.44.0 → 2.46.0

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

@@ -33,7 +33,7 @@ module DatadogAPIClient::V1
 
     # Create an AWS integration.
     #
-    # Create a Datadog-Amazon Web Services integration.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** Create a Datadog-Amazon Web Services integration.
     # Using the `POST` method updates your integration configuration
     # by adding your new configuration to the existing one in your Datadog organization.
     # A unique AWS Account ID for role based authentication.
@@ -106,12 +106,15 @@ module DatadogAPIClient::V1
 
     # Create an Amazon EventBridge source.
     #
-    # Create an Amazon EventBridge source.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** Create an Amazon EventBridge source.
+    #
+    # @deprecated This API is deprecated.
     #
     # @param body [AWSEventBridgeCreateRequest] Create an Amazon EventBridge source for an AWS account with a given name and region.
     # @param opts [Hash] the optional parameters
     # @return [Array<(AWSEventBridgeCreateResponse, Integer, Hash)>] AWSEventBridgeCreateResponse data, response status code and response headers
     def create_aws_event_bridge_source_with_http_info(body, opts = {})
+      warn "[DEPRECATION] `CreateAWSEventBridgeSource` is deprecated."
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AWSIntegrationAPI.create_aws_event_bridge_source ...'
@@ -243,7 +246,7 @@ module DatadogAPIClient::V1
 
     # Generate a new external ID.
     #
-    # Generate a new AWS external ID for a given AWS account ID and role name pair.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** Generate a new AWS external ID for a given AWS account ID and role name pair.
     #
     # @deprecated This API is deprecated.
     #
@@ -313,7 +316,7 @@ module DatadogAPIClient::V1
 
     # Delete an AWS integration.
     #
-    # Delete a Datadog-AWS integration matching the specified `account_id` and `role_name parameters`.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** Delete a Datadog-AWS integration matching the specified `account_id` and `role_name parameters`.
     #
     # @deprecated This API is deprecated.
     #
@@ -383,12 +386,15 @@ module DatadogAPIClient::V1
 
     # Delete an Amazon EventBridge source.
     #
-    # Delete an Amazon EventBridge source.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** Delete an Amazon EventBridge source.
+    #
+    # @deprecated This API is deprecated.
     #
     # @param body [AWSEventBridgeDeleteRequest] Delete the Amazon EventBridge source with the given name, region, and associated AWS account.
     # @param opts [Hash] the optional parameters
     # @return [Array<(AWSEventBridgeDeleteResponse, Integer, Hash)>] AWSEventBridgeDeleteResponse data, response status code and response headers
     def delete_aws_event_bridge_source_with_http_info(body, opts = {})
+      warn "[DEPRECATION] `DeleteAWSEventBridgeSource` is deprecated."
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AWSIntegrationAPI.delete_aws_event_bridge_source ...'
@@ -520,7 +526,7 @@ module DatadogAPIClient::V1
 
     # List namespace rules.
     #
-    # List all namespace rules for a given Datadog-AWS integration. This endpoint takes no arguments.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** List all namespace rules for a given Datadog-AWS integration. This endpoint takes no arguments.
     #
     # @deprecated This API is deprecated.
     #
@@ -583,7 +589,7 @@ module DatadogAPIClient::V1
 
     # List all AWS integrations.
     #
-    # List all Datadog-AWS integrations available in your Datadog organization.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** List all Datadog-AWS integrations available in your Datadog organization.
     #
     # @deprecated This API is deprecated.
     #
@@ -652,11 +658,14 @@ module DatadogAPIClient::V1
 
     # Get all Amazon EventBridge sources.
     #
-    # Get all Amazon EventBridge sources.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** Get all Amazon EventBridge sources.
+    #
+    # @deprecated This API is deprecated.
     #
     # @param opts [Hash] the optional parameters
     # @return [Array<(AWSEventBridgeListResponse, Integer, Hash)>] AWSEventBridgeListResponse data, response status code and response headers
     def list_aws_event_bridge_sources_with_http_info(opts = {})
+      warn "[DEPRECATION] `ListAWSEventBridgeSources` is deprecated."
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AWSIntegrationAPI.list_aws_event_bridge_sources ...'
@@ -781,7 +790,7 @@ module DatadogAPIClient::V1
 
     # Update an AWS integration.
     #
-    # Update a Datadog-Amazon Web Services integration.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** Update a Datadog-Amazon Web Services integration.
     #
     # @deprecated This API is deprecated.
     #

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

@@ -450,7 +450,7 @@ module DatadogAPIClient::V1
 
     # Get list of AWS log ready services.
     #
-    # Get the list of current AWS services that Datadog offers automatic log collection. Use returned service IDs with the services parameter for the Enable an AWS service log collection API endpoint.
+    # **This endpoint is deprecated - use the V2 endpoint instead.** Get the list of current AWS services that Datadog offers automatic log collection. Use returned service IDs with the services parameter for the Enable an AWS service log collection API endpoint.
     #
     # @deprecated This API is deprecated.
     #

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

@@ -101,6 +101,7 @@ module DatadogAPIClient::V1
     # Create an application key.
     #
     # Create an application key with a given name.
+    # This endpoint is disabled for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).
     #
     # @param body [ApplicationKey] 
     # @param opts [Hash] the optional parameters
@@ -233,6 +234,7 @@ module DatadogAPIClient::V1
     # Delete an application key.
     #
     # Delete a given application key.
+    # This endpoint is disabled for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).
     #
     # @param key [String] The specific APP key you are working with.
     # @param opts [Hash] the optional parameters
@@ -363,6 +365,7 @@ module DatadogAPIClient::V1
     # Get an application key.
     #
     # Get a given application key.
+    # This endpoint is disabled for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).
     #
     # @param key [String] The specific APP key you are working with.
     # @param opts [Hash] the optional parameters
@@ -488,6 +491,7 @@ module DatadogAPIClient::V1
     # Get all application keys.
     #
     # Get all application keys available for your Datadog account.
+    # This endpoint is disabled for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).
     #
     # @param opts [Hash] the optional parameters
     # @return [Array<(ApplicationKeyListResponse, Integer, Hash)>] ApplicationKeyListResponse data, response status code and response headers
@@ -620,6 +624,7 @@ module DatadogAPIClient::V1
     # Edit an application key.
     #
     # Edit an application key name.
+    # This endpoint is disabled for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).
     #
     # @param key [String] The specific APP key you are working with.
     # @param body [ApplicationKey] 

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

@@ -168,12 +168,17 @@ module DatadogAPIClient::V1
 
     # Search metrics.
     #
+    # **Note**: This endpoint is deprecated. Use `/api/v2/metrics` instead.
+    #
     # Search for metrics from the last 24 hours in Datadog.
     #
+    # @deprecated This API is deprecated.
+    #
     # @param q [String] Query string to search metrics upon. Can optionally be prefixed with `metrics:`.
     # @param opts [Hash] the optional parameters
     # @return [Array<(MetricSearchResponse, Integer, Hash)>] MetricSearchResponse data, response status code and response headers
     def list_metrics_with_http_info(q, opts = {})
+      warn "[DEPRECATION] `ListMetrics` is deprecated."
 
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: MetricsAPI.list_metrics ...'

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

@@ -456,6 +456,7 @@ module DatadogAPIClient::V1
     # @param opts [Hash] the optional parameters
     # @option opts [String] :group_states When specified, shows additional information about the group states. Choose one or more from `all`, `alert`, `warn`, and `no data`.
     # @option opts [Boolean] :with_downtimes If this argument is set to true, then the returned data includes all current active downtimes for the monitor.
+    # @option opts [Boolean] :with_assets If this argument is set to `true`, the returned data includes all assets tied to this monitor.
     # @return [Array<(Monitor, Integer, Hash)>] Monitor data, response status code and response headers
     def get_monitor_with_http_info(monitor_id, opts = {})
 
@@ -473,6 +474,7 @@ module DatadogAPIClient::V1
       query_params = opts[:query_params] || {}
       query_params[:'group_states'] = opts[:'group_states'] if !opts[:'group_states'].nil?
       query_params[:'with_downtimes'] = opts[:'with_downtimes'] if !opts[:'with_downtimes'].nil?
+      query_params[:'with_assets'] = opts[:'with_assets'] if !opts[:'with_assets'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

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

@@ -27,9 +27,11 @@ module DatadogAPIClient::V1
     # Your AWS Account ID without dashes.
     attr_accessor :account_id
 
-    # An object, (in the form `{"namespace1":true/false, "namespace2":true/false}`),
-    # that enables or disables metric collection for specific AWS namespaces for this
-    # AWS account only.
+    # An object (in the form `{"namespace1":true/false, "namespace2":true/false}`) containing user-supplied overrides
+    # for AWS namespace metric collection. **Important**: This field only contains namespaces explicitly configured through API calls,
+    # not the comprehensive enabled or disabled status of all namespaces. If a namespace is absent from this field, it uses Datadog's
+    # internal defaults (all namespaces enabled by default, except `AWS/SQS`, `AWS/ElasticMapReduce`, and `AWS/Usage`).
+    # For a complete view of all namespace statuses, use the V2 AWS Integration API instead.
     attr_accessor :account_specific_namespace_rules
 
     # Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general `resource_collection`.

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

@@ -33,5 +33,6 @@ module DatadogAPIClient::V1
     CI_PIPELINES = "ci_pipelines".freeze
     INCIDENT_ANALYTICS = "incident_analytics".freeze
     PRODUCT_ANALYTICS = "product_analytics".freeze
+    ON_CALL_EVENTS = "on_call_events".freeze
   end
 end

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

@@ -21,6 +21,9 @@ module DatadogAPIClient::V1
   class Monitor
     include BaseGenericModel
 
+    # The list of monitor assets tied to a monitor, which represents key links for users to take action on monitor alerts (for example, runbooks).
+    attr_accessor :assets
+
     # Timestamp of the monitor creation.
     attr_accessor :created
 
@@ -86,6 +89,7 @@ module DatadogAPIClient::V1
     # @!visibility private
     def self.attribute_map
       {
+        :'assets' => :'assets',
         :'created' => :'created',
         :'creator' => :'creator',
         :'deleted' => :'deleted',
@@ -111,6 +115,7 @@ module DatadogAPIClient::V1
     # @!visibility private
     def self.openapi_types
       {
+        :'assets' => :'Array<MonitorAsset>',
         :'created' => :'Time',
         :'creator' => :'Creator',
         :'deleted' => :'Time',
@@ -160,6 +165,12 @@ module DatadogAPIClient::V1
         end
       }
 
+      if attributes.key?(:'assets')
+        if (value = attributes[:'assets']).is_a?(Array)
+          self.assets = value
+        end
+      end
+
       if attributes.key?(:'created')
         self.created = attributes[:'created']
       end
@@ -294,6 +305,7 @@ module DatadogAPIClient::V1
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          assets == o.assets &&
           created == o.created &&
           creator == o.creator &&
           deleted == o.deleted &&
@@ -319,7 +331,7 @@ module DatadogAPIClient::V1
     # @return [Integer] Hash code
     # @!visibility private
     def hash
-      [created, creator, deleted, draft_status, id, matching_downtimes, message, modified, multi, name, options, overall_state, priority, query, restricted_roles, state, tags, type, additional_properties].hash
+      [assets, created, creator, deleted, draft_status, id, matching_downtimes, 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/monitor_asset.rb

@@ -0,0 +1,186 @@
+=begin
+#Datadog API V1 Collection
+
+#Collection of all Datadog Public endpoints.
+
+The version of the OpenAPI document: 1.0
+Contact: support@datadoghq.com
+Generated by: https://github.com/DataDog/datadog-api-client-ruby/tree/master/.generator
+
+ Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+ This product includes software developed at Datadog (https://www.datadoghq.com/).
+ Copyright 2020-Present Datadog, Inc.
+
+=end
+
+require 'date'
+require 'time'
+
+module DatadogAPIClient::V1
+  # Represents key links tied to a monitor to help users take action on alerts.
+  # This feature is in Preview and only available to users with the feature enabled.
+  class MonitorAsset
+    include BaseGenericModel
+
+    # Indicates the type of asset this entity represents on a monitor.
+    attr_reader :category
+
+    # Name for the monitor asset
+    attr_reader :name
+
+    # Represents the identifier of the internal Datadog resource that this asset represents. IDs in this field should be passed in as strings.
+    attr_accessor :resource_key
+
+    # Type of internal Datadog resource associated with a monitor asset.
+    attr_accessor :resource_type
+
+    # URL link for the asset. For links with an internal resource type set, this should be the relative path to where the Datadog domain is appended internally. For external links, this should be the full URL path.
+    attr_reader :url
+
+    attr_accessor :additional_properties
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    # @!visibility private
+    def self.attribute_map
+      {
+        :'category' => :'category',
+        :'name' => :'name',
+        :'resource_key' => :'resource_key',
+        :'resource_type' => :'resource_type',
+        :'url' => :'url'
+      }
+    end
+
+    # Attribute type mapping.
+    # @!visibility private
+    def self.openapi_types
+      {
+        :'category' => :'MonitorAssetCategory',
+        :'name' => :'String',
+        :'resource_key' => :'String',
+        :'resource_type' => :'MonitorAssetResourceType',
+        :'url' => :'String'
+      }
+    end
+
+    # Initializes the object
+    # @param attributes [Hash] Model attributes in the form of hash
+    # @!visibility private
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `DatadogAPIClient::V1::MonitorAsset` initialize method"
+      end
+
+      self.additional_properties = {}
+      # check to see if the attribute exists and convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!self.class.attribute_map.key?(k.to_sym))
+          self.additional_properties[k.to_sym] = v
+        else
+          h[k.to_sym] = v
+        end
+      }
+
+      if attributes.key?(:'category')
+        self.category = attributes[:'category']
+      end
+
+      if attributes.key?(:'name')
+        self.name = attributes[:'name']
+      end
+
+      if attributes.key?(:'resource_key')
+        self.resource_key = attributes[:'resource_key']
+      end
+
+      if attributes.key?(:'resource_type')
+        self.resource_type = attributes[:'resource_type']
+      end
+
+      if attributes.key?(:'url')
+        self.url = attributes[:'url']
+      end
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    # @!visibility private
+    def valid?
+      return false if @category.nil?
+      return false if @name.nil?
+      return false if @url.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param category [Object] Object to be assigned
+    # @!visibility private
+    def category=(category)
+      if category.nil?
+        fail ArgumentError, 'invalid value for "category", category cannot be nil.'
+      end
+      @category = category
+    end
+
+    # Custom attribute writer method with validation
+    # @param name [Object] Object to be assigned
+    # @!visibility private
+    def name=(name)
+      if name.nil?
+        fail ArgumentError, 'invalid value for "name", name cannot be nil.'
+      end
+      @name = name
+    end
+
+    # Custom attribute writer method with validation
+    # @param url [Object] Object to be assigned
+    # @!visibility private
+    def url=(url)
+      if url.nil?
+        fail ArgumentError, 'invalid value for "url", url cannot be nil.'
+      end
+      @url = url
+    end
+
+    # Returns the object in the form of hash, with additionalProperties support.
+    # @return [Hash] Returns the object in the form of hash
+    # @!visibility private
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      self.additional_properties.each_pair do |attr, value|
+        hash[attr] = value
+      end
+      hash
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param o [Object] Object to be compared
+    # @!visibility private
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          category == o.category &&
+          name == o.name &&
+          resource_key == o.resource_key &&
+          resource_type == o.resource_type &&
+          url == o.url &&
+          additional_properties == o.additional_properties
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    # @!visibility private
+    def hash
+      [category, name, resource_key, resource_type, url, additional_properties].hash
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+=begin
+#Datadog API V1 Collection
+
+#Collection of all Datadog Public endpoints.
+
+The version of the OpenAPI document: 1.0
+Contact: support@datadoghq.com
+Generated by: https://github.com/DataDog/datadog-api-client-ruby/tree/master/.generator
+
+ Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+ This product includes software developed at Datadog (https://www.datadoghq.com/).
+ Copyright 2020-Present Datadog, Inc.
+
+=end
+
+require 'date'
+require 'time'
+
+module DatadogAPIClient::V1
+  # Indicates the type of asset this entity represents on a monitor.
+  class MonitorAssetCategory
+    include BaseEnumModel
+
+    RUNBOOK = "runbook".freeze
+  end
+end

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

@@ -0,0 +1,26 @@
+=begin
+#Datadog API V1 Collection
+
+#Collection of all Datadog Public endpoints.
+
+The version of the OpenAPI document: 1.0
+Contact: support@datadoghq.com
+Generated by: https://github.com/DataDog/datadog-api-client-ruby/tree/master/.generator
+
+ Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+ This product includes software developed at Datadog (https://www.datadoghq.com/).
+ Copyright 2020-Present Datadog, Inc.
+
+=end
+
+require 'date'
+require 'time'
+
+module DatadogAPIClient::V1
+  # Type of internal Datadog resource associated with a monitor asset.
+  class MonitorAssetResourceType
+    include BaseEnumModel
+
+    NOTEBOOK = "notebook".freeze
+  end
+end

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

@@ -21,6 +21,9 @@ module DatadogAPIClient::V1
   class MonitorUpdateRequest
     include BaseGenericModel
 
+    # The list of monitor assets tied to a monitor, which represents key links for users to take action on monitor alerts (for example, runbooks).
+    attr_accessor :assets
+
     # Timestamp of the monitor creation.
     attr_accessor :created
 
@@ -83,6 +86,7 @@ module DatadogAPIClient::V1
     # @!visibility private
     def self.attribute_map
       {
+        :'assets' => :'assets',
         :'created' => :'created',
         :'creator' => :'creator',
         :'deleted' => :'deleted',
@@ -107,6 +111,7 @@ module DatadogAPIClient::V1
     # @!visibility private
     def self.openapi_types
       {
+        :'assets' => :'Array<MonitorAsset>',
         :'created' => :'Time',
         :'creator' => :'Creator',
         :'deleted' => :'Time',
@@ -131,6 +136,7 @@ module DatadogAPIClient::V1
     # @!visibility private
     def self.openapi_nullable
       Set.new([
+        :'assets',
         :'deleted',
         :'priority',
         :'restricted_roles',
@@ -155,6 +161,12 @@ module DatadogAPIClient::V1
         end
       }
 
+      if attributes.key?(:'assets')
+        if (value = attributes[:'assets']).is_a?(Array)
+          self.assets = value
+        end
+      end
+
       if attributes.key?(:'created')
         self.created = attributes[:'created']
       end
@@ -254,6 +266,7 @@ module DatadogAPIClient::V1
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          assets == o.assets &&
           created == o.created &&
           creator == o.creator &&
           deleted == o.deleted &&
@@ -278,7 +291,7 @@ module DatadogAPIClient::V1
     # @return [Integer] Hash code
     # @!visibility private
     def hash
-      [created, creator, deleted, draft_status, id, message, modified, multi, name, options, overall_state, priority, query, restricted_roles, state, tags, type, additional_properties].hash
+      [assets, 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