AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a deployment group to which application revisions are deployed.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateDeploymentGroup and EndCreateDeploymentGroup.

Namespace: Amazon.CodeDeploy
Assembly: AWSSDK.CodeDeploy.dll
Version: 3.x.y.z

Syntax

C#
public abstract Task<CreateDeploymentGroupResponse> CreateDeploymentGroupAsync(
         CreateDeploymentGroupRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.CodeDeploy.Model.CreateDeploymentGroupRequest

Container for the necessary parameters to execute the CreateDeploymentGroup service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the CreateDeploymentGroup service method, as returned by CodeDeploy.

Exceptions

ExceptionCondition
AlarmsLimitExceededException The maximum number of alarms for a deployment group (10) was exceeded.
ApplicationDoesNotExistException The application does not exist with the user or Amazon Web Services account.
ApplicationNameRequiredException The minimum number of required application names was not specified.
DeploymentConfigDoesNotExistException The deployment configuration does not exist with the user or Amazon Web Services account.
DeploymentGroupAlreadyExistsException A deployment group with the specified name with the user or Amazon Web Services account already exists.
DeploymentGroupLimitExceededException The deployment groups limit was exceeded.
DeploymentGroupNameRequiredException The deployment group name was not specified.
ECSServiceMappingLimitExceededException The Amazon ECS service is associated with more than one deployment groups. An Amazon ECS service can be associated with only one deployment group.
InvalidAlarmConfigException The format of the alarm configuration is invalid. Possible causes include: The alarm list is null. The alarm object is null. The alarm name is empty or null or exceeds the limit of 255 characters. Two alarms with the same name have been specified. The alarm configuration is enabled, but the alarm list is empty.
InvalidApplicationNameException The application name was specified in an invalid format.
InvalidAutoRollbackConfigException The automatic rollback configuration was specified in an invalid format. For example, automatic rollback is enabled, but an invalid triggering event type or no event types were listed.
InvalidAutoScalingGroupException The Auto Scaling group was specified in an invalid format or does not exist.
InvalidBlueGreenDeploymentConfigurationException The configuration for the blue/green deployment group was provided in an invalid format. For information about deployment configuration format, see CreateDeploymentConfig.
InvalidDeploymentConfigNameException The deployment configuration name was specified in an invalid format.
InvalidDeploymentGroupNameException The deployment group name was specified in an invalid format.
InvalidDeploymentStyleException An invalid deployment style was specified. Valid deployment types include "IN_PLACE" and "BLUE_GREEN." Valid deployment options include "WITH_TRAFFIC_CONTROL" and "WITHOUT_TRAFFIC_CONTROL."
InvalidEC2TagCombinationException A call was submitted that specified both Ec2TagFilters and Ec2TagSet, but only one of these data types can be used in a single call.
InvalidEC2TagException The tag was specified in an invalid format.
InvalidECSServiceException The Amazon ECS service identifier is not valid.
InvalidInputException The input was specified in an invalid format.
InvalidLoadBalancerInfoException An invalid load balancer name, or no load balancer name, was specified.
InvalidOnPremisesTagCombinationException A call was submitted that specified both OnPremisesTagFilters and OnPremisesTagSet, but only one of these data types can be used in a single call.
InvalidRoleException The service role ARN was specified in an invalid format. Or, if an Auto Scaling group was specified, the specified service role does not grant the appropriate permissions to Amazon EC2 Auto Scaling.
InvalidTagException The tag was specified in an invalid format.
InvalidTagsToAddException The specified tags are not valid.
InvalidTargetGroupPairException A target group pair associated with this deployment is not valid.
InvalidTrafficRoutingConfigurationException The configuration that specifies how traffic is routed during a deployment is invalid.
InvalidTriggerConfigException The trigger was specified in an invalid format.
LifecycleHookLimitExceededException The limit for lifecycle hooks was exceeded.
RoleRequiredException The role ID was not specified.
TagSetListLimitExceededException The number of tag groups included in the tag set list exceeded the maximum allowed limit of 3.
ThrottlingException An API function was called too frequently.
TriggerTargetsLimitExceededException The maximum allowed number of triggers was exceeded.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also