lib/aws-sdk-ecs/client.rb in aws-sdk-ecs-1.7.0 vs lib/aws-sdk-ecs/client.rb in aws-sdk-ecs-1.8.0
- old
+ new
@@ -407,10 +407,21 @@
#
#
#
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
#
+ # @option params [Integer] :health_check_grace_period_seconds
+ # The period of time, in seconds, that the Amazon ECS service scheduler
+ # should ignore 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 ELB health checks, you can specify a
+ # health check grace period of up to 1,800 seconds during which the ECS
+ # service scheduler will ignore ELB health check status. This grace
+ # period can prevent the ECS service scheduler from marking tasks as
+ # unhealthy and stopping them before they have time to come up.
+ #
# @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
#
# * {Types::CreateServiceResponse#service #service} => Types::Service
#
#
@@ -571,10 +582,11 @@
# subnets: ["String"], # required
# security_groups: ["String"],
# assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
# },
# },
+ # health_check_grace_period_seconds: 1,
# })
#
# @example Response structure
#
# resp.service.service_arn #=> String
@@ -625,10 +637,11 @@
# resp.service.network_configuration.awsvpc_configuration.subnets #=> Array
# resp.service.network_configuration.awsvpc_configuration.subnets[0] #=> String
# resp.service.network_configuration.awsvpc_configuration.security_groups #=> Array
# resp.service.network_configuration.awsvpc_configuration.security_groups[0] #=> String
# resp.service.network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
+ # resp.service.health_check_grace_period_seconds #=> Integer
#
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateService AWS API Documentation
#
# @overload create_service(params = {})
# @param [Hash] params ({})
@@ -850,10 +863,11 @@
# resp.service.network_configuration.awsvpc_configuration.subnets #=> Array
# resp.service.network_configuration.awsvpc_configuration.subnets[0] #=> String
# resp.service.network_configuration.awsvpc_configuration.security_groups #=> Array
# resp.service.network_configuration.awsvpc_configuration.security_groups[0] #=> String
# resp.service.network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
+ # resp.service.health_check_grace_period_seconds #=> Integer
#
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteService AWS API Documentation
#
# @overload delete_service(params = {})
# @param [Hash] params ({})
@@ -1134,11 +1148,11 @@
# Additional information about your clusters to be separated by launch
# type, including:
#
# * runningEC2TasksCount
#
- # * RunningFargateTasksCount
+ # * runningFargateTasksCount
#
# * pendingEC2TasksCount
#
# * pendingFargateTasksCount
#
@@ -1509,10 +1523,11 @@
# resp.services[0].network_configuration.awsvpc_configuration.subnets #=> Array
# resp.services[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
# resp.services[0].network_configuration.awsvpc_configuration.security_groups #=> Array
# resp.services[0].network_configuration.awsvpc_configuration.security_groups[0] #=> String
# resp.services[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
+ # resp.services[0].health_check_grace_period_seconds #=> Integer
# resp.failures #=> Array
# resp.failures[0].arn #=> String
# resp.failures[0].reason #=> String
#
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeServices AWS API Documentation
@@ -2893,17 +2908,24 @@
# The launch type required by the task. If no value is specified, it
# defaults to `EC2`.
#
# @option params [String] :cpu
# The number of `cpu` units used by the task. If using the EC2 launch
- # type, this field is optional and any value can be used. If you are
- # using the Fargate launch type, this field is required and you must use
- # one of the following values, which determines your range of valid
- # values for the `memory` parameter:
+ # type, this field is optional and any value can be used.
#
- # * 256 (.25 vCPU) - Available `memory` values: 512MB, 1GB, 2GB
+ # <note markdown="1"> Task-level CPU and memory parameters are ignored for Windows
+ # containers. We recommend specifying container-level resources for
+ # Windows containers.
#
+ # </note>
+ #
+ # If you are using the Fargate launch type, this field is required and
+ # you must use one of the following values, which determines your range
+ # of valid values for the `memory` parameter:
+ #
+ # * 256 (.25 vCPU) - Available `memory` values: 0.5GB, 1GB, 2GB
+ #
# * 512 (.5 vCPU) - Available `memory` values: 1GB, 2GB, 3GB, 4GB
#
# * 1024 (1 vCPU) - Available `memory` values: 2GB, 3GB, 4GB, 5GB, 6GB,
# 7GB, 8GB
#
@@ -2913,17 +2935,24 @@
# * 4096 (4 vCPU) - Available `memory` values: Between 8GB and 30GB in
# 1GB increments
#
# @option params [String] :memory
# The amount (in MiB) of memory used by the task. If using the EC2
- # launch type, this field is optional and any value can be used. If you
- # are using the Fargate launch type, this field is required and you must
- # use one of the following values, which determines your range of valid
- # values for the `cpu` parameter:
+ # launch type, this field is optional and any value can be used.
#
- # * 512MB, 1GB, 2GB - Available `cpu` values: 256 (.25 vCPU)
+ # <note markdown="1"> Task-level CPU and memory parameters are ignored for Windows
+ # containers. We recommend specifying container-level resources for
+ # Windows containers.
#
+ # </note>
+ #
+ # If you are using the Fargate launch type, this field is required and
+ # you must use one of the following values, which determines your range
+ # of valid values for the `cpu` parameter:
+ #
+ # * 0\.5GB, 1GB, 2GB - Available `cpu` values: 256 (.25 vCPU)
+ #
# * 1GB, 2GB, 3GB, 4GB - Available `cpu` values: 512 (.5 vCPU)
#
# * 2GB, 3GB, 4GB, 5GB, 6GB, 7GB, 8GB - Available `cpu` values: 1024 (1
# vCPU)
#
@@ -3209,12 +3238,34 @@
# *Amazon Elastic Container Service Developer Guide*.
#
# Alternatively, you can use StartTask to use your own scheduler or
# place tasks manually on specific container instances.
#
+ # The Amazon ECS API follows an eventual consistency model, due to the
+ # distributed nature of the system supporting the API. This means that
+ # the result of an API command you run that affects your Amazon ECS
+ # resources might not be immediately visible to all subsequent commands
+ # you run. You should keep this in mind when you carry out an API
+ # command that immediately follows a previous API command.
#
+ # To manage eventual consistency, you can do the following:
#
+ # * Confirm the state of the resource before you run a command to modify
+ # it. Run the DescribeTasks command using an exponential backoff
+ # algorithm to ensure that you allow enough time for the previous
+ # command to propagate through the system. To do this, run the
+ # DescribeTasks command repeatedly, starting with a couple of seconds
+ # of wait time, and increasing gradually up to five minutes of wait
+ # time.
+ #
+ # * Add wait time between subsequent commands, even if the DescribeTasks
+ # command returns an accurate response. Apply an exponential backoff
+ # algorithm starting with a couple of seconds of wait time, and
+ # increase gradually up to about five minutes of wait time.
+ #
+ #
+ #
# [1]: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html
#
# @option params [String] :cluster
# The short name or full Amazon Resource Name (ARN) of the cluster on
# which to run your task. If you do not specify a cluster, the default
@@ -4245,10 +4296,21 @@
# The platform version you want to update your service to run.
#
# @option params [Boolean] :force_new_deployment
# Whether or not to force a new deployment of the service.
#
+ # @option params [Integer] :health_check_grace_period_seconds
+ # The period of time, in seconds, that the Amazon ECS service scheduler
+ # should ignore 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 ELB health checks, you can specify a
+ # health check grace period of up to 1,800 seconds during which the ECS
+ # service scheduler will ignore ELB health check status. This grace
+ # period can prevent the ECS service scheduler from marking tasks as
+ # unhealthy and stopping them before they have time to come up.
+ #
# @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
#
# * {Types::UpdateServiceResponse#service #service} => Types::Service
#
#
@@ -4296,10 +4358,11 @@
# assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
# },
# },
# platform_version: "String",
# force_new_deployment: false,
+ # health_check_grace_period_seconds: 1,
# })
#
# @example Response structure
#
# resp.service.service_arn #=> String
@@ -4350,10 +4413,11 @@
# resp.service.network_configuration.awsvpc_configuration.subnets #=> Array
# resp.service.network_configuration.awsvpc_configuration.subnets[0] #=> String
# resp.service.network_configuration.awsvpc_configuration.security_groups #=> Array
# resp.service.network_configuration.awsvpc_configuration.security_groups[0] #=> String
# resp.service.network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
+ # resp.service.health_check_grace_period_seconds #=> Integer
#
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateService AWS API Documentation
#
# @overload update_service(params = {})
# @param [Hash] params ({})
@@ -4373,10 +4437,10 @@
operation: config.api.operation(operation_name),
client: self,
params: params,
config: config)
context[:gem_name] = 'aws-sdk-ecs'
- context[:gem_version] = '1.7.0'
+ context[:gem_version] = '1.8.0'
Seahorse::Client::Request.new(handlers, context)
end
# Polls an API operation until a resource enters a desired state.
#