aws-sdk-ecs 1.184.0 → 1.185.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95a92434ae65cdab0f01ce7381d725e51d67f89427133b8e6024fadb2faa4421
-  data.tar.gz: 791c3b283811138b9557751dd57b8a30c86ccd648972c14af38a95c26c70a7cb
+  metadata.gz: 38b36fd18655c03f5aaa5e0fc9480552102fbd86936d7f99c5df56e07bc3410d
+  data.tar.gz: 03d61e712ac92d82f613cd2149524e5e00ca638962e6fc35e167149851f2716d
 SHA512:
-  metadata.gz: 64cac46eb09e28a3fd4d58a7681e98a3f88c0739ad3cd1a50ea50023f76d60f0e48158fb4d48cca257da3f577486d9a7f95ddfa463dac0a1871523688cac67da
-  data.tar.gz: a72060e68c5bc72ec6bc2c46211e8c369d53db6c7bd37828d377a08972e9ddb03b252a5dc6908d83fba2b4e18726324710b2debd118c5d6c1359608d35c630c5
+  metadata.gz: f29dd5c74908e40eda0c548c493c07390c5dbec200e549de3c3d2c14e7b1e20705db1727aa5fb27ac5f8b1c61642a59f1f932503b20d6aa21d2de075262f9c00
+  data.tar.gz: b39f6ef29070ec0be6325bf1552e8a57fa549dbda4fab10b27b8002503fb20317d19972c7e832ac831212cce0f872749c3c1377e51b1d0cfab82f3a3e8dbd3ec

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.185.0 (2025-04-23)
+------------------
+
+* Feature - Add support to roll back an In_Progress ECS Service Deployment
+
 1.184.0 (2025-04-17)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.184.0
+1.185.0

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

@@ -4188,7 +4188,7 @@ module Aws::ECS
     #   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 #=> String, one of "PENDING", "SUCCESSFUL", "STOPPED", "STOP_REQUESTED", "IN_PROGRESS", "ROLLBACK_REQUESTED", "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
@@ -6054,7 +6054,7 @@ module Aws::ECS
     #   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
+    #     status: ["PENDING"], # accepts PENDING, SUCCESSFUL, STOPPED, STOP_REQUESTED, IN_PROGRESS, ROLLBACK_REQUESTED, ROLLBACK_IN_PROGRESS, ROLLBACK_SUCCESSFUL, ROLLBACK_FAILED
     #     created_at: {
     #       before: Time.now,
     #       after: Time.now,
@@ -6073,7 +6073,7 @@ module Aws::ECS
     #   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 #=> String, one of "PENDING", "SUCCESSFUL", "STOPPED", "STOP_REQUESTED", "IN_PROGRESS", "ROLLBACK_REQUESTED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_SUCCESSFUL", "ROLLBACK_FAILED"
     #   resp.service_deployments[0].status_reason #=> String
     #   resp.next_token #=> String
     #
@@ -8682,6 +8682,9 @@ module Aws::ECS
     #   run your task on. If you do not specify a cluster, the default cluster
     #   is assumed.
     #
+    #   Each account receives a default cluster the first time you use the
+    #   service, but you may also create other clusters.
+    #
     # @option params [Integer] :count
     #   The number of instantiations of the specified task to place on your
     #   cluster. You can specify up to 10 tasks for each call.
@@ -9620,6 +9623,70 @@ module Aws::ECS
       req.send_request(options)
     end
 
+    # Stops an ongoing service deployment.
+    #
+    # The following stop types are avaiable:
+    #
+    # * ROLLBACK - This option rolls back the service deployment to the
+    #   previous service revision.
+    #
+    #   You can use this option even if you didn't configure the service
+    #   deployment for the rollback option.
+    #
+    # For more information, see [Stopping Amazon ECS service deployments][1]
+    # in the *Amazon Elastic Container Service Developer Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/stop-service-deployment.html
+    #
+    # @option params [required, String] :service_deployment_arn
+    #   The ARN of the service deployment that you want to stop.
+    #
+    # @option params [String] :stop_type
+    #   How you want Amazon ECS to stop the task.
+    #
+    #   The valid values are `ROLLBACK`.
+    #
+    # @return [Types::StopServiceDeploymentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StopServiceDeploymentResponse#service_deployment_arn #service_deployment_arn} => String
+    #
+    #
+    # @example Example: To stop a service deployment
+    #
+    #   # This example stops the service deployment using the ROLLBACK option.
+    #
+    #   resp = client.stop_service_deployment({
+    #     service_deployment_arn: "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r", 
+    #     stop_type: "ROLLBACK", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     service_deployment_arn: "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r", 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.stop_service_deployment({
+    #     service_deployment_arn: "String", # required
+    #     stop_type: "ABORT", # accepts ABORT, ROLLBACK
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.service_deployment_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/StopServiceDeployment AWS API Documentation
+    #
+    # @overload stop_service_deployment(params = {})
+    # @param [Hash] params ({})
+    def stop_service_deployment(params = {}, options = {})
+      req = build_request(:stop_service_deployment, params)
+      req.send_request(options)
+    end
+
     # Stops a running task. Any tags associated with the task will be
     # deleted.
     #
@@ -12466,7 +12533,7 @@ module Aws::ECS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.184.0'
+      context[:gem_version] = '1.185.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -325,6 +325,7 @@ module Aws::ECS
     ServiceDeploymentAlarms = Shapes::StructureShape.new(name: 'ServiceDeploymentAlarms')
     ServiceDeploymentBrief = Shapes::StructureShape.new(name: 'ServiceDeploymentBrief')
     ServiceDeploymentCircuitBreaker = Shapes::StructureShape.new(name: 'ServiceDeploymentCircuitBreaker')
+    ServiceDeploymentNotFoundException = Shapes::StructureShape.new(name: 'ServiceDeploymentNotFoundException')
     ServiceDeploymentRollbackMonitorsStatus = Shapes::StringShape.new(name: 'ServiceDeploymentRollbackMonitorsStatus')
     ServiceDeploymentStatus = Shapes::StringShape.new(name: 'ServiceDeploymentStatus')
     ServiceDeploymentStatusList = Shapes::ListShape.new(name: 'ServiceDeploymentStatusList')
@@ -356,6 +357,9 @@ module Aws::ECS
     StartTaskRequest = Shapes::StructureShape.new(name: 'StartTaskRequest')
     StartTaskResponse = Shapes::StructureShape.new(name: 'StartTaskResponse')
     Statistics = Shapes::ListShape.new(name: 'Statistics')
+    StopServiceDeploymentRequest = Shapes::StructureShape.new(name: 'StopServiceDeploymentRequest')
+    StopServiceDeploymentResponse = Shapes::StructureShape.new(name: 'StopServiceDeploymentResponse')
+    StopServiceDeploymentStopType = Shapes::StringShape.new(name: 'StopServiceDeploymentStopType')
     StopTaskRequest = Shapes::StructureShape.new(name: 'StopTaskRequest')
     StopTaskResponse = Shapes::StructureShape.new(name: 'StopTaskResponse')
     String = Shapes::StringShape.new(name: 'String')
@@ -1627,6 +1631,8 @@ module Aws::ECS
     ServiceDeploymentCircuitBreaker.add_member(:threshold, Shapes::ShapeRef.new(shape: Integer, location_name: "threshold"))
     ServiceDeploymentCircuitBreaker.struct_class = Types::ServiceDeploymentCircuitBreaker
 
+    ServiceDeploymentNotFoundException.struct_class = Types::ServiceDeploymentNotFoundException
+
     ServiceDeploymentStatusList.member = Shapes::ShapeRef.new(shape: ServiceDeploymentStatus)
 
     ServiceDeployments.member = Shapes::ShapeRef.new(shape: ServiceDeployment)
@@ -1738,6 +1744,13 @@ module Aws::ECS
 
     Statistics.member = Shapes::ShapeRef.new(shape: KeyValuePair)
 
+    StopServiceDeploymentRequest.add_member(:service_deployment_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "serviceDeploymentArn"))
+    StopServiceDeploymentRequest.add_member(:stop_type, Shapes::ShapeRef.new(shape: StopServiceDeploymentStopType, location_name: "stopType"))
+    StopServiceDeploymentRequest.struct_class = Types::StopServiceDeploymentRequest
+
+    StopServiceDeploymentResponse.add_member(:service_deployment_arn, Shapes::ShapeRef.new(shape: String, location_name: "serviceDeploymentArn"))
+    StopServiceDeploymentResponse.struct_class = Types::StopServiceDeploymentResponse
+
     StopTaskRequest.add_member(:cluster, Shapes::ShapeRef.new(shape: String, location_name: "cluster"))
     StopTaskRequest.add_member(:task, Shapes::ShapeRef.new(shape: String, required: true, location_name: "task"))
     StopTaskRequest.add_member(:reason, Shapes::ShapeRef.new(shape: String, location_name: "reason"))
@@ -2740,6 +2753,21 @@ module Aws::ECS
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedFeatureException)
       end)
 
+      api.add_operation(:stop_service_deployment, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StopServiceDeployment"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: StopServiceDeploymentRequest)
+        o.output = Shapes::ShapeRef.new(shape: StopServiceDeploymentResponse)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ClientException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceDeploymentNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedFeatureException)
+      end)
+
       api.add_operation(:stop_task, Seahorse::Model::Operation.new.tap do |o|
         o.name = "StopTask"
         o.http_method = "POST"

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

@@ -46,6 +46,7 @@ module Aws::ECS
   # * {ResourceInUseException}
   # * {ResourceNotFoundException}
   # * {ServerException}
+  # * {ServiceDeploymentNotFoundException}
   # * {ServiceNotActiveException}
   # * {ServiceNotFoundException}
   # * {TargetNotConnectedException}
@@ -265,6 +266,16 @@ module Aws::ECS
       end
     end
 
+    class ServiceDeploymentNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::ECS::Types::ServiceDeploymentNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class ServiceNotActiveException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -9012,6 +9012,9 @@ module Aws::ECS
     #   The short name or full Amazon Resource Name (ARN) of the cluster to
     #   run your task on. If you do not specify a cluster, the default
     #   cluster is assumed.
+    #
+    #   Each account receives a default cluster the first time you use the
+    #   service, but you may also create other clusters.
     #   @return [String]
     #
     # @!attribute [rw] count
@@ -10322,6 +10325,14 @@ module Aws::ECS
       include Aws::Structure
     end
 
+    # The service deploy ARN that you specified in the
+    # `StopServiceDeployment` doesn't exist. You can use
+    # `ListServiceDeployments` to retrieve the service deployment ARNs.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceDeploymentNotFoundException AWS API Documentation
+    #
+    class ServiceDeploymentNotFoundException < Aws::EmptyStructure; end
+
     # The details for an event that's associated with a service.
     #
     # @!attribute [rw] id
@@ -11054,6 +11065,37 @@ module Aws::ECS
       include Aws::Structure
     end
 
+    # @!attribute [rw] service_deployment_arn
+    #   The ARN of the service deployment that you want to stop.
+    #   @return [String]
+    #
+    # @!attribute [rw] stop_type
+    #   How you want Amazon ECS to stop the task.
+    #
+    #   The valid values are `ROLLBACK`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/StopServiceDeploymentRequest AWS API Documentation
+    #
+    class StopServiceDeploymentRequest < Struct.new(
+      :service_deployment_arn,
+      :stop_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] service_deployment_arn
+    #   The ARN of the stopped service deployment.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/StopServiceDeploymentResponse AWS API Documentation
+    #
+    class StopServiceDeploymentResponse < Struct.new(
+      :service_deployment_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster
     #   that hosts the task to stop. If you do not specify a cluster, the

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.184.0'
+  GEM_VERSION = '1.185.0'
 
 end
 

data/sig/client.rbs

@@ -705,7 +705,7 @@ module Aws
       def list_service_deployments: (
                                       service: ::String,
                                       ?cluster: ::String,
-                                      ?status: Array[("PENDING" | "SUCCESSFUL" | "STOPPED" | "STOP_REQUESTED" | "IN_PROGRESS" | "ROLLBACK_IN_PROGRESS" | "ROLLBACK_SUCCESSFUL" | "ROLLBACK_FAILED")],
+                                      ?status: Array[("PENDING" | "SUCCESSFUL" | "STOPPED" | "STOP_REQUESTED" | "IN_PROGRESS" | "ROLLBACK_REQUESTED" | "ROLLBACK_IN_PROGRESS" | "ROLLBACK_SUCCESSFUL" | "ROLLBACK_FAILED")],
                                       ?created_at: {
                                         before: ::Time?,
                                         after: ::Time?
@@ -1383,6 +1383,17 @@ module Aws
                       ) -> _StartTaskResponseSuccess
                     | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StartTaskResponseSuccess
 
+      interface _StopServiceDeploymentResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::StopServiceDeploymentResponse]
+        def service_deployment_arn: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ECS/Client.html#stop_service_deployment-instance_method
+      def stop_service_deployment: (
+                                     service_deployment_arn: ::String,
+                                     ?stop_type: ("ABORT" | "ROLLBACK")
+                                   ) -> _StopServiceDeploymentResponseSuccess
+                                 | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StopServiceDeploymentResponseSuccess
+
       interface _StopTaskResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::StopTaskResponse]
         def task: () -> Types::Task

data/sig/errors.rbs

@@ -52,6 +52,8 @@ module Aws
       class ServerException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class ServiceDeploymentNotFoundException < ::Aws::Errors::ServiceError
+      end
       class ServiceNotActiveException < ::Aws::Errors::ServiceError
       end
       class ServiceNotFoundException < ::Aws::Errors::ServiceError

data/sig/types.rbs

@@ -908,7 +908,7 @@ module Aws::ECS
     class ListServiceDeploymentsRequest
       attr_accessor service: ::String
       attr_accessor cluster: ::String
-      attr_accessor status: ::Array[("PENDING" | "SUCCESSFUL" | "STOPPED" | "STOP_REQUESTED" | "IN_PROGRESS" | "ROLLBACK_IN_PROGRESS" | "ROLLBACK_SUCCESSFUL" | "ROLLBACK_FAILED")]
+      attr_accessor status: ::Array[("PENDING" | "SUCCESSFUL" | "STOPPED" | "STOP_REQUESTED" | "IN_PROGRESS" | "ROLLBACK_REQUESTED" | "ROLLBACK_IN_PROGRESS" | "ROLLBACK_SUCCESSFUL" | "ROLLBACK_FAILED")]
       attr_accessor created_at: Types::CreatedAt
       attr_accessor next_token: ::String
       attr_accessor max_results: ::Integer
@@ -1406,7 +1406,7 @@ module Aws::ECS
       attr_accessor updated_at: ::Time
       attr_accessor source_service_revisions: ::Array[Types::ServiceRevisionSummary]
       attr_accessor target_service_revision: Types::ServiceRevisionSummary
-      attr_accessor status: ("PENDING" | "SUCCESSFUL" | "STOPPED" | "STOP_REQUESTED" | "IN_PROGRESS" | "ROLLBACK_IN_PROGRESS" | "ROLLBACK_SUCCESSFUL" | "ROLLBACK_FAILED")
+      attr_accessor status: ("PENDING" | "SUCCESSFUL" | "STOPPED" | "STOP_REQUESTED" | "IN_PROGRESS" | "ROLLBACK_REQUESTED" | "ROLLBACK_IN_PROGRESS" | "ROLLBACK_SUCCESSFUL" | "ROLLBACK_FAILED")
       attr_accessor status_reason: ::String
       attr_accessor deployment_configuration: Types::DeploymentConfiguration
       attr_accessor rollback: Types::Rollback
@@ -1430,7 +1430,7 @@ module Aws::ECS
       attr_accessor created_at: ::Time
       attr_accessor finished_at: ::Time
       attr_accessor target_service_revision_arn: ::String
-      attr_accessor status: ("PENDING" | "SUCCESSFUL" | "STOPPED" | "STOP_REQUESTED" | "IN_PROGRESS" | "ROLLBACK_IN_PROGRESS" | "ROLLBACK_SUCCESSFUL" | "ROLLBACK_FAILED")
+      attr_accessor status: ("PENDING" | "SUCCESSFUL" | "STOPPED" | "STOP_REQUESTED" | "IN_PROGRESS" | "ROLLBACK_REQUESTED" | "ROLLBACK_IN_PROGRESS" | "ROLLBACK_SUCCESSFUL" | "ROLLBACK_FAILED")
       attr_accessor status_reason: ::String
       SENSITIVE: []
     end
@@ -1442,6 +1442,9 @@ module Aws::ECS
       SENSITIVE: []
     end
 
+    class ServiceDeploymentNotFoundException < Aws::EmptyStructure
+    end
+
     class ServiceEvent
       attr_accessor id: ::String
       attr_accessor created_at: ::Time
@@ -1551,6 +1554,17 @@ module Aws::ECS
       SENSITIVE: []
     end
 
+    class StopServiceDeploymentRequest
+      attr_accessor service_deployment_arn: ::String
+      attr_accessor stop_type: ("ABORT" | "ROLLBACK")
+      SENSITIVE: []
+    end
+
+    class StopServiceDeploymentResponse
+      attr_accessor service_deployment_arn: ::String
+      SENSITIVE: []
+    end
+
     class StopTaskRequest
       attr_accessor cluster: ::String
       attr_accessor task: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ecs
 version: !ruby/object:Gem::Version
-  version: 1.184.0
+  version: 1.185.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-17 00:00:00.000000000 Z
+date: 2025-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core