aws-sdk-ecs 1.164.0 → 1.166.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -562,21 +562,20 @@ module Aws::ECS
562
562
  # `default` cluster when you launch your first container instance.
563
563
  # However, you can create your own cluster with a unique name.
564
564
  #
565
- # <note markdown="1"> When you call the [CreateCluster][1] API operation, Amazon ECS
566
- # attempts to create the Amazon ECS service-linked role for your
567
- # account. This is so that it can manage required resources in other
568
- # Amazon Web Services services on your behalf. However, if the user that
569
- # makes the call doesn't have permissions to create the service-linked
570
- # role, it isn't created. For more information, see [Using
571
- # service-linked roles for Amazon ECS][2] in the *Amazon Elastic
572
- # Container Service Developer Guide*.
565
+ # <note markdown="1"> When you call the CreateCluster API operation, Amazon ECS attempts to
566
+ # create the Amazon ECS service-linked role for your account. This is so
567
+ # that it can manage required resources in other Amazon Web Services
568
+ # services on your behalf. However, if the user that makes the call
569
+ # doesn't have permissions to create the service-linked role, it isn't
570
+ # created. For more information, see [Using service-linked roles for
571
+ # Amazon ECS][1] in the *Amazon Elastic Container Service Developer
572
+ # Guide*.
573
573
  #
574
574
  # </note>
575
575
  #
576
576
  #
577
577
  #
578
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCluster.html
579
- # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
578
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html
580
579
  #
581
580
  # @option params [String] :cluster_name
582
581
  # The name of your cluster. If you don't specify a name for your
@@ -822,8 +821,8 @@ module Aws::ECS
822
821
  # Runs and maintains your desired number of tasks from a specified task
823
822
  # definition. If the number of tasks running in a service drops below
824
823
  # the `desiredCount`, Amazon ECS runs another copy of the task in the
825
- # specified cluster. To update an existing service, use
826
- # [UpdateService][1].
824
+ # specified cluster. To update an existing service, see the
825
+ # UpdateService action.
827
826
  #
828
827
  # <note markdown="1"> On March 21, 2024, a change was made to resolve the task definition
829
828
  # revision before authorization. When a task definition revision is not
@@ -840,13 +839,13 @@ module Aws::ECS
840
839
  # you can optionally run your service behind one or more load balancers.
841
840
  # The load balancers distribute traffic across the tasks that are
842
841
  # associated with the service. For more information, see [Service load
843
- # balancing][2] in the *Amazon Elastic Container Service Developer
842
+ # balancing][1] in the *Amazon Elastic Container Service Developer
844
843
  # Guide*.
845
844
  #
846
845
  # You can attach Amazon EBS volumes to Amazon ECS tasks by configuring
847
846
  # the volume when creating or updating a service. `volumeConfigurations`
848
847
  # is only supported for REPLICA service and not DAEMON service. For more
849
- # infomation, see [Amazon EBS volumes][3] in the *Amazon Elastic
848
+ # infomation, see [Amazon EBS volumes][2] in the *Amazon Elastic
850
849
  # Container Service Developer Guide*.
851
850
  #
852
851
  # Tasks for services that don't use a load balancer are considered
@@ -861,7 +860,7 @@ module Aws::ECS
861
860
  # service scheduler spreads tasks across Availability Zones. You can
862
861
  # use task placement strategies and constraints to customize task
863
862
  # placement decisions. For more information, see [Service scheduler
864
- # concepts][4] in the *Amazon Elastic Container Service Developer
863
+ # concepts][3] in the *Amazon Elastic Container Service Developer
865
864
  # Guide*.
866
865
  #
867
866
  # * `DAEMON` - The daemon scheduling strategy deploys exactly one task
@@ -872,13 +871,13 @@ module Aws::ECS
872
871
  # constraints. When using this strategy, you don't need to specify a
873
872
  # desired number of tasks, a task placement strategy, or use Service
874
873
  # Auto Scaling policies. For more information, see [Service scheduler
875
- # concepts][4] in the *Amazon Elastic Container Service Developer
874
+ # concepts][3] in the *Amazon Elastic Container Service Developer
876
875
  # Guide*.
877
876
  #
878
877
  # You can optionally specify a deployment configuration for your
879
878
  # service. The deployment is initiated by changing properties. For
880
879
  # example, the deployment might be initiated by the task definition or
881
- # by your desired count of a service. You can use [UpdateService][1].
880
+ # by your desired count of a service. You can use [UpdateService][4].
882
881
  # The default value for a replica service for `minimumHealthyPercent` is
883
882
  # 100%. The default value for a daemon service for
884
883
  # `minimumHealthyPercent` is 0%.
@@ -938,10 +937,10 @@ module Aws::ECS
938
937
  #
939
938
  #
940
939
  #
941
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html
942
- # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html
943
- # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html#ebs-volume-types
944
- # [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html
940
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html
941
+ # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html#ebs-volume-types
942
+ # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html
943
+ # [4]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html
945
944
  # [5]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html
946
945
  # [6]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html
947
946
  # [7]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement.html
@@ -1139,7 +1138,7 @@ module Aws::ECS
1139
1138
  #
1140
1139
  # @option params [Types::DeploymentConfiguration] :deployment_configuration
1141
1140
  # Optional deployment parameters that control how many tasks run during
1142
- # the deployment and the ordering of stopping and starting tasks.
1141
+ # the deployment and the failure detection methods.
1143
1142
  #
1144
1143
  # @option params [Array<Types::PlacementConstraint>] :placement_constraints
1145
1144
  # An array of placement constraint objects to use for tasks in your
@@ -1474,8 +1473,8 @@ module Aws::ECS
1474
1473
  # minimum_healthy_percent: 1,
1475
1474
  # alarms: {
1476
1475
  # alarm_names: ["String"], # required
1477
- # enable: false, # required
1478
1476
  # rollback: false, # required
1477
+ # enable: false, # required
1479
1478
  # },
1480
1479
  # },
1481
1480
  # placement_constraints: [
@@ -1575,7 +1574,7 @@ module Aws::ECS
1575
1574
  # },
1576
1575
  # ],
1577
1576
  # role_arn: "IAMRoleArn", # required
1578
- # filesystem_type: "ext3", # accepts ext3, ext4, xfs
1577
+ # filesystem_type: "ext3", # accepts ext3, ext4, xfs, ntfs
1579
1578
  # },
1580
1579
  # },
1581
1580
  # ],
@@ -1614,8 +1613,8 @@ module Aws::ECS
1614
1613
  # resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
1615
1614
  # resp.service.deployment_configuration.alarms.alarm_names #=> Array
1616
1615
  # resp.service.deployment_configuration.alarms.alarm_names[0] #=> String
1617
- # resp.service.deployment_configuration.alarms.enable #=> Boolean
1618
1616
  # resp.service.deployment_configuration.alarms.rollback #=> Boolean
1617
+ # resp.service.deployment_configuration.alarms.enable #=> Boolean
1619
1618
  # resp.service.task_sets #=> Array
1620
1619
  # resp.service.task_sets[0].id #=> String
1621
1620
  # resp.service.task_sets[0].task_set_arn #=> String
@@ -1723,7 +1722,7 @@ module Aws::ECS
1723
1722
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags[0].value #=> String
1724
1723
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
1725
1724
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
1726
- # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs"
1725
+ # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
1727
1726
  # resp.service.deployments[0].fargate_ephemeral_storage.kms_key_id #=> String
1728
1727
  # resp.service.role_arn #=> String
1729
1728
  # resp.service.events #=> Array
@@ -2425,8 +2424,8 @@ module Aws::ECS
2425
2424
  # resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
2426
2425
  # resp.service.deployment_configuration.alarms.alarm_names #=> Array
2427
2426
  # resp.service.deployment_configuration.alarms.alarm_names[0] #=> String
2428
- # resp.service.deployment_configuration.alarms.enable #=> Boolean
2429
2427
  # resp.service.deployment_configuration.alarms.rollback #=> Boolean
2428
+ # resp.service.deployment_configuration.alarms.enable #=> Boolean
2430
2429
  # resp.service.task_sets #=> Array
2431
2430
  # resp.service.task_sets[0].id #=> String
2432
2431
  # resp.service.task_sets[0].task_set_arn #=> String
@@ -2534,7 +2533,7 @@ module Aws::ECS
2534
2533
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags[0].value #=> String
2535
2534
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
2536
2535
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
2537
- # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs"
2536
+ # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
2538
2537
  # resp.service.deployments[0].fargate_ephemeral_storage.kms_key_id #=> String
2539
2538
  # resp.service.role_arn #=> String
2540
2539
  # resp.service.events #=> Array
@@ -3662,6 +3661,211 @@ module Aws::ECS
3662
3661
  req.send_request(options)
3663
3662
  end
3664
3663
 
3664
+ # Describes one or more of your service deployments.
3665
+ #
3666
+ # A service deployment happens when you release a software update for
3667
+ # the service. For more information, see [Amazon ECS service
3668
+ # deployments][1].
3669
+ #
3670
+ #
3671
+ #
3672
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployments.html
3673
+ #
3674
+ # @option params [required, Array<String>] :service_deployment_arns
3675
+ # The ARN of the service deployment.
3676
+ #
3677
+ # You can specify a maximum of 20 ARNs.
3678
+ #
3679
+ # @return [Types::DescribeServiceDeploymentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3680
+ #
3681
+ # * {Types::DescribeServiceDeploymentsResponse#service_deployments #service_deployments} => Array&lt;Types::ServiceDeployment&gt;
3682
+ # * {Types::DescribeServiceDeploymentsResponse#failures #failures} => Array&lt;Types::Failure&gt;
3683
+ #
3684
+ # @example Request syntax with placeholder values
3685
+ #
3686
+ # resp = client.describe_service_deployments({
3687
+ # service_deployment_arns: ["String"], # required
3688
+ # })
3689
+ #
3690
+ # @example Response structure
3691
+ #
3692
+ # resp.service_deployments #=> Array
3693
+ # resp.service_deployments[0].service_deployment_arn #=> String
3694
+ # resp.service_deployments[0].service_arn #=> String
3695
+ # resp.service_deployments[0].cluster_arn #=> String
3696
+ # resp.service_deployments[0].created_at #=> Time
3697
+ # resp.service_deployments[0].started_at #=> Time
3698
+ # resp.service_deployments[0].finished_at #=> Time
3699
+ # resp.service_deployments[0].stopped_at #=> Time
3700
+ # resp.service_deployments[0].updated_at #=> Time
3701
+ # resp.service_deployments[0].source_service_revisions #=> Array
3702
+ # resp.service_deployments[0].source_service_revisions[0].arn #=> String
3703
+ # resp.service_deployments[0].source_service_revisions[0].requested_task_count #=> Integer
3704
+ # resp.service_deployments[0].source_service_revisions[0].running_task_count #=> Integer
3705
+ # resp.service_deployments[0].source_service_revisions[0].pending_task_count #=> Integer
3706
+ # resp.service_deployments[0].target_service_revision.arn #=> String
3707
+ # resp.service_deployments[0].target_service_revision.requested_task_count #=> Integer
3708
+ # resp.service_deployments[0].target_service_revision.running_task_count #=> Integer
3709
+ # resp.service_deployments[0].target_service_revision.pending_task_count #=> Integer
3710
+ # resp.service_deployments[0].status #=> String, one of "PENDING", "SUCCESSFUL", "STOPPED", "STOP_REQUESTED", "IN_PROGRESS", "ROLLBACK_IN_PROGRESS", "ROLLBACK_SUCCESSFUL", "ROLLBACK_FAILED"
3711
+ # resp.service_deployments[0].status_reason #=> String
3712
+ # resp.service_deployments[0].deployment_configuration.deployment_circuit_breaker.enable #=> Boolean
3713
+ # resp.service_deployments[0].deployment_configuration.deployment_circuit_breaker.rollback #=> Boolean
3714
+ # resp.service_deployments[0].deployment_configuration.maximum_percent #=> Integer
3715
+ # resp.service_deployments[0].deployment_configuration.minimum_healthy_percent #=> Integer
3716
+ # resp.service_deployments[0].deployment_configuration.alarms.alarm_names #=> Array
3717
+ # resp.service_deployments[0].deployment_configuration.alarms.alarm_names[0] #=> String
3718
+ # resp.service_deployments[0].deployment_configuration.alarms.rollback #=> Boolean
3719
+ # resp.service_deployments[0].deployment_configuration.alarms.enable #=> Boolean
3720
+ # resp.service_deployments[0].rollback.reason #=> String
3721
+ # resp.service_deployments[0].rollback.started_at #=> Time
3722
+ # resp.service_deployments[0].rollback.service_revision_arn #=> String
3723
+ # resp.service_deployments[0].deployment_circuit_breaker.status #=> String, one of "TRIGGERED", "MONITORING", "MONITORING_COMPLETE", "DISABLED"
3724
+ # resp.service_deployments[0].deployment_circuit_breaker.failure_count #=> Integer
3725
+ # resp.service_deployments[0].deployment_circuit_breaker.threshold #=> Integer
3726
+ # resp.service_deployments[0].alarms.status #=> String, one of "TRIGGERED", "MONITORING", "MONITORING_COMPLETE", "DISABLED"
3727
+ # resp.service_deployments[0].alarms.alarm_names #=> Array
3728
+ # resp.service_deployments[0].alarms.alarm_names[0] #=> String
3729
+ # resp.service_deployments[0].alarms.triggered_alarm_names #=> Array
3730
+ # resp.service_deployments[0].alarms.triggered_alarm_names[0] #=> String
3731
+ # resp.failures #=> Array
3732
+ # resp.failures[0].arn #=> String
3733
+ # resp.failures[0].reason #=> String
3734
+ # resp.failures[0].detail #=> String
3735
+ #
3736
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeServiceDeployments AWS API Documentation
3737
+ #
3738
+ # @overload describe_service_deployments(params = {})
3739
+ # @param [Hash] params ({})
3740
+ def describe_service_deployments(params = {}, options = {})
3741
+ req = build_request(:describe_service_deployments, params)
3742
+ req.send_request(options)
3743
+ end
3744
+
3745
+ # Describes one or more service revisions.
3746
+ #
3747
+ # A service revision is a version of the service that includes the
3748
+ # values for the Amazon ECS resources (for example, task definition) and
3749
+ # the environment resources (for example, load balancers, subnets, and
3750
+ # security groups). For more information, see [Amazon ECS service
3751
+ # revisions][1].
3752
+ #
3753
+ # You can't describe a service revision that was created before October
3754
+ # 25, 2024.
3755
+ #
3756
+ #
3757
+ #
3758
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-revision.html
3759
+ #
3760
+ # @option params [required, Array<String>] :service_revision_arns
3761
+ # The ARN of the service revision.
3762
+ #
3763
+ # You can specify a maximum of 20 ARNs.
3764
+ #
3765
+ # You can call [ListServiceDeployments][1] to get the ARNs.
3766
+ #
3767
+ #
3768
+ #
3769
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListServiceDeployments.html
3770
+ #
3771
+ # @return [Types::DescribeServiceRevisionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3772
+ #
3773
+ # * {Types::DescribeServiceRevisionsResponse#service_revisions #service_revisions} => Array&lt;Types::ServiceRevision&gt;
3774
+ # * {Types::DescribeServiceRevisionsResponse#failures #failures} => Array&lt;Types::Failure&gt;
3775
+ #
3776
+ # @example Request syntax with placeholder values
3777
+ #
3778
+ # resp = client.describe_service_revisions({
3779
+ # service_revision_arns: ["String"], # required
3780
+ # })
3781
+ #
3782
+ # @example Response structure
3783
+ #
3784
+ # resp.service_revisions #=> Array
3785
+ # resp.service_revisions[0].service_revision_arn #=> String
3786
+ # resp.service_revisions[0].service_arn #=> String
3787
+ # resp.service_revisions[0].cluster_arn #=> String
3788
+ # resp.service_revisions[0].task_definition #=> String
3789
+ # resp.service_revisions[0].capacity_provider_strategy #=> Array
3790
+ # resp.service_revisions[0].capacity_provider_strategy[0].capacity_provider #=> String
3791
+ # resp.service_revisions[0].capacity_provider_strategy[0].weight #=> Integer
3792
+ # resp.service_revisions[0].capacity_provider_strategy[0].base #=> Integer
3793
+ # resp.service_revisions[0].launch_type #=> String, one of "EC2", "FARGATE", "EXTERNAL"
3794
+ # resp.service_revisions[0].platform_version #=> String
3795
+ # resp.service_revisions[0].platform_family #=> String
3796
+ # resp.service_revisions[0].load_balancers #=> Array
3797
+ # resp.service_revisions[0].load_balancers[0].target_group_arn #=> String
3798
+ # resp.service_revisions[0].load_balancers[0].load_balancer_name #=> String
3799
+ # resp.service_revisions[0].load_balancers[0].container_name #=> String
3800
+ # resp.service_revisions[0].load_balancers[0].container_port #=> Integer
3801
+ # resp.service_revisions[0].service_registries #=> Array
3802
+ # resp.service_revisions[0].service_registries[0].registry_arn #=> String
3803
+ # resp.service_revisions[0].service_registries[0].port #=> Integer
3804
+ # resp.service_revisions[0].service_registries[0].container_name #=> String
3805
+ # resp.service_revisions[0].service_registries[0].container_port #=> Integer
3806
+ # resp.service_revisions[0].network_configuration.awsvpc_configuration.subnets #=> Array
3807
+ # resp.service_revisions[0].network_configuration.awsvpc_configuration.subnets[0] #=> String
3808
+ # resp.service_revisions[0].network_configuration.awsvpc_configuration.security_groups #=> Array
3809
+ # resp.service_revisions[0].network_configuration.awsvpc_configuration.security_groups[0] #=> String
3810
+ # resp.service_revisions[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
3811
+ # resp.service_revisions[0].container_images #=> Array
3812
+ # resp.service_revisions[0].container_images[0].container_name #=> String
3813
+ # resp.service_revisions[0].container_images[0].image_digest #=> String
3814
+ # resp.service_revisions[0].container_images[0].image #=> String
3815
+ # resp.service_revisions[0].guard_duty_enabled #=> Boolean
3816
+ # resp.service_revisions[0].service_connect_configuration.enabled #=> Boolean
3817
+ # resp.service_revisions[0].service_connect_configuration.namespace #=> String
3818
+ # resp.service_revisions[0].service_connect_configuration.services #=> Array
3819
+ # resp.service_revisions[0].service_connect_configuration.services[0].port_name #=> String
3820
+ # resp.service_revisions[0].service_connect_configuration.services[0].discovery_name #=> String
3821
+ # resp.service_revisions[0].service_connect_configuration.services[0].client_aliases #=> Array
3822
+ # resp.service_revisions[0].service_connect_configuration.services[0].client_aliases[0].port #=> Integer
3823
+ # resp.service_revisions[0].service_connect_configuration.services[0].client_aliases[0].dns_name #=> String
3824
+ # resp.service_revisions[0].service_connect_configuration.services[0].ingress_port_override #=> Integer
3825
+ # resp.service_revisions[0].service_connect_configuration.services[0].timeout.idle_timeout_seconds #=> Integer
3826
+ # resp.service_revisions[0].service_connect_configuration.services[0].timeout.per_request_timeout_seconds #=> Integer
3827
+ # resp.service_revisions[0].service_connect_configuration.services[0].tls.issuer_certificate_authority.aws_pca_authority_arn #=> String
3828
+ # resp.service_revisions[0].service_connect_configuration.services[0].tls.kms_key #=> String
3829
+ # resp.service_revisions[0].service_connect_configuration.services[0].tls.role_arn #=> String
3830
+ # resp.service_revisions[0].service_connect_configuration.log_configuration.log_driver #=> String, one of "json-file", "syslog", "journald", "gelf", "fluentd", "awslogs", "splunk", "awsfirelens"
3831
+ # resp.service_revisions[0].service_connect_configuration.log_configuration.options #=> Hash
3832
+ # resp.service_revisions[0].service_connect_configuration.log_configuration.options["String"] #=> String
3833
+ # resp.service_revisions[0].service_connect_configuration.log_configuration.secret_options #=> Array
3834
+ # resp.service_revisions[0].service_connect_configuration.log_configuration.secret_options[0].name #=> String
3835
+ # resp.service_revisions[0].service_connect_configuration.log_configuration.secret_options[0].value_from #=> String
3836
+ # resp.service_revisions[0].volume_configurations #=> Array
3837
+ # resp.service_revisions[0].volume_configurations[0].name #=> String
3838
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.encrypted #=> Boolean
3839
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.kms_key_id #=> String
3840
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.volume_type #=> String
3841
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.size_in_gi_b #=> Integer
3842
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.snapshot_id #=> String
3843
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.iops #=> Integer
3844
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.throughput #=> Integer
3845
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications #=> Array
3846
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].resource_type #=> String, one of "volume"
3847
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags #=> Array
3848
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags[0].key #=> String
3849
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags[0].value #=> String
3850
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
3851
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
3852
+ # resp.service_revisions[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
3853
+ # resp.service_revisions[0].fargate_ephemeral_storage.kms_key_id #=> String
3854
+ # resp.service_revisions[0].created_at #=> Time
3855
+ # resp.failures #=> Array
3856
+ # resp.failures[0].arn #=> String
3857
+ # resp.failures[0].reason #=> String
3858
+ # resp.failures[0].detail #=> String
3859
+ #
3860
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DescribeServiceRevisions AWS API Documentation
3861
+ #
3862
+ # @overload describe_service_revisions(params = {})
3863
+ # @param [Hash] params ({})
3864
+ def describe_service_revisions(params = {}, options = {})
3865
+ req = build_request(:describe_service_revisions, params)
3866
+ req.send_request(options)
3867
+ end
3868
+
3665
3869
  # Describes the specified services running in your cluster.
3666
3870
  #
3667
3871
  # @option params [String] :cluster
@@ -3782,8 +3986,8 @@ module Aws::ECS
3782
3986
  # resp.services[0].deployment_configuration.minimum_healthy_percent #=> Integer
3783
3987
  # resp.services[0].deployment_configuration.alarms.alarm_names #=> Array
3784
3988
  # resp.services[0].deployment_configuration.alarms.alarm_names[0] #=> String
3785
- # resp.services[0].deployment_configuration.alarms.enable #=> Boolean
3786
3989
  # resp.services[0].deployment_configuration.alarms.rollback #=> Boolean
3990
+ # resp.services[0].deployment_configuration.alarms.enable #=> Boolean
3787
3991
  # resp.services[0].task_sets #=> Array
3788
3992
  # resp.services[0].task_sets[0].id #=> String
3789
3993
  # resp.services[0].task_sets[0].task_set_arn #=> String
@@ -3891,7 +4095,7 @@ module Aws::ECS
3891
4095
  # resp.services[0].deployments[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags[0].value #=> String
3892
4096
  # resp.services[0].deployments[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
3893
4097
  # resp.services[0].deployments[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
3894
- # resp.services[0].deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs"
4098
+ # resp.services[0].deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
3895
4099
  # resp.services[0].deployments[0].fargate_ephemeral_storage.kms_key_id #=> String
3896
4100
  # resp.services[0].role_arn #=> String
3897
4101
  # resp.services[0].events #=> Array
@@ -5127,6 +5331,100 @@ module Aws::ECS
5127
5331
  req.send_request(options)
5128
5332
  end
5129
5333
 
5334
+ # This operation lists all the service deployments that meet the
5335
+ # specified filter criteria.
5336
+ #
5337
+ # A service deployment happens when you release a softwre update for the
5338
+ # service. You route traffic from the running service revisions to the
5339
+ # new service revison and control the number of running tasks.
5340
+ #
5341
+ # This API returns the values that you use for the request parameters in
5342
+ # [DescribeServiceRevisions][1].
5343
+ #
5344
+ #
5345
+ #
5346
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeServiceRevisions.html
5347
+ #
5348
+ # @option params [required, String] :service
5349
+ # The ARN or name of the service
5350
+ #
5351
+ # @option params [String] :cluster
5352
+ # The cluster that hosts the service. This can either be the cluster
5353
+ # name or ARN. Starting April 15, 2023, Amazon Web Services will not
5354
+ # onboard new customers to Amazon Elastic Inference (EI), and will help
5355
+ # current customers migrate their workloads to options that offer better
5356
+ # price and performanceIf you don't specify a cluster, `deault` is
5357
+ # used.
5358
+ #
5359
+ # @option params [Array<String>] :status
5360
+ # An optional filter you can use to narrow the results. If you do not
5361
+ # specify a status, then all status values are included in the result.
5362
+ #
5363
+ # @option params [Types::CreatedAt] :created_at
5364
+ # An optional filter you can use to narrow the results by the service
5365
+ # creation date. If you do not specify a value, the result includes all
5366
+ # services created before the current time. The format is yyyy-MM-dd
5367
+ # HH:mm:ss.SSSSSS.
5368
+ #
5369
+ # @option params [String] :next_token
5370
+ # The `nextToken` value returned from a `ListServiceDeployments` request
5371
+ # indicating that more results are available to fulfill the request and
5372
+ # further calls are needed. If you provided `maxResults`, it's possible
5373
+ # the number of results is fewer than `maxResults`.
5374
+ #
5375
+ # @option params [Integer] :max_results
5376
+ # The maximum number of service deployment results that
5377
+ # `ListServiceDeployments` returned in paginated output. When this
5378
+ # parameter is used, `ListServiceDeployments` only returns `maxResults`
5379
+ # results in a single page along with a `nextToken` response element.
5380
+ # The remaining results of the initial request can be seen by sending
5381
+ # another `ListServiceDeployments` request with the returned `nextToken`
5382
+ # value. This value can be between 1 and 100. If this parameter isn't
5383
+ # used, then `ListServiceDeployments` returns up to 20 results and a
5384
+ # `nextToken` value if applicable.
5385
+ #
5386
+ # @return [Types::ListServiceDeploymentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5387
+ #
5388
+ # * {Types::ListServiceDeploymentsResponse#service_deployments #service_deployments} => Array&lt;Types::ServiceDeploymentBrief&gt;
5389
+ # * {Types::ListServiceDeploymentsResponse#next_token #next_token} => String
5390
+ #
5391
+ # @example Request syntax with placeholder values
5392
+ #
5393
+ # resp = client.list_service_deployments({
5394
+ # service: "String", # required
5395
+ # cluster: "String",
5396
+ # status: ["PENDING"], # accepts PENDING, SUCCESSFUL, STOPPED, STOP_REQUESTED, IN_PROGRESS, ROLLBACK_IN_PROGRESS, ROLLBACK_SUCCESSFUL, ROLLBACK_FAILED
5397
+ # created_at: {
5398
+ # before: Time.now,
5399
+ # after: Time.now,
5400
+ # },
5401
+ # next_token: "String",
5402
+ # max_results: 1,
5403
+ # })
5404
+ #
5405
+ # @example Response structure
5406
+ #
5407
+ # resp.service_deployments #=> Array
5408
+ # resp.service_deployments[0].service_deployment_arn #=> String
5409
+ # resp.service_deployments[0].service_arn #=> String
5410
+ # resp.service_deployments[0].cluster_arn #=> String
5411
+ # resp.service_deployments[0].started_at #=> Time
5412
+ # resp.service_deployments[0].created_at #=> Time
5413
+ # resp.service_deployments[0].finished_at #=> Time
5414
+ # resp.service_deployments[0].target_service_revision_arn #=> String
5415
+ # resp.service_deployments[0].status #=> String, one of "PENDING", "SUCCESSFUL", "STOPPED", "STOP_REQUESTED", "IN_PROGRESS", "ROLLBACK_IN_PROGRESS", "ROLLBACK_SUCCESSFUL", "ROLLBACK_FAILED"
5416
+ # resp.service_deployments[0].status_reason #=> String
5417
+ # resp.next_token #=> String
5418
+ #
5419
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ListServiceDeployments AWS API Documentation
5420
+ #
5421
+ # @overload list_service_deployments(params = {})
5422
+ # @param [Hash] params ({})
5423
+ def list_service_deployments(params = {}, options = {})
5424
+ req = build_request(:list_service_deployments, params)
5425
+ req.send_request(options)
5426
+ end
5427
+
5130
5428
  # Returns a list of services. You can filter the results by cluster,
5131
5429
  # launch type, and scheduling strategy.
5132
5430
  #
@@ -6550,19 +6848,22 @@ module Aws::ECS
6550
6848
  # non-root user.
6551
6849
  #
6552
6850
  # If the network mode is `awsvpc`, the task is allocated an elastic
6553
- # network interface, and you must specify a [NetworkConfiguration][1]
6554
- # value when you create a service or run a task with the task
6555
- # definition. For more information, see [Task Networking][2] in the
6556
- # *Amazon Elastic Container Service Developer Guide*.
6851
+ # network interface, and you must specify a NetworkConfiguration value
6852
+ # when you create a service or run a task with the task definition. For
6853
+ # more information, see [Task Networking][1] in the *Amazon Elastic
6854
+ # Container Service Developer Guide*.
6557
6855
  #
6558
6856
  # If the network mode is `host`, you cannot run multiple instantiations
6559
6857
  # of the same task on a single container instance when port mappings are
6560
6858
  # used.
6561
6859
  #
6860
+ # For more information, see [Network settings][2] in the *Docker run
6861
+ # reference*.
6862
+ #
6562
6863
  #
6563
6864
  #
6564
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_NetworkConfiguration.html
6565
- # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
6865
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html
6866
+ # [2]: https://docs.docker.com/engine/reference/run/#network-settings
6566
6867
  #
6567
6868
  # @option params [required, Array<Types::ContainerDefinition>] :container_definitions
6568
6869
  # A list of container definitions in JSON format that describe the
@@ -6725,10 +7026,12 @@ module Aws::ECS
6725
7026
  # the same process namespace.
6726
7027
  #
6727
7028
  # If no value is specified, the default is a private namespace for each
6728
- # container.
7029
+ # container. For more information, see [PID settings][1] in the *Docker
7030
+ # run reference*.
6729
7031
  #
6730
7032
  # If the `host` PID mode is used, there's a heightened risk of
6731
- # undesired process namespace exposure.
7033
+ # undesired process namespace exposure. For more information, see
7034
+ # [Docker security][2].
6732
7035
  #
6733
7036
  # <note markdown="1"> This parameter is not supported for Windows containers.
6734
7037
  #
@@ -6740,6 +7043,11 @@ module Aws::ECS
6740
7043
  #
6741
7044
  # </note>
6742
7045
  #
7046
+ #
7047
+ #
7048
+ # [1]: https://docs.docker.com/engine/reference/run/#pid-settings---pid
7049
+ # [2]: https://docs.docker.com/engine/security/security/
7050
+ #
6743
7051
  # @option params [String] :ipc_mode
6744
7052
  # The IPC resource namespace to use for the containers in the task. The
6745
7053
  # valid values are `host`, `task`, or `none`. If `host` is specified,
@@ -6751,14 +7059,16 @@ module Aws::ECS
6751
7059
  # private and not shared with other containers in a task or on the
6752
7060
  # container instance. If no value is specified, then the IPC resource
6753
7061
  # namespace sharing depends on the Docker daemon setting on the
6754
- # container instance.
7062
+ # container instance. For more information, see [IPC settings][1] in the
7063
+ # *Docker run reference*.
6755
7064
  #
6756
7065
  # If the `host` IPC mode is used, be aware that there is a heightened
6757
- # risk of undesired IPC namespace expose.
7066
+ # risk of undesired IPC namespace expose. For more information, see
7067
+ # [Docker security][2].
6758
7068
  #
6759
7069
  # If you are setting namespaced kernel parameters using `systemControls`
6760
7070
  # for the containers in the task, the following will apply to your IPC
6761
- # resource namespace. For more information, see [System Controls][1] in
7071
+ # resource namespace. For more information, see [System Controls][3] in
6762
7072
  # the *Amazon Elastic Container Service Developer Guide*.
6763
7073
  #
6764
7074
  # * For tasks that use the `host` IPC mode, IPC namespace related
@@ -6774,7 +7084,9 @@ module Aws::ECS
6774
7084
  #
6775
7085
  #
6776
7086
  #
6777
- # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html
7087
+ # [1]: https://docs.docker.com/engine/reference/run/#ipc-settings---ipc
7088
+ # [2]: https://docs.docker.com/engine/security/security/
7089
+ # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html
6778
7090
  #
6779
7091
  # @option params [Types::ProxyConfiguration] :proxy_configuration
6780
7092
  # The configuration details for the App Mesh proxy.
@@ -7760,7 +8072,7 @@ module Aws::ECS
7760
8072
  # termination_policy: {
7761
8073
  # delete_on_termination: false, # required
7762
8074
  # },
7763
- # filesystem_type: "ext3", # accepts ext3, ext4, xfs
8075
+ # filesystem_type: "ext3", # accepts ext3, ext4, xfs, ntfs
7764
8076
  # },
7765
8077
  # },
7766
8078
  # ],
@@ -8136,7 +8448,7 @@ module Aws::ECS
8136
8448
  # termination_policy: {
8137
8449
  # delete_on_termination: false, # required
8138
8450
  # },
8139
- # filesystem_type: "ext3", # accepts ext3, ext4, xfs
8451
+ # filesystem_type: "ext3", # accepts ext3, ext4, xfs, ntfs
8140
8452
  # },
8141
8453
  # },
8142
8454
  # ],
@@ -9539,7 +9851,7 @@ module Aws::ECS
9539
9851
  #
9540
9852
  # @option params [Types::DeploymentConfiguration] :deployment_configuration
9541
9853
  # Optional deployment parameters that control how many tasks run during
9542
- # the deployment and the ordering of stopping and starting tasks.
9854
+ # the deployment and the failure detection methods.
9543
9855
  #
9544
9856
  # @option params [Types::NetworkConfiguration] :network_configuration
9545
9857
  # An object representing the network configuration for the service.
@@ -9760,8 +10072,8 @@ module Aws::ECS
9760
10072
  # minimum_healthy_percent: 1,
9761
10073
  # alarms: {
9762
10074
  # alarm_names: ["String"], # required
9763
- # enable: false, # required
9764
10075
  # rollback: false, # required
10076
+ # enable: false, # required
9765
10077
  # },
9766
10078
  # },
9767
10079
  # network_configuration: {
@@ -9869,7 +10181,7 @@ module Aws::ECS
9869
10181
  # },
9870
10182
  # ],
9871
10183
  # role_arn: "IAMRoleArn", # required
9872
- # filesystem_type: "ext3", # accepts ext3, ext4, xfs
10184
+ # filesystem_type: "ext3", # accepts ext3, ext4, xfs, ntfs
9873
10185
  # },
9874
10186
  # },
9875
10187
  # ],
@@ -9908,8 +10220,8 @@ module Aws::ECS
9908
10220
  # resp.service.deployment_configuration.minimum_healthy_percent #=> Integer
9909
10221
  # resp.service.deployment_configuration.alarms.alarm_names #=> Array
9910
10222
  # resp.service.deployment_configuration.alarms.alarm_names[0] #=> String
9911
- # resp.service.deployment_configuration.alarms.enable #=> Boolean
9912
10223
  # resp.service.deployment_configuration.alarms.rollback #=> Boolean
10224
+ # resp.service.deployment_configuration.alarms.enable #=> Boolean
9913
10225
  # resp.service.task_sets #=> Array
9914
10226
  # resp.service.task_sets[0].id #=> String
9915
10227
  # resp.service.task_sets[0].task_set_arn #=> String
@@ -10017,7 +10329,7 @@ module Aws::ECS
10017
10329
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].tags[0].value #=> String
10018
10330
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.tag_specifications[0].propagate_tags #=> String, one of "TASK_DEFINITION", "SERVICE", "NONE"
10019
10331
  # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.role_arn #=> String
10020
- # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs"
10332
+ # resp.service.deployments[0].volume_configurations[0].managed_ebs_volume.filesystem_type #=> String, one of "ext3", "ext4", "xfs", "ntfs"
10021
10333
  # resp.service.deployments[0].fargate_ephemeral_storage.kms_key_id #=> String
10022
10334
  # resp.service.role_arn #=> String
10023
10335
  # resp.service.events #=> Array
@@ -10432,7 +10744,7 @@ module Aws::ECS
10432
10744
  tracer: tracer
10433
10745
  )
10434
10746
  context[:gem_name] = 'aws-sdk-ecs'
10435
- context[:gem_version] = '1.164.0'
10747
+ context[:gem_version] = '1.166.0'
10436
10748
  Seahorse::Client::Request.new(handlers, context)
10437
10749
  end
10438
10750