/*******************************************************************************
* Copyright 2012-2019 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
{
///
/// 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 desiredCount
,
/// Amazon ECS runs another copy of the task in the specified cluster. To update an existing
/// service, see the UpdateService action.
///
///
/// Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon
/// Elastic Inference (EI), and will help current customers migrate their workloads to
/// options that offer better price and performance. After April 15, 2023, new customers
/// will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker,
/// Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once
/// during the past 30-day period are considered current customers and will be able to
/// continue using the service.
///
/// 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 Service
/// load balancing in the Amazon Elastic Container Service Developer Guide.
///
/// Tasks for services that don't use a load balancer are considered healthy if they're
/// in the RUNNING
state. Tasks for services that use a load balancer are
/// considered healthy if they're in the RUNNING
state and are reported as
/// healthy by the load balancer.
///
/// There are two service scheduler strategies available:
/// REPLICA
- 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 Service
/// scheduler concepts in the Amazon Elastic Container Service Developer Guide.
/// DAEMON
- 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
/// Service
/// scheduler concepts in the Amazon Elastic Container Service Developer Guide.
///
/// 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. This is done with an
/// UpdateService operation. The default value for a replica service for minimumHealthyPercent
/// is 100%. The default value for a daemon service for minimumHealthyPercent
/// is 0%.
///
/// If a service uses the ECS
deployment controller, the minimum healthy
/// percent represents a lower limit on the number of tasks in a service that must remain
/// in the RUNNING
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 DRAINING
/// 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 RUNNING
state, tasks for services
/// that don't use a load balancer are considered healthy . If they're in the RUNNING
/// state and reported as healthy by the load balancer, tasks for services that do
/// use a load balancer are considered healthy . The default value for minimum healthy
/// percent is 100%.
///
/// If a service uses the ECS
deployment controller, the maximum percent
/// parameter represents an upper limit on the number of tasks in a service that are allowed
/// in the RUNNING
or PENDING
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 DRAINING
/// 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%.
///
/// If a service uses either the CODE_DEPLOY
or EXTERNAL
deployment
/// controller types and tasks that use the EC2 launch type, the minimum healthy percent
/// and maximum percent values are used only to define the lower and upper limit
/// on the number of the tasks in the service that remain in the RUNNING
/// state. This is while the container instances are in the DRAINING
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.
///
/// When creating a service that uses the EXTERNAL
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 CreateTaskSet
/// operation. For more information, see Amazon
/// ECS deployment types in the Amazon Elastic Container Service Developer Guide.
///
/// When the service scheduler launches new tasks, it determines task placement. For information
/// about task placement and task placement strategies, see Amazon
/// ECS task placement in the Amazon Elastic Container Service Developer Guide.
///
///
[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 also be referenced from properties attached to the cmdlet entry in the $AWSHistory stack."
)]
public partial class NewECSServiceCmdlet : AmazonECSClientCmdlet, IExecutor
{
#region Parameter Alarms_AlarmName
///
///
/// One or more CloudWatch alarm names. Use a "," to separate the alarms.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("DeploymentConfiguration_Alarms_AlarmNames")]
public System.String[] Alarms_AlarmName { get; set; }
#endregion
#region Parameter AwsvpcConfiguration_AssignPublicIp
///
///
/// Whether the task's elastic network interface receives a public IP address. The default
/// value is DISABLED
.
///
///
[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 CapacityProviderStrategy
///
///
/// The capacity provider strategy to use for the service.If a capacityProviderStrategy
is specified, the launchType
/// parameter must be omitted. If no capacityProviderStrategy
or launchType
/// is specified, the defaultCapacityProviderStrategy
for the cluster is
/// used.A capacity provider strategy may contain a maximum of 6 capacity providers.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public Amazon.ECS.Model.CapacityProviderStrategyItem[] CapacityProviderStrategy { get; set; }
#endregion
#region Parameter Cluster
///
///
/// 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.
///
///
[System.Management.Automation.Parameter(Position = 0, ValueFromPipelineByPropertyName = true, ValueFromPipeline = true)]
public System.String Cluster { get; set; }
#endregion
#region Parameter DesiredCount
///
///
/// The number of instantiations of the specified task definition to place and keep running
/// in your service.This is required if schedulingStrategy
is REPLICA
or isn't
/// specified. If schedulingStrategy
is DAEMON
then this isn't
/// required.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.Int32? DesiredCount { get; set; }
#endregion
#region Parameter Alarms_Enable
///
///
/// Determines whether to use the CloudWatch alarm option in the service deployment process.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("DeploymentConfiguration_Alarms_Enable")]
public System.Boolean? Alarms_Enable { get; set; }
#endregion
#region Parameter DeploymentCircuitBreaker_Enable
///
///
/// Determines whether to use the deployment circuit breaker logic for the service.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("DeploymentConfiguration_DeploymentCircuitBreaker_Enable")]
public System.Boolean? DeploymentCircuitBreaker_Enable { get; set; }
#endregion
#region Parameter ServiceConnectConfiguration_Enabled
///
///
/// Specifies whether to use Service Connect with this service.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.Boolean? ServiceConnectConfiguration_Enabled { get; set; }
#endregion
#region Parameter EnableECSManagedTag
///
///
/// Specifies whether to turn on Amazon ECS managed tags for the tasks within the service.
/// For more information, see Tagging
/// your Amazon ECS resources in the Amazon Elastic Container Service Developer
/// Guide.When you use Amazon ECS managed tags, you need to set the propagateTags
/// request parameter.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("EnableECSManagedTags")]
public System.Boolean? EnableECSManagedTag { get; set; }
#endregion
#region Parameter EnableExecuteCommand
///
///
/// Determines whether the execute command functionality is turned on for the service.
/// If true
, this enables execute command functionality on all containers
/// in the service tasks.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.Boolean? EnableExecuteCommand { get; set; }
#endregion
#region Parameter HealthCheckGracePeriodSecond
///
///
/// The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy
/// Elastic Load Balancing target health checks after a task has first started. This is
/// only used when your service is configured to use a load balancer. If your service
/// has a load balancer defined and you don't specify a health check grace period value,
/// the default value of 0
is used.If you do not use an Elastic Load Balancing, we recommend that you use the startPeriod
/// in the task definition health check parameters. For more information, see Health
/// check.If your service's tasks take a while to start and respond to Elastic Load Balancing
/// 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.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("HealthCheckGracePeriodSeconds")]
public System.Int32? HealthCheckGracePeriodSecond { get; set; }
#endregion
#region Parameter LaunchType
///
///
/// The infrastructure that you run your service on. For more information, see Amazon
/// ECS launch types in the Amazon Elastic Container Service Developer Guide.The FARGATE
launch type runs your tasks on Fargate On-Demand infrastructure.Fargate Spot infrastructure is available for use but a capacity provider strategy
/// must be used. For more information, see Fargate
/// capacity providers in the Amazon ECS User Guide for Fargate.The EC2
launch type runs your tasks on Amazon EC2 instances registered
/// to your cluster.The EXTERNAL
launch type runs your tasks on your on-premises server or
/// virtual machine (VM) capacity registered to your cluster.A service can use either a launch type or a capacity provider strategy. If a launchType
/// is specified, the capacityProviderStrategy
parameter must be omitted.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[AWSConstantClassSource("Amazon.ECS.LaunchType")]
public Amazon.ECS.LaunchType LaunchType { get; set; }
#endregion
#region Parameter LoadBalancer
///
///
/// A load balancer object representing the load balancers to use with your service. For
/// more information, see Service
/// load balancing in the Amazon Elastic Container Service Developer Guide.If the service uses the rolling update (ECS
) 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 Using
/// service-linked roles for Amazon ECS in the Amazon Elastic Container Service
/// Developer Guide.If the service uses the CODE_DEPLOY
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 targetGroupPair
). During a deployment, CodeDeploy determines which
/// task set in your service has the status PRIMARY
, 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.If you use the CODE_DEPLOY
deployment controller, these values can be
/// changed when updating the service.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.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.Services with tasks that use the awsvpc
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 ip
as the target type,
/// not instance
. This is because tasks that use the awsvpc
/// network mode are associated with an elastic network interface, not an Amazon EC2 instance.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("LoadBalancers")]
public Amazon.ECS.Model.LoadBalancer[] LoadBalancer { get; set; }
#endregion
#region Parameter LogConfiguration_LogDriver
///
///
/// The log driver to use for the container.For tasks on Fargate, the supported log drivers are awslogs
, splunk
,
/// and awsfirelens
.For tasks hosted on Amazon EC2 instances, the supported log drivers are awslogs
,
/// fluentd
, gelf
, json-file
, journald
,
/// logentries
,syslog
, splunk
, and awsfirelens
.For more information about using the awslogs
log driver, see Using
/// the awslogs log driver in the Amazon Elastic Container Service Developer Guide.For more information about using the awsfirelens
log driver, see Custom
/// log routing in the Amazon Elastic Container Service Developer Guide.If you have a custom driver that isn't listed, you can fork the Amazon ECS container
/// agent project that's available on
/// GitHub 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.
///
///
[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
///
///
/// If a service is using the rolling update (ECS
) deployment type, the maximumPercent
/// parameter represents an upper limit on the number of your service's tasks that are
/// allowed in the RUNNING
or PENDING
state during a deployment,
/// as a percentage of the desiredCount
(rounded down to the nearest integer).
/// This parameter enables you to define the deployment batch size. For example, if your
/// service is using the REPLICA
service scheduler and has a desiredCount
/// of four tasks and a maximumPercent
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 maximumPercent
value
/// for a service using the REPLICA
service scheduler is 200%.If a service is using either the blue/green (CODE_DEPLOY
) or EXTERNAL
/// deployment types and tasks that use the EC2 launch type, the maximum percent
/// value is set to the default value and is used to define the upper limit on the number
/// of the tasks in the service that remain in the RUNNING
state while the
/// container instances are in the DRAINING
state. If the tasks in the service
/// use the Fargate launch type, the maximum percent value is not used, although it is
/// returned when describing your service.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.Int32? DeploymentConfiguration_MaximumPercent { get; set; }
#endregion
#region Parameter DeploymentConfiguration_MinimumHealthyPercent
///
///
/// If a service is using the rolling update (ECS
) deployment type, the minimumHealthyPercent
/// represents a lower limit on the number of your service's tasks that must remain in
/// the RUNNING
state during a deployment, as a percentage of the desiredCount
/// (rounded up to the nearest integer). This parameter enables you to deploy without
/// using additional cluster capacity. For example, if your service has a desiredCount
/// of four tasks and a minimumHealthyPercent
of 50%, the service scheduler
/// may stop two existing tasks to free up cluster capacity before starting two new tasks.
/// For services that do not use a load balancer, the following should be noted:- A service is considered healthy if all essential containers within the tasks in the
/// service pass their health checks.
- 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
RUNNING
state before
/// the task is counted towards the minimum healthy percent total. - 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.
///
For services are that do use a load balancer, the following should be noted:- 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.
- 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.
If a service is using either the blue/green (CODE_DEPLOY
) or EXTERNAL
/// deployment types and is running tasks that use the EC2 launch type, the minimum
/// healthy percent value is set to the default value and is used to define the lower
/// limit on the number of the tasks in the service that remain in the RUNNING
/// state while the container instances are in the DRAINING
state. If a service
/// is using either the blue/green (CODE_DEPLOY
) or EXTERNAL
/// 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.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.Int32? DeploymentConfiguration_MinimumHealthyPercent { get; set; }
#endregion
#region Parameter ServiceConnectConfiguration_Namespace
///
///
/// 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 Working
/// with Services in the Cloud Map Developer Guide.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.String ServiceConnectConfiguration_Namespace { get; set; }
#endregion
#region Parameter LogConfiguration_Option
///
///
/// The configuration options to send to the log driver. 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: sudo docker version --format '{{.Server.APIVersion}}'
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("ServiceConnectConfiguration_LogConfiguration_Options")]
public System.Collections.Hashtable LogConfiguration_Option { get; set; }
#endregion
#region Parameter PlacementConstraint
///
///
/// 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.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("PlacementConstraints")]
public Amazon.ECS.Model.PlacementConstraint[] PlacementConstraint { get; set; }
#endregion
#region Parameter PlacementStrategy
///
///
/// The placement strategy objects to use for tasks in your service. You can specify a
/// maximum of 5 strategy rules for each service.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public Amazon.ECS.Model.PlacementStrategy[] PlacementStrategy { get; set; }
#endregion
#region Parameter PlatformVersion
///
///
/// 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 LATEST
platform version is used. For more information, see Fargate
/// platform versions in the Amazon Elastic Container Service Developer Guide.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.String PlatformVersion { get; set; }
#endregion
#region Parameter PropagateTag
///
///
/// 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 TagResource
/// API action.The default is NONE
.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("PropagateTags")]
[AWSConstantClassSource("Amazon.ECS.PropagateTags")]
public Amazon.ECS.PropagateTags PropagateTag { get; set; }
#endregion
#region Parameter Role
///
///
/// 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 awsvpc
network mode. If you specify the role
parameter,
/// you must also specify a load balancer object with the loadBalancers
parameter.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 awsvpc
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 Using
/// service-linked roles for Amazon ECS in the Amazon Elastic Container Service
/// Developer Guide.If your specified role has a path other than /
, 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 bar
has a path of /foo/
/// then you would specify /foo/bar
as the role name. For more information,
/// see Friendly
/// names and paths in the IAM User Guide.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.String Role { get; set; }
#endregion
#region Parameter Alarms_Rollback
///
///
/// 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.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("DeploymentConfiguration_Alarms_Rollback")]
public System.Boolean? Alarms_Rollback { get; set; }
#endregion
#region Parameter DeploymentCircuitBreaker_Rollback
///
///
/// 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.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("DeploymentConfiguration_DeploymentCircuitBreaker_Rollback")]
public System.Boolean? DeploymentCircuitBreaker_Rollback { get; set; }
#endregion
#region Parameter SchedulingStrategy
///
///
/// The scheduling strategy to use for the service. For more information, see Services.There are two service scheduler strategies available:REPLICA
-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 CODE_DEPLOY
or EXTERNAL
deployment controller types.DAEMON
-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.Tasks using the Fargate launch type or the CODE_DEPLOY
or EXTERNAL
/// deployment controller types don't support the DAEMON
scheduling strategy.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[AWSConstantClassSource("Amazon.ECS.SchedulingStrategy")]
public Amazon.ECS.SchedulingStrategy SchedulingStrategy { get; set; }
#endregion
#region Parameter LogConfiguration_SecretOption
///
///
/// The secrets to pass to the log configuration. For more information, see Specifying
/// sensitive data in the Amazon Elastic Container Service Developer Guide.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("ServiceConnectConfiguration_LogConfiguration_SecretOptions")]
public Amazon.ECS.Model.Secret[] LogConfiguration_SecretOption { get; set; }
#endregion
#region Parameter AwsvpcConfiguration_SecurityGroup
///
///
/// 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 per AwsVpcConfiguration
.All specified security groups must be from the same VPC.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("NetworkConfiguration_AwsvpcConfiguration_SecurityGroups")]
public System.String[] AwsvpcConfiguration_SecurityGroup { get; set; }
#endregion
#region Parameter ServiceName
///
///
/// 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.
///
///
#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
///
///
/// The details of the service discovery registry to associate with this service. For
/// more information, see Service
/// discovery.Each service may be associated with one service registry. Multiple service registries
/// for each service isn't supported.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("ServiceRegistries")]
public Amazon.ECS.Model.ServiceRegistry[] ServiceRegistry { get; set; }
#endregion
#region Parameter ServiceConnectConfiguration_Service
///
///
/// 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.
/// 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.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.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("ServiceConnectConfiguration_Services")]
public Amazon.ECS.Model.ServiceConnectService[] ServiceConnectConfiguration_Service { get; set; }
#endregion
#region Parameter AwsvpcConfiguration_Subnet
///
///
/// The IDs of the subnets associated with the task or service. There's a limit of 16
/// subnets that can be specified per AwsVpcConfiguration
.All specified subnets must be from the same VPC.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("NetworkConfiguration_AwsvpcConfiguration_Subnets")]
public System.String[] AwsvpcConfiguration_Subnet { get; set; }
#endregion
#region Parameter Tag
///
///
/// 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.The following basic restrictions apply to tags:- Maximum number of tags per resource - 50
- For each resource, each tag key must be unique, and each tag key can have only one
/// value.
- Maximum key length - 128 Unicode characters in UTF-8
- Maximum value length - 256 Unicode characters in UTF-8
- 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:
/// + - = . _ : / @.
- Tag keys and values are case-sensitive.
- Do not use
aws:
, AWS:
, 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.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[Alias("Tags")]
public Amazon.ECS.Model.Tag[] Tag { get; set; }
#endregion
#region Parameter TaskDefinition
///
///
/// The family
and revision
(family:revision
) or
/// full ARN of the task definition to run in your service. If a revision
/// isn't specified, the latest ACTIVE
revision is used.A task definition must be specified if the service uses either the ECS
/// or CODE_DEPLOY
deployment controllers.For more information about deployment types, see Amazon
/// ECS deployment types.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.String TaskDefinition { get; set; }
#endregion
#region Parameter DeploymentController_Type
///
///
/// The deployment controller type to use.There are three deployment controller types available:- ECS
- The rolling update (
ECS
) 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 DeploymentConfiguration. - CODE_DEPLOY
- The blue/green (
CODE_DEPLOY
) 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. - EXTERNAL
- The external (
EXTERNAL
) deployment type enables you to use any third-party
/// deployment controller for full control over the deployment process for an Amazon ECS
/// service.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
[AWSConstantClassSource("Amazon.ECS.DeploymentControllerType")]
public Amazon.ECS.DeploymentControllerType DeploymentController_Type { get; set; }
#endregion
#region Parameter ClientToken
///
///
/// An identifier that you provide to ensure the idempotency of the request. It must be
/// unique and is case sensitive. Up to 32 ASCII characters are allowed.
///
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public System.String ClientToken { get; set; }
#endregion
#region Parameter Select
///
/// 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.
///
[System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)]
public string Select { get; set; } = "Service";
#endregion
#region Parameter PassThru
///
/// 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.
///
[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
///
/// This parameter overrides confirmation prompts to force
/// the cmdlet to continue its operation. This parameter should always
/// be used with caution.
///
[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(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
if (this.CapacityProviderStrategy != null)
{
context.CapacityProviderStrategy = new List(this.CapacityProviderStrategy);
}
context.ClientToken = this.ClientToken;
context.Cluster = this.Cluster;
if (this.Alarms_AlarmName != null)
{
context.Alarms_AlarmName = new List(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(this.LoadBalancer);
}
context.AwsvpcConfiguration_AssignPublicIp = this.AwsvpcConfiguration_AssignPublicIp;
if (this.AwsvpcConfiguration_SecurityGroup != null)
{
context.AwsvpcConfiguration_SecurityGroup = new List(this.AwsvpcConfiguration_SecurityGroup);
}
if (this.AwsvpcConfiguration_Subnet != null)
{
context.AwsvpcConfiguration_Subnet = new List(this.AwsvpcConfiguration_Subnet);
}
if (this.PlacementConstraint != null)
{
context.PlacementConstraint = new List(this.PlacementConstraint);
}
if (this.PlacementStrategy != null)
{
context.PlacementStrategy = new List(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(StringComparer.Ordinal);
foreach (var hashKey in this.LogConfiguration_Option.Keys)
{
context.LogConfiguration_Option.Add((String)hashKey, (String)(this.LogConfiguration_Option[hashKey]));
}
}
if (this.LogConfiguration_SecretOption != null)
{
context.LogConfiguration_SecretOption = new List(this.LogConfiguration_SecretOption);
}
context.ServiceConnectConfiguration_Namespace = this.ServiceConnectConfiguration_Namespace;
if (this.ServiceConnectConfiguration_Service != null)
{
context.ServiceConnectConfiguration_Service = new List(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(this.ServiceRegistry);
}
if (this.Tag != null)
{
context.Tag = new List(this.Tag);
}
context.TaskDefinition = this.TaskDefinition;
// 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.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 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 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 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 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 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 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;
}
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 List CapacityProviderStrategy { get; set; }
public System.String ClientToken { get; set; }
public System.String Cluster { get; set; }
public List 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 LoadBalancer { get; set; }
public Amazon.ECS.AssignPublicIp AwsvpcConfiguration_AssignPublicIp { get; set; }
public List AwsvpcConfiguration_SecurityGroup { get; set; }
public List AwsvpcConfiguration_Subnet { get; set; }
public List PlacementConstraint { get; set; }
public List 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 LogConfiguration_Option { get; set; }
public List LogConfiguration_SecretOption { get; set; }
public System.String ServiceConnectConfiguration_Namespace { get; set; }
public List ServiceConnectConfiguration_Service { get; set; }
public System.String ServiceName { get; set; }
public List ServiceRegistry { get; set; }
public List Tag { get; set; }
public System.String TaskDefinition { get; set; }
public System.Func Select { get; set; } =
(response, cmdlet) => response.Service;
}
}
}