modules/AWSPowerShell/Cmdlets/ECS/Basic/New-ECSService-Cmdlet.cs (776 lines of code) (raw):

/******************************************************************************* * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * Licensed under the Apache License, Version 2.0 (the "License"). You may not use * this file except in compliance with the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. * This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the * specific language governing permissions and limitations under the License. * ***************************************************************************** * * AWS Tools for Windows (TM) PowerShell (TM) * */ using System; using System.Collections.Generic; using System.Linq; using System.Management.Automation; using System.Text; using Amazon.PowerShell.Common; using Amazon.Runtime; using Amazon.ECS; using Amazon.ECS.Model; namespace Amazon.PowerShell.Cmdlets.ECS { /// <summary> /// Runs and maintains your desired number of tasks from a specified task definition. /// If the number of tasks running in a service drops below the <c>desiredCount</c>, Amazon /// ECS runs another copy of the task in the specified cluster. To update an existing /// service, use <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html">UpdateService</a>. /// /// <note><para> /// On March 21, 2024, a change was made to resolve the task definition revision before /// authorization. When a task definition revision is not specified, authorization will /// occur using the latest revision of a task definition. /// </para></note><note><para> /// Amazon Elastic Inference (EI) is no longer available to customers. /// </para></note><para> /// In addition to maintaining the desired count of tasks in your service, you can optionally /// run your service behind one or more load balancers. The load balancers distribute /// traffic across the tasks that are associated with the service. For more information, /// see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html">Service /// load balancing</a> in the <i>Amazon Elastic Container Service Developer Guide</i>. /// </para><para> /// You can attach Amazon EBS volumes to Amazon ECS tasks by configuring the volume when /// creating or updating a service. <c>volumeConfigurations</c> is only supported for /// REPLICA service and not DAEMON service. For more infomation, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html#ebs-volume-types">Amazon /// EBS volumes</a> in the <i>Amazon Elastic Container Service Developer Guide</i>. /// </para><para> /// Tasks for services that don't use a load balancer are considered healthy if they're /// in the <c>RUNNING</c> state. Tasks for services that use a load balancer are considered /// healthy if they're in the <c>RUNNING</c> state and are reported as healthy by the /// load balancer. /// </para><para> /// There are two service scheduler strategies available: /// </para><ul><li><para><c>REPLICA</c> - The replica scheduling strategy places and maintains your desired /// number of tasks across your cluster. By default, the service scheduler spreads tasks /// across Availability Zones. You can use task placement strategies and constraints to /// customize task placement decisions. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html">Service /// scheduler concepts</a> in the <i>Amazon Elastic Container Service Developer Guide</i>. /// </para></li><li><para><c>DAEMON</c> - The daemon scheduling strategy deploys exactly one task on each active /// container instance that meets all of the task placement constraints that you specify /// in your cluster. The service scheduler also evaluates the task placement constraints /// for running tasks. It also stops tasks that don't meet the placement constraints. /// When using this strategy, you don't need to specify a desired number of tasks, a task /// placement strategy, or use Service Auto Scaling policies. For more information, see /// <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html">Service /// scheduler concepts</a> in the <i>Amazon Elastic Container Service Developer Guide</i>. /// </para></li></ul><para> /// You can optionally specify a deployment configuration for your service. The deployment /// is initiated by changing properties. For example, the deployment might be initiated /// by the task definition or by your desired count of a service. You can use <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html">UpdateService</a>. /// The default value for a replica service for <c>minimumHealthyPercent</c> is 100%. /// The default value for a daemon service for <c>minimumHealthyPercent</c> is 0%. /// </para><para> /// If a service uses the <c>ECS</c> deployment controller, the minimum healthy percent /// represents a lower limit on the number of tasks in a service that must remain in the /// <c>RUNNING</c> state during a deployment. Specifically, it represents it as a percentage /// of your desired number of tasks (rounded up to the nearest integer). This happens /// when any of your container instances are in the <c>DRAINING</c> state if the service /// contains tasks using the EC2 launch type. Using this parameter, you can deploy without /// using additional cluster capacity. For example, if you set your service to have desired /// number of four tasks and a minimum healthy percent of 50%, the scheduler might stop /// two existing tasks to free up cluster capacity before starting two new tasks. If they're /// in the <c>RUNNING</c> state, tasks for services that don't use a load balancer are /// considered healthy . If they're in the <c>RUNNING</c> state and reported as healthy /// by the load balancer, tasks for services that <i>do</i> use a load balancer are considered /// healthy . The default value for minimum healthy percent is 100%. /// </para><para> /// If a service uses the <c>ECS</c> deployment controller, the <b>maximum percent</b> /// parameter represents an upper limit on the number of tasks in a service that are allowed /// in the <c>RUNNING</c> or <c>PENDING</c> state during a deployment. Specifically, it /// represents it as a percentage of the desired number of tasks (rounded down to the /// nearest integer). This happens when any of your container instances are in the <c>DRAINING</c> /// state if the service contains tasks using the EC2 launch type. Using this parameter, /// you can define the deployment batch size. For example, if your service has a desired /// number of four tasks and a maximum percent value of 200%, the scheduler may start /// four new tasks before stopping the four older tasks (provided that the cluster resources /// required to do this are available). The default value for maximum percent is 200%. /// </para><para> /// If a service uses either the <c>CODE_DEPLOY</c> or <c>EXTERNAL</c> deployment controller /// types and tasks that use the EC2 launch type, the <b>minimum healthy percent</b> and /// <b>maximum percent</b> values are used only to define the lower and upper limit on /// the number of the tasks in the service that remain in the <c>RUNNING</c> state. This /// is while the container instances are in the <c>DRAINING</c> state. If the tasks in /// the service use the Fargate launch type, the minimum healthy percent and maximum percent /// values aren't used. This is the case even if they're currently visible when describing /// your service. /// </para><para> /// When creating a service that uses the <c>EXTERNAL</c> deployment controller, you can /// specify only parameters that aren't controlled at the task set level. The only required /// parameter is the service name. You control your services using the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html">CreateTaskSet</a>. /// For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon /// ECS deployment types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>. /// </para><para> /// When the service scheduler launches new tasks, it determines task placement. For information /// about task placement and task placement strategies, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement.html">Amazon /// ECS task placement</a> in the <i>Amazon Elastic Container Service Developer Guide</i></para> /// </summary> [Cmdlet("New", "ECSService", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Medium)] [OutputType("Amazon.ECS.Model.Service")] [AWSCmdlet("Calls the Amazon EC2 Container Service CreateService API operation.", Operation = new[] {"CreateService"}, SelectReturnType = typeof(Amazon.ECS.Model.CreateServiceResponse))] [AWSCmdletOutput("Amazon.ECS.Model.Service or Amazon.ECS.Model.CreateServiceResponse", "This cmdlet returns an Amazon.ECS.Model.Service object.", "The service call response (type Amazon.ECS.Model.CreateServiceResponse) can be returned by specifying '-Select *'." )] public partial class NewECSServiceCmdlet : AmazonECSClientCmdlet, IExecutor { protected override bool IsGeneratedCmdlet { get; set; } = true; #region Parameter Alarms_AlarmName /// <summary> /// <para> /// <para>One or more CloudWatch alarm names. Use a "," to separate the alarms.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("DeploymentConfiguration_Alarms_AlarmNames")] public System.String[] Alarms_AlarmName { get; set; } #endregion #region Parameter AwsvpcConfiguration_AssignPublicIp /// <summary> /// <para> /// <para>Whether the task's elastic network interface receives a public IP address. </para><para>Consider the following when you set this value:</para><ul><li><para>When you use <c>create-service</c> or <c>update-service</c>, the default is <c>DISABLED</c>. /// </para></li><li><para>When the service <c>deploymentController</c> is <c>ECS</c>, the value must be <c>DISABLED</c>. /// </para></li></ul> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("NetworkConfiguration_AwsvpcConfiguration_AssignPublicIp")] [AWSConstantClassSource("Amazon.ECS.AssignPublicIp")] public Amazon.ECS.AssignPublicIp AwsvpcConfiguration_AssignPublicIp { get; set; } #endregion #region Parameter AvailabilityZoneRebalancing /// <summary> /// <para> /// <para>Indicates whether to use Availability Zone rebalancing for the service.</para><para>For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html">Balancing /// an Amazon ECS service across Availability Zones</a> in the <i><i>Amazon Elastic Container /// Service Developer Guide</i></i>.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [AWSConstantClassSource("Amazon.ECS.AvailabilityZoneRebalancing")] public Amazon.ECS.AvailabilityZoneRebalancing AvailabilityZoneRebalancing { get; set; } #endregion #region Parameter CapacityProviderStrategy /// <summary> /// <para> /// <para>The capacity provider strategy to use for the service.</para><para>If a <c>capacityProviderStrategy</c> is specified, the <c>launchType</c> parameter /// must be omitted. If no <c>capacityProviderStrategy</c> or <c>launchType</c> is specified, /// the <c>defaultCapacityProviderStrategy</c> for the cluster is used.</para><para>A capacity provider strategy can contain a maximum of 20 capacity providers.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public Amazon.ECS.Model.CapacityProviderStrategyItem[] CapacityProviderStrategy { get; set; } #endregion #region Parameter Cluster /// <summary> /// <para> /// <para>The short name or full Amazon Resource Name (ARN) of the cluster that you run your /// service on. If you do not specify a cluster, the default cluster is assumed.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(Position = 0, ValueFromPipelineByPropertyName = true, ValueFromPipeline = true)] public System.String Cluster { get; set; } #endregion #region Parameter DesiredCount /// <summary> /// <para> /// <para>The number of instantiations of the specified task definition to place and keep running /// in your service.</para><para>This is required if <c>schedulingStrategy</c> is <c>REPLICA</c> or isn't specified. /// If <c>schedulingStrategy</c> is <c>DAEMON</c> then this isn't required.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.Int32? DesiredCount { get; set; } #endregion #region Parameter Alarms_Enable /// <summary> /// <para> /// <para>Determines whether to use the CloudWatch alarm option in the service deployment process.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("DeploymentConfiguration_Alarms_Enable")] public System.Boolean? Alarms_Enable { get; set; } #endregion #region Parameter DeploymentCircuitBreaker_Enable /// <summary> /// <para> /// <para>Determines whether to use the deployment circuit breaker logic for the service.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("DeploymentConfiguration_DeploymentCircuitBreaker_Enable")] public System.Boolean? DeploymentCircuitBreaker_Enable { get; set; } #endregion #region Parameter ServiceConnectConfiguration_Enabled /// <summary> /// <para> /// <para>Specifies whether to use Service Connect with this service.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.Boolean? ServiceConnectConfiguration_Enabled { get; set; } #endregion #region Parameter EnableECSManagedTag /// <summary> /// <para> /// <para>Specifies whether to turn on Amazon ECS managed tags for the tasks within the service. /// For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html">Tagging /// your Amazon ECS resources</a> in the <i>Amazon Elastic Container Service Developer /// Guide</i>.</para><para>When you use Amazon ECS managed tags, you need to set the <c>propagateTags</c> request /// parameter.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("EnableECSManagedTags")] public System.Boolean? EnableECSManagedTag { get; set; } #endregion #region Parameter EnableExecuteCommand /// <summary> /// <para> /// <para>Determines whether the execute command functionality is turned on for the service. /// If <c>true</c>, this enables execute command functionality on all containers in the /// service tasks.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.Boolean? EnableExecuteCommand { get; set; } #endregion #region Parameter HealthCheckGracePeriodSecond /// <summary> /// <para> /// <para>The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy /// Elastic Load Balancing, VPC Lattice, and container health checks after a task has /// first started. If you don't specify a health check grace period value, the default /// value of <c>0</c> is used. If you don't use any of the health checks, then <c>healthCheckGracePeriodSeconds</c> /// is unused.</para><para>If your service's tasks take a while to start and respond to health checks, you can /// specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). /// During that time, the Amazon ECS service scheduler ignores health check status. This /// grace period can prevent the service scheduler from marking tasks as unhealthy and /// stopping them before they have time to come up.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("HealthCheckGracePeriodSeconds")] public System.Int32? HealthCheckGracePeriodSecond { get; set; } #endregion #region Parameter LaunchType /// <summary> /// <para> /// <para>The infrastructure that you run your service on. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html">Amazon /// ECS launch types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</para><para>The <c>FARGATE</c> launch type runs your tasks on Fargate On-Demand infrastructure.</para><note><para>Fargate Spot infrastructure is available for use but a capacity provider strategy /// must be used. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/fargate-capacity-providers.html">Fargate /// capacity providers</a> in the <i>Amazon ECS Developer Guide</i>.</para></note><para>The <c>EC2</c> launch type runs your tasks on Amazon EC2 instances registered to your /// cluster.</para><para>The <c>EXTERNAL</c> launch type runs your tasks on your on-premises server or virtual /// machine (VM) capacity registered to your cluster.</para><para>A service can use either a launch type or a capacity provider strategy. If a <c>launchType</c> /// is specified, the <c>capacityProviderStrategy</c> parameter must be omitted.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [AWSConstantClassSource("Amazon.ECS.LaunchType")] public Amazon.ECS.LaunchType LaunchType { get; set; } #endregion #region Parameter LoadBalancer /// <summary> /// <para> /// <para>A load balancer object representing the load balancers to use with your service. For /// more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html">Service /// load balancing</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</para><para>If the service uses the rolling update (<c>ECS</c>) deployment controller and using /// either an Application Load Balancer or Network Load Balancer, you must specify one /// or more target group ARNs to attach to the service. The service-linked role is required /// for services that use multiple target groups. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html">Using /// service-linked roles for Amazon ECS</a> in the <i>Amazon Elastic Container Service /// Developer Guide</i>.</para><para>If the service uses the <c>CODE_DEPLOY</c> deployment controller, the service is required /// to use either an Application Load Balancer or Network Load Balancer. When creating /// an CodeDeploy deployment group, you specify two target groups (referred to as a <c>targetGroupPair</c>). /// During a deployment, CodeDeploy determines which task set in your service has the /// status <c>PRIMARY</c>, and it associates one target group with it. Then, it also associates /// the other target group with the replacement task set. The load balancer can also have /// up to two listeners: a required listener for production traffic and an optional listener /// that you can use to perform validation tests with Lambda functions before routing /// production traffic to it.</para><para>If you use the <c>CODE_DEPLOY</c> deployment controller, these values can be changed /// when updating the service.</para><para>For Application Load Balancers and Network Load Balancers, this object must contain /// the load balancer target group ARN, the container name, and the container port to /// access from the load balancer. The container name must be as it appears in a container /// definition. The load balancer name parameter must be omitted. When a task from this /// service is placed on a container instance, the container instance and port combination /// is registered as a target in the target group that's specified here.</para><para>For Classic Load Balancers, this object must contain the load balancer name, the container /// name , and the container port to access from the load balancer. The container name /// must be as it appears in a container definition. The target group ARN parameter must /// be omitted. When a task from this service is placed on a container instance, the container /// instance is registered with the load balancer that's specified here.</para><para>Services with tasks that use the <c>awsvpc</c> network mode (for example, those with /// the Fargate launch type) only support Application Load Balancers and Network Load /// Balancers. Classic Load Balancers aren't supported. Also, when you create any target /// groups for these services, you must choose <c>ip</c> as the target type, not <c>instance</c>. /// This is because tasks that use the <c>awsvpc</c> network mode are associated with /// an elastic network interface, not an Amazon EC2 instance.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("LoadBalancers")] public Amazon.ECS.Model.LoadBalancer[] LoadBalancer { get; set; } #endregion #region Parameter LogConfiguration_LogDriver /// <summary> /// <para> /// <para>The log driver to use for the container.</para><para>For tasks on Fargate, the supported log drivers are <c>awslogs</c>, <c>splunk</c>, /// and <c>awsfirelens</c>.</para><para>For tasks hosted on Amazon EC2 instances, the supported log drivers are <c>awslogs</c>, /// <c>fluentd</c>, <c>gelf</c>, <c>json-file</c>, <c>journald</c>, <c>syslog</c>, <c>splunk</c>, /// and <c>awsfirelens</c>.</para><para>For more information about using the <c>awslogs</c> log driver, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html">Send /// Amazon ECS logs to CloudWatch</a> in the <i>Amazon Elastic Container Service Developer /// Guide</i>.</para><para>For more information about using the <c>awsfirelens</c> log driver, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html">Send /// Amazon ECS logs to an Amazon Web Services service or Amazon Web Services Partner</a>.</para><note><para>If you have a custom driver that isn't listed, you can fork the Amazon ECS container /// agent project that's <a href="https://github.com/aws/amazon-ecs-agent">available on /// GitHub</a> and customize it to work with that driver. We encourage you to submit pull /// requests for changes that you would like to have included. However, we don't currently /// provide support for running modified copies of this software.</para></note> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("ServiceConnectConfiguration_LogConfiguration_LogDriver")] [AWSConstantClassSource("Amazon.ECS.LogDriver")] public Amazon.ECS.LogDriver LogConfiguration_LogDriver { get; set; } #endregion #region Parameter DeploymentConfiguration_MaximumPercent /// <summary> /// <para> /// <para>If a service is using the rolling update (<c>ECS</c>) deployment type, the <c>maximumPercent</c> /// parameter represents an upper limit on the number of your service's tasks that are /// allowed in the <c>RUNNING</c> or <c>PENDING</c> state during a deployment, as a percentage /// of the <c>desiredCount</c> (rounded down to the nearest integer). This parameter enables /// you to define the deployment batch size. For example, if your service is using the /// <c>REPLICA</c> service scheduler and has a <c>desiredCount</c> of four tasks and a /// <c>maximumPercent</c> value of 200%, the scheduler may start four new tasks before /// stopping the four older tasks (provided that the cluster resources required to do /// this are available). The default <c>maximumPercent</c> value for a service using the /// <c>REPLICA</c> service scheduler is 200%.</para><para>The Amazon ECS scheduler uses this parameter to replace unhealthy tasks by starting /// replacement tasks first and then stopping the unhealthy tasks, as long as cluster /// resources for starting replacement tasks are available. For more information about /// how the scheduler replaces unhealthy tasks, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html">Amazon /// ECS services</a>.</para><para>If a service is using either the blue/green (<c>CODE_DEPLOY</c>) or <c>EXTERNAL</c> /// deployment types, and tasks in the service use the EC2 launch type, the <b>maximum /// percent</b> value is set to the default value. The <b>maximum percent</b> value is /// used to define the upper limit on the number of the tasks in the service that remain /// in the <c>RUNNING</c> state while the container instances are in the <c>DRAINING</c> /// state.</para><note><para>You can't specify a custom <c>maximumPercent</c> value for a service that uses either /// the blue/green (<c>CODE_DEPLOY</c>) or <c>EXTERNAL</c> deployment types and has tasks /// that use the EC2 launch type.</para></note><para>If the service uses either the blue/green (<c>CODE_DEPLOY</c>) or <c>EXTERNAL</c> /// deployment types, and the tasks in the service use the Fargate launch type, the maximum /// percent value is not used. The value is still returned when describing your service.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.Int32? DeploymentConfiguration_MaximumPercent { get; set; } #endregion #region Parameter DeploymentConfiguration_MinimumHealthyPercent /// <summary> /// <para> /// <para>If a service is using the rolling update (<c>ECS</c>) deployment type, the <c>minimumHealthyPercent</c> /// represents a lower limit on the number of your service's tasks that must remain in /// the <c>RUNNING</c> state during a deployment, as a percentage of the <c>desiredCount</c> /// (rounded up to the nearest integer). This parameter enables you to deploy without /// using additional cluster capacity. For example, if your service has a <c>desiredCount</c> /// of four tasks and a <c>minimumHealthyPercent</c> of 50%, the service scheduler may /// stop two existing tasks to free up cluster capacity before starting two new tasks. /// </para><para> If any tasks are unhealthy and if <c>maximumPercent</c> doesn't allow the Amazon /// ECS scheduler to start replacement tasks, the scheduler stops the unhealthy tasks /// one-by-one — using the <c>minimumHealthyPercent</c> as a constraint — to clear up /// capacity to launch replacement tasks. For more information about how the scheduler /// replaces unhealthy tasks, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html">Amazon /// ECS services</a> . </para><para>For services that <i>do not</i> use a load balancer, the following should be noted:</para><ul><li><para>A service is considered healthy if all essential containers within the tasks in the /// service pass their health checks.</para></li><li><para>If a task has no essential containers with a health check defined, the service scheduler /// will wait for 40 seconds after a task reaches a <c>RUNNING</c> state before the task /// is counted towards the minimum healthy percent total.</para></li><li><para>If a task has one or more essential containers with a health check defined, the service /// scheduler will wait for the task to reach a healthy status before counting it towards /// the minimum healthy percent total. A task is considered healthy when all essential /// containers within the task have passed their health checks. The amount of time the /// service scheduler can wait for is determined by the container health check settings. /// </para></li></ul><para>For services that <i>do</i> use a load balancer, the following should be noted:</para><ul><li><para>If a task has no essential containers with a health check defined, the service scheduler /// will wait for the load balancer target group health check to return a healthy status /// before counting the task towards the minimum healthy percent total.</para></li><li><para>If a task has an essential container with a health check defined, the service scheduler /// will wait for both the task to reach a healthy status and the load balancer target /// group health check to return a healthy status before counting the task towards the /// minimum healthy percent total.</para></li></ul><para>The default value for a replica service for <c>minimumHealthyPercent</c> is 100%. /// The default <c>minimumHealthyPercent</c> value for a service using the <c>DAEMON</c> /// service schedule is 0% for the CLI, the Amazon Web Services SDKs, and the APIs and /// 50% for the Amazon Web Services Management Console.</para><para>The minimum number of healthy tasks during a deployment is the <c>desiredCount</c> /// multiplied by the <c>minimumHealthyPercent</c>/100, rounded up to the nearest integer /// value.</para><para>If a service is using either the blue/green (<c>CODE_DEPLOY</c>) or <c>EXTERNAL</c> /// deployment types and is running tasks that use the EC2 launch type, the <b>minimum /// healthy percent</b> value is set to the default value. The <b>minimum healthy percent</b> /// value is used to define the lower limit on the number of the tasks in the service /// that remain in the <c>RUNNING</c> state while the container instances are in the <c>DRAINING</c> /// state.</para><note><para>You can't specify a custom <c>minimumHealthyPercent</c> value for a service that uses /// either the blue/green (<c>CODE_DEPLOY</c>) or <c>EXTERNAL</c> deployment types and /// has tasks that use the EC2 launch type.</para></note><para>If a service is using either the blue/green (<c>CODE_DEPLOY</c>) or <c>EXTERNAL</c> /// deployment types and is running tasks that use the Fargate launch type, the minimum /// healthy percent value is not used, although it is returned when describing your service.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.Int32? DeploymentConfiguration_MinimumHealthyPercent { get; set; } #endregion #region Parameter ServiceConnectConfiguration_Namespace /// <summary> /// <para> /// <para>The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace for /// use with Service Connect. The namespace must be in the same Amazon Web Services Region /// as the Amazon ECS service and cluster. The type of namespace doesn't affect Service /// Connect. For more information about Cloud Map, see <a href="https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html">Working /// with Services</a> in the <i>Cloud Map Developer Guide</i>.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.String ServiceConnectConfiguration_Namespace { get; set; } #endregion #region Parameter LogConfiguration_Option /// <summary> /// <para> /// <para>The configuration options to send to the log driver.</para><para>The options you can specify depend on the log driver. Some of the options you can /// specify when you use the <c>awslogs</c> log driver to route logs to Amazon CloudWatch /// include the following:</para><dl><dt>awslogs-create-group</dt><dd><para>Required: No</para><para>Specify whether you want the log group to be created automatically. If this option /// isn't specified, it defaults to <c>false</c>.</para><note><para>Your IAM policy must include the <c>logs:CreateLogGroup</c> permission before you /// attempt to use <c>awslogs-create-group</c>.</para></note></dd><dt>awslogs-region</dt><dd><para>Required: Yes</para><para>Specify the Amazon Web Services Region that the <c>awslogs</c> log driver is to send /// your Docker logs to. You can choose to send all of your logs from clusters in different /// Regions to a single region in CloudWatch Logs. This is so that they're all visible /// in one location. Otherwise, you can separate them by Region for more granularity. /// Make sure that the specified log group exists in the Region that you specify with /// this option.</para></dd><dt>awslogs-group</dt><dd><para>Required: Yes</para><para>Make sure to specify a log group that the <c>awslogs</c> log driver sends its log /// streams to.</para></dd><dt>awslogs-stream-prefix</dt><dd><para>Required: Yes, when using Fargate.Optional when using EC2.</para><para>Use the <c>awslogs-stream-prefix</c> option to associate a log stream with the specified /// prefix, the container name, and the ID of the Amazon ECS task that the container belongs /// to. If you specify a prefix with this option, then the log stream takes the format /// <c>prefix-name/container-name/ecs-task-id</c>.</para><para>If you don't specify a prefix with this option, then the log stream is named after /// the container ID that's assigned by the Docker daemon on the container instance. Because /// it's difficult to trace logs back to the container that sent them with just the Docker /// container ID (which is only available on the container instance), we recommend that /// you specify a prefix with this option.</para><para>For Amazon ECS services, you can use the service name as the prefix. Doing so, you /// can trace log streams to the service that the container belongs to, the name of the /// container that sent them, and the ID of the task that the container belongs to.</para><para>You must specify a stream-prefix for your logs to have your logs appear in the Log /// pane when using the Amazon ECS console.</para></dd><dt>awslogs-datetime-format</dt><dd><para>Required: No</para><para>This option defines a multiline start pattern in Python <c>strftime</c> format. A /// log message consists of a line that matches the pattern and any following lines that /// don’t match the pattern. The matched line is the delimiter between log messages.</para><para>One example of a use case for using this format is for parsing output such as a stack /// dump, which might otherwise be logged in multiple entries. The correct pattern allows /// it to be captured in a single entry.</para><para>For more information, see <a href="https://docs.docker.com/config/containers/logging/awslogs/#awslogs-datetime-format">awslogs-datetime-format</a>.</para><para>You cannot configure both the <c>awslogs-datetime-format</c> and <c>awslogs-multiline-pattern</c> /// options.</para><note><para>Multiline logging performs regular expression parsing and matching of all log messages. /// This might have a negative impact on logging performance.</para></note></dd><dt>awslogs-multiline-pattern</dt><dd><para>Required: No</para><para>This option defines a multiline start pattern that uses a regular expression. A log /// message consists of a line that matches the pattern and any following lines that don’t /// match the pattern. The matched line is the delimiter between log messages.</para><para>For more information, see <a href="https://docs.docker.com/config/containers/logging/awslogs/#awslogs-multiline-pattern">awslogs-multiline-pattern</a>.</para><para>This option is ignored if <c>awslogs-datetime-format</c> is also configured.</para><para>You cannot configure both the <c>awslogs-datetime-format</c> and <c>awslogs-multiline-pattern</c> /// options.</para><note><para>Multiline logging performs regular expression parsing and matching of all log messages. /// This might have a negative impact on logging performance.</para></note></dd></dl><para>The following options apply to all supported log drivers.</para><dl><dt>mode</dt><dd><para>Required: No</para><para>Valid values: <c>non-blocking</c> | <c>blocking</c></para><para>This option defines the delivery mode of log messages from the container to the log /// driver specified using <c>logDriver</c>. The delivery mode you choose affects application /// availability when the flow of logs from container is interrupted.</para><para>If you use the <c>blocking</c> mode and the flow of logs is interrupted, calls from /// container code to write to the <c>stdout</c> and <c>stderr</c> streams will block. /// The logging thread of the application will block as a result. This may cause the application /// to become unresponsive and lead to container healthcheck failure. </para><para>If you use the <c>non-blocking</c> mode, the container's logs are instead stored in /// an in-memory intermediate buffer configured with the <c>max-buffer-size</c> option. /// This prevents the application from becoming unresponsive when logs cannot be sent. /// We recommend using this mode if you want to ensure service availability and are okay /// with some log loss. For more information, see <a href="http://aws.amazon.com/blogs/containers/preventing-log-loss-with-non-blocking-mode-in-the-awslogs-container-log-driver/">Preventing /// log loss with non-blocking mode in the <c>awslogs</c> container log driver</a>.</para><para>You can set a default <c>mode</c> for all containers in a specific Amazon Web Services /// Region by using the <c>defaultLogDriverMode</c> account setting. If you don't specify /// the <c>mode</c> option or configure the account setting, Amazon ECS will default to /// the <c>blocking</c> mode. For more information about the account setting, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#default-log-driver-mode">Default /// log driver mode</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</para></dd><dt>max-buffer-size</dt><dd><para>Required: No</para><para>Default value: <c>1m</c></para><para>When <c>non-blocking</c> mode is used, the <c>max-buffer-size</c> log option controls /// the size of the buffer that's used for intermediate message storage. Make sure to /// specify an adequate buffer size based on your application. When the buffer fills up, /// further logs cannot be stored. Logs that cannot be stored are lost. </para></dd></dl><para>To route logs using the <c>splunk</c> log router, you need to specify a <c>splunk-token</c> /// and a <c>splunk-url</c>.</para><para>When you use the <c>awsfirelens</c> log router to route logs to an Amazon Web Services /// Service or Amazon Web Services Partner Network destination for log storage and analytics, /// you can set the <c>log-driver-buffer-limit</c> option to limit the number of events /// that are buffered in memory, before being sent to the log router container. It can /// help to resolve potential log loss issue because high throughput might result in memory /// running out for the buffer inside of Docker.</para><para>Other options you can specify when using <c>awsfirelens</c> to route logs depend on /// the destination. When you export logs to Amazon Data Firehose, you can specify the /// Amazon Web Services Region with <c>region</c> and a name for the log stream with <c>delivery_stream</c>.</para><para>When you export logs to Amazon Kinesis Data Streams, you can specify an Amazon Web /// Services Region with <c>region</c> and a data stream name with <c>stream</c>.</para><para> When you export logs to Amazon OpenSearch Service, you can specify options like <c>Name</c>, /// <c>Host</c> (OpenSearch Service endpoint without protocol), <c>Port</c>, <c>Index</c>, /// <c>Type</c>, <c>Aws_auth</c>, <c>Aws_region</c>, <c>Suppress_Type_Name</c>, and <c>tls</c>. /// For more information, see <a href="http://aws.amazon.com/blogs/containers/under-the-hood-firelens-for-amazon-ecs-tasks/">Under /// the hood: FireLens for Amazon ECS Tasks</a>.</para><para>When you export logs to Amazon S3, you can specify the bucket using the <c>bucket</c> /// option. You can also specify <c>region</c>, <c>total_file_size</c>, <c>upload_timeout</c>, /// and <c>use_put_object</c> as options.</para><para>This parameter requires version 1.19 of the Docker Remote API or greater on your container /// instance. To check the Docker Remote API version on your container instance, log in /// to your container instance and run the following command: <c>sudo docker version --format /// '{{.Server.APIVersion}}'</c></para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("ServiceConnectConfiguration_LogConfiguration_Options")] public System.Collections.Hashtable LogConfiguration_Option { get; set; } #endregion #region Parameter PlacementConstraint /// <summary> /// <para> /// <para>An array of placement constraint objects to use for tasks in your service. You can /// specify a maximum of 10 constraints for each task. This limit includes constraints /// in the task definition and those specified at runtime.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("PlacementConstraints")] public Amazon.ECS.Model.PlacementConstraint[] PlacementConstraint { get; set; } #endregion #region Parameter PlacementStrategy /// <summary> /// <para> /// <para>The placement strategy objects to use for tasks in your service. You can specify a /// maximum of 5 strategy rules for each service.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public Amazon.ECS.Model.PlacementStrategy[] PlacementStrategy { get; set; } #endregion #region Parameter PlatformVersion /// <summary> /// <para> /// <para>The platform version that your tasks in the service are running on. A platform version /// is specified only for tasks using the Fargate launch type. If one isn't specified, /// the <c>LATEST</c> platform version is used. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html">Fargate /// platform versions</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.String PlatformVersion { get; set; } #endregion #region Parameter PropagateTag /// <summary> /// <para> /// <para>Specifies whether to propagate the tags from the task definition to the task. If no /// value is specified, the tags aren't propagated. Tags can only be propagated to the /// task during task creation. To add tags to a task after task creation, use the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html">TagResource</a> /// API action.</para><para>You must set this to a value other than <c>NONE</c> when you use Cost Explorer. For /// more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/usage-reports.html">Amazon /// ECS usage reports</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</para><para>The default is <c>NONE</c>.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("PropagateTags")] [AWSConstantClassSource("Amazon.ECS.PropagateTags")] public Amazon.ECS.PropagateTags PropagateTag { get; set; } #endregion #region Parameter Role /// <summary> /// <para> /// <para>The name or full Amazon Resource Name (ARN) of the IAM role that allows Amazon ECS /// to make calls to your load balancer on your behalf. This parameter is only permitted /// if you are using a load balancer with your service and your task definition doesn't /// use the <c>awsvpc</c> network mode. If you specify the <c>role</c> parameter, you /// must also specify a load balancer object with the <c>loadBalancers</c> parameter.</para><important><para>If your account has already created the Amazon ECS service-linked role, that role /// is used for your service unless you specify a role here. The service-linked role is /// required if your task definition uses the <c>awsvpc</c> network mode or if the service /// is configured to use service discovery, an external deployment controller, multiple /// target groups, or Elastic Inference accelerators in which case you don't specify a /// role here. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html">Using /// service-linked roles for Amazon ECS</a> in the <i>Amazon Elastic Container Service /// Developer Guide</i>.</para></important><para>If your specified role has a path other than <c>/</c>, then you must either specify /// the full role ARN (this is recommended) or prefix the role name with the path. For /// example, if a role with the name <c>bar</c> has a path of <c>/foo/</c> then you would /// specify <c>/foo/bar</c> as the role name. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names">Friendly /// names and paths</a> in the <i>IAM User Guide</i>.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.String Role { get; set; } #endregion #region Parameter Alarms_Rollback /// <summary> /// <para> /// <para>Determines whether to configure Amazon ECS to roll back the service if a service deployment /// fails. If rollback is used, when a service deployment fails, the service is rolled /// back to the last deployment that completed successfully.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("DeploymentConfiguration_Alarms_Rollback")] public System.Boolean? Alarms_Rollback { get; set; } #endregion #region Parameter DeploymentCircuitBreaker_Rollback /// <summary> /// <para> /// <para>Determines whether to configure Amazon ECS to roll back the service if a service deployment /// fails. If rollback is on, when a service deployment fails, the service is rolled back /// to the last deployment that completed successfully.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("DeploymentConfiguration_DeploymentCircuitBreaker_Rollback")] public System.Boolean? DeploymentCircuitBreaker_Rollback { get; set; } #endregion #region Parameter SchedulingStrategy /// <summary> /// <para> /// <para>The scheduling strategy to use for the service. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html">Services</a>.</para><para>There are two service scheduler strategies available:</para><ul><li><para><c>REPLICA</c>-The replica scheduling strategy places and maintains the desired number /// of tasks across your cluster. By default, the service scheduler spreads tasks across /// Availability Zones. You can use task placement strategies and constraints to customize /// task placement decisions. This scheduler strategy is required if the service uses /// the <c>CODE_DEPLOY</c> or <c>EXTERNAL</c> deployment controller types.</para></li><li><para><c>DAEMON</c>-The daemon scheduling strategy deploys exactly one task on each active /// container instance that meets all of the task placement constraints that you specify /// in your cluster. The service scheduler also evaluates the task placement constraints /// for running tasks and will stop tasks that don't meet the placement constraints. When /// you're using this strategy, you don't need to specify a desired number of tasks, a /// task placement strategy, or use Service Auto Scaling policies.</para><note><para>Tasks using the Fargate launch type or the <c>CODE_DEPLOY</c> or <c>EXTERNAL</c> deployment /// controller types don't support the <c>DAEMON</c> scheduling strategy.</para></note></li></ul> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [AWSConstantClassSource("Amazon.ECS.SchedulingStrategy")] public Amazon.ECS.SchedulingStrategy SchedulingStrategy { get; set; } #endregion #region Parameter LogConfiguration_SecretOption /// <summary> /// <para> /// <para>The secrets to pass to the log configuration. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html">Specifying /// sensitive data</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("ServiceConnectConfiguration_LogConfiguration_SecretOptions")] public Amazon.ECS.Model.Secret[] LogConfiguration_SecretOption { get; set; } #endregion #region Parameter AwsvpcConfiguration_SecurityGroup /// <summary> /// <para> /// <para>The IDs of the security groups associated with the task or service. If you don't specify /// a security group, the default security group for the VPC is used. There's a limit /// of 5 security groups that can be specified.</para><note><para>All specified security groups must be from the same VPC.</para></note> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("NetworkConfiguration_AwsvpcConfiguration_SecurityGroups")] public System.String[] AwsvpcConfiguration_SecurityGroup { get; set; } #endregion #region Parameter ServiceName /// <summary> /// <para> /// <para>The name of your service. Up to 255 letters (uppercase and lowercase), numbers, underscores, /// and hyphens are allowed. Service names must be unique within a cluster, but you can /// have similarly named services in multiple clusters within a Region or across multiple /// Regions.</para> /// </para> /// </summary> #if !MODULAR [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] #else [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true, Mandatory = true)] [System.Management.Automation.AllowEmptyString] [System.Management.Automation.AllowNull] #endif [Amazon.PowerShell.Common.AWSRequiredParameter] public System.String ServiceName { get; set; } #endregion #region Parameter ServiceRegistry /// <summary> /// <para> /// <para>The details of the service discovery registry to associate with this service. For /// more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html">Service /// discovery</a>.</para><note><para>Each service may be associated with one service registry. Multiple service registries /// for each service isn't supported.</para></note> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("ServiceRegistries")] public Amazon.ECS.Model.ServiceRegistry[] ServiceRegistry { get; set; } #endregion #region Parameter ServiceConnectConfiguration_Service /// <summary> /// <para> /// <para>The list of Service Connect service objects. These are names and aliases (also known /// as endpoints) that are used by other Amazon ECS services to connect to this service. /// </para><para>This field is not required for a "client" Amazon ECS service that's a member of a /// namespace only to connect to other services within the namespace. An example of this /// would be a frontend application that accepts incoming requests from either a load /// balancer that's attached to the service or by other means.</para><para>An object selects a port from the task definition, assigns a name for the Cloud Map /// service, and a list of aliases (endpoints) and ports for client applications to refer /// to this service.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("ServiceConnectConfiguration_Services")] public Amazon.ECS.Model.ServiceConnectService[] ServiceConnectConfiguration_Service { get; set; } #endregion #region Parameter AwsvpcConfiguration_Subnet /// <summary> /// <para> /// <para>The IDs of the subnets associated with the task or service. There's a limit of 16 /// subnets that can be specified.</para><note><para>All specified subnets must be from the same VPC.</para></note> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("NetworkConfiguration_AwsvpcConfiguration_Subnets")] public System.String[] AwsvpcConfiguration_Subnet { get; set; } #endregion #region Parameter Tag /// <summary> /// <para> /// <para>The metadata that you apply to the service to help you categorize and organize them. /// Each tag consists of a key and an optional value, both of which you define. When a /// service is deleted, the tags are deleted as well.</para><para>The following basic restrictions apply to tags:</para><ul><li><para>Maximum number of tags per resource - 50</para></li><li><para>For each resource, each tag key must be unique, and each tag key can have only one /// value.</para></li><li><para>Maximum key length - 128 Unicode characters in UTF-8</para></li><li><para>Maximum value length - 256 Unicode characters in UTF-8</para></li><li><para>If your tagging schema is used across multiple services and resources, remember that /// other services may have restrictions on allowed characters. Generally allowed characters /// are: letters, numbers, and spaces representable in UTF-8, and the following characters: /// + - = . _ : / @.</para></li><li><para>Tag keys and values are case-sensitive.</para></li><li><para>Do not use <c>aws:</c>, <c>AWS:</c>, or any upper or lowercase combination of such /// as a prefix for either keys or values as it is reserved for Amazon Web Services use. /// You cannot edit or delete tag keys or values with this prefix. Tags with this prefix /// do not count against your tags per resource limit.</para></li></ul> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("Tags")] public Amazon.ECS.Model.Tag[] Tag { get; set; } #endregion #region Parameter TaskDefinition /// <summary> /// <para> /// <para>The <c>family</c> and <c>revision</c> (<c>family:revision</c>) or full ARN of the /// task definition to run in your service. If a <c>revision</c> isn't specified, the /// latest <c>ACTIVE</c> revision is used.</para><para>A task definition must be specified if the service uses either the <c>ECS</c> or <c>CODE_DEPLOY</c> /// deployment controllers.</para><para>For more information about deployment types, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon /// ECS deployment types</a>.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.String TaskDefinition { get; set; } #endregion #region Parameter DeploymentController_Type /// <summary> /// <para> /// <para>The deployment controller type to use.</para><para>There are three deployment controller types available:</para><dl><dt>ECS</dt><dd><para>The rolling update (<c>ECS</c>) deployment type involves replacing the current running /// version of the container with the latest version. The number of containers Amazon /// ECS adds or removes from the service during a rolling update is controlled by adjusting /// the minimum and maximum number of healthy tasks allowed during a service deployment, /// as specified in the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeploymentConfiguration.html">DeploymentConfiguration</a>.</para><para>For more information about rolling deployments, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html">Deploy /// Amazon ECS services by replacing tasks</a> in the <i>Amazon Elastic Container Service /// Developer Guide</i>.</para></dd><dt>CODE_DEPLOY</dt><dd><para>The blue/green (<c>CODE_DEPLOY</c>) deployment type uses the blue/green deployment /// model powered by CodeDeploy, which allows you to verify a new deployment of a service /// before sending production traffic to it.</para><para>For more information about blue/green deployments, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html">Validate /// the state of an Amazon ECS service before deployment </a> in the <i>Amazon Elastic /// Container Service Developer Guide</i>.</para></dd><dt>EXTERNAL</dt><dd><para>The external (<c>EXTERNAL</c>) deployment type enables you to use any third-party /// deployment controller for full control over the deployment process for an Amazon ECS /// service.</para><para>For more information about external deployments, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-external.html">Deploy /// Amazon ECS services using a third-party controller </a> in the <i>Amazon Elastic Container /// Service Developer Guide</i>.</para></dd></dl> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [AWSConstantClassSource("Amazon.ECS.DeploymentControllerType")] public Amazon.ECS.DeploymentControllerType DeploymentController_Type { get; set; } #endregion #region Parameter VolumeConfiguration /// <summary> /// <para> /// <para>The configuration for a volume specified in the task definition as a volume that is /// configured at launch time. Currently, the only supported volume type is an Amazon /// EBS volume.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("VolumeConfigurations")] public Amazon.ECS.Model.ServiceVolumeConfiguration[] VolumeConfiguration { get; set; } #endregion #region Parameter VpcLatticeConfiguration /// <summary> /// <para> /// <para>The VPC Lattice configuration for the service being created.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [Alias("VpcLatticeConfigurations")] public Amazon.ECS.Model.VpcLatticeConfiguration[] VpcLatticeConfiguration { get; set; } #endregion #region Parameter ClientToken /// <summary> /// <para> /// <para>An identifier that you provide to ensure the idempotency of the request. It must be /// unique and is case sensitive. Up to 36 ASCII characters in the range of 33-126 (inclusive) /// are allowed.</para> /// </para> /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.String ClientToken { get; set; } #endregion #region Parameter Select /// <summary> /// Use the -Select parameter to control the cmdlet output. The default value is 'Service'. /// Specifying -Select '*' will result in the cmdlet returning the whole service response (Amazon.ECS.Model.CreateServiceResponse). /// Specifying the name of a property of type Amazon.ECS.Model.CreateServiceResponse will result in that property being returned. /// Specifying -Select '^ParameterName' will result in the cmdlet returning the selected cmdlet parameter value. /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public string Select { get; set; } = "Service"; #endregion #region Parameter PassThru /// <summary> /// Changes the cmdlet behavior to return the value passed to the Cluster parameter. /// The -PassThru parameter is deprecated, use -Select '^Cluster' instead. This parameter will be removed in a future version. /// </summary> [System.Obsolete("The -PassThru parameter is deprecated, use -Select '^Cluster' instead. This parameter will be removed in a future version.")] [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public SwitchParameter PassThru { get; set; } #endregion #region Parameter Force /// <summary> /// This parameter overrides confirmation prompts to force /// the cmdlet to continue its operation. This parameter should always /// be used with caution. /// </summary> [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public SwitchParameter Force { get; set; } #endregion protected override void ProcessRecord() { this._AWSSignerType = "v4"; base.ProcessRecord(); var resourceIdentifiersText = FormatParameterValuesForConfirmationMsg(nameof(this.ServiceName), MyInvocation.BoundParameters); if (!ConfirmShouldProceed(this.Force.IsPresent, resourceIdentifiersText, "New-ECSService (CreateService)")) { return; } var context = new CmdletContext(); // allow for manipulation of parameters prior to loading into context PreExecutionContextLoad(context); #pragma warning disable CS0618, CS0612 //A class member was marked with the Obsolete attribute if (ParameterWasBound(nameof(this.Select))) { context.Select = CreateSelectDelegate<Amazon.ECS.Model.CreateServiceResponse, NewECSServiceCmdlet>(Select) ?? throw new System.ArgumentException("Invalid value for -Select parameter.", nameof(this.Select)); if (this.PassThru.IsPresent) { throw new System.ArgumentException("-PassThru cannot be used when -Select is specified.", nameof(this.Select)); } } else if (this.PassThru.IsPresent) { context.Select = (response, cmdlet) => this.Cluster; } #pragma warning restore CS0618, CS0612 //A class member was marked with the Obsolete attribute context.AvailabilityZoneRebalancing = this.AvailabilityZoneRebalancing; if (this.CapacityProviderStrategy != null) { context.CapacityProviderStrategy = new List<Amazon.ECS.Model.CapacityProviderStrategyItem>(this.CapacityProviderStrategy); } context.ClientToken = this.ClientToken; context.Cluster = this.Cluster; if (this.Alarms_AlarmName != null) { context.Alarms_AlarmName = new List<System.String>(this.Alarms_AlarmName); } context.Alarms_Enable = this.Alarms_Enable; context.Alarms_Rollback = this.Alarms_Rollback; context.DeploymentCircuitBreaker_Enable = this.DeploymentCircuitBreaker_Enable; context.DeploymentCircuitBreaker_Rollback = this.DeploymentCircuitBreaker_Rollback; context.DeploymentConfiguration_MaximumPercent = this.DeploymentConfiguration_MaximumPercent; context.DeploymentConfiguration_MinimumHealthyPercent = this.DeploymentConfiguration_MinimumHealthyPercent; context.DeploymentController_Type = this.DeploymentController_Type; context.DesiredCount = this.DesiredCount; context.EnableECSManagedTag = this.EnableECSManagedTag; context.EnableExecuteCommand = this.EnableExecuteCommand; context.HealthCheckGracePeriodSecond = this.HealthCheckGracePeriodSecond; context.LaunchType = this.LaunchType; if (this.LoadBalancer != null) { context.LoadBalancer = new List<Amazon.ECS.Model.LoadBalancer>(this.LoadBalancer); } context.AwsvpcConfiguration_AssignPublicIp = this.AwsvpcConfiguration_AssignPublicIp; if (this.AwsvpcConfiguration_SecurityGroup != null) { context.AwsvpcConfiguration_SecurityGroup = new List<System.String>(this.AwsvpcConfiguration_SecurityGroup); } if (this.AwsvpcConfiguration_Subnet != null) { context.AwsvpcConfiguration_Subnet = new List<System.String>(this.AwsvpcConfiguration_Subnet); } if (this.PlacementConstraint != null) { context.PlacementConstraint = new List<Amazon.ECS.Model.PlacementConstraint>(this.PlacementConstraint); } if (this.PlacementStrategy != null) { context.PlacementStrategy = new List<Amazon.ECS.Model.PlacementStrategy>(this.PlacementStrategy); } context.PlatformVersion = this.PlatformVersion; context.PropagateTag = this.PropagateTag; context.Role = this.Role; context.SchedulingStrategy = this.SchedulingStrategy; context.ServiceConnectConfiguration_Enabled = this.ServiceConnectConfiguration_Enabled; context.LogConfiguration_LogDriver = this.LogConfiguration_LogDriver; if (this.LogConfiguration_Option != null) { context.LogConfiguration_Option = new Dictionary<System.String, System.String>(StringComparer.Ordinal); foreach (var hashKey in this.LogConfiguration_Option.Keys) { context.LogConfiguration_Option.Add((String)hashKey, (System.String)(this.LogConfiguration_Option[hashKey])); } } if (this.LogConfiguration_SecretOption != null) { context.LogConfiguration_SecretOption = new List<Amazon.ECS.Model.Secret>(this.LogConfiguration_SecretOption); } context.ServiceConnectConfiguration_Namespace = this.ServiceConnectConfiguration_Namespace; if (this.ServiceConnectConfiguration_Service != null) { context.ServiceConnectConfiguration_Service = new List<Amazon.ECS.Model.ServiceConnectService>(this.ServiceConnectConfiguration_Service); } context.ServiceName = this.ServiceName; #if MODULAR if (this.ServiceName == null && ParameterWasBound(nameof(this.ServiceName))) { WriteWarning("You are passing $null as a value for parameter ServiceName which is marked as required. In case you believe this parameter was incorrectly marked as required, report this by opening an issue at https://github.com/aws/aws-tools-for-powershell/issues."); } #endif if (this.ServiceRegistry != null) { context.ServiceRegistry = new List<Amazon.ECS.Model.ServiceRegistry>(this.ServiceRegistry); } if (this.Tag != null) { context.Tag = new List<Amazon.ECS.Model.Tag>(this.Tag); } context.TaskDefinition = this.TaskDefinition; if (this.VolumeConfiguration != null) { context.VolumeConfiguration = new List<Amazon.ECS.Model.ServiceVolumeConfiguration>(this.VolumeConfiguration); } if (this.VpcLatticeConfiguration != null) { context.VpcLatticeConfiguration = new List<Amazon.ECS.Model.VpcLatticeConfiguration>(this.VpcLatticeConfiguration); } // allow further manipulation of loaded context prior to processing PostExecutionContextLoad(context); var output = Execute(context) as CmdletOutput; ProcessOutput(output); } #region IExecutor Members public object Execute(ExecutorContext context) { var cmdletContext = context as CmdletContext; // create request var request = new Amazon.ECS.Model.CreateServiceRequest(); if (cmdletContext.AvailabilityZoneRebalancing != null) { request.AvailabilityZoneRebalancing = cmdletContext.AvailabilityZoneRebalancing; } if (cmdletContext.CapacityProviderStrategy != null) { request.CapacityProviderStrategy = cmdletContext.CapacityProviderStrategy; } if (cmdletContext.ClientToken != null) { request.ClientToken = cmdletContext.ClientToken; } if (cmdletContext.Cluster != null) { request.Cluster = cmdletContext.Cluster; } // populate DeploymentConfiguration var requestDeploymentConfigurationIsNull = true; request.DeploymentConfiguration = new Amazon.ECS.Model.DeploymentConfiguration(); System.Int32? requestDeploymentConfiguration_deploymentConfiguration_MaximumPercent = null; if (cmdletContext.DeploymentConfiguration_MaximumPercent != null) { requestDeploymentConfiguration_deploymentConfiguration_MaximumPercent = cmdletContext.DeploymentConfiguration_MaximumPercent.Value; } if (requestDeploymentConfiguration_deploymentConfiguration_MaximumPercent != null) { request.DeploymentConfiguration.MaximumPercent = requestDeploymentConfiguration_deploymentConfiguration_MaximumPercent.Value; requestDeploymentConfigurationIsNull = false; } System.Int32? requestDeploymentConfiguration_deploymentConfiguration_MinimumHealthyPercent = null; if (cmdletContext.DeploymentConfiguration_MinimumHealthyPercent != null) { requestDeploymentConfiguration_deploymentConfiguration_MinimumHealthyPercent = cmdletContext.DeploymentConfiguration_MinimumHealthyPercent.Value; } if (requestDeploymentConfiguration_deploymentConfiguration_MinimumHealthyPercent != null) { request.DeploymentConfiguration.MinimumHealthyPercent = requestDeploymentConfiguration_deploymentConfiguration_MinimumHealthyPercent.Value; requestDeploymentConfigurationIsNull = false; } Amazon.ECS.Model.DeploymentCircuitBreaker requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker = null; // populate DeploymentCircuitBreaker var requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreakerIsNull = true; requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker = new Amazon.ECS.Model.DeploymentCircuitBreaker(); System.Boolean? requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker_deploymentCircuitBreaker_Enable = null; if (cmdletContext.DeploymentCircuitBreaker_Enable != null) { requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker_deploymentCircuitBreaker_Enable = cmdletContext.DeploymentCircuitBreaker_Enable.Value; } if (requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker_deploymentCircuitBreaker_Enable != null) { requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker.Enable = requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker_deploymentCircuitBreaker_Enable.Value; requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreakerIsNull = false; } System.Boolean? requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker_deploymentCircuitBreaker_Rollback = null; if (cmdletContext.DeploymentCircuitBreaker_Rollback != null) { requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker_deploymentCircuitBreaker_Rollback = cmdletContext.DeploymentCircuitBreaker_Rollback.Value; } if (requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker_deploymentCircuitBreaker_Rollback != null) { requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker.Rollback = requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker_deploymentCircuitBreaker_Rollback.Value; requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreakerIsNull = false; } // determine if requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker should be set to null if (requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreakerIsNull) { requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker = null; } if (requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker != null) { request.DeploymentConfiguration.DeploymentCircuitBreaker = requestDeploymentConfiguration_deploymentConfiguration_DeploymentCircuitBreaker; requestDeploymentConfigurationIsNull = false; } Amazon.ECS.Model.DeploymentAlarms requestDeploymentConfiguration_deploymentConfiguration_Alarms = null; // populate Alarms var requestDeploymentConfiguration_deploymentConfiguration_AlarmsIsNull = true; requestDeploymentConfiguration_deploymentConfiguration_Alarms = new Amazon.ECS.Model.DeploymentAlarms(); List<System.String> requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_AlarmName = null; if (cmdletContext.Alarms_AlarmName != null) { requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_AlarmName = cmdletContext.Alarms_AlarmName; } if (requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_AlarmName != null) { requestDeploymentConfiguration_deploymentConfiguration_Alarms.AlarmNames = requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_AlarmName; requestDeploymentConfiguration_deploymentConfiguration_AlarmsIsNull = false; } System.Boolean? requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_Enable = null; if (cmdletContext.Alarms_Enable != null) { requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_Enable = cmdletContext.Alarms_Enable.Value; } if (requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_Enable != null) { requestDeploymentConfiguration_deploymentConfiguration_Alarms.Enable = requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_Enable.Value; requestDeploymentConfiguration_deploymentConfiguration_AlarmsIsNull = false; } System.Boolean? requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_Rollback = null; if (cmdletContext.Alarms_Rollback != null) { requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_Rollback = cmdletContext.Alarms_Rollback.Value; } if (requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_Rollback != null) { requestDeploymentConfiguration_deploymentConfiguration_Alarms.Rollback = requestDeploymentConfiguration_deploymentConfiguration_Alarms_alarms_Rollback.Value; requestDeploymentConfiguration_deploymentConfiguration_AlarmsIsNull = false; } // determine if requestDeploymentConfiguration_deploymentConfiguration_Alarms should be set to null if (requestDeploymentConfiguration_deploymentConfiguration_AlarmsIsNull) { requestDeploymentConfiguration_deploymentConfiguration_Alarms = null; } if (requestDeploymentConfiguration_deploymentConfiguration_Alarms != null) { request.DeploymentConfiguration.Alarms = requestDeploymentConfiguration_deploymentConfiguration_Alarms; requestDeploymentConfigurationIsNull = false; } // determine if request.DeploymentConfiguration should be set to null if (requestDeploymentConfigurationIsNull) { request.DeploymentConfiguration = null; } // populate DeploymentController var requestDeploymentControllerIsNull = true; request.DeploymentController = new Amazon.ECS.Model.DeploymentController(); Amazon.ECS.DeploymentControllerType requestDeploymentController_deploymentController_Type = null; if (cmdletContext.DeploymentController_Type != null) { requestDeploymentController_deploymentController_Type = cmdletContext.DeploymentController_Type; } if (requestDeploymentController_deploymentController_Type != null) { request.DeploymentController.Type = requestDeploymentController_deploymentController_Type; requestDeploymentControllerIsNull = false; } // determine if request.DeploymentController should be set to null if (requestDeploymentControllerIsNull) { request.DeploymentController = null; } if (cmdletContext.DesiredCount != null) { request.DesiredCount = cmdletContext.DesiredCount.Value; } if (cmdletContext.EnableECSManagedTag != null) { request.EnableECSManagedTags = cmdletContext.EnableECSManagedTag.Value; } if (cmdletContext.EnableExecuteCommand != null) { request.EnableExecuteCommand = cmdletContext.EnableExecuteCommand.Value; } if (cmdletContext.HealthCheckGracePeriodSecond != null) { request.HealthCheckGracePeriodSeconds = cmdletContext.HealthCheckGracePeriodSecond.Value; } if (cmdletContext.LaunchType != null) { request.LaunchType = cmdletContext.LaunchType; } if (cmdletContext.LoadBalancer != null) { request.LoadBalancers = cmdletContext.LoadBalancer; } // populate NetworkConfiguration var requestNetworkConfigurationIsNull = true; request.NetworkConfiguration = new Amazon.ECS.Model.NetworkConfiguration(); Amazon.ECS.Model.AwsVpcConfiguration requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration = null; // populate AwsvpcConfiguration var requestNetworkConfiguration_networkConfiguration_AwsvpcConfigurationIsNull = true; requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration = new Amazon.ECS.Model.AwsVpcConfiguration(); Amazon.ECS.AssignPublicIp requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_AssignPublicIp = null; if (cmdletContext.AwsvpcConfiguration_AssignPublicIp != null) { requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_AssignPublicIp = cmdletContext.AwsvpcConfiguration_AssignPublicIp; } if (requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_AssignPublicIp != null) { requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration.AssignPublicIp = requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_AssignPublicIp; requestNetworkConfiguration_networkConfiguration_AwsvpcConfigurationIsNull = false; } List<System.String> requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_SecurityGroup = null; if (cmdletContext.AwsvpcConfiguration_SecurityGroup != null) { requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_SecurityGroup = cmdletContext.AwsvpcConfiguration_SecurityGroup; } if (requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_SecurityGroup != null) { requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration.SecurityGroups = requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_SecurityGroup; requestNetworkConfiguration_networkConfiguration_AwsvpcConfigurationIsNull = false; } List<System.String> requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_Subnet = null; if (cmdletContext.AwsvpcConfiguration_Subnet != null) { requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_Subnet = cmdletContext.AwsvpcConfiguration_Subnet; } if (requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_Subnet != null) { requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration.Subnets = requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration_awsvpcConfiguration_Subnet; requestNetworkConfiguration_networkConfiguration_AwsvpcConfigurationIsNull = false; } // determine if requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration should be set to null if (requestNetworkConfiguration_networkConfiguration_AwsvpcConfigurationIsNull) { requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration = null; } if (requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration != null) { request.NetworkConfiguration.AwsvpcConfiguration = requestNetworkConfiguration_networkConfiguration_AwsvpcConfiguration; requestNetworkConfigurationIsNull = false; } // determine if request.NetworkConfiguration should be set to null if (requestNetworkConfigurationIsNull) { request.NetworkConfiguration = null; } if (cmdletContext.PlacementConstraint != null) { request.PlacementConstraints = cmdletContext.PlacementConstraint; } if (cmdletContext.PlacementStrategy != null) { request.PlacementStrategy = cmdletContext.PlacementStrategy; } if (cmdletContext.PlatformVersion != null) { request.PlatformVersion = cmdletContext.PlatformVersion; } if (cmdletContext.PropagateTag != null) { request.PropagateTags = cmdletContext.PropagateTag; } if (cmdletContext.Role != null) { request.Role = cmdletContext.Role; } if (cmdletContext.SchedulingStrategy != null) { request.SchedulingStrategy = cmdletContext.SchedulingStrategy; } // populate ServiceConnectConfiguration var requestServiceConnectConfigurationIsNull = true; request.ServiceConnectConfiguration = new Amazon.ECS.Model.ServiceConnectConfiguration(); System.Boolean? requestServiceConnectConfiguration_serviceConnectConfiguration_Enabled = null; if (cmdletContext.ServiceConnectConfiguration_Enabled != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_Enabled = cmdletContext.ServiceConnectConfiguration_Enabled.Value; } if (requestServiceConnectConfiguration_serviceConnectConfiguration_Enabled != null) { request.ServiceConnectConfiguration.Enabled = requestServiceConnectConfiguration_serviceConnectConfiguration_Enabled.Value; requestServiceConnectConfigurationIsNull = false; } System.String requestServiceConnectConfiguration_serviceConnectConfiguration_Namespace = null; if (cmdletContext.ServiceConnectConfiguration_Namespace != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_Namespace = cmdletContext.ServiceConnectConfiguration_Namespace; } if (requestServiceConnectConfiguration_serviceConnectConfiguration_Namespace != null) { request.ServiceConnectConfiguration.Namespace = requestServiceConnectConfiguration_serviceConnectConfiguration_Namespace; requestServiceConnectConfigurationIsNull = false; } List<Amazon.ECS.Model.ServiceConnectService> requestServiceConnectConfiguration_serviceConnectConfiguration_Service = null; if (cmdletContext.ServiceConnectConfiguration_Service != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_Service = cmdletContext.ServiceConnectConfiguration_Service; } if (requestServiceConnectConfiguration_serviceConnectConfiguration_Service != null) { request.ServiceConnectConfiguration.Services = requestServiceConnectConfiguration_serviceConnectConfiguration_Service; requestServiceConnectConfigurationIsNull = false; } Amazon.ECS.Model.LogConfiguration requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration = null; // populate LogConfiguration var requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfigurationIsNull = true; requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration = new Amazon.ECS.Model.LogConfiguration(); Amazon.ECS.LogDriver requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_LogDriver = null; if (cmdletContext.LogConfiguration_LogDriver != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_LogDriver = cmdletContext.LogConfiguration_LogDriver; } if (requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_LogDriver != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration.LogDriver = requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_LogDriver; requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfigurationIsNull = false; } Dictionary<System.String, System.String> requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_Option = null; if (cmdletContext.LogConfiguration_Option != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_Option = cmdletContext.LogConfiguration_Option; } if (requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_Option != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration.Options = requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_Option; requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfigurationIsNull = false; } List<Amazon.ECS.Model.Secret> requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_SecretOption = null; if (cmdletContext.LogConfiguration_SecretOption != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_SecretOption = cmdletContext.LogConfiguration_SecretOption; } if (requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_SecretOption != null) { requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration.SecretOptions = requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration_logConfiguration_SecretOption; requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfigurationIsNull = false; } // determine if requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration should be set to null if (requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfigurationIsNull) { requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration = null; } if (requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration != null) { request.ServiceConnectConfiguration.LogConfiguration = requestServiceConnectConfiguration_serviceConnectConfiguration_LogConfiguration; requestServiceConnectConfigurationIsNull = false; } // determine if request.ServiceConnectConfiguration should be set to null if (requestServiceConnectConfigurationIsNull) { request.ServiceConnectConfiguration = null; } if (cmdletContext.ServiceName != null) { request.ServiceName = cmdletContext.ServiceName; } if (cmdletContext.ServiceRegistry != null) { request.ServiceRegistries = cmdletContext.ServiceRegistry; } if (cmdletContext.Tag != null) { request.Tags = cmdletContext.Tag; } if (cmdletContext.TaskDefinition != null) { request.TaskDefinition = cmdletContext.TaskDefinition; } if (cmdletContext.VolumeConfiguration != null) { request.VolumeConfigurations = cmdletContext.VolumeConfiguration; } if (cmdletContext.VpcLatticeConfiguration != null) { request.VpcLatticeConfigurations = cmdletContext.VpcLatticeConfiguration; } CmdletOutput output; // issue call var client = Client ?? CreateClient(_CurrentCredentials, _RegionEndpoint); try { var response = CallAWSServiceOperation(client, request); object pipelineOutput = null; pipelineOutput = cmdletContext.Select(response, this); output = new CmdletOutput { PipelineOutput = pipelineOutput, ServiceResponse = response }; } catch (Exception e) { output = new CmdletOutput { ErrorResponse = e }; } return output; } public ExecutorContext CreateContext() { return new CmdletContext(); } #endregion #region AWS Service Operation Call private Amazon.ECS.Model.CreateServiceResponse CallAWSServiceOperation(IAmazonECS client, Amazon.ECS.Model.CreateServiceRequest request) { Utils.Common.WriteVerboseEndpointMessage(this, client.Config, "Amazon EC2 Container Service", "CreateService"); try { #if DESKTOP return client.CreateService(request); #elif CORECLR return client.CreateServiceAsync(request).GetAwaiter().GetResult(); #else #error "Unknown build edition" #endif } catch (AmazonServiceException exc) { var webException = exc.InnerException as System.Net.WebException; if (webException != null) { throw new Exception(Utils.Common.FormatNameResolutionFailureMessage(client.Config, webException.Message), webException); } throw; } } #endregion internal partial class CmdletContext : ExecutorContext { public Amazon.ECS.AvailabilityZoneRebalancing AvailabilityZoneRebalancing { get; set; } public List<Amazon.ECS.Model.CapacityProviderStrategyItem> CapacityProviderStrategy { get; set; } public System.String ClientToken { get; set; } public System.String Cluster { get; set; } public List<System.String> Alarms_AlarmName { get; set; } public System.Boolean? Alarms_Enable { get; set; } public System.Boolean? Alarms_Rollback { get; set; } public System.Boolean? DeploymentCircuitBreaker_Enable { get; set; } public System.Boolean? DeploymentCircuitBreaker_Rollback { get; set; } public System.Int32? DeploymentConfiguration_MaximumPercent { get; set; } public System.Int32? DeploymentConfiguration_MinimumHealthyPercent { get; set; } public Amazon.ECS.DeploymentControllerType DeploymentController_Type { get; set; } public System.Int32? DesiredCount { get; set; } public System.Boolean? EnableECSManagedTag { get; set; } public System.Boolean? EnableExecuteCommand { get; set; } public System.Int32? HealthCheckGracePeriodSecond { get; set; } public Amazon.ECS.LaunchType LaunchType { get; set; } public List<Amazon.ECS.Model.LoadBalancer> LoadBalancer { get; set; } public Amazon.ECS.AssignPublicIp AwsvpcConfiguration_AssignPublicIp { get; set; } public List<System.String> AwsvpcConfiguration_SecurityGroup { get; set; } public List<System.String> AwsvpcConfiguration_Subnet { get; set; } public List<Amazon.ECS.Model.PlacementConstraint> PlacementConstraint { get; set; } public List<Amazon.ECS.Model.PlacementStrategy> PlacementStrategy { get; set; } public System.String PlatformVersion { get; set; } public Amazon.ECS.PropagateTags PropagateTag { get; set; } public System.String Role { get; set; } public Amazon.ECS.SchedulingStrategy SchedulingStrategy { get; set; } public System.Boolean? ServiceConnectConfiguration_Enabled { get; set; } public Amazon.ECS.LogDriver LogConfiguration_LogDriver { get; set; } public Dictionary<System.String, System.String> LogConfiguration_Option { get; set; } public List<Amazon.ECS.Model.Secret> LogConfiguration_SecretOption { get; set; } public System.String ServiceConnectConfiguration_Namespace { get; set; } public List<Amazon.ECS.Model.ServiceConnectService> ServiceConnectConfiguration_Service { get; set; } public System.String ServiceName { get; set; } public List<Amazon.ECS.Model.ServiceRegistry> ServiceRegistry { get; set; } public List<Amazon.ECS.Model.Tag> Tag { get; set; } public System.String TaskDefinition { get; set; } public List<Amazon.ECS.Model.ServiceVolumeConfiguration> VolumeConfiguration { get; set; } public List<Amazon.ECS.Model.VpcLatticeConfiguration> VpcLatticeConfiguration { get; set; } public System.Func<Amazon.ECS.Model.CreateServiceResponse, NewECSServiceCmdlet, object> Select { get; set; } = (response, cmdlet) => response.Service; } } }