aws-sdk-cloudwatch 1.105.0 → 1.106.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2067019b249fd610f65f93bf227571c7789d9cad4e3f6336b02d7b88bddd6cc
-  data.tar.gz: 00d657ece5aba354e9a4721606fb5e38aa8bce814ea520d3efac6618a7d98cad
+  metadata.gz: b8367cd3fce605a046cae966bc653790b7bb83cf851a421fdf065a884da29313
+  data.tar.gz: c835b8f01d81813bd9ce0f3124bc84c45b213ec438da31527e33c0fc0dfa0769
 SHA512:
-  metadata.gz: 948dee631dcd6e5d6b3eb64b67a0d7c72738c706e13d92c93849bb1e83a3001b5519c82d9fe0bdbfb877f961bb277e49cd4098af3419f985bd28293b7f37573f
-  data.tar.gz: 341cc2e14743a62ad2fe42437b5dfb0783d6010252baf9de7e7873f37c52b8c83f585737ccd6a4a08c736d02a68902231c8119a989e2222c18b195f51a33c281
+  metadata.gz: 03aba18f4403465f8f83adf8a47b3e45b26601ed66c6ba8e76cb104515cac705d0cbc5f4cad01c031d27827fa3392a2d386bfb1415d2870a4b4ea2eb113e3990
+  data.tar.gz: dbcc3ee47b2c509bd562e2dedfb66f99530d2dfe26c84e58015baea34014ee39c6d937258626eb30dfd7be07bb77b703d3619b2104d33211884b76cf293f2ac2

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.106.0 (2024-11-15)
+------------------
+
+* Feature - Adds support for adding related Entity information to metrics ingested through PutMetricData.
+
 1.105.0 (2024-11-06)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.105.0
+1.106.0

data/lib/aws-sdk-cloudwatch/client.rb

@@ -2363,7 +2363,7 @@ module Aws::CloudWatch
     #
     #   The results that are returned are an approximation of the value you
     #   specify. There is a low probability that the returned results include
-    #   metrics with last published data as much as 40 minutes more than the
+    #   metrics with last published data as much as 50 minutes more than the
     #   specified time interval.
     #
     # @option params [Boolean] :include_linked_accounts
@@ -3558,6 +3558,10 @@ module Aws::CloudWatch
     #   you specify in this parameter are ignored. To change the tags of an
     #   existing alarm, use [TagResource][1] or [UntagResource][2].
     #
+    #   To use this field to set tags for an alarm when you create it, you
+    #   must be signed on with both the `cloudwatch:PutMetricAlarm` and
+    #   `cloudwatch:TagResource` permissions.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
@@ -3645,13 +3649,20 @@ module Aws::CloudWatch
       req.send_request(options)
     end
 
-    # Publishes metric data points to Amazon CloudWatch. CloudWatch
-    # associates the data points with the specified metric. If the specified
-    # metric does not exist, CloudWatch creates the metric. When CloudWatch
-    # creates a metric, it can take up to fifteen minutes for the metric to
-    # appear in calls to [ListMetrics][1].
-    #
-    # You can publish either individual data points in the `Value` field, or
+    # Publishes metric data to Amazon CloudWatch. CloudWatch associates the
+    # data with the specified metric. If the specified metric does not
+    # exist, CloudWatch creates the metric. When CloudWatch creates a
+    # metric, it can take up to fifteen minutes for the metric to appear in
+    # calls to [ListMetrics][1].
+    #
+    # You can publish metrics with associated entity data (so that related
+    # telemetry can be found and viewed together), or publish metric data by
+    # itself. To send entity data with your metrics, use the
+    # `EntityMetricData` parameter. To send metrics without entity data, use
+    # the `MetricData` parameter. The `EntityMetricData` structure includes
+    # `MetricData` structures for the metric data.
+    #
+    # You can publish either individual values in the `Value` field, or
     # arrays of values and the number of times each value occurred during
     # the period by using the `Values` and `Counts` fields in the
     # `MetricData` structure. Using the `Values` and `Counts` method enables
@@ -3660,7 +3671,8 @@ module Aws::CloudWatch
     #
     # Each `PutMetricData` request is limited to 1 MB in size for HTTP POST
     # requests. You can send a payload compressed by gzip. Each request is
-    # also limited to no more than 1000 different metrics.
+    # also limited to no more than 1000 different metrics (across both the
+    # `MetricData` and `EntityMetricData` properties).
     #
     # Although the `Value` parameter accepts numbers of type `Double`,
     # CloudWatch rejects values that are either too small or too large.
@@ -3680,7 +3692,7 @@ module Aws::CloudWatch
     # least 48 hours to become available for [GetMetricData][3] or
     # [GetMetricStatistics][4] from the time they are submitted. Data points
     # with time stamps between 3 and 24 hours ago can take as much as 2
-    # hours to become available for for [GetMetricData][3] or
+    # hours to become available for [GetMetricData][3] or
     # [GetMetricStatistics][4].
     #
     # CloudWatch needs raw data points to calculate percentile statistics.
@@ -3708,17 +3720,73 @@ module Aws::CloudWatch
     #   To avoid conflicts with Amazon Web Services service namespaces, you
     #   should not specify a namespace that begins with `AWS/`
     #
-    # @option params [required, Array<Types::MetricDatum>] :metric_data
-    #   The data for the metric. The array can include no more than 1000
+    # @option params [Array<Types::MetricDatum>] :metric_data
+    #   The data for the metrics. Use this parameter if your metrics do not
+    #   contain associated entities. The array can include no more than 1000
     #   metrics per call.
     #
+    #   The limit of metrics allowed, 1000, is the sum of both
+    #   `EntityMetricData` and `MetricData` metrics.
+    #
+    # @option params [Array<Types::EntityMetricData>] :entity_metric_data
+    #   Data for metrics that contain associated entity information. You can
+    #   include up to two `EntityMetricData` objects, each of which can
+    #   contain a single `Entity` and associated metrics.
+    #
+    #   The limit of metrics allowed, 1000, is the sum of both
+    #   `EntityMetricData` and `MetricData` metrics.
+    #
+    # @option params [Boolean] :strict_entity_validation
+    #   Whether to accept valid metric data when an invalid entity is sent.
+    #
+    #   * When set to `true`: Any validation error (for entity or metric data)
+    #     will fail the entire request, and no data will be ingested. The
+    #     failed operation will return a 400 result with the error.
+    #
+    #   * When set to `false`: Validation errors in the entity will not
+    #     associate the metric with the entity, but the metric data will still
+    #     be accepted and ingested. Validation errors in the metric data will
+    #     fail the entire request, and no data will be ingested.
+    #
+    #     In the case of an invalid entity, the operation will return a `200`
+    #     status, but an additional response header will contain information
+    #     about the validation errors. The new header,
+    #     `X-Amzn-Failure-Message` is an enumeration of the following values:
+    #
+    #     * `InvalidEntity` - The provided entity is invalid.
+    #
+    #     * `InvalidKeyAttributes` - The provided `KeyAttributes` of an entity
+    #       is invalid.
+    #
+    #     * `InvalidAttributes` - The provided `Attributes` of an entity is
+    #       invalid.
+    #
+    #     * `InvalidTypeValue` - The provided `Type` in the `KeyAttributes` of
+    #       an entity is invalid.
+    #
+    #     * `EntitySizeTooLarge` - The number of `EntityMetricData` objects
+    #       allowed is 2.
+    #
+    #     * `MissingRequiredFields` - There are missing required fields in the
+    #       `KeyAttributes` for the provided `Type`.
+    #
+    #     For details of the requirements for specifying an entity, see [How
+    #     to add related information to telemetry][1] in the *CloudWatch User
+    #     Guide*.
+    #
+    #   This parameter is *required* when `EntityMetricData` is included.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/adding-your-own-related-telemetry.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.put_metric_data({
     #     namespace: "Namespace", # required
-    #     metric_data: [ # required
+    #     metric_data: [
     #       {
     #         metric_name: "MetricName", # required
     #         dimensions: [
@@ -3741,6 +3809,42 @@ module Aws::CloudWatch
     #         storage_resolution: 1,
     #       },
     #     ],
+    #     entity_metric_data: [
+    #       {
+    #         entity: {
+    #           key_attributes: {
+    #             "EntityKeyAttributesMapKeyString" => "EntityKeyAttributesMapValueString",
+    #           },
+    #           attributes: {
+    #             "EntityAttributesMapKeyString" => "EntityAttributesMapValueString",
+    #           },
+    #         },
+    #         metric_data: [
+    #           {
+    #             metric_name: "MetricName", # required
+    #             dimensions: [
+    #               {
+    #                 name: "DimensionName", # required
+    #                 value: "DimensionValue", # required
+    #               },
+    #             ],
+    #             timestamp: Time.now,
+    #             value: 1.0,
+    #             statistic_values: {
+    #               sample_count: 1.0, # required
+    #               sum: 1.0, # required
+    #               minimum: 1.0, # required
+    #               maximum: 1.0, # required
+    #             },
+    #             values: [1.0],
+    #             counts: [1.0],
+    #             unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
+    #             storage_resolution: 1,
+    #           },
+    #         ],
+    #       },
+    #     ],
+    #     strict_entity_validation: false,
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricData AWS API Documentation
@@ -4178,7 +4282,7 @@ module Aws::CloudWatch
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.105.0'
+      context[:gem_version] = '1.106.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudwatch/client_api.rb

@@ -96,6 +96,15 @@ module Aws::CloudWatch
     EnableAlarmActionsInput = Shapes::StructureShape.new(name: 'EnableAlarmActionsInput')
     EnableInsightRulesInput = Shapes::StructureShape.new(name: 'EnableInsightRulesInput')
     EnableInsightRulesOutput = Shapes::StructureShape.new(name: 'EnableInsightRulesOutput')
+    Entity = Shapes::StructureShape.new(name: 'Entity')
+    EntityAttributesMap = Shapes::MapShape.new(name: 'EntityAttributesMap')
+    EntityAttributesMapKeyString = Shapes::StringShape.new(name: 'EntityAttributesMapKeyString')
+    EntityAttributesMapValueString = Shapes::StringShape.new(name: 'EntityAttributesMapValueString')
+    EntityKeyAttributesMap = Shapes::MapShape.new(name: 'EntityKeyAttributesMap')
+    EntityKeyAttributesMapKeyString = Shapes::StringShape.new(name: 'EntityKeyAttributesMapKeyString')
+    EntityKeyAttributesMapValueString = Shapes::StringShape.new(name: 'EntityKeyAttributesMapValueString')
+    EntityMetricData = Shapes::StructureShape.new(name: 'EntityMetricData')
+    EntityMetricDataList = Shapes::ListShape.new(name: 'EntityMetricDataList')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     EvaluateLowSampleCountPercentile = Shapes::StringShape.new(name: 'EvaluateLowSampleCountPercentile')
     EvaluationPeriods = Shapes::IntegerShape.new(name: 'EvaluationPeriods')
@@ -266,6 +275,7 @@ module Aws::CloudWatch
     StopMetricStreamsInput = Shapes::StructureShape.new(name: 'StopMetricStreamsInput')
     StopMetricStreamsOutput = Shapes::StructureShape.new(name: 'StopMetricStreamsOutput')
     StorageResolution = Shapes::IntegerShape.new(name: 'StorageResolution')
+    StrictEntityValidation = Shapes::BooleanShape.new(name: 'StrictEntityValidation')
     SuppressorPeriod = Shapes::IntegerShape.new(name: 'SuppressorPeriod')
     Tag = Shapes::StructureShape.new(name: 'Tag')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
@@ -508,6 +518,22 @@ module Aws::CloudWatch
     EnableInsightRulesOutput.add_member(:failures, Shapes::ShapeRef.new(shape: BatchFailures, location_name: "Failures"))
     EnableInsightRulesOutput.struct_class = Types::EnableInsightRulesOutput
 
+    Entity.add_member(:key_attributes, Shapes::ShapeRef.new(shape: EntityKeyAttributesMap, location_name: "KeyAttributes"))
+    Entity.add_member(:attributes, Shapes::ShapeRef.new(shape: EntityAttributesMap, location_name: "Attributes"))
+    Entity.struct_class = Types::Entity
+
+    EntityAttributesMap.key = Shapes::ShapeRef.new(shape: EntityAttributesMapKeyString)
+    EntityAttributesMap.value = Shapes::ShapeRef.new(shape: EntityAttributesMapValueString)
+
+    EntityKeyAttributesMap.key = Shapes::ShapeRef.new(shape: EntityKeyAttributesMapKeyString)
+    EntityKeyAttributesMap.value = Shapes::ShapeRef.new(shape: EntityKeyAttributesMapValueString)
+
+    EntityMetricData.add_member(:entity, Shapes::ShapeRef.new(shape: Entity, location_name: "Entity"))
+    EntityMetricData.add_member(:metric_data, Shapes::ShapeRef.new(shape: MetricData, location_name: "MetricData"))
+    EntityMetricData.struct_class = Types::EntityMetricData
+
+    EntityMetricDataList.member = Shapes::ShapeRef.new(shape: EntityMetricData)
+
     ExtendedStatistics.member = Shapes::ShapeRef.new(shape: ExtendedStatistic)
 
     GetDashboardInput.add_member(:dashboard_name, Shapes::ShapeRef.new(shape: DashboardName, required: true, location_name: "DashboardName"))
@@ -925,7 +951,9 @@ module Aws::CloudWatch
     PutMetricAlarmInput.struct_class = Types::PutMetricAlarmInput
 
     PutMetricDataInput.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, required: true, location_name: "Namespace"))
-    PutMetricDataInput.add_member(:metric_data, Shapes::ShapeRef.new(shape: MetricData, required: true, location_name: "MetricData"))
+    PutMetricDataInput.add_member(:metric_data, Shapes::ShapeRef.new(shape: MetricData, location_name: "MetricData"))
+    PutMetricDataInput.add_member(:entity_metric_data, Shapes::ShapeRef.new(shape: EntityMetricDataList, location_name: "EntityMetricData"))
+    PutMetricDataInput.add_member(:strict_entity_validation, Shapes::ShapeRef.new(shape: StrictEntityValidation, location_name: "StrictEntityValidation", metadata: {"box"=>true}))
     PutMetricDataInput.struct_class = Types::PutMetricDataInput
 
     PutMetricStreamInput.add_member(:name, Shapes::ShapeRef.new(shape: MetricStreamName, required: true, location_name: "Name"))

data/lib/aws-sdk-cloudwatch/metric.rb

@@ -737,6 +737,10 @@ module Aws::CloudWatch
     #   you specify in this parameter are ignored. To change the tags of an
     #   existing alarm, use [TagResource][1] or [UntagResource][2].
     #
+    #   To use this field to set tags for an alarm when you create it, you
+    #   must be signed on with both the `cloudwatch:PutMetricAlarm` and
+    #   `cloudwatch:TagResource` permissions.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
@@ -768,7 +772,7 @@ module Aws::CloudWatch
     # @example Request syntax with placeholder values
     #
     #   metric.put_data({
-    #     metric_data: [ # required
+    #     metric_data: [
     #       {
     #         metric_name: "MetricName", # required
     #         dimensions: [
@@ -791,11 +795,101 @@ module Aws::CloudWatch
     #         storage_resolution: 1,
     #       },
     #     ],
+    #     entity_metric_data: [
+    #       {
+    #         entity: {
+    #           key_attributes: {
+    #             "EntityKeyAttributesMapKeyString" => "EntityKeyAttributesMapValueString",
+    #           },
+    #           attributes: {
+    #             "EntityAttributesMapKeyString" => "EntityAttributesMapValueString",
+    #           },
+    #         },
+    #         metric_data: [
+    #           {
+    #             metric_name: "MetricName", # required
+    #             dimensions: [
+    #               {
+    #                 name: "DimensionName", # required
+    #                 value: "DimensionValue", # required
+    #               },
+    #             ],
+    #             timestamp: Time.now,
+    #             value: 1.0,
+    #             statistic_values: {
+    #               sample_count: 1.0, # required
+    #               sum: 1.0, # required
+    #               minimum: 1.0, # required
+    #               maximum: 1.0, # required
+    #             },
+    #             values: [1.0],
+    #             counts: [1.0],
+    #             unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
+    #             storage_resolution: 1,
+    #           },
+    #         ],
+    #       },
+    #     ],
+    #     strict_entity_validation: false,
     #   })
     # @param [Hash] options ({})
-    # @option options [required, Array<Types::MetricDatum>] :metric_data
-    #   The data for the metric. The array can include no more than 1000
+    # @option options [Array<Types::MetricDatum>] :metric_data
+    #   The data for the metrics. Use this parameter if your metrics do not
+    #   contain associated entities. The array can include no more than 1000
     #   metrics per call.
+    #
+    #   The limit of metrics allowed, 1000, is the sum of both
+    #   `EntityMetricData` and `MetricData` metrics.
+    # @option options [Array<Types::EntityMetricData>] :entity_metric_data
+    #   Data for metrics that contain associated entity information. You can
+    #   include up to two `EntityMetricData` objects, each of which can
+    #   contain a single `Entity` and associated metrics.
+    #
+    #   The limit of metrics allowed, 1000, is the sum of both
+    #   `EntityMetricData` and `MetricData` metrics.
+    # @option options [Boolean] :strict_entity_validation
+    #   Whether to accept valid metric data when an invalid entity is sent.
+    #
+    #   * When set to `true`: Any validation error (for entity or metric data)
+    #     will fail the entire request, and no data will be ingested. The
+    #     failed operation will return a 400 result with the error.
+    #
+    #   * When set to `false`: Validation errors in the entity will not
+    #     associate the metric with the entity, but the metric data will still
+    #     be accepted and ingested. Validation errors in the metric data will
+    #     fail the entire request, and no data will be ingested.
+    #
+    #     In the case of an invalid entity, the operation will return a `200`
+    #     status, but an additional response header will contain information
+    #     about the validation errors. The new header,
+    #     `X-Amzn-Failure-Message` is an enumeration of the following values:
+    #
+    #     * `InvalidEntity` - The provided entity is invalid.
+    #
+    #     * `InvalidKeyAttributes` - The provided `KeyAttributes` of an entity
+    #       is invalid.
+    #
+    #     * `InvalidAttributes` - The provided `Attributes` of an entity is
+    #       invalid.
+    #
+    #     * `InvalidTypeValue` - The provided `Type` in the `KeyAttributes` of
+    #       an entity is invalid.
+    #
+    #     * `EntitySizeTooLarge` - The number of `EntityMetricData` objects
+    #       allowed is 2.
+    #
+    #     * `MissingRequiredFields` - There are missing required fields in the
+    #       `KeyAttributes` for the provided `Type`.
+    #
+    #     For details of the requirements for specifying an entity, see [How
+    #     to add related information to telemetry][1] in the *CloudWatch User
+    #     Guide*.
+    #
+    #   This parameter is *required* when `EntityMetricData` is included.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/adding-your-own-related-telemetry.html
     # @return [EmptyStructure]
     def put_data(options = {})
       options = Aws::Util.deep_merge(options,

data/lib/aws-sdk-cloudwatch/resource.rb

@@ -294,7 +294,7 @@ module Aws::CloudWatch
     #
     #   The results that are returned are an approximation of the value you
     #   specify. There is a low probability that the returned results include
-    #   metrics with last published data as much as 40 minutes more than the
+    #   metrics with last published data as much as 50 minutes more than the
     #   specified time interval.
     # @option options [Boolean] :include_linked_accounts
     #   If you are using this operation in a monitoring account, specify

data/lib/aws-sdk-cloudwatch/types.rb

@@ -1073,6 +1073,73 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # An entity associated with metrics, to allow for finding related
+    # telemetry. An entity is typically a resource or service within your
+    # system. For example, metrics from an Amazon EC2 instance could be
+    # associated with that instance as the entity. Similarly, metrics from a
+    # service that you own could be associated with that service as the
+    # entity.
+    #
+    # @!attribute [rw] key_attributes
+    #   The attributes of the entity which identify the specific entity, as
+    #   a list of key-value pairs. Entities with the same `KeyAttributes`
+    #   are considered to be the same entity. For an entity to be valid, the
+    #   `KeyAttributes` must exist and be formatted correctly.
+    #
+    #   There are five allowed attributes (key names): `Type`,
+    #   `ResourceType`, `Identifier`, `Name`, and `Environment`.
+    #
+    #   For details about how to use the key attributes to specify an
+    #   entity, see [How to add related information to telemetry][1] in the
+    #   *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/adding-your-own-related-telemetry.html
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] attributes
+    #   Additional attributes of the entity that are not used to specify the
+    #   identity of the entity. A list of key-value pairs.
+    #
+    #   For details about how to use the attributes, see [How to add related
+    #   information to telemetry][1] in the *CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/adding-your-own-related-telemetry.html
+    #   @return [Hash<String,String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/Entity AWS API Documentation
+    #
+    class Entity < Struct.new(
+      :key_attributes,
+      :attributes)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A set of metrics that are associated with an entity, such as a
+    # specific service or resource. Contains the entity and the list of
+    # metric data associated with it.
+    #
+    # @!attribute [rw] entity
+    #   The entity associated with the metrics.
+    #   @return [Types::Entity]
+    #
+    # @!attribute [rw] metric_data
+    #   The metric data.
+    #   @return [Array<Types::MetricDatum>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/EntityMetricData AWS API Documentation
+    #
+    class EntityMetricData < Struct.new(
+      :entity,
+      :metric_data)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] dashboard_name
     #   The name of the dashboard to be described.
     #   @return [String]
@@ -2157,7 +2224,7 @@ module Aws::CloudWatch
     #
     #   The results that are returned are an approximation of the value you
     #   specify. There is a low probability that the returned results
-    #   include metrics with last published data as much as 40 minutes more
+    #   include metrics with last published data as much as 50 minutes more
     #   than the specified time interval.
     #   @return [String]
     #
@@ -4045,6 +4112,10 @@ module Aws::CloudWatch
     #   tags you specify in this parameter are ignored. To change the tags
     #   of an existing alarm, use [TagResource][1] or [UntagResource][2].
     #
+    #   To use this field to set tags for an alarm when you create it, you
+    #   must be signed on with both the `cloudwatch:PutMetricAlarm` and
+    #   `cloudwatch:TagResource` permissions.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
@@ -4101,15 +4172,76 @@ module Aws::CloudWatch
     #   @return [String]
     #
     # @!attribute [rw] metric_data
-    #   The data for the metric. The array can include no more than 1000
+    #   The data for the metrics. Use this parameter if your metrics do not
+    #   contain associated entities. The array can include no more than 1000
     #   metrics per call.
+    #
+    #   The limit of metrics allowed, 1000, is the sum of both
+    #   `EntityMetricData` and `MetricData` metrics.
     #   @return [Array<Types::MetricDatum>]
     #
+    # @!attribute [rw] entity_metric_data
+    #   Data for metrics that contain associated entity information. You can
+    #   include up to two `EntityMetricData` objects, each of which can
+    #   contain a single `Entity` and associated metrics.
+    #
+    #   The limit of metrics allowed, 1000, is the sum of both
+    #   `EntityMetricData` and `MetricData` metrics.
+    #   @return [Array<Types::EntityMetricData>]
+    #
+    # @!attribute [rw] strict_entity_validation
+    #   Whether to accept valid metric data when an invalid entity is sent.
+    #
+    #   * When set to `true`: Any validation error (for entity or metric
+    #     data) will fail the entire request, and no data will be ingested.
+    #     The failed operation will return a 400 result with the error.
+    #
+    #   * When set to `false`: Validation errors in the entity will not
+    #     associate the metric with the entity, but the metric data will
+    #     still be accepted and ingested. Validation errors in the metric
+    #     data will fail the entire request, and no data will be ingested.
+    #
+    #     In the case of an invalid entity, the operation will return a
+    #     `200` status, but an additional response header will contain
+    #     information about the validation errors. The new header,
+    #     `X-Amzn-Failure-Message` is an enumeration of the following
+    #     values:
+    #
+    #     * `InvalidEntity` - The provided entity is invalid.
+    #
+    #     * `InvalidKeyAttributes` - The provided `KeyAttributes` of an
+    #       entity is invalid.
+    #
+    #     * `InvalidAttributes` - The provided `Attributes` of an entity is
+    #       invalid.
+    #
+    #     * `InvalidTypeValue` - The provided `Type` in the `KeyAttributes`
+    #       of an entity is invalid.
+    #
+    #     * `EntitySizeTooLarge` - The number of `EntityMetricData` objects
+    #       allowed is 2.
+    #
+    #     * `MissingRequiredFields` - There are missing required fields in
+    #       the `KeyAttributes` for the provided `Type`.
+    #
+    #     For details of the requirements for specifying an entity, see [How
+    #     to add related information to telemetry][1] in the *CloudWatch
+    #     User Guide*.
+    #
+    #   This parameter is *required* when `EntityMetricData` is included.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/adding-your-own-related-telemetry.html
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricDataInput AWS API Documentation
     #
     class PutMetricDataInput < Struct.new(
       :namespace,
-      :metric_data)
+      :metric_data,
+      :entity_metric_data,
+      :strict_entity_validation)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-cloudwatch.rb

@@ -58,7 +58,7 @@ module Aws::CloudWatch
   autoload :CompositeAlarm, 'aws-sdk-cloudwatch/composite_alarm'
   autoload :Metric, 'aws-sdk-cloudwatch/metric'
 
-  GEM_VERSION = '1.105.0'
+  GEM_VERSION = '1.106.0'
 
 end
 

data/sig/client.rbs

@@ -694,7 +694,7 @@ module Aws
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/Client.html#put_metric_data-instance_method
       def put_metric_data: (
                              namespace: ::String,
-                             metric_data: Array[
+                             ?metric_data: Array[
                                {
                                  metric_name: ::String,
                                  dimensions: Array[
@@ -716,7 +716,39 @@ module Aws
                                  unit: ("Seconds" | "Microseconds" | "Milliseconds" | "Bytes" | "Kilobytes" | "Megabytes" | "Gigabytes" | "Terabytes" | "Bits" | "Kilobits" | "Megabits" | "Gigabits" | "Terabits" | "Percent" | "Count" | "Bytes/Second" | "Kilobytes/Second" | "Megabytes/Second" | "Gigabytes/Second" | "Terabytes/Second" | "Bits/Second" | "Kilobits/Second" | "Megabits/Second" | "Gigabits/Second" | "Terabits/Second" | "Count/Second" | "None")?,
                                  storage_resolution: ::Integer?
                                },
-                             ]
+                             ],
+                             ?entity_metric_data: Array[
+                               {
+                                 entity: {
+                                   key_attributes: Hash[::String, ::String]?,
+                                   attributes: Hash[::String, ::String]?
+                                 }?,
+                                 metric_data: Array[
+                                   {
+                                     metric_name: ::String,
+                                     dimensions: Array[
+                                       {
+                                         name: ::String,
+                                         value: ::String
+                                       },
+                                     ]?,
+                                     timestamp: ::Time?,
+                                     value: ::Float?,
+                                     statistic_values: {
+                                       sample_count: ::Float,
+                                       sum: ::Float,
+                                       minimum: ::Float,
+                                       maximum: ::Float
+                                     }?,
+                                     values: Array[::Float]?,
+                                     counts: Array[::Float]?,
+                                     unit: ("Seconds" | "Microseconds" | "Milliseconds" | "Bytes" | "Kilobytes" | "Megabytes" | "Gigabytes" | "Terabytes" | "Bits" | "Kilobits" | "Megabits" | "Gigabits" | "Terabits" | "Percent" | "Count" | "Bytes/Second" | "Kilobytes/Second" | "Megabytes/Second" | "Gigabytes/Second" | "Terabytes/Second" | "Bits/Second" | "Kilobits/Second" | "Megabits/Second" | "Gigabits/Second" | "Terabits/Second" | "Count/Second" | "None")?,
+                                     storage_resolution: ::Integer?
+                                   },
+                                 ]?
+                               },
+                             ],
+                             ?strict_entity_validation: bool
                            ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
 

data/sig/metric.rbs

@@ -115,7 +115,7 @@ module Aws
 
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/Metric.html#put_data-instance_method
       def put_data: (
-                      metric_data: Array[
+                      ?metric_data: Array[
                         {
                           metric_name: ::String,
                           dimensions: Array[
@@ -137,7 +137,39 @@ module Aws
                           unit: ("Seconds" | "Microseconds" | "Milliseconds" | "Bytes" | "Kilobytes" | "Megabytes" | "Gigabytes" | "Terabytes" | "Bits" | "Kilobits" | "Megabits" | "Gigabits" | "Terabits" | "Percent" | "Count" | "Bytes/Second" | "Kilobytes/Second" | "Megabytes/Second" | "Gigabytes/Second" | "Terabytes/Second" | "Bits/Second" | "Kilobits/Second" | "Megabits/Second" | "Gigabits/Second" | "Terabits/Second" | "Count/Second" | "None")?,
                           storage_resolution: ::Integer?
                         },
-                      ]
+                      ],
+                      ?entity_metric_data: Array[
+                        {
+                          entity: {
+                            key_attributes: Hash[::String, ::String]?,
+                            attributes: Hash[::String, ::String]?
+                          }?,
+                          metric_data: Array[
+                            {
+                              metric_name: ::String,
+                              dimensions: Array[
+                                {
+                                  name: ::String,
+                                  value: ::String
+                                },
+                              ]?,
+                              timestamp: ::Time?,
+                              value: ::Float?,
+                              statistic_values: {
+                                sample_count: ::Float,
+                                sum: ::Float,
+                                minimum: ::Float,
+                                maximum: ::Float
+                              }?,
+                              values: Array[::Float]?,
+                              counts: Array[::Float]?,
+                              unit: ("Seconds" | "Microseconds" | "Milliseconds" | "Bytes" | "Kilobytes" | "Megabytes" | "Gigabytes" | "Terabytes" | "Bits" | "Kilobits" | "Megabits" | "Gigabits" | "Terabits" | "Percent" | "Count" | "Bytes/Second" | "Kilobytes/Second" | "Megabytes/Second" | "Gigabytes/Second" | "Terabytes/Second" | "Bits/Second" | "Kilobits/Second" | "Megabits/Second" | "Gigabits/Second" | "Terabits/Second" | "Count/Second" | "None")?,
+                              storage_resolution: ::Integer?
+                            },
+                          ]?
+                        },
+                      ],
+                      ?strict_entity_validation: bool
                     ) -> ::Aws::EmptyStructure
                   | (?Hash[Symbol, untyped]) -> ::Aws::EmptyStructure
 

data/sig/types.rbs

@@ -268,6 +268,18 @@ module Aws::CloudWatch
       SENSITIVE: []
     end
 
+    class Entity
+      attr_accessor key_attributes: ::Hash[::String, ::String]
+      attr_accessor attributes: ::Hash[::String, ::String]
+      SENSITIVE: []
+    end
+
+    class EntityMetricData
+      attr_accessor entity: Types::Entity
+      attr_accessor metric_data: ::Array[Types::MetricDatum]
+      SENSITIVE: []
+    end
+
     class GetDashboardInput
       attr_accessor dashboard_name: ::String
       SENSITIVE: []
@@ -758,6 +770,8 @@ module Aws::CloudWatch
     class PutMetricDataInput
       attr_accessor namespace: ::String
       attr_accessor metric_data: ::Array[Types::MetricDatum]
+      attr_accessor entity_metric_data: ::Array[Types::EntityMetricData]
+      attr_accessor strict_entity_validation: bool
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatch
 version: !ruby/object:Gem::Version
-  version: 1.105.0
+  version: 1.106.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-06 00:00:00.000000000 Z
+date: 2024-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core