aws-sdk-ecs 1.172.0 → 1.174.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -506,6 +506,46 @@ module Aws::ECS
506
506
  #
507
507
  # * {Types::CreateCapacityProviderResponse#capacity_provider #capacity_provider} => Types::CapacityProvider
508
508
  #
509
+ #
510
+ # @example Example: To create a capacity provider
511
+ #
512
+ # # This example creates a capacity provider that uses the specified Auto Scaling group MyASG and has managed scaling and
513
+ # # manager termination protection enabled.
514
+ #
515
+ # resp = client.create_capacity_provider({
516
+ # name: "MyCapacityProvider",
517
+ # auto_scaling_group_provider: {
518
+ # auto_scaling_group_arn: "arn:aws:autoscaling:us-east-1:123456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG",
519
+ # managed_scaling: {
520
+ # status: "ENABLED",
521
+ # target_capacity: 100,
522
+ # },
523
+ # managed_termination_protection: "ENABLED",
524
+ # },
525
+ # })
526
+ #
527
+ # resp.to_h outputs the following:
528
+ # {
529
+ # capacity_provider: {
530
+ # name: "MyCapacityProvider",
531
+ # auto_scaling_group_provider: {
532
+ # auto_scaling_group_arn: "arn:aws:autoscaling:us-east-1:132456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG",
533
+ # managed_scaling: {
534
+ # instance_warmup_period: 300,
535
+ # maximum_scaling_step_size: 10000,
536
+ # minimum_scaling_step_size: 1,
537
+ # status: "ENABLED",
538
+ # target_capacity: 100,
539
+ # },
540
+ # managed_termination_protection: "ENABLED",
541
+ # },
542
+ # capacity_provider_arn: "arn:aws:ecs:us-east-1:123456789012:capacity-provider/MyCapacityProvider",
543
+ # status: "ACTIVE",
544
+ # tags: [
545
+ # ],
546
+ # },
547
+ # }
548
+ #
509
549
  # @example Request syntax with placeholder values
510
550
  #
511
551
  # resp = client.create_capacity_provider({
@@ -1931,6 +1971,64 @@ module Aws::ECS
1931
1971
  #
1932
1972
  # * {Types::CreateTaskSetResponse#task_set #task_set} => Types::TaskSet
1933
1973
  #
1974
+ #
1975
+ # @example Example: To create a task set
1976
+ #
1977
+ # # This example creates a task set in a service that uses the EXTERNAL deployment controller.
1978
+ #
1979
+ # resp = client.create_task_set({
1980
+ # cluster: "MyCluster",
1981
+ # network_configuration: {
1982
+ # awsvpc_configuration: {
1983
+ # security_groups: [
1984
+ # "sg-12344321",
1985
+ # ],
1986
+ # subnets: [
1987
+ # "subnet-12344321",
1988
+ # ],
1989
+ # },
1990
+ # },
1991
+ # service: "MyService",
1992
+ # task_definition: "MyTaskDefinition:2",
1993
+ # })
1994
+ #
1995
+ # resp.to_h outputs the following:
1996
+ # {
1997
+ # task_set: {
1998
+ # computed_desired_count: 0,
1999
+ # created_at: Time.parse(1557128360.711),
2000
+ # id: "ecs-svc/1234567890123456789",
2001
+ # launch_type: "EC2",
2002
+ # load_balancers: [
2003
+ # ],
2004
+ # network_configuration: {
2005
+ # awsvpc_configuration: {
2006
+ # assign_public_ip: "DISABLED",
2007
+ # security_groups: [
2008
+ # "sg-12344321",
2009
+ # ],
2010
+ # subnets: [
2011
+ # "subnet-12344321",
2012
+ # ],
2013
+ # },
2014
+ # },
2015
+ # pending_count: 0,
2016
+ # running_count: 0,
2017
+ # scale: {
2018
+ # value: 0,
2019
+ # unit: "PERCENT",
2020
+ # },
2021
+ # service_registries: [
2022
+ # ],
2023
+ # stability_status: "STABILIZING",
2024
+ # stability_status_at: Time.parse(1557128360.711),
2025
+ # status: "ACTIVE",
2026
+ # task_definition: "arn:aws:ecs:us-west-2:123456789012:task-definition/MyTaskDefinition:2",
2027
+ # task_set_arn: "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
2028
+ # updated_at: Time.parse(1557128360.711),
2029
+ # },
2030
+ # }
2031
+ #
1934
2032
  # @example Request syntax with placeholder values
1935
2033
  #
1936
2034
  # resp = client.create_task_set({
@@ -2141,6 +2239,31 @@ module Aws::ECS
2141
2239
  #
2142
2240
  # * {Types::DeleteAttributesResponse#attributes #attributes} => Array<Types::Attribute>
2143
2241
  #
2242
+ #
2243
+ # @example Example: To delete a custom attribute from an Amazon ECS instance
2244
+ #
2245
+ # # This example deletes an attribute named stack from a container instance.
2246
+ #
2247
+ # resp = client.delete_attributes({
2248
+ # attributes: [
2249
+ # {
2250
+ # name: "stack",
2251
+ # target_id: "aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34",
2252
+ # },
2253
+ # ],
2254
+ # })
2255
+ #
2256
+ # resp.to_h outputs the following:
2257
+ # {
2258
+ # attributes: [
2259
+ # {
2260
+ # name: "stack",
2261
+ # value: "production",
2262
+ # target_id: "aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34",
2263
+ # },
2264
+ # ],
2265
+ # }
2266
+ #
2144
2267
  # @example Request syntax with placeholder values
2145
2268
  #
2146
2269
  # resp = client.delete_attributes({
@@ -2205,6 +2328,37 @@ module Aws::ECS
2205
2328
  #
2206
2329
  # * {Types::DeleteCapacityProviderResponse#capacity_provider #capacity_provider} => Types::CapacityProvider
2207
2330
  #
2331
+ #
2332
+ # @example Example: To delete a specified capacity provider
2333
+ #
2334
+ # # This example deletes a specified capacity provider.
2335
+ #
2336
+ # resp = client.delete_capacity_provider({
2337
+ # capacity_provider: "arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider",
2338
+ # })
2339
+ #
2340
+ # resp.to_h outputs the following:
2341
+ # {
2342
+ # capacity_provider: {
2343
+ # name: "ExampleCapacityProvider",
2344
+ # auto_scaling_group_provider: {
2345
+ # auto_scaling_group_arn: "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
2346
+ # managed_scaling: {
2347
+ # maximum_scaling_step_size: 10000,
2348
+ # minimum_scaling_step_size: 1,
2349
+ # status: "ENABLED",
2350
+ # target_capacity: 100,
2351
+ # },
2352
+ # managed_termination_protection: "DISABLED",
2353
+ # },
2354
+ # capacity_provider_arn: "arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider",
2355
+ # status: "ACTIVE",
2356
+ # tags: [
2357
+ # ],
2358
+ # update_status: "DELETE_IN_PROGRESS",
2359
+ # },
2360
+ # }
2361
+ #
2208
2362
  # @example Request syntax with placeholder values
2209
2363
  #
2210
2364
  # resp = client.delete_capacity_provider({
@@ -2642,6 +2796,57 @@ module Aws::ECS
2642
2796
  # * {Types::DeleteTaskDefinitionsResponse#task_definitions #task_definitions} => Array<Types::TaskDefinition>
2643
2797
  # * {Types::DeleteTaskDefinitionsResponse#failures #failures} => Array<Types::Failure>
2644
2798
  #
2799
+ #
2800
+ # @example Example: To delete a task definition that has been deregistered
2801
+ #
2802
+ # # This example deletes a specified deregistered task definition.
2803
+ #
2804
+ # resp = client.delete_task_definitions({
2805
+ # task_definitions: [
2806
+ # "Example-task-definition:1",
2807
+ # ],
2808
+ # })
2809
+ #
2810
+ # resp.to_h outputs the following:
2811
+ # {
2812
+ # failures: [
2813
+ # ],
2814
+ # task_definitions: [
2815
+ # {
2816
+ # container_definitions: [
2817
+ # {
2818
+ # name: "wave",
2819
+ # command: [
2820
+ # "apt-get update; apt-get install stress; while true; do stress --cpu $(( RANDOM % 4 )) -t $(( RANDOM % 10 )); done",
2821
+ # ],
2822
+ # cpu: 50,
2823
+ # entry_point: [
2824
+ # "bash",
2825
+ # "-c",
2826
+ # ],
2827
+ # environment: [
2828
+ # ],
2829
+ # essential: true,
2830
+ # image: "ubuntu",
2831
+ # memory: 100,
2832
+ # mount_points: [
2833
+ # ],
2834
+ # port_mappings: [
2835
+ # ],
2836
+ # volumes_from: [
2837
+ # ],
2838
+ # },
2839
+ # ],
2840
+ # family: "cpu-wave",
2841
+ # revision: 1,
2842
+ # status: "DELETE_IN_PROGRESS",
2843
+ # task_definition_arn: "arn:aws:ecs:us-east-1:012345678910:task-definition/Example-task-definition:1",
2844
+ # volumes: [
2845
+ # ],
2846
+ # },
2847
+ # ],
2848
+ # }
2849
+ #
2645
2850
  # @example Request syntax with placeholder values
2646
2851
  #
2647
2852
  # resp = client.delete_task_definitions({
@@ -2820,6 +3025,7 @@ module Aws::ECS
2820
3025
  # resp.task_definitions[0].deregistered_at #=> Time
2821
3026
  # resp.task_definitions[0].registered_by #=> String
2822
3027
  # resp.task_definitions[0].ephemeral_storage.size_in_gi_b #=> Integer
3028
+ # resp.task_definitions[0].enable_fault_injection #=> Boolean
2823
3029
  # resp.failures #=> Array
2824
3030
  # resp.failures[0].arn #=> String
2825
3031
  # resp.failures[0].reason #=> String
@@ -2863,6 +3069,55 @@ module Aws::ECS
2863
3069
  #
2864
3070
  # * {Types::DeleteTaskSetResponse#task_set #task_set} => Types::TaskSet
2865
3071
  #
3072
+ #
3073
+ # @example Example: To delete a task set within a service that uses the EXTERNAL deployment controller type
3074
+ #
3075
+ # # This example deletes a task set and uses the force flag to force deletion if it hasn't scaled to zero.
3076
+ #
3077
+ # resp = client.delete_task_set({
3078
+ # cluster: "MyCluster",
3079
+ # force: true,
3080
+ # service: "MyService",
3081
+ # task_set: "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
3082
+ # })
3083
+ #
3084
+ # resp.to_h outputs the following:
3085
+ # {
3086
+ # task_set: {
3087
+ # computed_desired_count: 0,
3088
+ # created_at: Time.parse(1557130260.276),
3089
+ # id: "ecs-svc/1234567890123456789",
3090
+ # launch_type: "EC2",
3091
+ # load_balancers: [
3092
+ # ],
3093
+ # network_configuration: {
3094
+ # awsvpc_configuration: {
3095
+ # assign_public_ip: "DISABLED",
3096
+ # security_groups: [
3097
+ # "sg-12345678",
3098
+ # ],
3099
+ # subnets: [
3100
+ # "subnet-12345678",
3101
+ # ],
3102
+ # },
3103
+ # },
3104
+ # pending_count: 0,
3105
+ # running_count: 0,
3106
+ # scale: {
3107
+ # value: 0,
3108
+ # unit: "PERCENT",
3109
+ # },
3110
+ # service_registries: [
3111
+ # ],
3112
+ # stability_status: "STABILIZING",
3113
+ # stability_status_at: Time.parse(1557130290.707),
3114
+ # status: "DRAINING",
3115
+ # task_definition: "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2",
3116
+ # task_set_arn: "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
3117
+ # updated_at: Time.parse(1557130290.707),
3118
+ # },
3119
+ # }
3120
+ #
2866
3121
  # @example Request syntax with placeholder values
2867
3122
  #
2868
3123
  # resp = client.delete_task_set({
@@ -3105,6 +3360,49 @@ module Aws::ECS
3105
3360
  #
3106
3361
  # * {Types::DeregisterTaskDefinitionResponse#task_definition #task_definition} => Types::TaskDefinition
3107
3362
  #
3363
+ #
3364
+ # @example Example: To deregister a revision of a task definition
3365
+ #
3366
+ # # This example deregisters the first revision of the curler task definition
3367
+ #
3368
+ # resp = client.deregister_task_definition({
3369
+ # task_definition: "curler:1",
3370
+ # })
3371
+ #
3372
+ # resp.to_h outputs the following:
3373
+ # {
3374
+ # task_definition: {
3375
+ # container_definitions: [
3376
+ # {
3377
+ # name: "curler",
3378
+ # command: [
3379
+ # "curl -v http://example.com/",
3380
+ # ],
3381
+ # cpu: 100,
3382
+ # entry_point: [
3383
+ # ],
3384
+ # environment: [
3385
+ # ],
3386
+ # essential: true,
3387
+ # image: "curl:latest",
3388
+ # memory: 256,
3389
+ # mount_points: [
3390
+ # ],
3391
+ # port_mappings: [
3392
+ # ],
3393
+ # volumes_from: [
3394
+ # ],
3395
+ # },
3396
+ # ],
3397
+ # family: "curler",
3398
+ # revision: 1,
3399
+ # status: "INACTIVE",
3400
+ # task_definition_arn: "arn:aws:ecs:us-west-2:123456789012:task-definition/curler:1",
3401
+ # volumes: [
3402
+ # ],
3403
+ # },
3404
+ # }
3405
+ #
3108
3406
  # @example Request syntax with placeholder values
3109
3407
  #
3110
3408
  # resp = client.deregister_task_definition({
@@ -3282,6 +3580,7 @@ module Aws::ECS
3282
3580
  # resp.task_definition.deregistered_at #=> Time
3283
3581
  # resp.task_definition.registered_by #=> String
3284
3582
  # resp.task_definition.ephemeral_storage.size_in_gi_b #=> Integer
3583
+ # resp.task_definition.enable_fault_injection #=> Boolean
3285
3584
  #
3286
3585
  # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeregisterTaskDefinition AWS API Documentation
3287
3586
  #
@@ -3335,6 +3634,91 @@ module Aws::ECS
3335
3634
  # * {Types::DescribeCapacityProvidersResponse#failures #failures} => Array<Types::Failure>
3336
3635
  # * {Types::DescribeCapacityProvidersResponse#next_token #next_token} => String
3337
3636
  #
3637
+ #
3638
+ # @example Example: To describe all capacity providers
3639
+ #
3640
+ # # This example retrieves details about all capacity providers.
3641
+ #
3642
+ # resp = client.describe_capacity_providers({
3643
+ # })
3644
+ #
3645
+ # resp.to_h outputs the following:
3646
+ # {
3647
+ # capacity_providers: [
3648
+ # {
3649
+ # name: "MyCapacityProvider",
3650
+ # auto_scaling_group_provider: {
3651
+ # auto_scaling_group_arn: "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
3652
+ # managed_scaling: {
3653
+ # maximum_scaling_step_size: 1000,
3654
+ # minimum_scaling_step_size: 1,
3655
+ # status: "ENABLED",
3656
+ # target_capacity: 100,
3657
+ # },
3658
+ # managed_termination_protection: "ENABLED",
3659
+ # },
3660
+ # capacity_provider_arn: "arn:aws:ecs:us-west-2:123456789012:capacity-provider/MyCapacityProvider",
3661
+ # status: "ACTIVE",
3662
+ # tags: [
3663
+ # ],
3664
+ # },
3665
+ # {
3666
+ # name: "FARGATE",
3667
+ # capacity_provider_arn: "arn:aws:ecs:us-west-2:123456789012:capacity-provider/FARGATE",
3668
+ # status: "ACTIVE",
3669
+ # tags: [
3670
+ # ],
3671
+ # },
3672
+ # {
3673
+ # name: "FARGATE_SPOT",
3674
+ # capacity_provider_arn: "arn:aws:ecs:us-west-2:123456789012:capacity-provider/FARGATE_SPOT",
3675
+ # status: "ACTIVE",
3676
+ # tags: [
3677
+ # ],
3678
+ # },
3679
+ # ],
3680
+ # }
3681
+ #
3682
+ # @example Example: To describe a specific capacity provider
3683
+ #
3684
+ # # This example retrieves details about the capacity provider MyCapacityProvider
3685
+ #
3686
+ # resp = client.describe_capacity_providers({
3687
+ # capacity_providers: [
3688
+ # "MyCapacityProvider",
3689
+ # ],
3690
+ # include: [
3691
+ # "TAGS",
3692
+ # ],
3693
+ # })
3694
+ #
3695
+ # resp.to_h outputs the following:
3696
+ # {
3697
+ # capacity_providers: [
3698
+ # {
3699
+ # name: "MyCapacityProvider",
3700
+ # auto_scaling_group_provider: {
3701
+ # auto_scaling_group_arn: "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
3702
+ # managed_scaling: {
3703
+ # maximum_scaling_step_size: 1000,
3704
+ # minimum_scaling_step_size: 1,
3705
+ # status: "ENABLED",
3706
+ # target_capacity: 100,
3707
+ # },
3708
+ # managed_termination_protection: "ENABLED",
3709
+ # },
3710
+ # capacity_provider_arn: "arn:aws:ecs:us-west-2:123456789012:capacity-provider/MyCapacityProvider",
3711
+ # status: "ACTIVE",
3712
+ # tags: [
3713
+ # {
3714
+ # key: "environment",
3715
+ # value: "production",
3716
+ # },
3717
+ # ],
3718
+ # },
3719
+ # ],
3720
+ # }
3721
+ #
3338
3722
  # @example Request syntax with placeholder values
3339
3723
  #
3340
3724
  # resp = client.describe_capacity_providers({
@@ -3715,6 +4099,46 @@ module Aws::ECS
3715
4099
  # * {Types::DescribeServiceDeploymentsResponse#service_deployments #service_deployments} => Array<Types::ServiceDeployment>
3716
4100
  # * {Types::DescribeServiceDeploymentsResponse#failures #failures} => Array<Types::Failure>
3717
4101
  #
4102
+ #
4103
+ # @example Example: To describe a service deployment
4104
+ #
4105
+ # # This example describes a service deployment for the service sd-example in the example cluster.
4106
+ #
4107
+ # resp = client.describe_service_deployments({
4108
+ # service_deployment_arns: [
4109
+ # "arn:aws:ecs:us-west-2:123456789012:service-deployment/example/sd-example/NCWGC2ZR-taawPAYrIaU5",
4110
+ # ],
4111
+ # })
4112
+ #
4113
+ # resp.to_h outputs the following:
4114
+ # {
4115
+ # failures: [
4116
+ # ],
4117
+ # service_deployments: [
4118
+ # {
4119
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/example",
4120
+ # deployment_configuration: {
4121
+ # deployment_circuit_breaker: {
4122
+ # enable: false,
4123
+ # rollback: false,
4124
+ # },
4125
+ # maximum_percent: 200,
4126
+ # minimum_healthy_percent: 100,
4127
+ # },
4128
+ # service_arn: "arn:aws:ecs:us-west-2:123456789012:service/example/sd-example",
4129
+ # service_deployment_arn: "arn:aws:ecs:us-west-2:123456789012:service-deployment/example/sd-example/NCWGC2ZR-taawPAYrIaU5",
4130
+ # status: "PENDING",
4131
+ # target_service_revision: {
4132
+ # arn: "arn:aws:ecs:us-west-2:123456789012:service-revision/example/sd-example/4980306466373577095",
4133
+ # pending_task_count: 0,
4134
+ # requested_task_count: 0,
4135
+ # running_task_count: 0,
4136
+ # },
4137
+ # updated_at: Time.parse("2024-09-10T16:49:35.572000+00:00"),
4138
+ # },
4139
+ # ],
4140
+ # }
4141
+ #
3718
4142
  # @example Request syntax with placeholder values
3719
4143
  #
3720
4144
  # resp = client.describe_service_deployments({
@@ -3807,6 +4231,46 @@ module Aws::ECS
3807
4231
  # * {Types::DescribeServiceRevisionsResponse#service_revisions #service_revisions} => Array<Types::ServiceRevision>
3808
4232
  # * {Types::DescribeServiceRevisionsResponse#failures #failures} => Array<Types::Failure>
3809
4233
  #
4234
+ #
4235
+ # @example Example: To describe a service revision
4236
+ #
4237
+ # # This example describes a service revision with the specified ARN
4238
+ #
4239
+ # resp = client.describe_service_revisions({
4240
+ # service_revision_arns: [
4241
+ # "arn:aws:ecs:us-west-2:123456789012:service-revision/testc/sd1/4980306466373577095",
4242
+ # ],
4243
+ # })
4244
+ #
4245
+ # resp.to_h outputs the following:
4246
+ # {
4247
+ # failures: [
4248
+ # ],
4249
+ # service_revisions: [
4250
+ # {
4251
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/example",
4252
+ # created_at: Time.parse("2024-09-10T16:49:26.388000+00:00"),
4253
+ # launch_type: "FARGATE",
4254
+ # network_configuration: {
4255
+ # awsvpc_configuration: {
4256
+ # assign_public_ip: "ENABLED",
4257
+ # security_groups: [
4258
+ # "sg-09605d60a6bc1b296",
4259
+ # ],
4260
+ # subnets: [
4261
+ # "subnet-0a4040e73895f04e1",
4262
+ # ],
4263
+ # },
4264
+ # },
4265
+ # platform_family: "DockerLinux",
4266
+ # platform_version: "1.4.0",
4267
+ # service_arn: "arn:aws:ecs:us-west-2:123456789012:service/example/sd-example",
4268
+ # service_revision_arn: "arn:aws:ecs:us-west-2:123456789012:service-revision/example/sd-example/4980306466373577095",
4269
+ # task_definition: "arn:aws:ecs:us-west-2:123456789012:task-definition/large-ngingx:1",
4270
+ # },
4271
+ # ],
4272
+ # }
4273
+ #
3810
4274
  # @example Request syntax with placeholder values
3811
4275
  #
3812
4276
  # resp = client.describe_service_revisions({
@@ -4453,6 +4917,7 @@ module Aws::ECS
4453
4917
  # resp.task_definition.deregistered_at #=> Time
4454
4918
  # resp.task_definition.registered_by #=> String
4455
4919
  # resp.task_definition.ephemeral_storage.size_in_gi_b #=> Integer
4920
+ # resp.task_definition.enable_fault_injection #=> Boolean
4456
4921
  # resp.tags #=> Array
4457
4922
  # resp.tags[0].key #=> String
4458
4923
  # resp.tags[0].value #=> String
@@ -4496,17 +4961,71 @@ module Aws::ECS
4496
4961
  # * {Types::DescribeTaskSetsResponse#task_sets #task_sets} => Array<Types::TaskSet>
4497
4962
  # * {Types::DescribeTaskSetsResponse#failures #failures} => Array<Types::Failure>
4498
4963
  #
4499
- # @example Request syntax with placeholder values
4964
+ #
4965
+ # @example Example: To describe a task set
4966
+ #
4967
+ # # This example describes a task set in service MyService that uses an EXTERNAL deployment controller.
4500
4968
  #
4501
4969
  # resp = client.describe_task_sets({
4502
- # cluster: "String", # required
4503
- # service: "String", # required
4504
- # task_sets: ["String"],
4505
- # include: ["TAGS"], # accepts TAGS
4970
+ # cluster: "MyCluster",
4971
+ # service: "MyService",
4972
+ # task_sets: [
4973
+ # "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
4974
+ # ],
4506
4975
  # })
4507
4976
  #
4508
- # @example Response structure
4509
- #
4977
+ # resp.to_h outputs the following:
4978
+ # {
4979
+ # failures: [
4980
+ # ],
4981
+ # task_sets: [
4982
+ # {
4983
+ # computed_desired_count: 0,
4984
+ # created_at: Time.parse(1557207715.195),
4985
+ # id: "ecs-svc/1234567890123456789",
4986
+ # launch_type: "EC2",
4987
+ # load_balancers: [
4988
+ # ],
4989
+ # network_configuration: {
4990
+ # awsvpc_configuration: {
4991
+ # assign_public_ip: "DISABLED",
4992
+ # security_groups: [
4993
+ # "sg-1234431",
4994
+ # ],
4995
+ # subnets: [
4996
+ # "subnet-12344321",
4997
+ # ],
4998
+ # },
4999
+ # },
5000
+ # pending_count: 0,
5001
+ # running_count: 0,
5002
+ # scale: {
5003
+ # value: 0,
5004
+ # unit: "PERCENT",
5005
+ # },
5006
+ # service_registries: [
5007
+ # ],
5008
+ # stability_status: "STEADY_STATE",
5009
+ # stability_status_at: Time.parse(1557207740.014),
5010
+ # status: "ACTIVE",
5011
+ # task_definition: "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2",
5012
+ # task_set_arn: "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
5013
+ # updated_at: Time.parse(1557207740.014),
5014
+ # },
5015
+ # ],
5016
+ # }
5017
+ #
5018
+ # @example Request syntax with placeholder values
5019
+ #
5020
+ # resp = client.describe_task_sets({
5021
+ # cluster: "String", # required
5022
+ # service: "String", # required
5023
+ # task_sets: ["String"],
5024
+ # include: ["TAGS"], # accepts TAGS
5025
+ # })
5026
+ #
5027
+ # @example Response structure
5028
+ #
4510
5029
  # resp.task_sets #=> Array
4511
5030
  # resp.task_sets[0].id #=> String
4512
5031
  # resp.task_sets[0].task_set_arn #=> String
@@ -4873,6 +5392,33 @@ module Aws::ECS
4873
5392
  # * {Types::ExecuteCommandResponse#session #session} => Types::Session
4874
5393
  # * {Types::ExecuteCommandResponse#task_arn #task_arn} => String
4875
5394
  #
5395
+ #
5396
+ # @example Example: To run a command remotely on a container in a task
5397
+ #
5398
+ # # This example runs an interactive /bin/sh command on a container MyContainer.
5399
+ #
5400
+ # resp = client.execute_command({
5401
+ # cluster: "MyCluster",
5402
+ # command: "/bin/sh",
5403
+ # container: "MyContainer",
5404
+ # interactive: true,
5405
+ # task: "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE",
5406
+ # })
5407
+ #
5408
+ # resp.to_h outputs the following:
5409
+ # {
5410
+ # cluster_arn: "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster",
5411
+ # container_arn: "arn:aws:ecs:us-east-1:123456789012:container/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE/43ba4b77-37f7-4a41-b923-69d4abEXAMPLE",
5412
+ # container_name: "MyContainer",
5413
+ # interactive: true,
5414
+ # session: {
5415
+ # session_id: "ecs-execute-command-794nnsxobsg4p2hiur6gxu9a9e",
5416
+ # stream_url: "wss://ssmmessages.us-east-1.amazonaws.com/v1/data-channel/ecs-execute-command-794nnsxobsg4p2hiur6gxu9a9e?role=publish_subscribe&cell-number=AAEAAfiZG4oybxqsYj3Zhm15s4J0W1k7d9nxVRenNO8Kl5nzAAAAAGdbWGl479/y/4IrTWPadUic3eBrMu3vmB7aPvI+s12lbpDc142y1KZy",
5417
+ # token_value: "AAEAAcVb7ww10N9aNUI5Cl7K7DbHjbD2Ed4Mw6uaGYIc+UFNAAAAAGdbWGmMDaPbGfDkzrVIhyKEsc4CPT2hcToPU6yzlddPm7rRZvYQtpaAgsvQdjbCAd9OB6ohtDYfqZI9gzMqLKegXq0E+KbDcGPnQVODFNHmQxnR1BvC6vNcHqh6HAJuKnQD7RSYx/J5bfYNHj4hCYHuN0HNcueSDOOTRB/MBt5DBDY7Djv2uzs9FD0N1kcsGljZkZWLuPTVKHHyrU3zh0awfrFFC3RXvgaUCBnloIIvZeq2CjTesxn9JJS+3N4I0DVxfkHdWWBbBY/5+wH82JVTJpqN3yOAt74u/W7TvYBd7Xu2lQbvtpuAnEszl++bFG2ZoV3dfnmBkSnfD/qV1FJcEskbxUHKgmqe0Paouv4zwrQKNfWYfcv9xkWskqcExh07IeaxZz1tp/WegZ5D76sD6xYeuH+35TMNXMoY7oudLgxIXsA7b39ElM7orGi4Jy3W2tLyuNIvDoI2JI6ww4tYdEjYZnld9rhKwV9rDHk1Z8wjHMs++3BIkHrFQRsv7BFUWlZ9lyqO9GWlXeBe7dQtOeFNahBuJUE9z/xLHJn1x13VkdROKqUVHTJrT4sXAnI5roWiGPoQPVY7aHVYJnwjSxrPRWJBsgyHiVN3dAWTmeVMjp0VbOiJaLlpBI+AUWs8OeVRzuJSZ+1alETpK7Ukag7ma9K4lxq/N7IxYo2ub0cG/bvX42zQqdJAW+9St9sQ1QMaMvkSq1tdbLoOuY0QjN7JrkuKLFQA5bhs+o1YwItzIp7bNrzQ9Z9IN51qoGL5HDXQzi1kNFfYtAryhwt6BgtQU9Z0k+RpE+V5G+V68E0MMUvb313f0nRBYj1u5VKonWb708wADPbUU+s7nvbWuD5oLp1Z6A4iqI9Om0R4RrFASj/7fVY7r3raNXcIYA=",
5418
+ # },
5419
+ # task_arn: "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE",
5420
+ # }
5421
+ #
4876
5422
  # @example Request syntax with placeholder values
4877
5423
  #
4878
5424
  # resp = client.execute_command({
@@ -5167,6 +5713,29 @@ module Aws::ECS
5167
5713
  #
5168
5714
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
5169
5715
  #
5716
+ #
5717
+ # @example Example: To list container instances that have a specific attribute
5718
+ #
5719
+ # # This example lists attributes for a container instance with the attribute "stack" equal to the value "production".
5720
+ #
5721
+ # resp = client.list_attributes({
5722
+ # attribute_name: "stack",
5723
+ # attribute_value: "production",
5724
+ # cluster: "MyCluster",
5725
+ # target_type: "container-instance",
5726
+ # })
5727
+ #
5728
+ # resp.to_h outputs the following:
5729
+ # {
5730
+ # attributes: [
5731
+ # {
5732
+ # name: "stack",
5733
+ # value: "production",
5734
+ # target_id: "arn:aws:ecs:us-west-2:123456789012:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34",
5735
+ # },
5736
+ # ],
5737
+ # }
5738
+ #
5170
5739
  # @example Request syntax with placeholder values
5171
5740
  #
5172
5741
  # resp = client.list_attributes({
@@ -5377,9 +5946,9 @@ module Aws::ECS
5377
5946
  # This operation lists all the service deployments that meet the
5378
5947
  # specified filter criteria.
5379
5948
  #
5380
- # A service deployment happens when you release a softwre update for the
5381
- # service. You route traffic from the running service revisions to the
5382
- # new service revison and control the number of running tasks.
5949
+ # A service deployment happens when you release a software update for
5950
+ # the service. You route traffic from the running service revisions to
5951
+ # the new service revison and control the number of running tasks.
5383
5952
  #
5384
5953
  # This API returns the values that you use for the request parameters in
5385
5954
  # [DescribeServiceRevisions][1].
@@ -5396,7 +5965,7 @@ module Aws::ECS
5396
5965
  # name or ARN. Starting April 15, 2023, Amazon Web Services will not
5397
5966
  # onboard new customers to Amazon Elastic Inference (EI), and will help
5398
5967
  # current customers migrate their workloads to options that offer better
5399
- # price and performanceIf you don't specify a cluster, `default` is
5968
+ # price and performance. If you don't specify a cluster, `default` is
5400
5969
  # used.
5401
5970
  #
5402
5971
  # @option params [Array<String>] :status
@@ -5431,6 +6000,32 @@ module Aws::ECS
5431
6000
  # * {Types::ListServiceDeploymentsResponse#service_deployments #service_deployments} => Array&lt;Types::ServiceDeploymentBrief&gt;
5432
6001
  # * {Types::ListServiceDeploymentsResponse#next_token #next_token} => String
5433
6002
  #
6003
+ #
6004
+ # @example Example: To list service deployments that meet the specified criteria
6005
+ #
6006
+ # # This example lists all successful service deployments for the service "sd-example" in the cluster "example".
6007
+ #
6008
+ # resp = client.list_service_deployments({
6009
+ # cluster: "example",
6010
+ # service: "sd-example",
6011
+ # status: [
6012
+ # "SUCCESSFUL",
6013
+ # ],
6014
+ # })
6015
+ #
6016
+ # resp.to_h outputs the following:
6017
+ # {
6018
+ # service_deployments: [
6019
+ # {
6020
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/example",
6021
+ # service_arn: "arn:aws:ecs:us-west-2:123456789012:service/example/sd-example",
6022
+ # service_deployment_arn: "arn:aws:ecs:us-west-2:123456789012:service-deployment/example/sd-example/NCWGC2ZR-taawPAYrIaU5",
6023
+ # status: "SUCCESSFUL",
6024
+ # target_service_revision_arn: "arn:aws:ecs:us-west-2:123456789012:service-revision/example/sd-example/4980306466373577095",
6025
+ # },
6026
+ # ],
6027
+ # }
6028
+ #
5434
6029
  # @example Request syntax with placeholder values
5435
6030
  #
5436
6031
  # resp = client.list_service_deployments({
@@ -6481,6 +7076,33 @@ module Aws::ECS
6481
7076
  #
6482
7077
  # * {Types::PutAttributesResponse#attributes #attributes} => Array&lt;Types::Attribute&gt;
6483
7078
  #
7079
+ #
7080
+ # @example Example: To create or update an attribute on a resource
7081
+ #
7082
+ # # This example adds an attribute "stack" with the value "production" to a container instance.
7083
+ #
7084
+ # resp = client.put_attributes({
7085
+ # attributes: [
7086
+ # {
7087
+ # name: "stack",
7088
+ # value: "production",
7089
+ # target_id: "arn:aws:ecs:us-west-2:123456789012:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34",
7090
+ # },
7091
+ # ],
7092
+ # cluster: "MyCluster",
7093
+ # })
7094
+ #
7095
+ # resp.to_h outputs the following:
7096
+ # {
7097
+ # attributes: [
7098
+ # {
7099
+ # name: "stack",
7100
+ # value: "production",
7101
+ # target_id: "arn:aws:ecs:us-west-2:123456789012:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34",
7102
+ # },
7103
+ # ],
7104
+ # }
7105
+ #
6484
7106
  # @example Request syntax with placeholder values
6485
7107
  #
6486
7108
  # resp = client.put_attributes({
@@ -6589,6 +7211,260 @@ module Aws::ECS
6589
7211
  #
6590
7212
  # * {Types::PutClusterCapacityProvidersResponse#cluster #cluster} => Types::Cluster
6591
7213
  #
7214
+ #
7215
+ # @example Example: To add an existing capacity provider to a cluuster
7216
+ #
7217
+ # # This example adds an existing capacity provider "MyCapacityProvider2" to a cluster that already has the capacity
7218
+ # # provider "MyCapacityProvider1" associated with it. Both "MyCapacityProvider2" and "MyCapacityProvider1" need to be
7219
+ # # specified.
7220
+ #
7221
+ # resp = client.put_cluster_capacity_providers({
7222
+ # capacity_providers: [
7223
+ # "MyCapacityProvider1",
7224
+ # "MyCapacityProvider2",
7225
+ # ],
7226
+ # cluster: "MyCluster",
7227
+ # default_capacity_provider_strategy: [
7228
+ # {
7229
+ # capacity_provider: "MyCapacityProvider1",
7230
+ # weight: 1,
7231
+ # },
7232
+ # {
7233
+ # capacity_provider: "MyCapacityProvider2",
7234
+ # weight: 1,
7235
+ # },
7236
+ # ],
7237
+ # })
7238
+ #
7239
+ # resp.to_h outputs the following:
7240
+ # {
7241
+ # cluster: {
7242
+ # active_services_count: 0,
7243
+ # attachments: [
7244
+ # {
7245
+ # type: "as_policy",
7246
+ # details: [
7247
+ # {
7248
+ # name: "capacityProviderName",
7249
+ # value: "MyCapacityProvider1",
7250
+ # },
7251
+ # {
7252
+ # name: "scalingPolicyName",
7253
+ # value: "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
7254
+ # },
7255
+ # ],
7256
+ # id: "0fb0c8f4-6edd-4de1-9b09-17e470ee1918",
7257
+ # status: "ACTIVE",
7258
+ # },
7259
+ # {
7260
+ # type: "as_policy",
7261
+ # details: [
7262
+ # {
7263
+ # name: "capacityProviderName",
7264
+ # value: "MyCapacityProvider2",
7265
+ # },
7266
+ # {
7267
+ # name: "scalingPolicyName",
7268
+ # value: "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
7269
+ # },
7270
+ # ],
7271
+ # id: "ae592060-2382-4663-9476-b015c685593c",
7272
+ # status: "ACTIVE",
7273
+ # },
7274
+ # ],
7275
+ # attachments_status: "UPDATE_IN_PROGRESS",
7276
+ # capacity_providers: [
7277
+ # "MyCapacityProvider1",
7278
+ # "MyCapacityProvider2",
7279
+ # ],
7280
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
7281
+ # cluster_name: "MyCluster",
7282
+ # default_capacity_provider_strategy: [
7283
+ # {
7284
+ # base: 0,
7285
+ # capacity_provider: "MyCapacityProvider1",
7286
+ # weight: 1,
7287
+ # },
7288
+ # {
7289
+ # base: 0,
7290
+ # capacity_provider: "MyCapacityProvider2",
7291
+ # weight: 1,
7292
+ # },
7293
+ # ],
7294
+ # pending_tasks_count: 0,
7295
+ # registered_container_instances_count: 0,
7296
+ # running_tasks_count: 0,
7297
+ # settings: [
7298
+ # {
7299
+ # name: "containerInsights",
7300
+ # value: "enabled",
7301
+ # },
7302
+ # ],
7303
+ # statistics: [
7304
+ # ],
7305
+ # status: "ACTIVE",
7306
+ # tags: [
7307
+ # ],
7308
+ # },
7309
+ # }
7310
+ #
7311
+ # @example Example: To remove a capacity provider from a cluster
7312
+ #
7313
+ # # This example removes a capacity provider "MyCapacityProvider2" from a cluster that has both "MyCapacityProvider2" and
7314
+ # # "MyCapacityProvider1" associated with it. Only "MyCapacityProvider1" needs to be specified in this scenario.
7315
+ #
7316
+ # resp = client.put_cluster_capacity_providers({
7317
+ # capacity_providers: [
7318
+ # "MyCapacityProvider1",
7319
+ # ],
7320
+ # cluster: "MyCluster",
7321
+ # default_capacity_provider_strategy: [
7322
+ # {
7323
+ # base: 0,
7324
+ # capacity_provider: "MyCapacityProvider1",
7325
+ # weight: 1,
7326
+ # },
7327
+ # ],
7328
+ # })
7329
+ #
7330
+ # resp.to_h outputs the following:
7331
+ # {
7332
+ # cluster: {
7333
+ # active_services_count: 0,
7334
+ # attachments: [
7335
+ # {
7336
+ # type: "as_policy",
7337
+ # details: [
7338
+ # {
7339
+ # name: "capacityProviderName",
7340
+ # value: "MyCapacityProvider1",
7341
+ # },
7342
+ # {
7343
+ # name: "scalingPolicyName",
7344
+ # value: "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
7345
+ # },
7346
+ # ],
7347
+ # id: "0fb0c8f4-6edd-4de1-9b09-17e470ee1918",
7348
+ # status: "ACTIVE",
7349
+ # },
7350
+ # {
7351
+ # type: "as_policy",
7352
+ # details: [
7353
+ # {
7354
+ # name: "capacityProviderName",
7355
+ # value: "MyCapacityProvider2",
7356
+ # },
7357
+ # {
7358
+ # name: "scalingPolicyName",
7359
+ # value: "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
7360
+ # },
7361
+ # ],
7362
+ # id: "ae592060-2382-4663-9476-b015c685593c",
7363
+ # status: "DELETING",
7364
+ # },
7365
+ # ],
7366
+ # attachments_status: "UPDATE_IN_PROGRESS",
7367
+ # capacity_providers: [
7368
+ # "MyCapacityProvider1",
7369
+ # ],
7370
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
7371
+ # cluster_name: "MyCluster",
7372
+ # default_capacity_provider_strategy: [
7373
+ # {
7374
+ # base: 0,
7375
+ # capacity_provider: "MyCapacityProvider1",
7376
+ # weight: 1,
7377
+ # },
7378
+ # ],
7379
+ # pending_tasks_count: 0,
7380
+ # registered_container_instances_count: 0,
7381
+ # running_tasks_count: 0,
7382
+ # settings: [
7383
+ # {
7384
+ # name: "containerInsights",
7385
+ # value: "enabled",
7386
+ # },
7387
+ # ],
7388
+ # statistics: [
7389
+ # ],
7390
+ # status: "ACTIVE",
7391
+ # tags: [
7392
+ # ],
7393
+ # },
7394
+ # }
7395
+ #
7396
+ # @example Example: To remove all capacity providers from a cluster
7397
+ #
7398
+ # # This example removes all capacity providers associated with a cluster.
7399
+ #
7400
+ # resp = client.put_cluster_capacity_providers({
7401
+ # capacity_providers: [
7402
+ # ],
7403
+ # cluster: "MyCluster",
7404
+ # default_capacity_provider_strategy: [
7405
+ # ],
7406
+ # })
7407
+ #
7408
+ # resp.to_h outputs the following:
7409
+ # {
7410
+ # cluster: {
7411
+ # active_services_count: 0,
7412
+ # attachments: [
7413
+ # {
7414
+ # type: "as_policy",
7415
+ # details: [
7416
+ # {
7417
+ # name: "capacityProviderName",
7418
+ # value: "MyCapacityProvider1",
7419
+ # },
7420
+ # {
7421
+ # name: "scalingPolicyName",
7422
+ # value: "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
7423
+ # },
7424
+ # ],
7425
+ # id: "0fb0c8f4-6edd-4de1-9b09-17e470ee1918",
7426
+ # status: "DELETING",
7427
+ # },
7428
+ # {
7429
+ # type: "as_policy",
7430
+ # details: [
7431
+ # {
7432
+ # name: "capacityProviderName",
7433
+ # value: "MyCapacityProvider2",
7434
+ # },
7435
+ # {
7436
+ # name: "scalingPolicyName",
7437
+ # value: "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
7438
+ # },
7439
+ # ],
7440
+ # id: "ae592060-2382-4663-9476-b015c685593c",
7441
+ # status: "DELETING",
7442
+ # },
7443
+ # ],
7444
+ # attachments_status: "UPDATE_IN_PROGRESS",
7445
+ # capacity_providers: [
7446
+ # ],
7447
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
7448
+ # cluster_name: "MyCluster",
7449
+ # default_capacity_provider_strategy: [
7450
+ # ],
7451
+ # pending_tasks_count: 0,
7452
+ # registered_container_instances_count: 0,
7453
+ # running_tasks_count: 0,
7454
+ # settings: [
7455
+ # {
7456
+ # name: "containerInsights",
7457
+ # value: "enabled",
7458
+ # },
7459
+ # ],
7460
+ # statistics: [
7461
+ # ],
7462
+ # status: "ACTIVE",
7463
+ # tags: [
7464
+ # ],
7465
+ # },
7466
+ # }
7467
+ #
6592
7468
  # @example Request syntax with placeholder values
6593
7469
  #
6594
7470
  # resp = client.put_cluster_capacity_providers({
@@ -7193,6 +8069,11 @@ module Aws::ECS
7193
8069
  # The operating system that your tasks definitions run on. A platform
7194
8070
  # family is specified only for tasks using the Fargate launch type.
7195
8071
  #
8072
+ # @option params [Boolean] :enable_fault_injection
8073
+ # Enables fault injection when you register your task definition and
8074
+ # allows for fault injection requests to be accepted from the task's
8075
+ # containers. The default value is `false`.
8076
+ #
7196
8077
  # @return [Types::RegisterTaskDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7197
8078
  #
7198
8079
  # * {Types::RegisterTaskDefinitionResponse#task_definition #task_definition} => Types::TaskDefinition
@@ -7500,6 +8381,7 @@ module Aws::ECS
7500
8381
  # cpu_architecture: "X86_64", # accepts X86_64, ARM64
7501
8382
  # operating_system_family: "WINDOWS_SERVER_2019_FULL", # accepts WINDOWS_SERVER_2019_FULL, WINDOWS_SERVER_2019_CORE, WINDOWS_SERVER_2016_FULL, WINDOWS_SERVER_2004_CORE, WINDOWS_SERVER_2022_CORE, WINDOWS_SERVER_2022_FULL, WINDOWS_SERVER_20H2_CORE, LINUX
7502
8383
  # },
8384
+ # enable_fault_injection: false,
7503
8385
  # })
7504
8386
  #
7505
8387
  # @example Response structure
@@ -7673,6 +8555,7 @@ module Aws::ECS
7673
8555
  # resp.task_definition.deregistered_at #=> Time
7674
8556
  # resp.task_definition.registered_by #=> String
7675
8557
  # resp.task_definition.ephemeral_storage.size_in_gi_b #=> Integer
8558
+ # resp.task_definition.enable_fault_injection #=> Boolean
7676
8559
  # resp.tags #=> Array
7677
8560
  # resp.tags[0].key #=> String
7678
8561
  # resp.tags[0].value #=> String
@@ -8417,33 +9300,89 @@ module Aws::ECS
8417
9300
  # * {Types::StartTaskResponse#tasks #tasks} => Array&lt;Types::Task&gt;
8418
9301
  # * {Types::StartTaskResponse#failures #failures} => Array&lt;Types::Failure&gt;
8419
9302
  #
8420
- # @example Request syntax with placeholder values
9303
+ #
9304
+ # @example Example: To start a new task
9305
+ #
9306
+ # # This example starts a new task in the cluster "MyCluster" on the specified container instance using the latest revision
9307
+ # # of the "hello-world" task definition.
8421
9308
  #
8422
9309
  # resp = client.start_task({
8423
- # cluster: "String",
8424
- # container_instances: ["String"], # required
8425
- # enable_ecs_managed_tags: false,
8426
- # enable_execute_command: false,
8427
- # group: "String",
8428
- # network_configuration: {
8429
- # awsvpc_configuration: {
8430
- # subnets: ["String"], # required
8431
- # security_groups: ["String"],
8432
- # assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
8433
- # },
8434
- # },
8435
- # overrides: {
8436
- # container_overrides: [
8437
- # {
8438
- # name: "String",
8439
- # command: ["String"],
8440
- # environment: [
8441
- # {
8442
- # name: "String",
8443
- # value: "String",
8444
- # },
8445
- # ],
8446
- # environment_files: [
9310
+ # cluster: "MyCluster",
9311
+ # container_instances: [
9312
+ # "4c543eed-f83f-47da-b1d8-3d23f1da4c64",
9313
+ # ],
9314
+ # task_definition: "hello-world",
9315
+ # })
9316
+ #
9317
+ # resp.to_h outputs the following:
9318
+ # {
9319
+ # failures: [
9320
+ # ],
9321
+ # tasks: [
9322
+ # {
9323
+ # version: 1,
9324
+ # cluster_arn: "arn:aws:ecs:us-east-1:012345678910:cluster/default",
9325
+ # container_instance_arn: "arn:aws:ecs:us-east-1:012345678910:container-instance/default/4c543eed-f83f-47da-b1d8-3d23f1da4c64",
9326
+ # containers: [
9327
+ # {
9328
+ # name: "wordpress",
9329
+ # container_arn: "arn:aws:ecs:us-east-1:012345678910:container/e76594d4-27e1-4c74-98b5-46a6435eb769",
9330
+ # last_status: "PENDING",
9331
+ # task_arn: "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb",
9332
+ # },
9333
+ # {
9334
+ # name: "mysql",
9335
+ # container_arn: "arn:aws:ecs:us-east-1:012345678910:container/default/b19106ea-4fa8-4f1d-9767-96922c82b070",
9336
+ # last_status: "PENDING",
9337
+ # task_arn: "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb",
9338
+ # },
9339
+ # ],
9340
+ # created_at: Time.parse(1479765460.842),
9341
+ # desired_status: "RUNNING",
9342
+ # last_status: "PENDING",
9343
+ # overrides: {
9344
+ # container_overrides: [
9345
+ # {
9346
+ # name: "wordpress",
9347
+ # },
9348
+ # {
9349
+ # name: "mysql",
9350
+ # },
9351
+ # ],
9352
+ # },
9353
+ # task_arn: "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb",
9354
+ # task_definition_arn: "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6",
9355
+ # },
9356
+ # ],
9357
+ # }
9358
+ #
9359
+ # @example Request syntax with placeholder values
9360
+ #
9361
+ # resp = client.start_task({
9362
+ # cluster: "String",
9363
+ # container_instances: ["String"], # required
9364
+ # enable_ecs_managed_tags: false,
9365
+ # enable_execute_command: false,
9366
+ # group: "String",
9367
+ # network_configuration: {
9368
+ # awsvpc_configuration: {
9369
+ # subnets: ["String"], # required
9370
+ # security_groups: ["String"],
9371
+ # assign_public_ip: "ENABLED", # accepts ENABLED, DISABLED
9372
+ # },
9373
+ # },
9374
+ # overrides: {
9375
+ # container_overrides: [
9376
+ # {
9377
+ # name: "String",
9378
+ # command: ["String"],
9379
+ # environment: [
9380
+ # {
9381
+ # name: "String",
9382
+ # value: "String",
9383
+ # },
9384
+ # ],
9385
+ # environment_files: [
8447
9386
  # {
8448
9387
  # value: "String", # required
8449
9388
  # type: "s3", # required, accepts s3
@@ -8689,6 +9628,68 @@ module Aws::ECS
8689
9628
  #
8690
9629
  # * {Types::StopTaskResponse#task #task} => Types::Task
8691
9630
  #
9631
+ #
9632
+ # @example Example: To stop a task
9633
+ #
9634
+ # # This example stops a task with ID "1dc5c17a-422b-4dc4-b493-371970c6c4d6" in cluster "MyCluster".
9635
+ #
9636
+ # resp = client.stop_task({
9637
+ # cluster: "MyCluster",
9638
+ # reason: "testing stop task.",
9639
+ # task: "1dc5c17a-422b-4dc4-b493-371970c6c4d6",
9640
+ # })
9641
+ #
9642
+ # resp.to_h outputs the following:
9643
+ # {
9644
+ # task: {
9645
+ # version: 0,
9646
+ # cluster_arn: "arn:aws:ecs:us-east-1:012345678910:cluster/MyCluster",
9647
+ # container_instance_arn: "arn:aws:ecs:us-east-1:012345678910:container-instance/MyCluster/5991d8da-1d59-49d2-a31f-4230f9e73140",
9648
+ # containers: [
9649
+ # {
9650
+ # name: "simple-app",
9651
+ # container_arn: "arn:aws:ecs:us-east-1:012345678910:container/4df26bb4-f057-467b-a079-961675296e64",
9652
+ # last_status: "RUNNING",
9653
+ # network_bindings: [
9654
+ # {
9655
+ # bind_ip: "0.0.0.0",
9656
+ # container_port: 80,
9657
+ # host_port: 32774,
9658
+ # protocol: "tcp",
9659
+ # },
9660
+ # ],
9661
+ # task_arn: "arn:aws:ecs:us-east-1:012345678910:task/MyCluster/1dc5c17a-422b-4dc4-b493-371970c6c4d6",
9662
+ # },
9663
+ # {
9664
+ # name: "busybox",
9665
+ # container_arn: "arn:aws:ecs:us-east-1:012345678910:container/e09064f7-7361-4c87-8ab9-8d073bbdbcb9",
9666
+ # last_status: "RUNNING",
9667
+ # network_bindings: [
9668
+ # ],
9669
+ # task_arn: "arn:aws:ecs:us-east-1:012345678910:task/MyCluster/1dc5c17a-422b-4dc4-b493-371970c6c4d6",
9670
+ # },
9671
+ # ],
9672
+ # created_at: Time.parse(1476822811.295),
9673
+ # desired_status: "STOPPED",
9674
+ # last_status: "RUNNING",
9675
+ # overrides: {
9676
+ # container_overrides: [
9677
+ # {
9678
+ # name: "simple-app",
9679
+ # },
9680
+ # {
9681
+ # name: "busybox",
9682
+ # },
9683
+ # ],
9684
+ # },
9685
+ # started_at: Time.parse(1476822833.998),
9686
+ # started_by: "ecs-svc/9223370560032507596",
9687
+ # stopped_reason: "testing stop task.",
9688
+ # task_arn: "arn:aws:ecs:us-east-1:012345678910:task/1dc5c17a-422b-4dc4-b493-371970c6c4d6",
9689
+ # task_definition_arn: "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-dynamic-ports:1",
9690
+ # },
9691
+ # }
9692
+ #
8692
9693
  # @example Request syntax with placeholder values
8693
9694
  #
8694
9695
  # resp = client.stop_task({
@@ -9168,6 +10169,46 @@ module Aws::ECS
9168
10169
  #
9169
10170
  # * {Types::UpdateCapacityProviderResponse#capacity_provider #capacity_provider} => Types::CapacityProvider
9170
10171
  #
10172
+ #
10173
+ # @example Example: To update a capacity provider's parameters
10174
+ #
10175
+ # # This example updates the targetCapacity and instanceWarmupPeriod parameters for the capacity provider MyCapacityProvider
10176
+ # # to 90 and 150 respectively.
10177
+ #
10178
+ # resp = client.update_capacity_provider({
10179
+ # name: "MyCapacityProvider",
10180
+ # auto_scaling_group_provider: {
10181
+ # managed_scaling: {
10182
+ # instance_warmup_period: 150,
10183
+ # status: "ENABLED",
10184
+ # target_capacity: 90,
10185
+ # },
10186
+ # },
10187
+ # })
10188
+ #
10189
+ # resp.to_h outputs the following:
10190
+ # {
10191
+ # capacity_provider: {
10192
+ # name: "MyCapacityProvider",
10193
+ # auto_scaling_group_provider: {
10194
+ # auto_scaling_group_arn: "arn:aws:autoscaling:us-east-1:132456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG",
10195
+ # managed_scaling: {
10196
+ # instance_warmup_period: 150,
10197
+ # maximum_scaling_step_size: 10000,
10198
+ # minimum_scaling_step_size: 1,
10199
+ # status: "ENABLED",
10200
+ # target_capacity: 90,
10201
+ # },
10202
+ # managed_termination_protection: "ENABLED",
10203
+ # },
10204
+ # capacity_provider_arn: "arn:aws:ecs:us-east-1:123456789012:capacity-provider/MyCapacityProvider",
10205
+ # status: "ACTIVE",
10206
+ # tags: [
10207
+ # ],
10208
+ # update_status: "UPDATE_COMPLETE",
10209
+ # },
10210
+ # }
10211
+ #
9171
10212
  # @example Request syntax with placeholder values
9172
10213
  #
9173
10214
  # resp = client.update_capacity_provider({
@@ -9250,6 +10291,198 @@ module Aws::ECS
9250
10291
  #
9251
10292
  # * {Types::UpdateClusterResponse#cluster #cluster} => Types::Cluster
9252
10293
  #
10294
+ #
10295
+ # @example Example: To update a cluster's observability settings.
10296
+ #
10297
+ # # This example turns on enhanced containerInsights in an existing cluster.
10298
+ #
10299
+ # resp = client.update_cluster({
10300
+ # cluster: "ECS-project-update-cluster",
10301
+ # settings: [
10302
+ # {
10303
+ # name: "containerInsights",
10304
+ # value: "enhanced",
10305
+ # },
10306
+ # ],
10307
+ # })
10308
+ #
10309
+ # resp.to_h outputs the following:
10310
+ # {
10311
+ # cluster: {
10312
+ # active_services_count: 0,
10313
+ # attachments: [
10314
+ # {
10315
+ # type: "as_policy",
10316
+ # details: [
10317
+ # {
10318
+ # name: "capacityProviderName",
10319
+ # value: "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
10320
+ # },
10321
+ # {
10322
+ # name: "scalingPolicyName",
10323
+ # value: "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93",
10324
+ # },
10325
+ # ],
10326
+ # id: "069d002b-7634-42e4-b1d4-544f4c8f6380",
10327
+ # status: "CREATED",
10328
+ # },
10329
+ # {
10330
+ # type: "managed_draining",
10331
+ # details: [
10332
+ # {
10333
+ # name: "capacityProviderName",
10334
+ # value: "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
10335
+ # },
10336
+ # {
10337
+ # name: "autoScalingLifecycleHookName",
10338
+ # value: "ecs-managed-draining-termination-hook",
10339
+ # },
10340
+ # ],
10341
+ # id: "08b5b6ca-45e9-4209-a65d-e962a27c490a",
10342
+ # status: "CREATED",
10343
+ # },
10344
+ # {
10345
+ # type: "sc",
10346
+ # details: [
10347
+ # ],
10348
+ # id: "45d0b36f-8cff-46b6-9380-1288744802ab",
10349
+ # status: "ATTACHED",
10350
+ # },
10351
+ # ],
10352
+ # attachments_status: "UPDATE_COMPLETE",
10353
+ # capacity_providers: [
10354
+ # "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
10355
+ # ],
10356
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster",
10357
+ # cluster_name: "ECS-project-update-cluster",
10358
+ # default_capacity_provider_strategy: [
10359
+ # {
10360
+ # base: 0,
10361
+ # capacity_provider: "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
10362
+ # weight: 1,
10363
+ # },
10364
+ # ],
10365
+ # pending_tasks_count: 0,
10366
+ # registered_container_instances_count: 0,
10367
+ # running_tasks_count: 0,
10368
+ # service_connect_defaults: {
10369
+ # namespace: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-igwrsylmy3kwvcdx",
10370
+ # },
10371
+ # settings: [
10372
+ # {
10373
+ # name: "containerInsights",
10374
+ # value: "enhanced",
10375
+ # },
10376
+ # ],
10377
+ # statistics: [
10378
+ # ],
10379
+ # status: "ACTIVE",
10380
+ # tags: [
10381
+ # ],
10382
+ # },
10383
+ # }
10384
+ #
10385
+ # @example Example: To update a cluster's Service Connect defaults.
10386
+ #
10387
+ # # This example sets a default Service Connect namespace.
10388
+ #
10389
+ # resp = client.update_cluster({
10390
+ # cluster: "ECS-project-update-cluster",
10391
+ # service_connect_defaults: {
10392
+ # namespace: "test",
10393
+ # },
10394
+ # })
10395
+ #
10396
+ # resp.to_h outputs the following:
10397
+ # {
10398
+ # cluster: {
10399
+ # active_services_count: 0,
10400
+ # attachments: [
10401
+ # {
10402
+ # type: "as_policy",
10403
+ # details: [
10404
+ # {
10405
+ # name: "capacityProviderName",
10406
+ # value: "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
10407
+ # },
10408
+ # {
10409
+ # name: "scalingPolicyName",
10410
+ # value: "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93",
10411
+ # },
10412
+ # ],
10413
+ # id: "069d002b-7634-42e4-b1d4-544f4c8f6380",
10414
+ # status: "CREATED",
10415
+ # },
10416
+ # {
10417
+ # type: "managed_draining",
10418
+ # details: [
10419
+ # {
10420
+ # name: "capacityProviderName",
10421
+ # value: "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
10422
+ # },
10423
+ # {
10424
+ # name: "autoScalingLifecycleHookName",
10425
+ # value: "ecs-managed-draining-termination-hook",
10426
+ # },
10427
+ # ],
10428
+ # id: "08b5b6ca-45e9-4209-a65d-e962a27c490a",
10429
+ # status: "CREATED",
10430
+ # },
10431
+ # {
10432
+ # type: "sc",
10433
+ # details: [
10434
+ # ],
10435
+ # id: "45d0b36f-8cff-46b6-9380-1288744802ab",
10436
+ # status: "DELETED",
10437
+ # },
10438
+ # {
10439
+ # type: "sc",
10440
+ # details: [
10441
+ # ],
10442
+ # id: "3e6890c3-609c-4832-91de-d6ca891b3ef1",
10443
+ # status: "ATTACHED",
10444
+ # },
10445
+ # {
10446
+ # type: "sc",
10447
+ # details: [
10448
+ # ],
10449
+ # id: "961b8ec1-c2f1-4070-8495-e669b7668e90",
10450
+ # status: "DELETED",
10451
+ # },
10452
+ # ],
10453
+ # attachments_status: "UPDATE_COMPLETE",
10454
+ # capacity_providers: [
10455
+ # "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
10456
+ # ],
10457
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster",
10458
+ # cluster_name: "ECS-project-update-cluster",
10459
+ # default_capacity_provider_strategy: [
10460
+ # {
10461
+ # base: 0,
10462
+ # capacity_provider: "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
10463
+ # weight: 1,
10464
+ # },
10465
+ # ],
10466
+ # pending_tasks_count: 0,
10467
+ # registered_container_instances_count: 0,
10468
+ # running_tasks_count: 0,
10469
+ # service_connect_defaults: {
10470
+ # namespace: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-dtjmxqpfi46ht7dr",
10471
+ # },
10472
+ # settings: [
10473
+ # {
10474
+ # name: "containerInsights",
10475
+ # value: "enhanced",
10476
+ # },
10477
+ # ],
10478
+ # statistics: [
10479
+ # ],
10480
+ # status: "ACTIVE",
10481
+ # tags: [
10482
+ # ],
10483
+ # },
10484
+ # }
10485
+ #
9253
10486
  # @example Request syntax with placeholder values
9254
10487
  #
9255
10488
  # resp = client.update_cluster({
@@ -9361,6 +10594,44 @@ module Aws::ECS
9361
10594
  #
9362
10595
  # * {Types::UpdateClusterSettingsResponse#cluster #cluster} => Types::Cluster
9363
10596
  #
10597
+ #
10598
+ # @example Example: To update a cluster's settings
10599
+ #
10600
+ # # This example enables CloudWatch Container Insights for the default cluster.
10601
+ #
10602
+ # resp = client.update_cluster_settings({
10603
+ # cluster: "default",
10604
+ # settings: [
10605
+ # {
10606
+ # name: "containerInsights",
10607
+ # value: "enabled",
10608
+ # },
10609
+ # ],
10610
+ # })
10611
+ #
10612
+ # resp.to_h outputs the following:
10613
+ # {
10614
+ # cluster: {
10615
+ # active_services_count: 0,
10616
+ # cluster_arn: "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
10617
+ # cluster_name: "default",
10618
+ # pending_tasks_count: 0,
10619
+ # registered_container_instances_count: 0,
10620
+ # running_tasks_count: 0,
10621
+ # settings: [
10622
+ # {
10623
+ # name: "containerInsights",
10624
+ # value: "enabled",
10625
+ # },
10626
+ # ],
10627
+ # statistics: [
10628
+ # ],
10629
+ # status: "ACTIVE",
10630
+ # tags: [
10631
+ # ],
10632
+ # },
10633
+ # }
10634
+ #
9364
10635
  # @example Request syntax with placeholder values
9365
10636
  #
9366
10637
  # resp = client.update_cluster_settings({
@@ -9473,6 +10744,29 @@ module Aws::ECS
9473
10744
  #
9474
10745
  # * {Types::UpdateContainerAgentResponse#container_instance #container_instance} => Types::ContainerInstance
9475
10746
  #
10747
+ #
10748
+ # @example Example: To update the container agent version on a container instance
10749
+ #
10750
+ # # This example updates the container agent version on the specified container instance in cluster MyCluster.
10751
+ #
10752
+ # resp = client.update_container_agent({
10753
+ # cluster: "MyCluster",
10754
+ # container_instance: "53ac7152-dcd1-4102-81f5-208962864132",
10755
+ # })
10756
+ #
10757
+ # resp.to_h outputs the following:
10758
+ # {
10759
+ # container_instance: {
10760
+ # agent_connected: true,
10761
+ # agent_update_status: "PENDING",
10762
+ # version_info: {
10763
+ # agent_hash: "4023248",
10764
+ # agent_version: "1.0.0",
10765
+ # docker_version: "DockerVersion: 1.5.0",
10766
+ # },
10767
+ # },
10768
+ # }
10769
+ #
9476
10770
  # @example Request syntax with placeholder values
9477
10771
  #
9478
10772
  # resp = client.update_container_agent({
@@ -9625,6 +10919,179 @@ module Aws::ECS
9625
10919
  # * {Types::UpdateContainerInstancesStateResponse#container_instances #container_instances} => Array&lt;Types::ContainerInstance&gt;
9626
10920
  # * {Types::UpdateContainerInstancesStateResponse#failures #failures} => Array&lt;Types::Failure&gt;
9627
10921
  #
10922
+ #
10923
+ # @example Example: To update the state of a container instance
10924
+ #
10925
+ # # This example updates the state of the specified container instance in the default cluster to DRAINING.
10926
+ #
10927
+ # resp = client.update_container_instances_state({
10928
+ # cluster: "default",
10929
+ # container_instances: [
10930
+ # "1c3be8ed-df30-47b4-8f1e-6e68ebd01f34",
10931
+ # ],
10932
+ # status: "DRAINING",
10933
+ # })
10934
+ #
10935
+ # resp.to_h outputs the following:
10936
+ # {
10937
+ # container_instances: [
10938
+ # {
10939
+ # version: 30,
10940
+ # agent_connected: true,
10941
+ # attributes: [
10942
+ # {
10943
+ # name: "ecs.availability-zone",
10944
+ # value: "us-west-2b",
10945
+ # },
10946
+ # {
10947
+ # name: "com.amazonaws.ecs.capability.logging-driver.syslog",
10948
+ # },
10949
+ # {
10950
+ # name: "ecs.instance-type",
10951
+ # value: "c4.xlarge",
10952
+ # },
10953
+ # {
10954
+ # name: "ecs.ami-id",
10955
+ # value: "ami-a2ca61c2",
10956
+ # },
10957
+ # {
10958
+ # name: "com.amazonaws.ecs.capability.task-iam-role-network-host",
10959
+ # },
10960
+ # {
10961
+ # name: "com.amazonaws.ecs.capability.logging-driver.awslogs",
10962
+ # },
10963
+ # {
10964
+ # name: "com.amazonaws.ecs.capability.logging-driver.json-file",
10965
+ # },
10966
+ # {
10967
+ # name: "com.amazonaws.ecs.capability.docker-remote-api.1.17",
10968
+ # },
10969
+ # {
10970
+ # name: "com.amazonaws.ecs.capability.privileged-container",
10971
+ # },
10972
+ # {
10973
+ # name: "com.amazonaws.ecs.capability.docker-remote-api.1.18",
10974
+ # },
10975
+ # {
10976
+ # name: "com.amazonaws.ecs.capability.docker-remote-api.1.19",
10977
+ # },
10978
+ # {
10979
+ # name: "com.amazonaws.ecs.capability.ecr-auth",
10980
+ # },
10981
+ # {
10982
+ # name: "ecs.os-type",
10983
+ # value: "linux",
10984
+ # },
10985
+ # {
10986
+ # name: "com.amazonaws.ecs.capability.docker-remote-api.1.20",
10987
+ # },
10988
+ # {
10989
+ # name: "com.amazonaws.ecs.capability.docker-remote-api.1.21",
10990
+ # },
10991
+ # {
10992
+ # name: "com.amazonaws.ecs.capability.docker-remote-api.1.22",
10993
+ # },
10994
+ # {
10995
+ # name: "com.amazonaws.ecs.capability.task-iam-role",
10996
+ # },
10997
+ # {
10998
+ # name: "com.amazonaws.ecs.capability.docker-remote-api.1.23",
10999
+ # },
11000
+ # ],
11001
+ # container_instance_arn: "arn:aws:ecs:us-west-2:012345678910:container-instance/default/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34",
11002
+ # ec2_instance_id: "i-05d99c76955727ec6",
11003
+ # pending_tasks_count: 0,
11004
+ # registered_resources: [
11005
+ # {
11006
+ # name: "CPU",
11007
+ # type: "INTEGER",
11008
+ # double_value: 0,
11009
+ # integer_value: 4096,
11010
+ # long_value: 0,
11011
+ # },
11012
+ # {
11013
+ # name: "MEMORY",
11014
+ # type: "INTEGER",
11015
+ # double_value: 0,
11016
+ # integer_value: 7482,
11017
+ # long_value: 0,
11018
+ # },
11019
+ # {
11020
+ # name: "PORTS",
11021
+ # type: "STRINGSET",
11022
+ # double_value: 0,
11023
+ # integer_value: 0,
11024
+ # long_value: 0,
11025
+ # string_set_value: [
11026
+ # "22",
11027
+ # "2376",
11028
+ # "2375",
11029
+ # "51678",
11030
+ # "51679",
11031
+ # ],
11032
+ # },
11033
+ # {
11034
+ # name: "PORTS_UDP",
11035
+ # type: "STRINGSET",
11036
+ # double_value: 0,
11037
+ # integer_value: 0,
11038
+ # long_value: 0,
11039
+ # string_set_value: [
11040
+ # ],
11041
+ # },
11042
+ # ],
11043
+ # remaining_resources: [
11044
+ # {
11045
+ # name: "CPU",
11046
+ # type: "INTEGER",
11047
+ # double_value: 0,
11048
+ # integer_value: 4096,
11049
+ # long_value: 0,
11050
+ # },
11051
+ # {
11052
+ # name: "MEMORY",
11053
+ # type: "INTEGER",
11054
+ # double_value: 0,
11055
+ # integer_value: 7482,
11056
+ # long_value: 0,
11057
+ # },
11058
+ # {
11059
+ # name: "PORTS",
11060
+ # type: "STRINGSET",
11061
+ # double_value: 0,
11062
+ # integer_value: 0,
11063
+ # long_value: 0,
11064
+ # string_set_value: [
11065
+ # "22",
11066
+ # "2376",
11067
+ # "2375",
11068
+ # "51678",
11069
+ # "51679",
11070
+ # ],
11071
+ # },
11072
+ # {
11073
+ # name: "PORTS_UDP",
11074
+ # type: "STRINGSET",
11075
+ # double_value: 0,
11076
+ # integer_value: 0,
11077
+ # long_value: 0,
11078
+ # string_set_value: [
11079
+ # ],
11080
+ # },
11081
+ # ],
11082
+ # running_tasks_count: 0,
11083
+ # status: "DRAINING",
11084
+ # version_info: {
11085
+ # agent_hash: "efe53c6",
11086
+ # agent_version: "1.13.1",
11087
+ # docker_version: "DockerVersion: 1.11.2",
11088
+ # },
11089
+ # },
11090
+ # ],
11091
+ # failures: [
11092
+ # ],
11093
+ # }
11094
+ #
9628
11095
  # @example Request syntax with placeholder values
9629
11096
  #
9630
11097
  # resp = client.update_container_instances_state({
@@ -10490,6 +11957,54 @@ module Aws::ECS
10490
11957
  #
10491
11958
  # * {Types::UpdateServicePrimaryTaskSetResponse#task_set #task_set} => Types::TaskSet
10492
11959
  #
11960
+ #
11961
+ # @example Example: To update the primary task set for a service
11962
+ #
11963
+ # # This example updates the primary task set for a service MyService that uses the EXTERNAL deployment controller type.
11964
+ #
11965
+ # resp = client.update_service_primary_task_set({
11966
+ # cluster: "MyCluster",
11967
+ # primary_task_set: "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
11968
+ # service: "MyService",
11969
+ # })
11970
+ #
11971
+ # resp.to_h outputs the following:
11972
+ # {
11973
+ # task_set: {
11974
+ # computed_desired_count: 1,
11975
+ # created_at: Time.parse(1557128360.711),
11976
+ # id: "ecs-svc/1234567890123456789",
11977
+ # launch_type: "EC2",
11978
+ # load_balancers: [
11979
+ # ],
11980
+ # network_configuration: {
11981
+ # awsvpc_configuration: {
11982
+ # assign_public_ip: "DISABLED",
11983
+ # security_groups: [
11984
+ # "sg-12344312",
11985
+ # ],
11986
+ # subnets: [
11987
+ # "subnet-12344321",
11988
+ # ],
11989
+ # },
11990
+ # },
11991
+ # pending_count: 0,
11992
+ # running_count: 0,
11993
+ # scale: {
11994
+ # value: 50,
11995
+ # unit: "PERCENT",
11996
+ # },
11997
+ # service_registries: [
11998
+ # ],
11999
+ # stability_status: "STABILIZING",
12000
+ # stability_status_at: Time.parse(1557129279.914),
12001
+ # status: "PRIMARY",
12002
+ # task_definition: "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2",
12003
+ # task_set_arn: "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
12004
+ # updated_at: Time.parse(1557129412.653),
12005
+ # },
12006
+ # }
12007
+ #
10493
12008
  # @example Request syntax with placeholder values
10494
12009
  #
10495
12010
  # resp = client.update_service_primary_task_set({
@@ -10754,6 +12269,58 @@ module Aws::ECS
10754
12269
  #
10755
12270
  # * {Types::UpdateTaskSetResponse#task_set #task_set} => Types::TaskSet
10756
12271
  #
12272
+ #
12273
+ # @example Example: To update a task set
12274
+ #
12275
+ # # This example updates the task set to adjust the scale.
12276
+ #
12277
+ # resp = client.update_task_set({
12278
+ # cluster: "MyCluster",
12279
+ # scale: {
12280
+ # value: 50,
12281
+ # unit: "PERCENT",
12282
+ # },
12283
+ # service: "MyService",
12284
+ # task_set: "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
12285
+ # })
12286
+ #
12287
+ # resp.to_h outputs the following:
12288
+ # {
12289
+ # task_set: {
12290
+ # computed_desired_count: 0,
12291
+ # created_at: Time.parse(1557128360.711),
12292
+ # id: "ecs-svc/1234567890123456789",
12293
+ # launch_type: "EC2",
12294
+ # load_balancers: [
12295
+ # ],
12296
+ # network_configuration: {
12297
+ # awsvpc_configuration: {
12298
+ # assign_public_ip: "DISABLED",
12299
+ # security_groups: [
12300
+ # "sg-12344321",
12301
+ # ],
12302
+ # subnets: [
12303
+ # "subnet-12344321",
12304
+ # ],
12305
+ # },
12306
+ # },
12307
+ # pending_count: 0,
12308
+ # running_count: 0,
12309
+ # scale: {
12310
+ # value: 50,
12311
+ # unit: "PERCENT",
12312
+ # },
12313
+ # service_registries: [
12314
+ # ],
12315
+ # stability_status: "STABILIZING",
12316
+ # stability_status_at: Time.parse(1557129279.914),
12317
+ # status: "ACTIVE",
12318
+ # task_definition: "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2",
12319
+ # task_set_arn: "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789",
12320
+ # updated_at: Time.parse(1557129279.914),
12321
+ # },
12322
+ # }
12323
+ #
10757
12324
  # @example Request syntax with placeholder values
10758
12325
  #
10759
12326
  # resp = client.update_task_set({
@@ -10839,7 +12406,7 @@ module Aws::ECS
10839
12406
  tracer: tracer
10840
12407
  )
10841
12408
  context[:gem_name] = 'aws-sdk-ecs'
10842
- context[:gem_version] = '1.172.0'
12409
+ context[:gem_version] = '1.174.0'
10843
12410
  Seahorse::Client::Request.new(handlers, context)
10844
12411
  end
10845
12412