aws-sdk-ecs 1.59.0 → 1.60.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 4c362005cf7550cbf4709fc8f5ecf074c746658f87f9b09a97c2a31cea0b971f
4
- data.tar.gz: 499d1561fd517e309c156267b7bdb6356db8d9ebc9bf201d4a090fb2c96c5c55
3
+ metadata.gz: 4b192f9fa98b6b215373dd1daa194c1cfd6c59e979d97098c2d45b9e0f5b662b
4
+ data.tar.gz: 58be7ae365abbace9826c904c2cc9aee89e296aaa3b70b1e671815f5b94ea3e9
5
5
  SHA512:
6
- metadata.gz: b79eb71c8e855972f61389da3769222f49c3f6c29a3d7b9296017a60584a96996c201c62ad6c407c72f578e8e1f1ff9738d1dea7ed8954270384b3bd969c17aa
7
- data.tar.gz: d22da21a5ff617301457d5be87cf6015ef811dad37c4b05626244b5f6557793d6fbba8d05d97731ac24fc5f07690081b6b54cf7b4ccf7dba110c7d66f93575bd
6
+ metadata.gz: ada4c418ce905c4599217521d5057fc1550e3e2f00ab4965b69fd1a4241610a842f4744ea63a7ceb5ebb4f9e8baa83fecca32ddd914e7420679398b3fe96c452
7
+ data.tar.gz: ffb3944d0c2eb4d50d08ebf458978508fcd2cf43f90eb57f2252ad38470130b7b1ae71e3f4632c65ec0baa386b79325340c430d0cf860c70aa9e46f971b4dbc3
@@ -46,6 +46,6 @@ require_relative 'aws-sdk-ecs/customizations'
46
46
  # @service
47
47
  module Aws::ECS
48
48
 
49
- GEM_VERSION = '1.59.0'
49
+ GEM_VERSION = '1.60.0'
50
50
 
51
51
  end
@@ -279,8 +279,7 @@ module Aws::ECS
279
279
  #
280
280
  # @option options [Integer] :http_read_timeout (60) The default
281
281
  # number of seconds to wait for response data. This value can
282
- # safely be set
283
- # per-request on the session yielded by {#session_for}.
282
+ # safely be set per-request on the session.
284
283
  #
285
284
  # @option options [Float] :http_idle_timeout (5) The number of
286
285
  # seconds a connection is allowed to sit idle before it is
@@ -292,7 +291,7 @@ module Aws::ECS
292
291
  # request body. This option has no effect unless the request has
293
292
  # "Expect" header set to "100-continue". Defaults to `nil` which
294
293
  # disables this behaviour. This value can safely be set per
295
- # request on the session yielded by {#session_for}.
294
+ # request on the session.
296
295
  #
297
296
  # @option options [Boolean] :http_wire_trace (false) When `true`,
298
297
  # HTTP debug output will be sent to the `:logger`.
@@ -478,8 +477,8 @@ module Aws::ECS
478
477
  # PutAccountSetting or PutAccountSettingDefault.
479
478
  #
480
479
  # @option params [Array<String>] :capacity_providers
481
- # The short name or full Amazon Resource Name (ARN) of one or more
482
- # capacity providers to associate with the cluster.
480
+ # The short name of one or more capacity providers to associate with the
481
+ # cluster.
483
482
  #
484
483
  # If specifying a capacity provider that uses an Auto Scaling group, the
485
484
  # capacity provider must already be created and not already associated
@@ -646,11 +645,14 @@ module Aws::ECS
646
645
  #
647
646
  # * `DAEMON` - The daemon scheduling strategy deploys exactly one task
648
647
  # on each active container instance that meets all of the task
649
- # placement constraints that you specify in your cluster. When using
650
- # this strategy, you don't need to specify a desired number of tasks,
651
- # a task placement strategy, or use Service Auto Scaling policies. For
652
- # more information, see [Service Scheduler Concepts][2] in the *Amazon
653
- # Elastic Container Service Developer Guide*.
648
+ # placement constraints that you specify in your cluster. The service
649
+ # scheduler also evaluates the task placement constraints for running
650
+ # tasks and will stop tasks that do not meet the placement
651
+ # constraints. When using this strategy, you don't need to specify a
652
+ # desired number of tasks, a task placement strategy, or use Service
653
+ # Auto Scaling policies. For more information, see [Service Scheduler
654
+ # Concepts][2] in the *Amazon Elastic Container Service Developer
655
+ # Guide*.
654
656
  #
655
657
  # You can optionally specify a deployment configuration for your
656
658
  # service. The deployment is triggered by changing properties, such as
@@ -976,9 +978,12 @@ module Aws::ECS
976
978
  #
977
979
  # * `DAEMON`-The daemon scheduling strategy deploys exactly one task on
978
980
  # each active container instance that meets all of the task placement
979
- # constraints that you specify in your cluster. When you're using
980
- # this strategy, you don't need to specify a desired number of tasks,
981
- # a task placement strategy, or use Service Auto Scaling policies.
981
+ # constraints that you specify in your cluster. The service scheduler
982
+ # also evaluates the task placement constraints for running tasks and
983
+ # will stop tasks that do not meet the placement constraints. When
984
+ # you're using this strategy, you don't need to specify a desired
985
+ # number of tasks, a task placement strategy, or use Service Auto
986
+ # Scaling policies.
982
987
  #
983
988
  # <note markdown="1"> Tasks using the Fargate launch type or the `CODE_DEPLOY` or
984
989
  # `EXTERNAL` deployment controller types don't support the `DAEMON`
@@ -2385,6 +2390,10 @@ module Aws::ECS
2385
2390
  # resp.task_definition.volumes[0].docker_volume_configuration.labels["String"] #=> String
2386
2391
  # resp.task_definition.volumes[0].efs_volume_configuration.file_system_id #=> String
2387
2392
  # resp.task_definition.volumes[0].efs_volume_configuration.root_directory #=> String
2393
+ # resp.task_definition.volumes[0].efs_volume_configuration.transit_encryption #=> String, one of "ENABLED", "DISABLED"
2394
+ # resp.task_definition.volumes[0].efs_volume_configuration.transit_encryption_port #=> Integer
2395
+ # resp.task_definition.volumes[0].efs_volume_configuration.authorization_config.access_point_id #=> String
2396
+ # resp.task_definition.volumes[0].efs_volume_configuration.authorization_config.iam #=> String, one of "ENABLED", "DISABLED"
2388
2397
  # resp.task_definition.status #=> String, one of "ACTIVE", "INACTIVE"
2389
2398
  # resp.task_definition.requires_attributes #=> Array
2390
2399
  # resp.task_definition.requires_attributes[0].name #=> String
@@ -3016,6 +3025,12 @@ module Aws::ECS
3016
3025
  # resp.failures[0].reason #=> String
3017
3026
  # resp.failures[0].detail #=> String
3018
3027
  #
3028
+ #
3029
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
3030
+ #
3031
+ # * services_inactive
3032
+ # * services_stable
3033
+ #
3019
3034
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeServices AWS API Documentation
3020
3035
  #
3021
3036
  # @overload describe_services(params = {})
@@ -3238,6 +3253,10 @@ module Aws::ECS
3238
3253
  # resp.task_definition.volumes[0].docker_volume_configuration.labels["String"] #=> String
3239
3254
  # resp.task_definition.volumes[0].efs_volume_configuration.file_system_id #=> String
3240
3255
  # resp.task_definition.volumes[0].efs_volume_configuration.root_directory #=> String
3256
+ # resp.task_definition.volumes[0].efs_volume_configuration.transit_encryption #=> String, one of "ENABLED", "DISABLED"
3257
+ # resp.task_definition.volumes[0].efs_volume_configuration.transit_encryption_port #=> Integer
3258
+ # resp.task_definition.volumes[0].efs_volume_configuration.authorization_config.access_point_id #=> String
3259
+ # resp.task_definition.volumes[0].efs_volume_configuration.authorization_config.iam #=> String, one of "ENABLED", "DISABLED"
3241
3260
  # resp.task_definition.status #=> String, one of "ACTIVE", "INACTIVE"
3242
3261
  # resp.task_definition.requires_attributes #=> Array
3243
3262
  # resp.task_definition.requires_attributes[0].name #=> String
@@ -3551,6 +3570,12 @@ module Aws::ECS
3551
3570
  # resp.failures[0].reason #=> String
3552
3571
  # resp.failures[0].detail #=> String
3553
3572
  #
3573
+ #
3574
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
3575
+ #
3576
+ # * tasks_running
3577
+ # * tasks_stopped
3578
+ #
3554
3579
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeTasks AWS API Documentation
3555
3580
  #
3556
3581
  # @overload describe_tasks(params = {})
@@ -3654,6 +3679,8 @@ module Aws::ECS
3654
3679
  # * {Types::ListAccountSettingsResponse#settings #settings} => Array&lt;Types::Setting&gt;
3655
3680
  # * {Types::ListAccountSettingsResponse#next_token #next_token} => String
3656
3681
  #
3682
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3683
+ #
3657
3684
  #
3658
3685
  # @example Example: To view your effective account settings
3659
3686
  #
@@ -3793,6 +3820,8 @@ module Aws::ECS
3793
3820
  # * {Types::ListAttributesResponse#attributes #attributes} => Array&lt;Types::Attribute&gt;
3794
3821
  # * {Types::ListAttributesResponse#next_token #next_token} => String
3795
3822
  #
3823
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3824
+ #
3796
3825
  # @example Request syntax with placeholder values
3797
3826
  #
3798
3827
  # resp = client.list_attributes({
@@ -3851,6 +3880,8 @@ module Aws::ECS
3851
3880
  # * {Types::ListClustersResponse#cluster_arns #cluster_arns} => Array&lt;String&gt;
3852
3881
  # * {Types::ListClustersResponse#next_token #next_token} => String
3853
3882
  #
3883
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3884
+ #
3854
3885
  #
3855
3886
  # @example Example: To list your available clusters
3856
3887
  #
@@ -3949,6 +3980,8 @@ module Aws::ECS
3949
3980
  # * {Types::ListContainerInstancesResponse#container_instance_arns #container_instance_arns} => Array&lt;String&gt;
3950
3981
  # * {Types::ListContainerInstancesResponse#next_token #next_token} => String
3951
3982
  #
3983
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3984
+ #
3952
3985
  #
3953
3986
  # @example Example: To list your available container instances in a cluster
3954
3987
  #
@@ -4031,6 +4064,8 @@ module Aws::ECS
4031
4064
  # * {Types::ListServicesResponse#service_arns #service_arns} => Array&lt;String&gt;
4032
4065
  # * {Types::ListServicesResponse#next_token #next_token} => String
4033
4066
  #
4067
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4068
+ #
4034
4069
  #
4035
4070
  # @example Example: To list the services in a cluster
4036
4071
  #
@@ -4177,6 +4212,8 @@ module Aws::ECS
4177
4212
  # * {Types::ListTaskDefinitionFamiliesResponse#families #families} => Array&lt;String&gt;
4178
4213
  # * {Types::ListTaskDefinitionFamiliesResponse#next_token #next_token} => String
4179
4214
  #
4215
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4216
+ #
4180
4217
  #
4181
4218
  # @example Example: To list your registered task definition families
4182
4219
  #
@@ -4290,6 +4327,8 @@ module Aws::ECS
4290
4327
  # * {Types::ListTaskDefinitionsResponse#task_definition_arns #task_definition_arns} => Array&lt;String&gt;
4291
4328
  # * {Types::ListTaskDefinitionsResponse#next_token #next_token} => String
4292
4329
  #
4330
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4331
+ #
4293
4332
  #
4294
4333
  # @example Example: To list your registered task definitions
4295
4334
  #
@@ -4433,6 +4472,8 @@ module Aws::ECS
4433
4472
  # * {Types::ListTasksResponse#task_arns #task_arns} => Array&lt;String&gt;
4434
4473
  # * {Types::ListTasksResponse#next_token #next_token} => String
4435
4474
  #
4475
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4476
+ #
4436
4477
  #
4437
4478
  # @example Example: To list the tasks in a cluster
4438
4479
  #
@@ -5588,6 +5629,12 @@ module Aws::ECS
5588
5629
  # efs_volume_configuration: {
5589
5630
  # file_system_id: "String", # required
5590
5631
  # root_directory: "String",
5632
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
5633
+ # transit_encryption_port: 1,
5634
+ # authorization_config: {
5635
+ # access_point_id: "String",
5636
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
5637
+ # },
5591
5638
  # },
5592
5639
  # },
5593
5640
  # ],
@@ -5744,6 +5791,10 @@ module Aws::ECS
5744
5791
  # resp.task_definition.volumes[0].docker_volume_configuration.labels["String"] #=> String
5745
5792
  # resp.task_definition.volumes[0].efs_volume_configuration.file_system_id #=> String
5746
5793
  # resp.task_definition.volumes[0].efs_volume_configuration.root_directory #=> String
5794
+ # resp.task_definition.volumes[0].efs_volume_configuration.transit_encryption #=> String, one of "ENABLED", "DISABLED"
5795
+ # resp.task_definition.volumes[0].efs_volume_configuration.transit_encryption_port #=> Integer
5796
+ # resp.task_definition.volumes[0].efs_volume_configuration.authorization_config.access_point_id #=> String
5797
+ # resp.task_definition.volumes[0].efs_volume_configuration.authorization_config.iam #=> String, one of "ENABLED", "DISABLED"
5747
5798
  # resp.task_definition.status #=> String, one of "ACTIVE", "INACTIVE"
5748
5799
  # resp.task_definition.requires_attributes #=> Array
5749
5800
  # resp.task_definition.requires_attributes[0].name #=> String
@@ -7285,25 +7336,33 @@ module Aws::ECS
7285
7336
  req.send_request(options)
7286
7337
  end
7287
7338
 
7339
+ # Updating the task placement strategies and constraints on an Amazon
7340
+ # ECS service remains in preview and is a Beta Service as defined by and
7341
+ # subject to the Beta Service Participation Service Terms located at
7342
+ # [https://aws.amazon.com/service-terms][1] ("Beta Terms"). These Beta
7343
+ # Terms apply to your participation in this preview.
7344
+ #
7288
7345
  # Modifies the parameters of a service.
7289
7346
  #
7290
7347
  # For services using the rolling update (`ECS`) deployment controller,
7291
- # the desired count, deployment configuration, network configuration, or
7292
- # task definition used can be updated.
7348
+ # the desired count, deployment configuration, network configuration,
7349
+ # task placement constraints and strategies, or task definition used can
7350
+ # be updated.
7293
7351
  #
7294
7352
  # For services using the blue/green (`CODE_DEPLOY`) deployment
7295
- # controller, only the desired count, deployment configuration, and
7296
- # health check grace period can be updated using this API. If the
7297
- # network configuration, platform version, or task definition need to be
7298
- # updated, a new AWS CodeDeploy deployment should be created. For more
7299
- # information, see [CreateDeployment][1] in the *AWS CodeDeploy API
7300
- # Reference*.
7353
+ # controller, only the desired count, deployment configuration, task
7354
+ # placement constraints and strategies, and health check grace period
7355
+ # can be updated using this API. If the network configuration, platform
7356
+ # version, or task definition need to be updated, a new AWS CodeDeploy
7357
+ # deployment should be created. For more information, see
7358
+ # [CreateDeployment][2] in the *AWS CodeDeploy API Reference*.
7301
7359
  #
7302
7360
  # For services using an external deployment controller, you can update
7303
- # only the desired count and health check grace period using this API.
7304
- # If the launch type, load balancer, network configuration, platform
7305
- # version, or task definition need to be updated, you should create a
7306
- # new task set. For more information, see CreateTaskSet.
7361
+ # only the desired count, task placement constraints and strategies, and
7362
+ # health check grace period using this API. If the launch type, load
7363
+ # balancer, network configuration, platform version, or task definition
7364
+ # need to be updated, you should create a new task set. For more
7365
+ # information, see CreateTaskSet.
7307
7366
  #
7308
7367
  # You can add to or subtract from the number of instantiations of a task
7309
7368
  # definition in a service by specifying the cluster that the service is
@@ -7393,7 +7452,8 @@ module Aws::ECS
7393
7452
  #
7394
7453
  #
7395
7454
  #
7396
- # [1]: https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
7455
+ # [1]: https://aws.amazon.com/service-terms
7456
+ # [2]: https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
7397
7457
  #
7398
7458
  # @option params [String] :cluster
7399
7459
  # The short name or full Amazon Resource Name (ARN) of the cluster that
@@ -7420,9 +7480,30 @@ module Aws::ECS
7420
7480
  #
7421
7481
  # If the service is using the default capacity provider strategy for the
7422
7482
  # cluster, the service can be updated to use one or more capacity
7423
- # providers. However, when a service is using a non-default capacity
7424
- # provider strategy, the service cannot be updated to use the cluster's
7425
- # default capacity provider strategy.
7483
+ # providers as opposed to the default capacity provider strategy.
7484
+ # However, when a service is using a capacity provider strategy that is
7485
+ # not the default capacity provider strategy, the service cannot be
7486
+ # updated to use the cluster's default capacity provider strategy.
7487
+ #
7488
+ # A capacity provider strategy consists of one or more capacity
7489
+ # providers along with the `base` and `weight` to assign to them. A
7490
+ # capacity provider must be associated with the cluster to be used in a
7491
+ # capacity provider strategy. The PutClusterCapacityProviders API is
7492
+ # used to associate a capacity provider with a cluster. Only capacity
7493
+ # providers with an `ACTIVE` or `UPDATING` status can be used.
7494
+ #
7495
+ # If specifying a capacity provider that uses an Auto Scaling group, the
7496
+ # capacity provider must already be created. New capacity providers can
7497
+ # be created with the CreateCapacityProvider API operation.
7498
+ #
7499
+ # To use a AWS Fargate capacity provider, specify either the `FARGATE`
7500
+ # or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
7501
+ # providers are available to all accounts and only need to be associated
7502
+ # with a cluster to be used.
7503
+ #
7504
+ # The PutClusterCapacityProviders API operation is used to update the
7505
+ # list of available capacity providers for a cluster after the cluster
7506
+ # is created.
7426
7507
  #
7427
7508
  # @option params [Types::DeploymentConfiguration] :deployment_configuration
7428
7509
  # Optional deployment parameters that control how many tasks run during
@@ -7878,7 +7959,7 @@ module Aws::ECS
7878
7959
  params: params,
7879
7960
  config: config)
7880
7961
  context[:gem_name] = 'aws-sdk-ecs'
7881
- context[:gem_version] = '1.59.0'
7962
+ context[:gem_version] = '1.60.0'
7882
7963
  Seahorse::Client::Request.new(handlers, context)
7883
7964
  end
7884
7965
 
@@ -7944,12 +8025,12 @@ module Aws::ECS
7944
8025
  # The following table lists the valid waiter names, the operations they call,
7945
8026
  # and the default `:delay` and `:max_attempts` values.
7946
8027
  #
7947
- # | waiter_name | params | :delay | :max_attempts |
7948
- # | ----------------- | -------------------- | -------- | ------------- |
7949
- # | services_inactive | {#describe_services} | 15 | 40 |
7950
- # | services_stable | {#describe_services} | 15 | 40 |
7951
- # | tasks_running | {#describe_tasks} | 6 | 100 |
7952
- # | tasks_stopped | {#describe_tasks} | 6 | 100 |
8028
+ # | waiter_name | params | :delay | :max_attempts |
8029
+ # | ----------------- | -------------------------- | -------- | ------------- |
8030
+ # | services_inactive | {Client#describe_services} | 15 | 40 |
8031
+ # | services_stable | {Client#describe_services} | 15 | 40 |
8032
+ # | tasks_running | {Client#describe_tasks} | 6 | 100 |
8033
+ # | tasks_stopped | {Client#describe_tasks} | 6 | 100 |
7953
8034
  #
7954
8035
  # @raise [Errors::FailureStateError] Raised when the waiter terminates
7955
8036
  # because the waiter has entered a state that it will not transition
@@ -119,6 +119,9 @@ module Aws::ECS
119
119
  DockerLabelsMap = Shapes::MapShape.new(name: 'DockerLabelsMap')
120
120
  DockerVolumeConfiguration = Shapes::StructureShape.new(name: 'DockerVolumeConfiguration')
121
121
  Double = Shapes::FloatShape.new(name: 'Double')
122
+ EFSAuthorizationConfig = Shapes::StructureShape.new(name: 'EFSAuthorizationConfig')
123
+ EFSAuthorizationConfigIAM = Shapes::StringShape.new(name: 'EFSAuthorizationConfigIAM')
124
+ EFSTransitEncryption = Shapes::StringShape.new(name: 'EFSTransitEncryption')
122
125
  EFSVolumeConfiguration = Shapes::StructureShape.new(name: 'EFSVolumeConfiguration')
123
126
  EnvironmentVariables = Shapes::ListShape.new(name: 'EnvironmentVariables')
124
127
  Failure = Shapes::StructureShape.new(name: 'Failure')
@@ -756,8 +759,15 @@ module Aws::ECS
756
759
  DockerVolumeConfiguration.add_member(:labels, Shapes::ShapeRef.new(shape: StringMap, location_name: "labels"))
757
760
  DockerVolumeConfiguration.struct_class = Types::DockerVolumeConfiguration
758
761
 
762
+ EFSAuthorizationConfig.add_member(:access_point_id, Shapes::ShapeRef.new(shape: String, location_name: "accessPointId"))
763
+ EFSAuthorizationConfig.add_member(:iam, Shapes::ShapeRef.new(shape: EFSAuthorizationConfigIAM, location_name: "iam"))
764
+ EFSAuthorizationConfig.struct_class = Types::EFSAuthorizationConfig
765
+
759
766
  EFSVolumeConfiguration.add_member(:file_system_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "fileSystemId"))
760
767
  EFSVolumeConfiguration.add_member(:root_directory, Shapes::ShapeRef.new(shape: String, location_name: "rootDirectory"))
768
+ EFSVolumeConfiguration.add_member(:transit_encryption, Shapes::ShapeRef.new(shape: EFSTransitEncryption, location_name: "transitEncryption"))
769
+ EFSVolumeConfiguration.add_member(:transit_encryption_port, Shapes::ShapeRef.new(shape: BoxedInteger, location_name: "transitEncryptionPort"))
770
+ EFSVolumeConfiguration.add_member(:authorization_config, Shapes::ShapeRef.new(shape: EFSAuthorizationConfig, location_name: "authorizationConfig"))
761
771
  EFSVolumeConfiguration.struct_class = Types::EFSVolumeConfiguration
762
772
 
763
773
  EnvironmentVariables.member = Shapes::ShapeRef.new(shape: KeyValuePair)
@@ -6,13 +6,7 @@
6
6
  # WARNING ABOUT GENERATED CODE
7
7
 
8
8
  module Aws::ECS
9
- # This class provides a resource oriented interface for ECS.
10
- # To create a resource object:
11
- # resource = Aws::ECS::Resource.new(region: 'us-west-2')
12
- # You can supply a client object with custom configuration that will be used for all resource operations.
13
- # If you do not pass +:client+, a default client will be constructed.
14
- # client = Aws::ECS::Client.new(region: 'us-west-2')
15
- # resource = Aws::ECS::Resource.new(client: client)
9
+
16
10
  class Resource
17
11
 
18
12
  # @param options ({})
@@ -322,8 +322,7 @@ module Aws::ECS
322
322
  # }
323
323
  #
324
324
  # @!attribute [rw] capacity_provider
325
- # The short name or full Amazon Resource Name (ARN) of the capacity
326
- # provider.
325
+ # The short name of the capacity provider.
327
326
  # @return [String]
328
327
  #
329
328
  # @!attribute [rw] weight
@@ -1653,10 +1652,10 @@ module Aws::ECS
1653
1652
  # @return [Types::LogConfiguration]
1654
1653
  #
1655
1654
  # @!attribute [rw] health_check
1656
- # The health check command and associated configuration parameters for
1657
- # the container. This parameter maps to `HealthCheck` in the [Create a
1658
- # container][1] section of the [Docker Remote API][2] and the
1659
- # `HEALTHCHECK` parameter of [docker run][3].
1655
+ # The container health check command and associated configuration
1656
+ # parameters for the container. This parameter maps to `HealthCheck`
1657
+ # in the [Create a container][1] section of the [Docker Remote API][2]
1658
+ # and the `HEALTHCHECK` parameter of [docker run][3].
1660
1659
  #
1661
1660
  #
1662
1661
  #
@@ -2307,8 +2306,8 @@ module Aws::ECS
2307
2306
  # @return [Array<Types::ClusterSetting>]
2308
2307
  #
2309
2308
  # @!attribute [rw] capacity_providers
2310
- # The short name or full Amazon Resource Name (ARN) of one or more
2311
- # capacity providers to associate with the cluster.
2309
+ # The short name of one or more capacity providers to associate with
2310
+ # the cluster.
2312
2311
  #
2313
2312
  # If specifying a capacity provider that uses an Auto Scaling group,
2314
2313
  # the capacity provider must already be created and not already
@@ -2712,10 +2711,12 @@ module Aws::ECS
2712
2711
  #
2713
2712
  # * `DAEMON`-The daemon scheduling strategy deploys exactly one task
2714
2713
  # on each active container instance that meets all of the task
2715
- # placement constraints that you specify in your cluster. When
2716
- # you're using this strategy, you don't need to specify a desired
2717
- # number of tasks, a task placement strategy, or use Service Auto
2718
- # Scaling policies.
2714
+ # placement constraints that you specify in your cluster. The
2715
+ # service scheduler also evaluates the task placement constraints
2716
+ # for running tasks and will stop tasks that do not meet the
2717
+ # placement constraints. When you're using this strategy, you
2718
+ # don't need to specify a desired number of tasks, a task placement
2719
+ # strategy, or use Service Auto Scaling policies.
2719
2720
  #
2720
2721
  # <note markdown="1"> Tasks using the Fargate launch type or the `CODE_DEPLOY` or
2721
2722
  # `EXTERNAL` deployment controller types don't support the `DAEMON`
@@ -4207,19 +4208,60 @@ module Aws::ECS
4207
4208
  include Aws::Structure
4208
4209
  end
4209
4210
 
4210
- # This parameter is specified when you are using an Amazon Elastic File
4211
- # System (Amazon EFS) file storage. Amazon EFS file systems are only
4212
- # supported when you are using the EC2 launch type.
4211
+ # The authorization configuration details for the Amazon EFS file
4212
+ # system.
4213
+ #
4214
+ # @note When making an API call, you may pass EFSAuthorizationConfig
4215
+ # data as a hash:
4213
4216
  #
4214
- # `EFSVolumeConfiguration` remains in preview and is a Beta Service as
4215
- # defined by and subject to the Beta Service Participation Service Terms
4216
- # located at [https://aws.amazon.com/service-terms][1] ("Beta Terms").
4217
- # These Beta Terms apply to your participation in this preview of
4218
- # `EFSVolumeConfiguration`.
4217
+ # {
4218
+ # access_point_id: "String",
4219
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
4220
+ # }
4219
4221
  #
4222
+ # @!attribute [rw] access_point_id
4223
+ # The Amazon EFS access point ID to use. If an access point is
4224
+ # specified, the root directory value specified in the
4225
+ # `EFSVolumeConfiguration` will be relative to the directory set for
4226
+ # the access point. If an access point is used, transit encryption
4227
+ # must be enabled in the `EFSVolumeConfiguration`. For more
4228
+ # information, see [Working with Amazon EFS Access Points][1] in the
4229
+ # *Amazon Elastic File System User Guide*.
4220
4230
  #
4221
4231
  #
4222
- # [1]: https://aws.amazon.com/service-terms
4232
+ #
4233
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html
4234
+ # @return [String]
4235
+ #
4236
+ # @!attribute [rw] iam
4237
+ # Whether or not to use the Amazon ECS task IAM role defined in a task
4238
+ # definition when mounting the Amazon EFS file system. If enabled,
4239
+ # transit encryption must be enabled in the `EFSVolumeConfiguration`.
4240
+ # If this parameter is omitted, the default value of `DISABLED` is
4241
+ # used. For more information, see [Using Amazon EFS Access Points][1]
4242
+ # in the *Amazon Elastic Container Service Developer Guide*.
4243
+ #
4244
+ #
4245
+ #
4246
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/efs-volumes.html#efs-volume-accesspoints
4247
+ # @return [String]
4248
+ #
4249
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/EFSAuthorizationConfig AWS API Documentation
4250
+ #
4251
+ class EFSAuthorizationConfig < Struct.new(
4252
+ :access_point_id,
4253
+ :iam)
4254
+ include Aws::Structure
4255
+ end
4256
+
4257
+ # This parameter is specified when you are using an Amazon Elastic File
4258
+ # System file system for task storage. For more information, see [Amazon
4259
+ # EFS Volumes][1] in the *Amazon Elastic Container Service Developer
4260
+ # Guide*.
4261
+ #
4262
+ #
4263
+ #
4264
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/efs-volumes.html
4223
4265
  #
4224
4266
  # @note When making an API call, you may pass EFSVolumeConfiguration
4225
4267
  # data as a hash:
@@ -4227,6 +4269,12 @@ module Aws::ECS
4227
4269
  # {
4228
4270
  # file_system_id: "String", # required
4229
4271
  # root_directory: "String",
4272
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
4273
+ # transit_encryption_port: 1,
4274
+ # authorization_config: {
4275
+ # access_point_id: "String",
4276
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
4277
+ # },
4230
4278
  # }
4231
4279
  #
4232
4280
  # @!attribute [rw] file_system_id
@@ -4235,14 +4283,49 @@ module Aws::ECS
4235
4283
  #
4236
4284
  # @!attribute [rw] root_directory
4237
4285
  # The directory within the Amazon EFS file system to mount as the root
4238
- # directory inside the host.
4286
+ # directory inside the host. If this parameter is omitted, the root of
4287
+ # the Amazon EFS volume will be used. Specifying `/` will have the
4288
+ # same effect as omitting this parameter.
4289
+ # @return [String]
4290
+ #
4291
+ # @!attribute [rw] transit_encryption
4292
+ # Whether or not to enable encryption for Amazon EFS data in transit
4293
+ # between the Amazon ECS host and the Amazon EFS server. Transit
4294
+ # encryption must be enabled if Amazon EFS IAM authorization is used.
4295
+ # If this parameter is omitted, the default value of `DISABLED` is
4296
+ # used. For more information, see [Encrypting Data in Transit][1] in
4297
+ # the *Amazon Elastic File System User Guide*.
4298
+ #
4299
+ #
4300
+ #
4301
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/encryption-in-transit.html
4239
4302
  # @return [String]
4240
4303
  #
4304
+ # @!attribute [rw] transit_encryption_port
4305
+ # The port to use when sending encrypted data between the Amazon ECS
4306
+ # host and the Amazon EFS server. If you do not specify a transit
4307
+ # encryption port, it will use the port selection strategy that the
4308
+ # Amazon EFS mount helper uses. For more information, see [EFS Mount
4309
+ # Helper][1] in the *Amazon Elastic File System User Guide*.
4310
+ #
4311
+ #
4312
+ #
4313
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-mount-helper.html
4314
+ # @return [Integer]
4315
+ #
4316
+ # @!attribute [rw] authorization_config
4317
+ # The authorization configuration details for the Amazon EFS file
4318
+ # system.
4319
+ # @return [Types::EFSAuthorizationConfig]
4320
+ #
4241
4321
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/EFSVolumeConfiguration AWS API Documentation
4242
4322
  #
4243
4323
  class EFSVolumeConfiguration < Struct.new(
4244
4324
  :file_system_id,
4245
- :root_directory)
4325
+ :root_directory,
4326
+ :transit_encryption,
4327
+ :transit_encryption_port,
4328
+ :authorization_config)
4246
4329
  include Aws::Structure
4247
4330
  end
4248
4331
 
@@ -4322,6 +4405,39 @@ module Aws::ECS
4322
4405
  # Docker health checks that exist in the container image (such as those
4323
4406
  # specified in a parent image or from the image's Dockerfile).
4324
4407
  #
4408
+ # You can view the health status of both individual containers and a
4409
+ # task with the DescribeTasks API operation or when viewing the task
4410
+ # details in the console.
4411
+ #
4412
+ # The following describes the possible `healthStatus` values for a
4413
+ # container:
4414
+ #
4415
+ # * `HEALTHY`-The container health check has passed successfully.
4416
+ #
4417
+ # * `UNHEALTHY`-The container health check has failed.
4418
+ #
4419
+ # * `UNKNOWN`-The container health check is being evaluated or there is
4420
+ # no container health check defined.
4421
+ #
4422
+ # The following describes the possible `healthStatus` values for a task.
4423
+ # The container health check status of nonessential containers do not
4424
+ # have an effect on the health status of a task.
4425
+ #
4426
+ # * `HEALTHY`-All essential containers within the task have passed their
4427
+ # health checks.
4428
+ #
4429
+ # * `UNHEALTHY`-One or more essential containers have failed their
4430
+ # health check.
4431
+ #
4432
+ # * `UNKNOWN`-The essential containers within the task are still having
4433
+ # their health checks evaluated or there are no container health
4434
+ # checks defined.
4435
+ #
4436
+ # If a task is run manually, and not as part of a service, the task will
4437
+ # continue its lifecycle regardless of its health status. For tasks that
4438
+ # are part of a service, if the task reports as unhealthy then the task
4439
+ # will be stopped and the service scheduler will replace it.
4440
+ #
4325
4441
  # The following are notes about container health check support:
4326
4442
  #
4327
4443
  # * Container health checks require version 1.17.0 or greater of the
@@ -6849,6 +6965,12 @@ module Aws::ECS
6849
6965
  # efs_volume_configuration: {
6850
6966
  # file_system_id: "String", # required
6851
6967
  # root_directory: "String",
6968
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
6969
+ # transit_encryption_port: 1,
6970
+ # authorization_config: {
6971
+ # access_point_id: "String",
6972
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
6973
+ # },
6852
6974
  # },
6853
6975
  # },
6854
6976
  # ],
@@ -7914,9 +8036,11 @@ module Aws::ECS
7914
8036
  # placement decisions.
7915
8037
  #
7916
8038
  # * `DAEMON`-The daemon scheduling strategy deploys exactly one task
7917
- # on each container instance in your cluster. When you are using
7918
- # this strategy, do not specify a desired number of tasks or any
7919
- # task placement strategies.
8039
+ # on each active container instance that meets all of the task
8040
+ # placement constraints that you specify in your cluster. The
8041
+ # service scheduler also evaluates the task placement constraints
8042
+ # for running tasks and will stop tasks that do not meet the
8043
+ # placement constraints.
7920
8044
  #
7921
8045
  # <note markdown="1"> Fargate tasks do not support the `DAEMON` scheduling strategy.
7922
8046
  #
@@ -9152,7 +9276,7 @@ module Aws::ECS
9152
9276
  #
9153
9277
  #
9154
9278
  #
9155
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_IAM_role.html
9279
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html
9156
9280
  # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/windows_task_IAM_roles.html
9157
9281
  # @return [String]
9158
9282
  #
@@ -10165,9 +10289,31 @@ module Aws::ECS
10165
10289
  #
10166
10290
  # If the service is using the default capacity provider strategy for
10167
10291
  # the cluster, the service can be updated to use one or more capacity
10168
- # providers. However, when a service is using a non-default capacity
10169
- # provider strategy, the service cannot be updated to use the
10170
- # cluster's default capacity provider strategy.
10292
+ # providers as opposed to the default capacity provider strategy.
10293
+ # However, when a service is using a capacity provider strategy that
10294
+ # is not the default capacity provider strategy, the service cannot be
10295
+ # updated to use the cluster's default capacity provider strategy.
10296
+ #
10297
+ # A capacity provider strategy consists of one or more capacity
10298
+ # providers along with the `base` and `weight` to assign to them. A
10299
+ # capacity provider must be associated with the cluster to be used in
10300
+ # a capacity provider strategy. The PutClusterCapacityProviders API is
10301
+ # used to associate a capacity provider with a cluster. Only capacity
10302
+ # providers with an `ACTIVE` or `UPDATING` status can be used.
10303
+ #
10304
+ # If specifying a capacity provider that uses an Auto Scaling group,
10305
+ # the capacity provider must already be created. New capacity
10306
+ # providers can be created with the CreateCapacityProvider API
10307
+ # operation.
10308
+ #
10309
+ # To use a AWS Fargate capacity provider, specify either the `FARGATE`
10310
+ # or `FARGATE_SPOT` capacity providers. The AWS Fargate capacity
10311
+ # providers are available to all accounts and only need to be
10312
+ # associated with a cluster to be used.
10313
+ #
10314
+ # The PutClusterCapacityProviders API operation is used to update the
10315
+ # list of available capacity providers for a cluster after the cluster
10316
+ # is created.
10171
10317
  # @return [Array<Types::CapacityProviderStrategyItem>]
10172
10318
  #
10173
10319
  # @!attribute [rw] deployment_configuration
@@ -10395,6 +10541,12 @@ module Aws::ECS
10395
10541
  # efs_volume_configuration: {
10396
10542
  # file_system_id: "String", # required
10397
10543
  # root_directory: "String",
10544
+ # transit_encryption: "ENABLED", # accepts ENABLED, DISABLED
10545
+ # transit_encryption_port: 1,
10546
+ # authorization_config: {
10547
+ # access_point_id: "String",
10548
+ # iam: "ENABLED", # accepts ENABLED, DISABLED
10549
+ # },
10398
10550
  # },
10399
10551
  # }
10400
10552
  #
@@ -8,6 +8,70 @@
8
8
  require 'aws-sdk-core/waiters'
9
9
 
10
10
  module Aws::ECS
11
+ # Waiters are utility methods that poll for a particular state to occur
12
+ # on a client. Waiters can fail after a number of attempts at a polling
13
+ # interval defined for the service client.
14
+ #
15
+ # For a list of operations that can be waited for and the
16
+ # client methods called for each operation, see the table below or the
17
+ # {Client#wait_until} field documentation for the {Client}.
18
+ #
19
+ # # Invoking a Waiter
20
+ # To invoke a waiter, call #wait_until on a {Client}. The first parameter
21
+ # is the waiter name, which is specific to the service client and indicates
22
+ # which operation is being waited for. The second parameter is a hash of
23
+ # parameters that are passed to the client method called by the waiter,
24
+ # which varies according to the waiter name.
25
+ #
26
+ # # Wait Failures
27
+ # To catch errors in a waiter, use WaiterFailed,
28
+ # as shown in the following example.
29
+ #
30
+ # rescue rescue Aws::Waiters::Errors::WaiterFailed => error
31
+ # puts "failed waiting for instance running: #{error.message}
32
+ # end
33
+ #
34
+ # # Configuring a Waiter
35
+ # Each waiter has a default polling interval and a maximum number of
36
+ # attempts it will make before returning control to your program.
37
+ # To set these values, use the `max_attempts` and `delay` parameters
38
+ # in your `#wait_until` call.
39
+ # The following example waits for up to 25 seconds, polling every five seconds.
40
+ #
41
+ # client.wait_until(...) do |w|
42
+ # w.max_attempts = 5
43
+ # w.delay = 5
44
+ # end
45
+ #
46
+ # To disable wait failures, set the value of either of these parameters
47
+ # to `nil`.
48
+ #
49
+ # # Extending a Waiter
50
+ # To modify the behavior of waiters, you can register callbacks that are
51
+ # triggered before each polling attempt and before waiting.
52
+ #
53
+ # The following example implements an exponential backoff in a waiter
54
+ # by doubling the amount of time to wait on every attempt.
55
+ #
56
+ # client.wait_until(...) do |w|
57
+ # w.interval = 0 # disable normal sleep
58
+ # w.before_wait do |n, resp|
59
+ # sleep(n ** 2)
60
+ # end
61
+ # end
62
+ #
63
+ # # Available Waiters
64
+ #
65
+ # The following table lists the valid waiter names, the operations they call,
66
+ # and the default `:delay` and `:max_attempts` values.
67
+ #
68
+ # | waiter_name | params | :delay | :max_attempts |
69
+ # | ----------------- | -------------------------- | -------- | ------------- |
70
+ # | services_inactive | {Client#describe_services} | 15 | 40 |
71
+ # | services_stable | {Client#describe_services} | 15 | 40 |
72
+ # | tasks_running | {Client#describe_tasks} | 6 | 100 |
73
+ # | tasks_stopped | {Client#describe_tasks} | 6 | 100 |
74
+ #
11
75
  module Waiters
12
76
 
13
77
  class ServicesInactive
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-ecs
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.59.0
4
+ version: 1.60.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-03-16 00:00:00.000000000 Z
11
+ date: 2020-04-08 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -81,7 +81,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
81
81
  - !ruby/object:Gem::Version
82
82
  version: '0'
83
83
  requirements: []
84
- rubygems_version: 3.0.3
84
+ rubyforge_project:
85
+ rubygems_version: 2.7.6.2
85
86
  signing_key:
86
87
  specification_version: 4
87
88
  summary: AWS SDK for Ruby - Amazon ECS