aws-sdk-ecs 1.152.0 → 1.153.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 760912f7aedf1fe350d8d670e032df818bd93ec1fa07879f27e48460d680782a
-  data.tar.gz: dfce34693986030fe358df790e223479c6267eb3ada28cbb36ae03cb27db9b6c
+  metadata.gz: 93ed3e7df1cbd25815a7d9537e41771a006a65f3556917d4edfca405ed509563
+  data.tar.gz: 69fbffb5733e5e7e76da34d91936759af4df0ea368cda19e35e968c5fea8b0c7
 SHA512:
-  metadata.gz: a459988b0e207f68d2e9038419b754dc98faf1f0ac8cb5ee03f5aa2cf78c9777c5d0b059992a9970af210d60ee848a5a30f04892745e336618ddbd7d653b7697
-  data.tar.gz: 4b87c7f936b078b2a2e0eb62018c83c0175a319315c7aab9f2fadd7c0afb2d95254028ec32b546161054c8a0ffa5cbc2b2db02bd3b82eafc6ce52c268e92fee4
+  metadata.gz: 7ebd984cf41fa8096ae0a6c0408b44a29f41ef462652b3ea5c4897926a5479f918ad910d358f02655f00733f652be67254c7869346695da6233be650c92657fd
+  data.tar.gz: 6212f970998f5d9046a2adac806f8d7d039d59670764f14c01b6f3e173087e02d9a9c13fc4e5d1dead17123f8f35a51a3cedf9325b4058e1ec5e40bb9f291ab0

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.153.0 (2024-08-15)
+------------------
+
+* Feature - This release introduces a new ContainerDefinition configuration to support the customer-managed keys for ECS container restart feature.
+
 1.152.0 (2024-08-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.152.0
+1.153.0

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

@@ -1749,7 +1749,7 @@ module Aws::ECS
     #
     #  </note>
     #
-    # For information about the maximum number of task sets and otther
+    # For information about the maximum number of task sets and other
     # quotas, see [Amazon ECS service quotas][2] in the *Amazon Elastic
     # Container Service Developer Guide*.
     #
@@ -2596,6 +2596,10 @@ module Aws::ECS
     #   resp.task_definitions[0].container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
     #   resp.task_definitions[0].container_definitions[0].port_mappings[0].container_port_range #=> String
     #   resp.task_definitions[0].container_definitions[0].essential #=> Boolean
+    #   resp.task_definitions[0].container_definitions[0].restart_policy.enabled #=> Boolean
+    #   resp.task_definitions[0].container_definitions[0].restart_policy.ignored_exit_codes #=> Array
+    #   resp.task_definitions[0].container_definitions[0].restart_policy.ignored_exit_codes[0] #=> Integer
+    #   resp.task_definitions[0].container_definitions[0].restart_policy.restart_attempt_period #=> Integer
     #   resp.task_definitions[0].container_definitions[0].entry_point #=> Array
     #   resp.task_definitions[0].container_definitions[0].entry_point[0] #=> String
     #   resp.task_definitions[0].container_definitions[0].command #=> Array
@@ -3053,6 +3057,10 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
     #   resp.task_definition.container_definitions[0].port_mappings[0].container_port_range #=> String
     #   resp.task_definition.container_definitions[0].essential #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.enabled #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes #=> Array
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes[0] #=> Integer
+    #   resp.task_definition.container_definitions[0].restart_policy.restart_attempt_period #=> Integer
     #   resp.task_definition.container_definitions[0].entry_point #=> Array
     #   resp.task_definition.container_definitions[0].entry_point[0] #=> String
     #   resp.task_definition.container_definitions[0].command #=> Array
@@ -3999,6 +4007,10 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
     #   resp.task_definition.container_definitions[0].port_mappings[0].container_port_range #=> String
     #   resp.task_definition.container_definitions[0].essential #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.enabled #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes #=> Array
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes[0] #=> Integer
+    #   resp.task_definition.container_definitions[0].restart_policy.restart_attempt_period #=> Integer
     #   resp.task_definition.container_definitions[0].entry_point #=> Array
     #   resp.task_definition.container_definitions[0].entry_point[0] #=> String
     #   resp.task_definition.container_definitions[0].command #=> Array
@@ -6405,21 +6417,18 @@ module Aws::ECS
     # Tasks][2] in the *Amazon Elastic Container Service Developer Guide*.
     #
     # You can specify a Docker networking mode for the containers in your
-    # task definition with the `networkMode` parameter. The available
-    # network modes correspond to those described in [Network settings][3]
-    # in the Docker run reference. If you specify the `awsvpc` network mode,
-    # the task is allocated an elastic network interface, and you must
-    # specify a NetworkConfiguration when you create a service or run a task
-    # with the task definition. For more information, see [Task
-    # Networking][4] in the *Amazon Elastic Container Service Developer
-    # Guide*.
+    # task definition with the `networkMode` parameter. If you specify the
+    # `awsvpc` network mode, the task is allocated an elastic network
+    # interface, and you must specify a NetworkConfiguration when you create
+    # a service or run a task with the task definition. For more
+    # information, see [Task Networking][3] in the *Amazon Elastic Container
+    # Service Developer Guide*.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html
     # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html
-    # [3]: https://docs.docker.com/engine/reference/run/#/network-settings
-    # [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
+    # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
     #
     # @option params [required, String] :family
     #   You must specify a `family` for a task definition. You can use it
@@ -6441,14 +6450,13 @@ module Aws::ECS
     # @option params [String] :execution_role_arn
     #   The Amazon Resource Name (ARN) of the task execution role that grants
     #   the Amazon ECS container agent permission to make Amazon Web Services
-    #   API calls on your behalf. The task execution IAM role is required
-    #   depending on the requirements of your task. For more information, see
-    #   [Amazon ECS task execution IAM role][1] in the *Amazon Elastic
-    #   Container Service Developer Guide*.
+    #   API calls on your behalf. For informationabout the required IAM roles
+    #   for Amazon ECS, see [IAM roles for Amazon ECS][1] in the *Amazon
+    #   Elastic Container Service Developer Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_execution_IAM_role.html
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security-ecs-iam-role-overview.html
     #
     # @option params [String] :network_mode
     #   The Docker networking mode to use for the containers in the task. The
@@ -6477,22 +6485,19 @@ module Aws::ECS
     #   non-root user.
     #
     #   If the network mode is `awsvpc`, the task is allocated an elastic
-    #   network interface, and you must specify a NetworkConfiguration value
-    #   when you create a service or run a task with the task definition. For
-    #   more information, see [Task Networking][1] in the *Amazon Elastic
-    #   Container Service Developer Guide*.
+    #   network interface, and you must specify a [NetworkConfiguration][1]
+    #   value when you create a service or run a task with the task
+    #   definition. For more information, see [Task Networking][2] in the
+    #   *Amazon Elastic Container Service Developer Guide*.
     #
     #   If the network mode is `host`, you cannot run multiple instantiations
     #   of the same task on a single container instance when port mappings are
     #   used.
     #
-    #   For more information, see [Network settings][2] in the *Docker run
-    #   reference*.
     #
     #
-    #
-    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
-    #   [2]: https://docs.docker.com/engine/reference/run/#network-settings
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_NetworkConfiguration.html
+    #   [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
     #
     # @option params [required, Array<Types::ContainerDefinition>] :container_definitions
     #   A list of container definitions in JSON format that describe the
@@ -6655,12 +6660,10 @@ module Aws::ECS
     #   the same process namespace.
     #
     #   If no value is specified, the default is a private namespace for each
-    #   container. For more information, see [PID settings][1] in the *Docker
-    #   run reference*.
+    #   container.
     #
     #   If the `host` PID mode is used, there's a heightened risk of
-    #   undesired process namespace exposure. For more information, see
-    #   [Docker security][2].
+    #   undesired process namespace exposure.
     #
     #   <note markdown="1"> This parameter is not supported for Windows containers.
     #
@@ -6672,11 +6675,6 @@ module Aws::ECS
     #
     #    </note>
     #
-    #
-    #
-    #   [1]: https://docs.docker.com/engine/reference/run/#pid-settings---pid
-    #   [2]: https://docs.docker.com/engine/security/security/
-    #
     # @option params [String] :ipc_mode
     #   The IPC resource namespace to use for the containers in the task. The
     #   valid values are `host`, `task`, or `none`. If `host` is specified,
@@ -6688,16 +6686,14 @@ module Aws::ECS
     #   private and not shared with other containers in a task or on the
     #   container instance. If no value is specified, then the IPC resource
     #   namespace sharing depends on the Docker daemon setting on the
-    #   container instance. For more information, see [IPC settings][1] in the
-    #   *Docker run reference*.
+    #   container instance.
     #
     #   If the `host` IPC mode is used, be aware that there is a heightened
-    #   risk of undesired IPC namespace expose. For more information, see
-    #   [Docker security][2].
+    #   risk of undesired IPC namespace expose.
     #
     #   If you are setting namespaced kernel parameters using `systemControls`
     #   for the containers in the task, the following will apply to your IPC
-    #   resource namespace. For more information, see [System Controls][3] in
+    #   resource namespace. For more information, see [System Controls][1] in
     #   the *Amazon Elastic Container Service Developer Guide*.
     #
     #   * For tasks that use the `host` IPC mode, IPC namespace related
@@ -6713,9 +6709,7 @@ module Aws::ECS
     #
     #
     #
-    #   [1]: https://docs.docker.com/engine/reference/run/#ipc-settings---ipc
-    #   [2]: https://docs.docker.com/engine/security/security/
-    #   [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html
     #
     # @option params [Types::ProxyConfiguration] :proxy_configuration
     #   The configuration details for the App Mesh proxy.
@@ -6852,6 +6846,11 @@ module Aws::ECS
     #           },
     #         ],
     #         essential: false,
+    #         restart_policy: {
+    #           enabled: false, # required
+    #           ignored_exit_codes: [1],
+    #           restart_attempt_period: 1,
+    #         },
     #         entry_point: ["String"],
     #         command: ["String"],
     #         environment: [
@@ -7084,6 +7083,10 @@ module Aws::ECS
     #   resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
     #   resp.task_definition.container_definitions[0].port_mappings[0].container_port_range #=> String
     #   resp.task_definition.container_definitions[0].essential #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.enabled #=> Boolean
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes #=> Array
+    #   resp.task_definition.container_definitions[0].restart_policy.ignored_exit_codes[0] #=> Integer
+    #   resp.task_definition.container_definitions[0].restart_policy.restart_attempt_period #=> Integer
     #   resp.task_definition.container_definitions[0].entry_point #=> Array
     #   resp.task_definition.container_definitions[0].entry_point[0] #=> String
     #   resp.task_definition.container_definitions[0].command #=> Array
@@ -7442,13 +7445,18 @@ module Aws::ECS
     #   automatically trigger a task to run a batch process job, you could
     #   apply a unique identifier for that job to your task with the
     #   `startedBy` parameter. You can then identify which tasks belong to
-    #   that job by filtering the results of a ListTasks call with the
+    #   that job by filtering the results of a [ListTasks][1] call with the
     #   `startedBy` value. Up to 128 letters (uppercase and lowercase),
-    #   numbers, hyphens (-), and underscores (\_) are allowed.
+    #   numbers, hyphens (-), forward slash (/), and underscores (\_) are
+    #   allowed.
     #
     #   If a task is started by an Amazon ECS service, then the `startedBy`
     #   parameter contains the deployment ID of the service that starts it.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListTasks.html
+    #
     # @option params [Array<Types::Tag>] :tags
     #   The metadata that you apply to the task to help you categorize and
     #   organize them. Each tag consists of a key and an optional value, both
@@ -7912,13 +7920,18 @@ module Aws::ECS
     #   automatically trigger a task to run a batch process job, you could
     #   apply a unique identifier for that job to your task with the
     #   `startedBy` parameter. You can then identify which tasks belong to
-    #   that job by filtering the results of a ListTasks call with the
+    #   that job by filtering the results of a [ListTasks][1] call with the
     #   `startedBy` value. Up to 36 letters (uppercase and lowercase),
-    #   numbers, hyphens (-), and underscores (\_) are allowed.
+    #   numbers, hyphens (-), forward slash (/), and underscores (\_) are
+    #   allowed.
     #
     #   If a task is started by an Amazon ECS service, the `startedBy`
     #   parameter contains the deployment ID of the service that starts it.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListTasks.html
+    #
     # @option params [Array<Types::Tag>] :tags
     #   The metadata that you apply to the task to help you categorize and
     #   organize them. Each tag consists of a key and an optional value, both
@@ -9135,12 +9148,16 @@ module Aws::ECS
     # manually.
     #
     # A container instance has completed draining when it has no more
-    # `RUNNING` tasks. You can verify this using ListTasks.
+    # `RUNNING` tasks. You can verify this using [ListTasks][1].
     #
     # When a container instance has been drained, you can set a container
     # instance to `ACTIVE` status and once it has reached that status the
     # Amazon ECS scheduler can begin scheduling tasks on the instance again.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListTasks.html
+    #
     # @option params [String] :cluster
     #   The short name or full Amazon Resource Name (ARN) of the cluster that
     #   hosts the container instance to update. If you do not specify a
@@ -10331,7 +10348,7 @@ module Aws::ECS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ecs'
-      context[:gem_version] = '1.152.0'
+      context[:gem_version] = '1.153.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -76,6 +76,7 @@ module Aws::ECS
     ContainerInstances = Shapes::ListShape.new(name: 'ContainerInstances')
     ContainerOverride = Shapes::StructureShape.new(name: 'ContainerOverride')
     ContainerOverrides = Shapes::ListShape.new(name: 'ContainerOverrides')
+    ContainerRestartPolicy = Shapes::StructureShape.new(name: 'ContainerRestartPolicy')
     ContainerStateChange = Shapes::StructureShape.new(name: 'ContainerStateChange')
     ContainerStateChanges = Shapes::ListShape.new(name: 'ContainerStateChanges')
     Containers = Shapes::ListShape.new(name: 'Containers')
@@ -185,6 +186,7 @@ module Aws::ECS
     InstanceHealthCheckState = Shapes::StringShape.new(name: 'InstanceHealthCheckState')
     InstanceHealthCheckType = Shapes::StringShape.new(name: 'InstanceHealthCheckType')
     Integer = Shapes::IntegerShape.new(name: 'Integer')
+    IntegerList = Shapes::ListShape.new(name: 'IntegerList')
     InvalidParameterException = Shapes::StructureShape.new(name: 'InvalidParameterException')
     IpcMode = Shapes::StringShape.new(name: 'IpcMode')
     KernelCapabilities = Shapes::StructureShape.new(name: 'KernelCapabilities')
@@ -562,6 +564,7 @@ module Aws::ECS
     ContainerDefinition.add_member(:links, Shapes::ShapeRef.new(shape: StringList, location_name: "links"))
     ContainerDefinition.add_member(:port_mappings, Shapes::ShapeRef.new(shape: PortMappingList, location_name: "portMappings"))
     ContainerDefinition.add_member(:essential, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "essential"))
+    ContainerDefinition.add_member(:restart_policy, Shapes::ShapeRef.new(shape: ContainerRestartPolicy, location_name: "restartPolicy"))
     ContainerDefinition.add_member(:entry_point, Shapes::ShapeRef.new(shape: StringList, location_name: "entryPoint"))
     ContainerDefinition.add_member(:command, Shapes::ShapeRef.new(shape: StringList, location_name: "command"))
     ContainerDefinition.add_member(:environment, Shapes::ShapeRef.new(shape: EnvironmentVariables, location_name: "environment"))
@@ -643,6 +646,11 @@ module Aws::ECS
 
     ContainerOverrides.member = Shapes::ShapeRef.new(shape: ContainerOverride)
 
+    ContainerRestartPolicy.add_member(:enabled, Shapes::ShapeRef.new(shape: BoxedBoolean, required: true, location_name: "enabled"))
+    ContainerRestartPolicy.add_member(:ignored_exit_codes, Shapes::ShapeRef.new(shape: IntegerList, location_name: "ignoredExitCodes"))
+    ContainerRestartPolicy.add_member(:restart_attempt_period, Shapes::ShapeRef.new(shape: BoxedInteger, location_name: "restartAttemptPeriod"))
+    ContainerRestartPolicy.struct_class = Types::ContainerRestartPolicy
+
     ContainerStateChange.add_member(:container_name, Shapes::ShapeRef.new(shape: String, location_name: "containerName"))
     ContainerStateChange.add_member(:image_digest, Shapes::ShapeRef.new(shape: String, location_name: "imageDigest"))
     ContainerStateChange.add_member(:runtime_id, Shapes::ShapeRef.new(shape: String, location_name: "runtimeId"))
@@ -1049,6 +1057,8 @@ module Aws::ECS
 
     InstanceHealthCheckResultList.member = Shapes::ShapeRef.new(shape: InstanceHealthCheckResult)
 
+    IntegerList.member = Shapes::ShapeRef.new(shape: BoxedInteger)
+
     InvalidParameterException.struct_class = Types::InvalidParameterException
 
     KernelCapabilities.add_member(:add, Shapes::ShapeRef.new(shape: StringList, location_name: "add"))