aws-sdk-ecs 1.237.0 → 1.238.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fa8f274d8ebb5e3f32853a8afcd1295d5eff74276d2cad9cb813e2d5a4289fa
-  data.tar.gz: 229c5e928be336d438ffbf41ad32f6336651031cb7d3ab83a64e8ed3d0fd4b6f
+  metadata.gz: 7cb318724f73d1a7e40ec775154e7c7c35bdccc5d575c2eeb4b0845f9facb89e
+  data.tar.gz: 874349088dc3c7e751b772ed04e8e7d8090e425fadc927f18b3e0f8621ae3be4
 SHA512:
-  metadata.gz: bca215c6e29f93e71f6301e20db100d632d46600c19341f9c9ccdcf332c330bcbd7b83b8e6f0d03b9918894a322294fdbc99383182e5512afc8a12694b1c0dfe
-  data.tar.gz: 04dab105f0f10aeaf980bc29c616ec044e01b0e50948e7e7b9b015ceef8182cd60c9016edbb0acaa337e23842926d2e5b286d446c5c668fa7e84422361ce9521
+  metadata.gz: 3de3597aca2dfceaf276de4f0c0033dcba479dc3aa0fc143e292714a0eedbe2cb1b76c2822514b94bcb3d6e425ac32c95d6ea15f1e0d39a6b2c43cdf6d2759b5
+  data.tar.gz: b3042dd2689112a0043568fc4a913c019f29840b7f31cfd12e26a6888e95401f29bb78c60ac53c73200d78e90efbe38fdd87ce022a546b376296b0eda5f5ca71

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.238.0 (2026-06-18)
+------------------
+
+* Feature - Amazon ECS services now support high resolution (20 second) CloudWatch metrics for CPUUtilization and MemoryUtilization. Use these metrics for faster service auto scaling.
+
 1.237.0 (2026-06-17)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.237.0
+1.238.0

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

@@ -2171,6 +2171,12 @@ module Aws::ECS
     # @option params [Array<Types::VpcLatticeConfiguration>] :vpc_lattice_configurations
     #   The VPC Lattice configuration for the service being created.
     #
+    # @option params [Types::MonitoringConfiguration] :monitoring
+    #   The optional monitoring configuration for the service, which defines
+    #   the resolution for the service-level `CPUUtilization` and
+    #   `MemoryUtilization` Amazon CloudWatch metrics. When not specified,
+    #   Amazon ECS uses the default resolution of `60` seconds.
+    #
     # @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateServiceResponse#service #service} => Types::Service
@@ -2368,6 +2374,47 @@ module Aws::ECS
     #     }, 
     #   }
     #
+    # @example Example: To create a service with a monitoring configuration
+    #
+    #   # This example creates a service with a monitoring configuration that sets 20-second resolution for CPUUtilization and
+    #   # MemoryUtilization CloudWatch metrics. The monitoring configuration is not returned in the CreateService response. Use
+    #   # DescribeServiceRevisions to view the monitoring configuration.
+    #
+    #   resp = client.create_service({
+    #     desired_count: 2, 
+    #     monitoring: {
+    #       metric_configurations: [
+    #         {
+    #           metric_names: [
+    #             "CPUUtilization", 
+    #             "MemoryUtilization", 
+    #           ], 
+    #           resolution_seconds: 20, 
+    #         }, 
+    #       ], 
+    #     }, 
+    #     service_name: "ecs-monitored-service", 
+    #     task_definition: "my-app:1", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     service: {
+    #       cluster_arn: "arn:aws:ecs:us-east-1:012345678910:cluster/default", 
+    #       deployment_configuration: {
+    #         maximum_percent: 200, 
+    #         minimum_healthy_percent: 100, 
+    #       }, 
+    #       desired_count: 2, 
+    #       pending_count: 0, 
+    #       running_count: 0, 
+    #       service_arn: "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-monitored-service", 
+    #       service_name: "ecs-monitored-service", 
+    #       status: "ACTIVE", 
+    #       task_definition: "arn:aws:ecs:us-east-1:012345678910:task-definition/my-app:1", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_service({
@@ -2567,6 +2614,14 @@ module Aws::ECS
     #         port_name: "String", # required
     #       },
     #     ],
+    #     monitoring: {
+    #       metric_configurations: [
+    #         {
+    #           metric_names: ["MetricName"], # required
+    #           resolution_seconds: 1, # required
+    #         },
+    #       ],
+    #     },
     #   })
     #
     # @example Response structure
@@ -6299,6 +6354,46 @@ module Aws::ECS
     #     ], 
     #   }
     #
+    # @example Example: To describe a service revision with a monitoring configuration
+    #
+    #   # This example describes a service revision that has a monitoring configuration with 20-second resolution for
+    #   # CPUUtilization and MemoryUtilization CloudWatch metrics.
+    #
+    #   resp = client.describe_service_revisions({
+    #     service_revision_arns: [
+    #       "arn:aws:ecs:us-east-1:012345678910:service-revision/default/ecs-monitored-service/8675309012345678901", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     failures: [
+    #     ], 
+    #     service_revisions: [
+    #       {
+    #         cluster_arn: "arn:aws:ecs:us-east-1:012345678910:cluster/default", 
+    #         created_at: Time.parse("2026-06-10T12:00:00.00Z"), 
+    #         launch_type: "FARGATE", 
+    #         monitoring: {
+    #           metric_configurations: [
+    #             {
+    #               metric_names: [
+    #                 "CPUUtilization", 
+    #                 "MemoryUtilization", 
+    #               ], 
+    #               resolution_seconds: 20, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #         platform_family: "DockerLinux", 
+    #         platform_version: "1.4.0", 
+    #         service_arn: "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-monitored-service", 
+    #         service_revision_arn: "arn:aws:ecs:us-east-1:012345678910:service-revision/default/ecs-monitored-service/8675309012345678901", 
+    #         task_definition: "arn:aws:ecs:us-east-1:012345678910:task-definition/my-app:1", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_service_revisions({
@@ -6462,6 +6557,10 @@ module Aws::ECS
     #   resp.service_revisions[0].ecs_managed_resources.log_groups[0].status_reason #=> String
     #   resp.service_revisions[0].ecs_managed_resources.log_groups[0].updated_at #=> Time
     #   resp.service_revisions[0].ecs_managed_resources.log_groups[0].log_group_name #=> String
+    #   resp.service_revisions[0].monitoring.metric_configurations #=> Array
+    #   resp.service_revisions[0].monitoring.metric_configurations[0].metric_names #=> Array
+    #   resp.service_revisions[0].monitoring.metric_configurations[0].metric_names[0] #=> String
+    #   resp.service_revisions[0].monitoring.metric_configurations[0].resolution_seconds #=> Integer
     #   resp.failures #=> Array
     #   resp.failures[0].arn #=> String
     #   resp.failures[0].reason #=> String
@@ -15116,6 +15215,12 @@ module Aws::ECS
     #
     #   This parameter triggers a new service deployment.
     #
+    # @option params [Types::MonitoringConfiguration] :monitoring
+    #   The optional monitoring configuration for the service, which defines
+    #   the resolution for the service-level `CPUUtilization` and
+    #   `MemoryUtilization` Amazon CloudWatch metrics. When not specified,
+    #   Amazon ECS uses the default resolution of `60` seconds.
+    #
     # @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateServiceResponse#service #service} => Types::Service
@@ -15176,6 +15281,31 @@ module Aws::ECS
     #   {
     #   }
     #
+    # @example Example: To update a service with a monitoring configuration
+    #
+    #   # This example updates a service to add a monitoring configuration that sets 20-second resolution for CPUUtilization and
+    #   # MemoryUtilization CloudWatch metrics. The monitoring configuration is not returned in the UpdateService response. Use
+    #   # DescribeServiceRevisions to view the monitoring configuration.
+    #
+    #   resp = client.update_service({
+    #     monitoring: {
+    #       metric_configurations: [
+    #         {
+    #           metric_names: [
+    #             "CPUUtilization", 
+    #             "MemoryUtilization", 
+    #           ], 
+    #           resolution_seconds: 20, 
+    #         }, 
+    #       ], 
+    #     }, 
+    #     service: "ecs-monitored-service", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_service({
@@ -15366,6 +15496,14 @@ module Aws::ECS
     #         port_name: "String", # required
     #       },
     #     ],
+    #     monitoring: {
+    #       metric_configurations: [
+    #         {
+    #           metric_names: ["MetricName"], # required
+    #           resolution_seconds: 1, # required
+    #         },
+    #       ],
+    #     },
     #   })
     #
     # @example Response structure
@@ -16072,7 +16210,7 @@ module Aws::ECS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.237.0'
+      context[:gem_version] = '1.238.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -411,7 +411,13 @@ module Aws::ECS
     ManagedTerminationProtection = Shapes::StringShape.new(name: 'ManagedTerminationProtection')
     MemoryGiBPerVCpuRequest = Shapes::StructureShape.new(name: 'MemoryGiBPerVCpuRequest')
     MemoryMiBRequest = Shapes::StructureShape.new(name: 'MemoryMiBRequest')
+    MetricConfiguration = Shapes::StructureShape.new(name: 'MetricConfiguration')
+    MetricConfigurationList = Shapes::ListShape.new(name: 'MetricConfigurationList')
+    MetricName = Shapes::StringShape.new(name: 'MetricName')
+    MetricNamesList = Shapes::ListShape.new(name: 'MetricNamesList')
+    MetricResolutionSeconds = Shapes::IntegerShape.new(name: 'MetricResolutionSeconds')
     MissingVersionException = Shapes::StructureShape.new(name: 'MissingVersionException')
+    MonitoringConfiguration = Shapes::StructureShape.new(name: 'MonitoringConfiguration')
     MountPoint = Shapes::StructureShape.new(name: 'MountPoint')
     MountPointList = Shapes::ListShape.new(name: 'MountPointList')
     NamespaceNotFoundException = Shapes::StructureShape.new(name: 'NamespaceNotFoundException')
@@ -1053,6 +1059,7 @@ module Aws::ECS
     CreateServiceRequest.add_member(:service_connect_configuration, Shapes::ShapeRef.new(shape: ServiceConnectConfiguration, location_name: "serviceConnectConfiguration"))
     CreateServiceRequest.add_member(:volume_configurations, Shapes::ShapeRef.new(shape: ServiceVolumeConfigurations, location_name: "volumeConfigurations"))
     CreateServiceRequest.add_member(:vpc_lattice_configurations, Shapes::ShapeRef.new(shape: VpcLatticeConfigurations, location_name: "vpcLatticeConfigurations"))
+    CreateServiceRequest.add_member(:monitoring, Shapes::ShapeRef.new(shape: MonitoringConfiguration, location_name: "monitoring"))
     CreateServiceRequest.struct_class = Types::CreateServiceRequest
 
     CreateServiceResponse.add_member(:service, Shapes::ShapeRef.new(shape: Service, location_name: "service"))
@@ -2191,9 +2198,20 @@ module Aws::ECS
     MemoryMiBRequest.add_member(:max, Shapes::ShapeRef.new(shape: BoxedInteger, location_name: "max"))
     MemoryMiBRequest.struct_class = Types::MemoryMiBRequest
 
+    MetricConfiguration.add_member(:metric_names, Shapes::ShapeRef.new(shape: MetricNamesList, required: true, location_name: "metricNames"))
+    MetricConfiguration.add_member(:resolution_seconds, Shapes::ShapeRef.new(shape: MetricResolutionSeconds, required: true, location_name: "resolutionSeconds"))
+    MetricConfiguration.struct_class = Types::MetricConfiguration
+
+    MetricConfigurationList.member = Shapes::ShapeRef.new(shape: MetricConfiguration)
+
+    MetricNamesList.member = Shapes::ShapeRef.new(shape: MetricName)
+
     MissingVersionException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "message"))
     MissingVersionException.struct_class = Types::MissingVersionException
 
+    MonitoringConfiguration.add_member(:metric_configurations, Shapes::ShapeRef.new(shape: MetricConfigurationList, location_name: "metricConfigurations"))
+    MonitoringConfiguration.struct_class = Types::MonitoringConfiguration
+
     MountPoint.add_member(:source_volume, Shapes::ShapeRef.new(shape: String, location_name: "sourceVolume"))
     MountPoint.add_member(:container_path, Shapes::ShapeRef.new(shape: String, location_name: "containerPath"))
     MountPoint.add_member(:read_only, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "readOnly"))
@@ -2656,6 +2674,7 @@ module Aws::ECS
     ServiceRevision.add_member(:vpc_lattice_configurations, Shapes::ShapeRef.new(shape: VpcLatticeConfigurations, location_name: "vpcLatticeConfigurations"))
     ServiceRevision.add_member(:resolved_configuration, Shapes::ShapeRef.new(shape: ResolvedConfiguration, location_name: "resolvedConfiguration"))
     ServiceRevision.add_member(:ecs_managed_resources, Shapes::ShapeRef.new(shape: ECSManagedResources, location_name: "ecsManagedResources"))
+    ServiceRevision.add_member(:monitoring, Shapes::ShapeRef.new(shape: MonitoringConfiguration, location_name: "monitoring"))
     ServiceRevision.struct_class = Types::ServiceRevision
 
     ServiceRevisionLoadBalancer.add_member(:target_group_arn, Shapes::ShapeRef.new(shape: String, location_name: "targetGroupArn"))
@@ -3093,6 +3112,7 @@ module Aws::ECS
     UpdateServiceRequest.add_member(:service_connect_configuration, Shapes::ShapeRef.new(shape: ServiceConnectConfiguration, location_name: "serviceConnectConfiguration"))
     UpdateServiceRequest.add_member(:volume_configurations, Shapes::ShapeRef.new(shape: ServiceVolumeConfigurations, location_name: "volumeConfigurations"))
     UpdateServiceRequest.add_member(:vpc_lattice_configurations, Shapes::ShapeRef.new(shape: VpcLatticeConfigurations, location_name: "vpcLatticeConfigurations"))
+    UpdateServiceRequest.add_member(:monitoring, Shapes::ShapeRef.new(shape: MonitoringConfiguration, location_name: "monitoring"))
     UpdateServiceRequest.struct_class = Types::UpdateServiceRequest
 
     UpdateServiceResponse.add_member(:service, Shapes::ShapeRef.new(shape: Service, location_name: "service"))

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

@@ -3829,6 +3829,13 @@ module Aws::ECS
     #   The VPC Lattice configuration for the service being created.
     #   @return [Array<Types::VpcLatticeConfiguration>]
     #
+    # @!attribute [rw] monitoring
+    #   The optional monitoring configuration for the service, which defines
+    #   the resolution for the service-level `CPUUtilization` and
+    #   `MemoryUtilization` Amazon CloudWatch metrics. When not specified,
+    #   Amazon ECS uses the default resolution of `60` seconds.
+    #   @return [Types::MonitoringConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateServiceRequest AWS API Documentation
     #
     class CreateServiceRequest < Struct.new(
@@ -3857,7 +3864,8 @@ module Aws::ECS
       :enable_execute_command,
       :service_connect_configuration,
       :volume_configurations,
-      :vpc_lattice_configurations)
+      :vpc_lattice_configurations,
+      :monitoring)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -11675,6 +11683,28 @@ module Aws::ECS
       include Aws::Structure
     end
 
+    # The configuration for a specific set of metrics to collect for a
+    # service.
+    #
+    # @!attribute [rw] metric_names
+    #   The list of metric names to configure. The supported metric names
+    #   are `CPUUtilization` and `MemoryUtilization`.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] resolution_seconds
+    #   The resolution, in seconds, at which to collect the metrics. The
+    #   valid values are `20` and `60`.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/MetricConfiguration AWS API Documentation
+    #
+    class MetricConfiguration < Struct.new(
+      :metric_names,
+      :resolution_seconds)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Amazon ECS can't determine the current version of the Amazon ECS
     # container agent on the container instance and doesn't have enough
     # information to proceed with an update. This could be because the agent
@@ -11693,6 +11723,23 @@ module Aws::ECS
       include Aws::Structure
     end
 
+    # The optional monitoring configuration for a service, which defines the
+    # resolution for the service-level `CPUUtilization` and
+    # `MemoryUtilization` Amazon CloudWatch metrics. When not specified,
+    # Amazon ECS uses the default resolution of `60` seconds.
+    #
+    # @!attribute [rw] metric_configurations
+    #   The list of metric configurations for the service monitoring.
+    #   @return [Array<Types::MetricConfiguration>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/MonitoringConfiguration AWS API Documentation
+    #
+    class MonitoringConfiguration < Struct.new(
+      :metric_configurations)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The details for a volume mount point that's used in a container
     # definition.
     #
@@ -15853,6 +15900,13 @@ module Aws::ECS
     #   Express service for Amazon ECS.
     #   @return [Types::ECSManagedResources]
     #
+    # @!attribute [rw] monitoring
+    #   The optional monitoring configuration for the service, which defines
+    #   the resolution for the service-level `CPUUtilization` and
+    #   `MemoryUtilization` Amazon CloudWatch metrics. When not specified,
+    #   Amazon ECS uses the default resolution of `60` seconds.
+    #   @return [Types::MonitoringConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceRevision AWS API Documentation
     #
     class ServiceRevision < Struct.new(
@@ -15875,7 +15929,8 @@ module Aws::ECS
       :created_at,
       :vpc_lattice_configurations,
       :resolved_configuration,
-      :ecs_managed_resources)
+      :ecs_managed_resources,
+      :monitoring)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -19169,6 +19224,13 @@ module Aws::ECS
     #   This parameter triggers a new service deployment.
     #   @return [Array<Types::VpcLatticeConfiguration>]
     #
+    # @!attribute [rw] monitoring
+    #   The optional monitoring configuration for the service, which defines
+    #   the resolution for the service-level `CPUUtilization` and
+    #   `MemoryUtilization` Amazon CloudWatch metrics. When not specified,
+    #   Amazon ECS uses the default resolution of `60` seconds.
+    #   @return [Types::MonitoringConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateServiceRequest AWS API Documentation
     #
     class UpdateServiceRequest < Struct.new(
@@ -19193,7 +19255,8 @@ module Aws::ECS
       :service_registries,
       :service_connect_configuration,
       :volume_configurations,
-      :vpc_lattice_configurations)
+      :vpc_lattice_configurations,
+      :monitoring)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-ecs.rb

@@ -55,7 +55,7 @@ module Aws::ECS
   autoload :EndpointProvider, 'aws-sdk-ecs/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-ecs/endpoints'
 
-  GEM_VERSION = '1.237.0'
+  GEM_VERSION = '1.238.0'
 
 end
 

data/sig/client.rbs

@@ -325,7 +325,15 @@ module Aws
                                 target_group_arn: ::String,
                                 port_name: ::String
                               }
-                            ]
+                            ],
+                            ?monitoring: {
+                              metric_configurations: Array[
+                                {
+                                  metric_names: Array[::String],
+                                  resolution_seconds: ::Integer
+                                }
+                              ]?
+                            }
                           ) -> _CreateServiceResponseSuccess
                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateServiceResponseSuccess
 
@@ -1878,7 +1886,15 @@ module Aws
                                 target_group_arn: ::String,
                                 port_name: ::String
                               }
-                            ]
+                            ],
+                            ?monitoring: {
+                              metric_configurations: Array[
+                                {
+                                  metric_names: Array[::String],
+                                  resolution_seconds: ::Integer
+                                }
+                              ]?
+                            }
                           ) -> _UpdateServiceResponseSuccess
                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateServiceResponseSuccess
 

data/sig/types.rbs

@@ -470,6 +470,7 @@ module Aws::ECS
       attr_accessor service_connect_configuration: Types::ServiceConnectConfiguration
       attr_accessor volume_configurations: ::Array[Types::ServiceVolumeConfiguration]
       attr_accessor vpc_lattice_configurations: ::Array[Types::VpcLatticeConfiguration]
+      attr_accessor monitoring: Types::MonitoringConfiguration
       SENSITIVE: []
     end
 
@@ -1880,11 +1881,22 @@ module Aws::ECS
       SENSITIVE: []
     end
 
+    class MetricConfiguration
+      attr_accessor metric_names: ::Array[::String]
+      attr_accessor resolution_seconds: ::Integer
+      SENSITIVE: []
+    end
+
     class MissingVersionException
       attr_accessor message: ::String
       SENSITIVE: []
     end
 
+    class MonitoringConfiguration
+      attr_accessor metric_configurations: ::Array[Types::MetricConfiguration]
+      SENSITIVE: []
+    end
+
     class MountPoint
       attr_accessor source_volume: ::String
       attr_accessor container_path: ::String
@@ -2430,6 +2442,7 @@ module Aws::ECS
       attr_accessor vpc_lattice_configurations: ::Array[Types::VpcLatticeConfiguration]
       attr_accessor resolved_configuration: Types::ResolvedConfiguration
       attr_accessor ecs_managed_resources: Types::ECSManagedResources
+      attr_accessor monitoring: Types::MonitoringConfiguration
       SENSITIVE: []
     end
 
@@ -2938,6 +2951,7 @@ module Aws::ECS
       attr_accessor service_connect_configuration: Types::ServiceConnectConfiguration
       attr_accessor volume_configurations: ::Array[Types::ServiceVolumeConfiguration]
       attr_accessor vpc_lattice_configurations: ::Array[Types::VpcLatticeConfiguration]
+      attr_accessor monitoring: Types::MonitoringConfiguration
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ecs
 version: !ruby/object:Gem::Version
-  version: 1.237.0
+  version: 1.238.0
 platform: ruby
 authors:
 - Amazon Web Services