aws-sdk-ecs 1.165.0 → 1.171.0

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

@@ -972,6 +972,18 @@ module Aws::ECS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html
     #
+    # @option params [String] :availability_zone_rebalancing
+    #   Indicates whether to use Availability Zone rebalancing for the
+    #   service.
+    #
+    #   For more information, see [Balancing an Amazon ECS service across
+    #   Availability Zones][1] in the *Amazon Elastic Container Service
+    #   Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html
+    #
     # @option params [Array<Types::LoadBalancer>] :load_balancers
     #   A load balancer object representing the load balancers to use with
     #   your service. For more information, see [Service load balancing][1] in
@@ -1164,26 +1176,18 @@ module Aws::ECS
     #
     # @option params [Integer] :health_check_grace_period_seconds
     #   The period of time, in seconds, that the Amazon ECS service scheduler
-    #   ignores unhealthy Elastic Load Balancing target health checks after a
-    #   task has first started. This is only used when your service is
-    #   configured to use a load balancer. If your service has a load balancer
-    #   defined and you don't specify a health check grace period value, the
-    #   default value of `0` is used.
-    #
-    #   If you do not use an Elastic Load Balancing, we recommend that you use
-    #   the `startPeriod` in the task definition health check parameters. For
-    #   more information, see [Health check][1].
-    #
-    #   If your service's tasks take a while to start and respond to Elastic
-    #   Load Balancing health checks, you can specify a health check grace
-    #   period of up to 2,147,483,647 seconds (about 69 years). During that
-    #   time, the Amazon ECS service scheduler ignores health check status.
-    #   This grace period can prevent the service scheduler from marking tasks
-    #   as unhealthy and stopping them before they have time to come up.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html
+    #   ignores unhealthy Elastic Load Balancing, VPC Lattice, and container
+    #   health checks after a task has first started. If you don't specify a
+    #   health check grace period value, the default value of `0` is used. If
+    #   you don't use any of the health checks, then
+    #   `healthCheckGracePeriodSeconds` is unused.
+    #
+    #   If your service's tasks take a while to start and respond to health
+    #   checks, you can specify a health check grace period of up to
+    #   2,147,483,647 seconds (about 69 years). During that time, the Amazon
+    #   ECS service scheduler ignores health check status. This grace period
+    #   can prevent the service scheduler from marking tasks as unhealthy and
+    #   stopping them before they have time to come up.
     #
     # @option params [String] :scheduling_strategy
     #   The scheduling strategy to use for the service. For more information,
@@ -1309,6 +1313,9 @@ module Aws::ECS
     #   volume that is configured at launch time. Currently, the only
     #   supported volume type is an Amazon EBS volume.
     #
+    # @option params [Array<Types::VpcLatticeConfiguration>] :vpc_lattice_configurations
+    #   The VPC Lattice configuration for the service being created.
+    #
     # @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateServiceResponse#service #service} => Types::Service
@@ -1437,6 +1444,7 @@ module Aws::ECS
     #     cluster: "String",
     #     service_name: "String", # required
     #     task_definition: "String",
+    #     availability_zone_rebalancing: "ENABLED", # accepts ENABLED, DISABLED
     #     load_balancers: [
     #       {
     #         target_group_arn: "String",
@@ -1474,8 +1482,8 @@ module Aws::ECS
     #       minimum_healthy_percent: 1,
     #       alarms: {
     #         alarm_names: ["String"], # required
-    #         enable: false, # required
     #         rollback: false, # required
+    #         enable: false, # required
     #       },
     #     },
     #     placement_constraints: [
@@ -1579,6 +1587,13 @@ module Aws::ECS
     #         },
     #       },
     #     ],
+    #     vpc_lattice_configurations: [
+    #       {
+    #         role_arn: "IAMRoleArn", # required
+    #         target_group_arn: "String", # required
+    #         port_name: "String", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -1614,8 +1629,8 @@ module Aws::ECS
     #   resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
     #   resp.service.deployment_configuration.alarms.alarm_names #=> Array
     #   resp.service.deployment_configuration.alarms.alarm_names[0] #=> String
-    #   resp.service.deployment_configuration.alarms.enable #=> Boolean
     #   resp.service.deployment_configuration.alarms.rollback #=> Boolean
+    #   resp.service.deployment_configuration.alarms.enable #=> Boolean
     #   resp.service.task_sets #=> Array
     #   resp.service.task_sets[0].id #=> String
     #   resp.service.task_sets[0].task_set_arn #=> String
@@ -1725,6 +1740,10 @@ module Aws::ECS
     #   resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
     #   resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
     #   resp.service.deployments[0].fargate_ephemeral_storage.kms_key_id #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations #=> Array
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].role_arn #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].target_group_arn #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].port_name #=> String
     #   resp.service.role_arn #=> String
     #   resp.service.events #=> Array
     #   resp.service.events[0].id #=> String
@@ -1752,6 +1771,7 @@ module Aws::ECS
     #   resp.service.enable_ecs_managed_tags #=> Boolean
     #   resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
     #   resp.service.enable_execute_command #=> Boolean
+    #   resp.service.availability_zone_rebalancing #=> String, one of "ENABLED", "DISABLED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateService AWS API Documentation
     #
@@ -2156,7 +2176,7 @@ module Aws::ECS
     #
     # <note markdown="1"> The `FARGATE` and `FARGATE_SPOT` capacity providers are reserved and
     # can't be deleted. You can disassociate them from a cluster using
-    # either [PutCapacityProviderProviders][1] or by deleting the cluster.
+    # either [PutClusterCapacityProviders][1] or by deleting the cluster.
     #
     #  </note>
     #
@@ -2169,12 +2189,12 @@ module Aws::ECS
     # transitioned to use the capacity from the remaining capacity
     # providers. Only capacity providers that aren't associated with a
     # cluster can be deleted. To remove a capacity provider from a cluster,
-    # you can either use [PutCapacityProviderProviders][1] or delete the
+    # you can either use [PutClusterCapacityProviders][1] or delete the
     # cluster.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProviderProviders.html
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutClusterCapacityProviders.html
     # [2]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html
     #
     # @option params [required, String] :capacity_provider
@@ -2425,8 +2445,8 @@ module Aws::ECS
     #   resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
     #   resp.service.deployment_configuration.alarms.alarm_names #=> Array
     #   resp.service.deployment_configuration.alarms.alarm_names[0] #=> String
-    #   resp.service.deployment_configuration.alarms.enable #=> Boolean
     #   resp.service.deployment_configuration.alarms.rollback #=> Boolean
+    #   resp.service.deployment_configuration.alarms.enable #=> Boolean
     #   resp.service.task_sets #=> Array
     #   resp.service.task_sets[0].id #=> String
     #   resp.service.task_sets[0].task_set_arn #=> String
@@ -2536,6 +2556,10 @@ module Aws::ECS
     #   resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
     #   resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
     #   resp.service.deployments[0].fargate_ephemeral_storage.kms_key_id #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations #=> Array
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].role_arn #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].target_group_arn #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].port_name #=> String
     #   resp.service.role_arn #=> String
     #   resp.service.events #=> Array
     #   resp.service.events[0].id #=> String
@@ -2563,6 +2587,7 @@ module Aws::ECS
     #   resp.service.enable_ecs_managed_tags #=> Boolean
     #   resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
     #   resp.service.enable_execute_command #=> Boolean
+    #   resp.service.availability_zone_rebalancing #=> String, one of "ENABLED", "DISABLED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteService AWS API Documentation
     #
@@ -2691,6 +2716,7 @@ module Aws::ECS
     #   resp.task_definitions[0].container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
     #   resp.task_definitions[0].container_definitions[0].start_timeout #=> Integer
     #   resp.task_definitions[0].container_definitions[0].stop_timeout #=> Integer
+    #   resp.task_definitions[0].container_definitions[0].version_consistency #=> String, one of "enabled", "disabled"
     #   resp.task_definitions[0].container_definitions[0].hostname #=> String
     #   resp.task_definitions[0].container_definitions[0].user #=> String
     #   resp.task_definitions[0].container_definitions[0].working_directory #=> String
@@ -3152,6 +3178,7 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
     #   resp.task_definition.container_definitions[0].start_timeout #=> Integer
     #   resp.task_definition.container_definitions[0].stop_timeout #=> Integer
+    #   resp.task_definition.container_definitions[0].version_consistency #=> String, one of "enabled", "disabled"
     #   resp.task_definition.container_definitions[0].hostname #=> String
     #   resp.task_definition.container_definitions[0].user #=> String
     #   resp.task_definition.container_definitions[0].working_directory #=> String
@@ -3353,6 +3380,12 @@ module Aws::ECS
 
     # Describes one or more of your clusters.
     #
+    # For CLI examples, see [describe-clusters.rst][1] on GitHub.
+    #
+    #
+    #
+    # [1]: https://github.com/aws/aws-cli/blob/develop/awscli/examples/ecs/describe-clusters.rst
+    #
     # @option params [Array<String>] :clusters
     #   A list of up to 100 cluster names or full cluster Amazon Resource Name
     #   (ARN) entries. If you do not specify a cluster, the default cluster is
@@ -3662,6 +3695,215 @@ module Aws::ECS
       req.send_request(options)
     end
 
+    # Describes one or more of your service deployments.
+    #
+    # A service deployment happens when you release a software update for
+    # the service. For more information, see [Amazon ECS service
+    # deployments][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployments.html
+    #
+    # @option params [required, Array<String>] :service_deployment_arns
+    #   The ARN of the service deployment.
+    #
+    #   You can specify a maximum of 20 ARNs.
+    #
+    # @return [Types::DescribeServiceDeploymentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeServiceDeploymentsResponse#service_deployments #service_deployments} => Array&lt;Types::ServiceDeployment&gt;
+    #   * {Types::DescribeServiceDeploymentsResponse#failures #failures} => Array&lt;Types::Failure&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_service_deployments({
+    #     service_deployment_arns: ["String"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.service_deployments #=> Array
+    #   resp.service_deployments[0].service_deployment_arn #=> String
+    #   resp.service_deployments[0].service_arn #=> String
+    #   resp.service_deployments[0].cluster_arn #=> String
+    #   resp.service_deployments[0].created_at #=> Time
+    #   resp.service_deployments[0].started_at #=> Time
+    #   resp.service_deployments[0].finished_at #=> Time
+    #   resp.service_deployments[0].stopped_at #=> Time
+    #   resp.service_deployments[0].updated_at #=> Time
+    #   resp.service_deployments[0].source_service_revisions #=> Array
+    #   resp.service_deployments[0].source_service_revisions[0].arn #=> String
+    #   resp.service_deployments[0].source_service_revisions[0].requested_task_count #=> Integer
+    #   resp.service_deployments[0].source_service_revisions[0].running_task_count #=> Integer
+    #   resp.service_deployments[0].source_service_revisions[0].pending_task_count #=> Integer
+    #   resp.service_deployments[0].target_service_revision.arn #=> String
+    #   resp.service_deployments[0].target_service_revision.requested_task_count #=> Integer
+    #   resp.service_deployments[0].target_service_revision.running_task_count #=> Integer
+    #   resp.service_deployments[0].target_service_revision.pending_task_count #=> Integer
+    #   resp.service_deployments[0].status #=> String, one of "PENDING", "SUCCESSFUL", "STOPPED", "STOP_REQUESTED", "IN_PROGRESS", "ROLLBACK_IN_PROGRESS", "ROLLBACK_SUCCESSFUL", "ROLLBACK_FAILED"
+    #   resp.service_deployments[0].status_reason #=> String
+    #   resp.service_deployments[0].deployment_configuration.deployment_circuit_breaker.enable #=> Boolean
+    #   resp.service_deployments[0].deployment_configuration.deployment_circuit_breaker.rollback #=> Boolean
+    #   resp.service_deployments[0].deployment_configuration.maximum_percent #=> Integer
+    #   resp.service_deployments[0].deployment_configuration.minimum_healthy_percent #=> Integer
+    #   resp.service_deployments[0].deployment_configuration.alarms.alarm_names #=> Array
+    #   resp.service_deployments[0].deployment_configuration.alarms.alarm_names[0] #=> String
+    #   resp.service_deployments[0].deployment_configuration.alarms.rollback #=> Boolean
+    #   resp.service_deployments[0].deployment_configuration.alarms.enable #=> Boolean
+    #   resp.service_deployments[0].rollback.reason #=> String
+    #   resp.service_deployments[0].rollback.started_at #=> Time
+    #   resp.service_deployments[0].rollback.service_revision_arn #=> String
+    #   resp.service_deployments[0].deployment_circuit_breaker.status #=> String, one of "TRIGGERED", "MONITORING", "MONITORING_COMPLETE", "DISABLED"
+    #   resp.service_deployments[0].deployment_circuit_breaker.failure_count #=> Integer
+    #   resp.service_deployments[0].deployment_circuit_breaker.threshold #=> Integer
+    #   resp.service_deployments[0].alarms.status #=> String, one of "TRIGGERED", "MONITORING", "MONITORING_COMPLETE", "DISABLED"
+    #   resp.service_deployments[0].alarms.alarm_names #=> Array
+    #   resp.service_deployments[0].alarms.alarm_names[0] #=> String
+    #   resp.service_deployments[0].alarms.triggered_alarm_names #=> Array
+    #   resp.service_deployments[0].alarms.triggered_alarm_names[0] #=> String
+    #   resp.failures #=> Array
+    #   resp.failures[0].arn #=> String
+    #   resp.failures[0].reason #=> String
+    #   resp.failures[0].detail #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeServiceDeployments AWS API Documentation
+    #
+    # @overload describe_service_deployments(params = {})
+    # @param [Hash] params ({})
+    def describe_service_deployments(params = {}, options = {})
+      req = build_request(:describe_service_deployments, params)
+      req.send_request(options)
+    end
+
+    # Describes one or more service revisions.
+    #
+    # A service revision is a version of the service that includes the
+    # values for the Amazon ECS resources (for example, task definition) and
+    # the environment resources (for example, load balancers, subnets, and
+    # security groups). For more information, see [Amazon ECS service
+    # revisions][1].
+    #
+    # You can't describe a service revision that was created before October
+    # 25, 2024.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-revision.html
+    #
+    # @option params [required, Array<String>] :service_revision_arns
+    #   The ARN of the service revision.
+    #
+    #   You can specify a maximum of 20 ARNs.
+    #
+    #   You can call [ListServiceDeployments][1] to get the ARNs.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListServiceDeployments.html
+    #
+    # @return [Types::DescribeServiceRevisionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeServiceRevisionsResponse#service_revisions #service_revisions} => Array&lt;Types::ServiceRevision&gt;
+    #   * {Types::DescribeServiceRevisionsResponse#failures #failures} => Array&lt;Types::Failure&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_service_revisions({
+    #     service_revision_arns: ["String"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.service_revisions #=> Array
+    #   resp.service_revisions[0].service_revision_arn #=> String
+    #   resp.service_revisions[0].service_arn #=> String
+    #   resp.service_revisions[0].cluster_arn #=> String
+    #   resp.service_revisions[0].task_definition #=> String
+    #   resp.service_revisions[0].capacity_provider_strategy #=> Array
+    #   resp.service_revisions[0].capacity_provider_strategy[0].capacity_provider #=> String
+    #   resp.service_revisions[0].capacity_provider_strategy[0].weight #=> Integer
+    #   resp.service_revisions[0].capacity_provider_strategy[0].base #=> Integer
+    #   resp.service_revisions[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
+    #   resp.service_revisions[0].platform_version #=> String
+    #   resp.service_revisions[0].platform_family #=> String
+    #   resp.service_revisions[0].load_balancers #=> Array
+    #   resp.service_revisions[0].load_balancers[0].target_group_arn #=> String
+    #   resp.service_revisions[0].load_balancers[0].load_balancer_name #=> String
+    #   resp.service_revisions[0].load_balancers[0].container_name #=> String
+    #   resp.service_revisions[0].load_balancers[0].container_port #=> Integer
+    #   resp.service_revisions[0].service_registries #=> Array
+    #   resp.service_revisions[0].service_registries[0].registry_arn #=> String
+    #   resp.service_revisions[0].service_registries[0].port #=> Integer
+    #   resp.service_revisions[0].service_registries[0].container_name #=> String
+    #   resp.service_revisions[0].service_registries[0].container_port #=> Integer
+    #   resp.service_revisions[0].network_configuration.awsvpc_configuration.subnets #=> Array
+    #   resp.service_revisions[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
+    #   resp.service_revisions[0].network_configuration.awsvpc_configuration.security_groups #=> Array
+    #   resp.service_revisions[0].network_configuration.awsvpc_configuration.security_groups[0] #=> String
+    #   resp.service_revisions[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
+    #   resp.service_revisions[0].container_images #=> Array
+    #   resp.service_revisions[0].container_images[0].container_name #=> String
+    #   resp.service_revisions[0].container_images[0].image_digest #=> String
+    #   resp.service_revisions[0].container_images[0].image #=> String
+    #   resp.service_revisions[0].guard_duty_enabled #=> Boolean
+    #   resp.service_revisions[0].service_connect_configuration.enabled #=> Boolean
+    #   resp.service_revisions[0].service_connect_configuration.namespace #=> String
+    #   resp.service_revisions[0].service_connect_configuration.services #=> Array
+    #   resp.service_revisions[0].service_connect_configuration.services[0].port_name #=> String
+    #   resp.service_revisions[0].service_connect_configuration.services[0].discovery_name #=> String
+    #   resp.service_revisions[0].service_connect_configuration.services[0].client_aliases #=> Array
+    #   resp.service_revisions[0].service_connect_configuration.services[0].client_aliases[0].port #=> Integer
+    #   resp.service_revisions[0].service_connect_configuration.services[0].client_aliases[0].dns_name #=> String
+    #   resp.service_revisions[0].service_connect_configuration.services[0].ingress_port_override #=> Integer
+    #   resp.service_revisions[0].service_connect_configuration.services[0].timeout.idle_timeout_seconds #=> Integer
+    #   resp.service_revisions[0].service_connect_configuration.services[0].timeout.per_request_timeout_seconds #=> Integer
+    #   resp.service_revisions[0].service_connect_configuration.services[0].tls.issuer_certificate_authority.aws_pca_authority_arn #=> String
+    #   resp.service_revisions[0].service_connect_configuration.services[0].tls.kms_key #=> String
+    #   resp.service_revisions[0].service_connect_configuration.services[0].tls.role_arn #=> String
+    #   resp.service_revisions[0].service_connect_configuration.log_configuration.log_driver #=> String, one of "json-file", "syslog", "journald", "gelf", "fluentd", "awslogs", "splunk", "awsfirelens"
+    #   resp.service_revisions[0].service_connect_configuration.log_configuration.options #=> Hash
+    #   resp.service_revisions[0].service_connect_configuration.log_configuration.options["String"] #=> String
+    #   resp.service_revisions[0].service_connect_configuration.log_configuration.secret_options #=> Array
+    #   resp.service_revisions[0].service_connect_configuration.log_configuration.secret_options[0].name #=> String
+    #   resp.service_revisions[0].service_connect_configuration.log_configuration.secret_options[0].value_from #=> String
+    #   resp.service_revisions[0].volume_configurations #=> Array
+    #   resp.service_revisions[0].volume_configurations[0].name #=> String
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.encrypted #=> Boolean
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.kms_key_id #=> String
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.volume_type #=> String
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.size_in_gi_b #=> Integer
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.snapshot_id #=> String
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.iops #=> Integer
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.throughput #=> Integer
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications #=> Array
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].resource_type #=> String, one of "volume"
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags #=> Array
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags[0].key #=> String
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags[0].value #=> String
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
+    #   resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
+    #   resp.service_revisions[0].fargate_ephemeral_storage.kms_key_id #=> String
+    #   resp.service_revisions[0].created_at #=> Time
+    #   resp.service_revisions[0].vpc_lattice_configurations #=> Array
+    #   resp.service_revisions[0].vpc_lattice_configurations[0].role_arn #=> String
+    #   resp.service_revisions[0].vpc_lattice_configurations[0].target_group_arn #=> String
+    #   resp.service_revisions[0].vpc_lattice_configurations[0].port_name #=> String
+    #   resp.failures #=> Array
+    #   resp.failures[0].arn #=> String
+    #   resp.failures[0].reason #=> String
+    #   resp.failures[0].detail #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeServiceRevisions AWS API Documentation
+    #
+    # @overload describe_service_revisions(params = {})
+    # @param [Hash] params ({})
+    def describe_service_revisions(params = {}, options = {})
+      req = build_request(:describe_service_revisions, params)
+      req.send_request(options)
+    end
+
     # Describes the specified services running in your cluster.
     #
     # @option params [String] :cluster
@@ -3782,8 +4024,8 @@ module Aws::ECS
     #   resp.services[0].deployment_configuration.minimum_healthy_percent #=> Integer
     #   resp.services[0].deployment_configuration.alarms.alarm_names #=> Array
     #   resp.services[0].deployment_configuration.alarms.alarm_names[0] #=> String
-    #   resp.services[0].deployment_configuration.alarms.enable #=> Boolean
     #   resp.services[0].deployment_configuration.alarms.rollback #=> Boolean
+    #   resp.services[0].deployment_configuration.alarms.enable #=> Boolean
     #   resp.services[0].task_sets #=> Array
     #   resp.services[0].task_sets[0].id #=> String
     #   resp.services[0].task_sets[0].task_set_arn #=> String
@@ -3893,6 +4135,10 @@ module Aws::ECS
     #   resp.services[0].deployments[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
     #   resp.services[0].deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
     #   resp.services[0].deployments[0].fargate_ephemeral_storage.kms_key_id #=> String
+    #   resp.services[0].deployments[0].vpc_lattice_configurations #=> Array
+    #   resp.services[0].deployments[0].vpc_lattice_configurations[0].role_arn #=> String
+    #   resp.services[0].deployments[0].vpc_lattice_configurations[0].target_group_arn #=> String
+    #   resp.services[0].deployments[0].vpc_lattice_configurations[0].port_name #=> String
     #   resp.services[0].role_arn #=> String
     #   resp.services[0].events #=> Array
     #   resp.services[0].events[0].id #=> String
@@ -3920,6 +4166,7 @@ module Aws::ECS
     #   resp.services[0].enable_ecs_managed_tags #=> Boolean
     #   resp.services[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
     #   resp.services[0].enable_execute_command #=> Boolean
+    #   resp.services[0].availability_zone_rebalancing #=> String, one of "ENABLED", "DISABLED"
     #   resp.failures #=> Array
     #   resp.failures[0].arn #=> String
     #   resp.failures[0].reason #=> String
@@ -4102,6 +4349,7 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
     #   resp.task_definition.container_definitions[0].start_timeout #=> Integer
     #   resp.task_definition.container_definitions[0].stop_timeout #=> Integer
+    #   resp.task_definition.container_definitions[0].version_consistency #=> String, one of "enabled", "disabled"
     #   resp.task_definition.container_definitions[0].hostname #=> String
     #   resp.task_definition.container_definitions[0].user #=> String
     #   resp.task_definition.container_definitions[0].working_directory #=> String
@@ -4330,9 +4578,8 @@ module Aws::ECS
     # @option params [String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster that
     #   hosts the task or tasks to describe. If you do not specify a cluster,
-    #   the default cluster is assumed. This parameter is required if the task
-    #   or tasks you are describing were launched in any cluster other than
-    #   the default cluster.
+    #   the default cluster is assumed. This parameter is required. If you do
+    #   not specify a value, the `default` cluster is used.
     #
     # @option params [required, Array<String>] :tasks
     #   A list of up to 100 task IDs or full ARN entries.
@@ -5127,6 +5374,100 @@ module Aws::ECS
       req.send_request(options)
     end
 
+    # This operation lists all the service deployments that meet the
+    # specified filter criteria.
+    #
+    # A service deployment happens when you release a softwre update for the
+    # service. You route traffic from the running service revisions to the
+    # new service revison and control the number of running tasks.
+    #
+    # This API returns the values that you use for the request parameters in
+    # [DescribeServiceRevisions][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeServiceRevisions.html
+    #
+    # @option params [required, String] :service
+    #   The ARN or name of the service
+    #
+    # @option params [String] :cluster
+    #   The cluster that hosts the service. This can either be the cluster
+    #   name or ARN. Starting April 15, 2023, Amazon Web Services will not
+    #   onboard new customers to Amazon Elastic Inference (EI), and will help
+    #   current customers migrate their workloads to options that offer better
+    #   price and performanceIf you don't specify a cluster, `default` is
+    #   used.
+    #
+    # @option params [Array<String>] :status
+    #   An optional filter you can use to narrow the results. If you do not
+    #   specify a status, then all status values are included in the result.
+    #
+    # @option params [Types::CreatedAt] :created_at
+    #   An optional filter you can use to narrow the results by the service
+    #   creation date. If you do not specify a value, the result includes all
+    #   services created before the current time. The format is yyyy-MM-dd
+    #   HH:mm:ss.SSSSSS.
+    #
+    # @option params [String] :next_token
+    #   The `nextToken` value returned from a `ListServiceDeployments` request
+    #   indicating that more results are available to fulfill the request and
+    #   further calls are needed. If you provided `maxResults`, it's possible
+    #   the number of results is fewer than `maxResults`.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of service deployment results that
+    #   `ListServiceDeployments` returned in paginated output. When this
+    #   parameter is used, `ListServiceDeployments` only returns `maxResults`
+    #   results in a single page along with a `nextToken` response element.
+    #   The remaining results of the initial request can be seen by sending
+    #   another `ListServiceDeployments` request with the returned `nextToken`
+    #   value. This value can be between 1 and 100. If this parameter isn't
+    #   used, then `ListServiceDeployments` returns up to 20 results and a
+    #   `nextToken` value if applicable.
+    #
+    # @return [Types::ListServiceDeploymentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListServiceDeploymentsResponse#service_deployments #service_deployments} => Array&lt;Types::ServiceDeploymentBrief&gt;
+    #   * {Types::ListServiceDeploymentsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_service_deployments({
+    #     service: "String", # required
+    #     cluster: "String",
+    #     status: ["PENDING"], # accepts PENDING, SUCCESSFUL, STOPPED, STOP_REQUESTED, IN_PROGRESS, ROLLBACK_IN_PROGRESS, ROLLBACK_SUCCESSFUL, ROLLBACK_FAILED
+    #     created_at: {
+    #       before: Time.now,
+    #       after: Time.now,
+    #     },
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.service_deployments #=> Array
+    #   resp.service_deployments[0].service_deployment_arn #=> String
+    #   resp.service_deployments[0].service_arn #=> String
+    #   resp.service_deployments[0].cluster_arn #=> String
+    #   resp.service_deployments[0].started_at #=> Time
+    #   resp.service_deployments[0].created_at #=> Time
+    #   resp.service_deployments[0].finished_at #=> Time
+    #   resp.service_deployments[0].target_service_revision_arn #=> String
+    #   resp.service_deployments[0].status #=> String, one of "PENDING", "SUCCESSFUL", "STOPPED", "STOP_REQUESTED", "IN_PROGRESS", "ROLLBACK_IN_PROGRESS", "ROLLBACK_SUCCESSFUL", "ROLLBACK_FAILED"
+    #   resp.service_deployments[0].status_reason #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ListServiceDeployments AWS API Documentation
+    #
+    # @overload list_service_deployments(params = {})
+    # @param [Hash] params ({})
+    def list_service_deployments(params = {}, options = {})
+      req = build_request(:list_service_deployments, params)
+      req.send_request(options)
+    end
+
     # Returns a list of services. You can filter the results by cluster,
     # launch type, and scheduling strategy.
     #
@@ -5769,12 +6110,25 @@ module Aws::ECS
     #     Network Interface Trunking][1] in the *Amazon Elastic Container
     #     Service Developer Guide*.
     #
-    #   * `containerInsights` - When modified, the default setting indicating
-    #     whether Amazon Web Services CloudWatch Container Insights is turned
-    #     on for your clusters is changed. If `containerInsights` is turned
-    #     on, any new clusters that are created will have Container Insights
-    #     turned on unless you disable it during cluster creation. For more
-    #     information, see [CloudWatch Container Insights][2] in the *Amazon
+    #   * `containerInsights` - Container Insights with enhanced observability
+    #     provides all the Container Insights metrics, plus additional task
+    #     and container metrics. This version supports enhanced observability
+    #     for Amazon ECS clusters using the Amazon EC2 and Fargate launch
+    #     types. After you configure Container Insights with enhanced
+    #     observability on Amazon ECS, Container Insights auto-collects
+    #     detailed infrastructure telemetry from the cluster level down to the
+    #     container level in your environment and displays these critical
+    #     performance data in curated dashboards removing the heavy lifting in
+    #     observability set-up.
+    #
+    #     To use Container Insights with enhanced observability, set the
+    #     `containerInsights` account setting to `enhanced`.
+    #
+    #     To use Container Insights, set the `containerInsights` account
+    #     setting to `enabled`.
+    #
+    #     For more information, see [Monitor Amazon ECS containers using
+    #     Container Insights with enhanced observability][2] in the *Amazon
     #     Elastic Container Service Developer Guide*.
     #
     #   * `dualStackIPv6` - When turned on, when using a VPC in dual stack
@@ -5822,7 +6176,7 @@ module Aws::ECS
     #
     # @option params [required, String] :value
     #   The account setting value for the specified principal ARN. Accepted
-    #   values are `enabled`, `disabled`, `on`, and `off`.
+    #   values are `enabled`, `disabled`, `enhanced`, `on`, and `off`.
     #
     #   When you specify `fargateTaskRetirementWaitPeriod` for the `name`, the
     #   following are the valid values:
@@ -5965,12 +6319,25 @@ module Aws::ECS
     #     Network Interface Trunking][1] in the *Amazon Elastic Container
     #     Service Developer Guide*.
     #
-    #   * `containerInsights` - When modified, the default setting indicating
-    #     whether Amazon Web Services CloudWatch Container Insights is turned
-    #     on for your clusters is changed. If `containerInsights` is turned
-    #     on, any new clusters that are created will have Container Insights
-    #     turned on unless you disable it during cluster creation. For more
-    #     information, see [CloudWatch Container Insights][2] in the *Amazon
+    #   * `containerInsights` - Container Insights with enhanced observability
+    #     provides all the Container Insights metrics, plus additional task
+    #     and container metrics. This version supports enhanced observability
+    #     for Amazon ECS clusters using the Amazon EC2 and Fargate launch
+    #     types. After you configure Container Insights with enhanced
+    #     observability on Amazon ECS, Container Insights auto-collects
+    #     detailed infrastructure telemetry from the cluster level down to the
+    #     container level in your environment and displays these critical
+    #     performance data in curated dashboards removing the heavy lifting in
+    #     observability set-up.
+    #
+    #     To use Container Insights with enhanced observability, set the
+    #     `containerInsights` account setting to `enhanced`.
+    #
+    #     To use Container Insights, set the `containerInsights` account
+    #     setting to `enabled`.
+    #
+    #     For more information, see [Monitor Amazon ECS containers using
+    #     Container Insights with enhanced observability][2] in the *Amazon
     #     Elastic Container Service Developer Guide*.
     #
     #   * `dualStackIPv6` - When turned on, when using a VPC in dual stack
@@ -6021,7 +6388,7 @@ module Aws::ECS
     #
     # @option params [required, String] :value
     #   The account setting value for the specified principal ARN. Accepted
-    #   values are `enabled`, `disabled`, `on`, and `off`.
+    #   values are `enabled`, `disabled`, `on`, `enhanced`, and `off`.
     #
     #   When you specify `fargateTaskRetirementWaitPeriod` for the `name`, the
     #   following are the valid values:
@@ -6981,6 +7348,7 @@ module Aws::ECS
     #         ],
     #         start_timeout: 1,
     #         stop_timeout: 1,
+    #         version_consistency: "enabled", # accepts enabled, disabled
     #         hostname: "String",
     #         user: "String",
     #         working_directory: "String",
@@ -7195,6 +7563,7 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
     #   resp.task_definition.container_definitions[0].start_timeout #=> Integer
     #   resp.task_definition.container_definitions[0].stop_timeout #=> Integer
+    #   resp.task_definition.container_definitions[0].version_consistency #=> String, one of "enabled", "disabled"
     #   resp.task_definition.container_definitions[0].hostname #=> String
     #   resp.task_definition.container_definitions[0].user #=> String
     #   resp.task_definition.container_definitions[0].working_directory #=> String
@@ -9541,6 +9910,18 @@ module Aws::ECS
     #   Optional deployment parameters that control how many tasks run during
     #   the deployment and the ordering of stopping and starting tasks.
     #
+    # @option params [String] :availability_zone_rebalancing
+    #   Indicates whether to use Availability Zone rebalancing for the
+    #   service.
+    #
+    #   For more information, see [Balancing an Amazon ECS service across
+    #   Availability Zones][1] in the *Amazon Elastic Container Service
+    #   Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html
+    #
     # @option params [Types::NetworkConfiguration] :network_configuration
     #   An object representing the network configuration for the service.
     #
@@ -9585,14 +9966,17 @@ module Aws::ECS
     #
     # @option params [Integer] :health_check_grace_period_seconds
     #   The period of time, in seconds, that the Amazon ECS service scheduler
-    #   ignores unhealthy Elastic Load Balancing target health checks after a
-    #   task has first started. This is only valid if your service is
-    #   configured to use a load balancer. If your service's tasks take a
-    #   while to start and respond to Elastic Load Balancing health checks,
-    #   you can specify a health check grace period of up to 2,147,483,647
-    #   seconds. During that time, the Amazon ECS service scheduler ignores
-    #   the Elastic Load Balancing health check status. This grace period can
-    #   prevent the ECS service scheduler from marking tasks as unhealthy and
+    #   ignores unhealthy Elastic Load Balancing, VPC Lattice, and container
+    #   health checks after a task has first started. If you don't specify a
+    #   health check grace period value, the default value of `0` is used. If
+    #   you don't use any of the health checks, then
+    #   `healthCheckGracePeriodSeconds` is unused.
+    #
+    #   If your service's tasks take a while to start and respond to health
+    #   checks, you can specify a health check grace period of up to
+    #   2,147,483,647 seconds (about 69 years). During that time, the Amazon
+    #   ECS service scheduler ignores health check status. This grace period
+    #   can prevent the service scheduler from marking tasks as unhealthy and
     #   stopping them before they have time to come up.
     #
     # @option params [Boolean] :enable_execute_command
@@ -9706,6 +10090,10 @@ module Aws::ECS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ServiceManagedEBSVolumeConfiguration.html
     #
+    # @option params [Array<Types::VpcLatticeConfiguration>] :vpc_lattice_configurations
+    #   An object representing the VPC Lattice configuration for the service
+    #   being updated.
+    #
     # @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateServiceResponse#service #service} => Types::Service
@@ -9760,10 +10148,11 @@ module Aws::ECS
     #       minimum_healthy_percent: 1,
     #       alarms: {
     #         alarm_names: ["String"], # required
-    #         enable: false, # required
     #         rollback: false, # required
+    #         enable: false, # required
     #       },
     #     },
+    #     availability_zone_rebalancing: "ENABLED", # accepts ENABLED, DISABLED
     #     network_configuration: {
     #       awsvpc_configuration: {
     #         subnets: ["String"], # required
@@ -9873,6 +10262,13 @@ module Aws::ECS
     #         },
     #       },
     #     ],
+    #     vpc_lattice_configurations: [
+    #       {
+    #         role_arn: "IAMRoleArn", # required
+    #         target_group_arn: "String", # required
+    #         port_name: "String", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -9908,8 +10304,8 @@ module Aws::ECS
     #   resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
     #   resp.service.deployment_configuration.alarms.alarm_names #=> Array
     #   resp.service.deployment_configuration.alarms.alarm_names[0] #=> String
-    #   resp.service.deployment_configuration.alarms.enable #=> Boolean
     #   resp.service.deployment_configuration.alarms.rollback #=> Boolean
+    #   resp.service.deployment_configuration.alarms.enable #=> Boolean
     #   resp.service.task_sets #=> Array
     #   resp.service.task_sets[0].id #=> String
     #   resp.service.task_sets[0].task_set_arn #=> String
@@ -10019,6 +10415,10 @@ module Aws::ECS
     #   resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
     #   resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
     #   resp.service.deployments[0].fargate_ephemeral_storage.kms_key_id #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations #=> Array
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].role_arn #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].target_group_arn #=> String
+    #   resp.service.deployments[0].vpc_lattice_configurations[0].port_name #=> String
     #   resp.service.role_arn #=> String
     #   resp.service.events #=> Array
     #   resp.service.events[0].id #=> String
@@ -10046,6 +10446,7 @@ module Aws::ECS
     #   resp.service.enable_ecs_managed_tags #=> Boolean
     #   resp.service.propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
     #   resp.service.enable_execute_command #=> Boolean
+    #   resp.service.availability_zone_rebalancing #=> String, one of "ENABLED", "DISABLED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateService AWS API Documentation
     #
@@ -10432,7 +10833,7 @@ module Aws::ECS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.165.0'
+      context[:gem_version] = '1.171.0'
       Seahorse::Client::Request.new(handlers, context)
     end