@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonCodeDeployClient extends AmazonWebServiceClient implements AmazonCodeDeploy
CodeDeploy is a deployment service that automates application deployments to Amazon EC2 instances, on-premises instances running in your own facility, serverless Lambda functions, or applications in an Amazon ECS service.
You can deploy a nearly unlimited variety of application content, such as an updated Lambda function, updated applications in an Amazon ECS service, code, web and configuration files, executables, packages, scripts, multimedia files, and so on. CodeDeploy can deploy application content stored in Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do not need to make changes to your existing code before you can use CodeDeploy.
CodeDeploy makes it easier for you to rapidly release new features, helps you avoid downtime during application deployment, and handles the complexity of updating your applications, without many of the risks associated with error-prone manual deployments.
CodeDeploy Components
Use the information in this guide to help you work with the following CodeDeploy components:
Application: A name that uniquely identifies the application you want to deploy. CodeDeploy uses this name, which functions as a container, to ensure the correct combination of revision, deployment configuration, and deployment group are referenced during a deployment.
Deployment group: A set of individual instances, CodeDeploy Lambda deployment configuration settings, or an Amazon ECS service and network details. A Lambda deployment group specifies how to route traffic to a new version of a Lambda function. An Amazon ECS deployment group specifies the service created in Amazon ECS to deploy, a load balancer, and a listener to reroute production traffic to an updated containerized application. An Amazon EC2/On-premises deployment group contains individually tagged instances, Amazon EC2 instances in Amazon EC2 Auto Scaling groups, or both. All deployment groups can specify optional trigger, alarm, and rollback settings.
Deployment configuration: A set of deployment rules and deployment success and failure conditions used by CodeDeploy during a deployment.
Deployment: The process and the components used when updating a Lambda function, a containerized application in an Amazon ECS service, or of installing content on one or more instances.
Application revisions: For an Lambda deployment, this is an AppSpec file that specifies the Lambda function to be updated and one or more functions to validate deployment lifecycle events. For an Amazon ECS deployment, this is an AppSpec file that specifies the Amazon ECS task definition, container, and port where production traffic is rerouted. For an EC2/On-premises deployment, this is an archive file that contains source content—source code, webpages, executable files, and deployment scripts—along with an AppSpec file. Revisions are stored in Amazon S3 buckets or GitHub repositories. For Amazon S3, a revision is uniquely identified by its Amazon S3 object key and its ETag, version, or both. For GitHub, a revision is uniquely identified by its commit ID.
This guide also contains information to help you get details about the instances in your deployments, to make on-premises instances available for CodeDeploy deployments, to get details about a Lambda function deployment, and to get details about Amazon ECS service deployments.
CodeDeploy Information Resources
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Constructor and Description |
---|
AmazonCodeDeployClient()
Deprecated.
|
AmazonCodeDeployClient(AWSCredentials awsCredentials)
Deprecated.
use
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example:
AmazonCodeDeployClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build(); |
AmazonCodeDeployClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
|
AmazonCodeDeployClient(AWSCredentialsProvider awsCredentialsProvider)
Deprecated.
|
AmazonCodeDeployClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
|
AmazonCodeDeployClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
|
AmazonCodeDeployClient(ClientConfiguration clientConfiguration)
Deprecated.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
setEndpoint, setRegion
@Deprecated public AmazonCodeDeployClient()
AmazonCodeDeployClientBuilder.defaultClient()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain
@Deprecated public AmazonCodeDeployClient(ClientConfiguration clientConfiguration)
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration
- The client configuration options controlling how this client connects to CodeDeploy (ex: proxy settings,
retry counts, etc.).DefaultAWSCredentialsProviderChain
@Deprecated public AmazonCodeDeployClient(AWSCredentials awsCredentials)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
for example:
AmazonCodeDeployClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.@Deprecated public AmazonCodeDeployClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to CodeDeploy (ex: proxy settings,
retry counts, etc.).@Deprecated public AmazonCodeDeployClient(AWSCredentialsProvider awsCredentialsProvider)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.@Deprecated public AmazonCodeDeployClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to CodeDeploy (ex: proxy settings,
retry counts, etc.).@Deprecated public AmazonCodeDeployClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
and
AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to CodeDeploy (ex: proxy settings,
retry counts, etc.).requestMetricCollector
- optional request metric collectorpublic static AmazonCodeDeployClientBuilder builder()
public AddTagsToOnPremisesInstancesResult addTagsToOnPremisesInstances(AddTagsToOnPremisesInstancesRequest request)
Adds tags to on-premises instances.
addTagsToOnPremisesInstances
in interface AmazonCodeDeploy
addTagsToOnPremisesInstancesRequest
- Represents the input of, and adds tags to, an on-premises instance operation.InstanceNameRequiredException
- An on-premises instance name was not specified.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.TagRequiredException
- A tag was not specified.InvalidTagException
- The tag was specified in an invalid format.TagLimitExceededException
- The maximum allowed number of tags was exceeded.InstanceLimitExceededException
- The maximum number of allowed on-premises instances in a single call was exceeded.InstanceNotRegisteredException
- The specified on-premises instance is not registered.public BatchGetApplicationRevisionsResult batchGetApplicationRevisions(BatchGetApplicationRevisionsRequest request)
Gets information about one or more application revisions. The maximum number of application revisions that can be returned is 25.
batchGetApplicationRevisions
in interface AmazonCodeDeploy
batchGetApplicationRevisionsRequest
- Represents the input of a BatchGetApplicationRevisions
operation.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.InvalidApplicationNameException
- The application name was specified in an invalid format.RevisionRequiredException
- The revision ID was not specified.InvalidRevisionException
- The revision was specified in an invalid format.BatchLimitExceededException
- The maximum number of names or IDs allowed for this request (100) was exceeded.public BatchGetApplicationsResult batchGetApplications(BatchGetApplicationsRequest request)
Gets information about one or more applications. The maximum number of applications that can be returned is 100.
batchGetApplications
in interface AmazonCodeDeploy
batchGetApplicationsRequest
- Represents the input of a BatchGetApplications
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.BatchLimitExceededException
- The maximum number of names or IDs allowed for this request (100) was exceeded.public BatchGetApplicationsResult batchGetApplications()
AmazonCodeDeploy
batchGetApplications
in interface AmazonCodeDeploy
AmazonCodeDeploy.batchGetApplications(BatchGetApplicationsRequest)
public BatchGetDeploymentGroupsResult batchGetDeploymentGroups(BatchGetDeploymentGroupsRequest request)
Gets information about one or more deployment groups.
batchGetDeploymentGroups
in interface AmazonCodeDeploy
batchGetDeploymentGroupsRequest
- Represents the input of a BatchGetDeploymentGroups
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.DeploymentGroupNameRequiredException
- The deployment group name was not specified.InvalidDeploymentGroupNameException
- The deployment group name was specified in an invalid format.BatchLimitExceededException
- The maximum number of names or IDs allowed for this request (100) was exceeded.DeploymentConfigDoesNotExistException
- The deployment configuration does not exist with the user or Amazon Web Services account.@Deprecated public BatchGetDeploymentInstancesResult batchGetDeploymentInstances(BatchGetDeploymentInstancesRequest request)
This method works, but is deprecated. Use BatchGetDeploymentTargets
instead.
Returns an array of one or more instances associated with a deployment. This method works with EC2/On-premises
and Lambda compute platforms. The newer BatchGetDeploymentTargets
works with all compute platforms.
The maximum number of instances that can be returned is 25.
batchGetDeploymentInstances
in interface AmazonCodeDeploy
batchGetDeploymentInstancesRequest
- Represents the input of a BatchGetDeploymentInstances
operation.DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.InstanceIdRequiredException
- The instance ID was not specified.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.BatchLimitExceededException
- The maximum number of names or IDs allowed for this request (100) was exceeded.InvalidComputePlatformException
- The computePlatform is invalid. The computePlatform should be Lambda
, Server
,
or ECS
.public BatchGetDeploymentTargetsResult batchGetDeploymentTargets(BatchGetDeploymentTargetsRequest request)
Returns an array of one or more targets associated with a deployment. This method works with all compute types
and should be used instead of the deprecated BatchGetDeploymentInstances
. The maximum number of
targets that can be returned is 25.
The type of targets returned depends on the deployment's compute platform or deployment method:
EC2/On-premises: Information about Amazon EC2 instance targets.
Lambda: Information about Lambda functions targets.
Amazon ECS: Information about Amazon ECS service targets.
CloudFormation: Information about targets of blue/green deployments initiated by a CloudFormation stack update.
batchGetDeploymentTargets
in interface AmazonCodeDeploy
batchGetDeploymentTargetsRequest
- InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.DeploymentNotStartedException
- The specified deployment has not started.DeploymentTargetIdRequiredException
- A deployment target ID was not provided.InvalidDeploymentTargetIdException
- The target ID provided was not valid.DeploymentTargetDoesNotExistException
- The provided target ID does not belong to the attempted deployment.DeploymentTargetListSizeExceededException
- The maximum number of targets that can be associated with an Amazon ECS or Lambda deployment was
exceeded. The target list of both types of deployments must have exactly one item. This exception does
not apply to EC2/On-premises deployments.InstanceDoesNotExistException
- The specified instance does not exist in the deployment group.public BatchGetDeploymentsResult batchGetDeployments(BatchGetDeploymentsRequest request)
Gets information about one or more deployments. The maximum number of deployments that can be returned is 25.
batchGetDeployments
in interface AmazonCodeDeploy
batchGetDeploymentsRequest
- Represents the input of a BatchGetDeployments
operation.DeploymentIdRequiredException
- At least one deployment ID must be specified.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.BatchLimitExceededException
- The maximum number of names or IDs allowed for this request (100) was exceeded.public BatchGetDeploymentsResult batchGetDeployments()
AmazonCodeDeploy
batchGetDeployments
in interface AmazonCodeDeploy
AmazonCodeDeploy.batchGetDeployments(BatchGetDeploymentsRequest)
public BatchGetOnPremisesInstancesResult batchGetOnPremisesInstances(BatchGetOnPremisesInstancesRequest request)
Gets information about one or more on-premises instances. The maximum number of on-premises instances that can be returned is 25.
batchGetOnPremisesInstances
in interface AmazonCodeDeploy
batchGetOnPremisesInstancesRequest
- Represents the input of a BatchGetOnPremisesInstances
operation.InstanceNameRequiredException
- An on-premises instance name was not specified.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.BatchLimitExceededException
- The maximum number of names or IDs allowed for this request (100) was exceeded.public BatchGetOnPremisesInstancesResult batchGetOnPremisesInstances()
AmazonCodeDeploy
batchGetOnPremisesInstances
in interface AmazonCodeDeploy
AmazonCodeDeploy.batchGetOnPremisesInstances(BatchGetOnPremisesInstancesRequest)
public ContinueDeploymentResult continueDeployment(ContinueDeploymentRequest request)
For a blue/green deployment, starts the process of rerouting traffic from instances in the original environment to instances in the replacement environment without waiting for a specified wait time to elapse. (Traffic rerouting, which is achieved by registering instances in the replacement environment with the load balancer, can start as soon as all instances have a status of Ready.)
continueDeployment
in interface AmazonCodeDeploy
continueDeploymentRequest
- DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.DeploymentAlreadyCompletedException
- The deployment is already complete.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.DeploymentIsNotInReadyStateException
- The deployment does not have a status of Ready and can't continue yet.UnsupportedActionForDeploymentTypeException
- A call was submitted that is not supported for the specified deployment type.InvalidDeploymentWaitTypeException
- The wait type is invalid.InvalidDeploymentStatusException
- The specified deployment status doesn't exist or cannot be determined.public CreateApplicationResult createApplication(CreateApplicationRequest request)
Creates an application.
createApplication
in interface AmazonCodeDeploy
createApplicationRequest
- Represents the input of a CreateApplication
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationAlreadyExistsException
- An application with the specified name with the user or Amazon Web Services account already exists.ApplicationLimitExceededException
- More applications were attempted to be created than are allowed.InvalidComputePlatformException
- The computePlatform is invalid. The computePlatform should be Lambda
, Server
,
or ECS
.InvalidTagsToAddException
- The specified tags are not valid.public CreateDeploymentResult createDeployment(CreateDeploymentRequest request)
Deploys an application revision through the specified deployment group.
createDeployment
in interface AmazonCodeDeploy
createDeploymentRequest
- Represents the input of a CreateDeployment
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.DeploymentGroupNameRequiredException
- The deployment group name was not specified.InvalidDeploymentGroupNameException
- The deployment group name was specified in an invalid format.DeploymentGroupDoesNotExistException
- The named deployment group with the user or Amazon Web Services account does not exist.RevisionRequiredException
- The revision ID was not specified.RevisionDoesNotExistException
- The named revision does not exist with the user or Amazon Web Services account.InvalidRevisionException
- The revision was specified in an invalid format.InvalidDeploymentConfigNameException
- The deployment configuration name was specified in an invalid format.DeploymentConfigDoesNotExistException
- The deployment configuration does not exist with the user or Amazon Web Services account.DescriptionTooLongException
- The description is too long.DeploymentLimitExceededException
- The number of allowed deployments was exceeded.InvalidTargetInstancesException
- The target instance configuration is invalid. Possible causes include:
Configuration data for target instances was entered for an in-place deployment.
The limit of 10 tags for a tag type was exceeded.
The combined length of the tag names exceeded the limit.
A specified tag is not currently applied to any instances.
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.
AlarmsLimitExceededException
- The maximum number of alarms for a deployment group (10) was exceeded.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.InvalidLoadBalancerInfoException
- An invalid load balancer name, or no load balancer name, was specified.InvalidFileExistsBehaviorException
- An invalid fileExistsBehavior option was specified to determine how CodeDeploy handles files or
directories that already exist in a deployment target location, but weren't part of the previous
successful deployment. Valid values include "DISALLOW," "OVERWRITE," and "RETAIN."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.InvalidAutoScalingGroupException
- The Auto Scaling group was specified in an invalid format or does not exist.ThrottlingException
- An API function was called too frequently.InvalidUpdateOutdatedInstancesOnlyValueException
- The UpdateOutdatedInstancesOnly value is invalid. For Lambda deployments, false
is expected.
For EC2/On-premises deployments, true
or false
is expected.InvalidIgnoreApplicationStopFailuresValueException
- The IgnoreApplicationStopFailures value is invalid. For Lambda deployments, false
is
expected. For EC2/On-premises deployments, true
or false
is expected.InvalidGitHubAccountTokenException
- The GitHub token is not valid.InvalidTrafficRoutingConfigurationException
- The configuration that specifies how traffic is routed during a deployment is invalid.public CreateDeploymentConfigResult createDeploymentConfig(CreateDeploymentConfigRequest request)
Creates a deployment configuration.
createDeploymentConfig
in interface AmazonCodeDeploy
createDeploymentConfigRequest
- Represents the input of a CreateDeploymentConfig
operation.InvalidDeploymentConfigNameException
- The deployment configuration name was specified in an invalid format.DeploymentConfigNameRequiredException
- The deployment configuration name was not specified.DeploymentConfigAlreadyExistsException
- A deployment configuration with the specified name with the user or Amazon Web Services account already
exists.InvalidMinimumHealthyHostValueException
- The minimum healthy instance value was specified in an invalid format.DeploymentConfigLimitExceededException
- The deployment configurations limit was exceeded.InvalidComputePlatformException
- The computePlatform is invalid. The computePlatform should be Lambda
, Server
,
or ECS
.InvalidTrafficRoutingConfigurationException
- The configuration that specifies how traffic is routed during a deployment is invalid.InvalidZonalDeploymentConfigurationException
- The ZonalConfig
object is not valid.public CreateDeploymentGroupResult createDeploymentGroup(CreateDeploymentGroupRequest request)
Creates a deployment group to which application revisions are deployed.
createDeploymentGroup
in interface AmazonCodeDeploy
createDeploymentGroupRequest
- Represents the input of a CreateDeploymentGroup
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.DeploymentGroupNameRequiredException
- The deployment group name was not specified.InvalidDeploymentGroupNameException
- The deployment group name was specified in an invalid format.DeploymentGroupAlreadyExistsException
- A deployment group with the specified name with the user or Amazon Web Services account already exists.InvalidEC2TagException
- The tag was specified in an invalid format.InvalidTagException
- The tag was specified in an invalid format.InvalidAutoScalingGroupException
- The Auto Scaling group was specified in an invalid format or does not exist.InvalidDeploymentConfigNameException
- The deployment configuration name was specified in an invalid format.DeploymentConfigDoesNotExistException
- The deployment configuration does not exist with the user or Amazon Web Services account.RoleRequiredException
- The role ID was not specified.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.DeploymentGroupLimitExceededException
- The deployment groups limit was exceeded.LifecycleHookLimitExceededException
- The limit for lifecycle hooks was exceeded.InvalidTriggerConfigException
- The trigger was specified in an invalid format.TriggerTargetsLimitExceededException
- The maximum allowed number of triggers was exceeded.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.
AlarmsLimitExceededException
- The maximum number of alarms for a deployment group (10) was exceeded.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.InvalidLoadBalancerInfoException
- An invalid load balancer name, or no load balancer name, was specified.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."InvalidBlueGreenDeploymentConfigurationException
- The configuration for the blue/green deployment group was provided in an invalid format. For information
about deployment configuration format, see CreateDeploymentConfig.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.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.TagSetListLimitExceededException
- The number of tag groups included in the tag set list exceeded the maximum allowed limit of 3.InvalidInputException
- The input was specified in an invalid format.ThrottlingException
- An API function was called too frequently.InvalidECSServiceException
- The Amazon ECS service identifier is not valid.InvalidTargetGroupPairException
- A target group pair associated with this deployment is not valid.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.InvalidTagsToAddException
- The specified tags are not valid.InvalidTrafficRoutingConfigurationException
- The configuration that specifies how traffic is routed during a deployment is invalid.public DeleteApplicationResult deleteApplication(DeleteApplicationRequest request)
Deletes an application.
deleteApplication
in interface AmazonCodeDeploy
deleteApplicationRequest
- Represents the input of a DeleteApplication
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.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.public DeleteDeploymentConfigResult deleteDeploymentConfig(DeleteDeploymentConfigRequest request)
Deletes a deployment configuration.
A deployment configuration cannot be deleted if it is currently in use. Predefined configurations cannot be deleted.
deleteDeploymentConfig
in interface AmazonCodeDeploy
deleteDeploymentConfigRequest
- Represents the input of a DeleteDeploymentConfig
operation.InvalidDeploymentConfigNameException
- The deployment configuration name was specified in an invalid format.DeploymentConfigNameRequiredException
- The deployment configuration name was not specified.DeploymentConfigInUseException
- The deployment configuration is still in use.InvalidOperationException
- An invalid operation was detected.public DeleteDeploymentGroupResult deleteDeploymentGroup(DeleteDeploymentGroupRequest request)
Deletes a deployment group.
deleteDeploymentGroup
in interface AmazonCodeDeploy
deleteDeploymentGroupRequest
- Represents the input of a DeleteDeploymentGroup
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.DeploymentGroupNameRequiredException
- The deployment group name was not specified.InvalidDeploymentGroupNameException
- The deployment group name was specified in an invalid format.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.public DeleteGitHubAccountTokenResult deleteGitHubAccountToken(DeleteGitHubAccountTokenRequest request)
Deletes a GitHub account connection.
deleteGitHubAccountToken
in interface AmazonCodeDeploy
deleteGitHubAccountTokenRequest
- Represents the input of a DeleteGitHubAccount
operation.GitHubAccountTokenNameRequiredException
- The call is missing a required GitHub account connection name.GitHubAccountTokenDoesNotExistException
- No GitHub account connection exists with the named specified in the call.InvalidGitHubAccountTokenNameException
- The format of the specified GitHub account connection name is invalid.ResourceValidationException
- The specified resource could not be validated.OperationNotSupportedException
- The API used does not support the deployment.public DeleteResourcesByExternalIdResult deleteResourcesByExternalId(DeleteResourcesByExternalIdRequest request)
Deletes resources linked to an external ID. This action only applies if you have configured blue/green deployments through CloudFormation.
It is not necessary to call this action directly. CloudFormation calls it on your behalf when it needs to delete stack resources. This action is offered publicly in case you need to delete resources to comply with General Data Protection Regulation (GDPR) requirements.
deleteResourcesByExternalId
in interface AmazonCodeDeploy
deleteResourcesByExternalIdRequest
- public DeregisterOnPremisesInstanceResult deregisterOnPremisesInstance(DeregisterOnPremisesInstanceRequest request)
Deregisters an on-premises instance.
deregisterOnPremisesInstance
in interface AmazonCodeDeploy
deregisterOnPremisesInstanceRequest
- Represents the input of a DeregisterOnPremisesInstance
operation.InstanceNameRequiredException
- An on-premises instance name was not specified.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.public GetApplicationResult getApplication(GetApplicationRequest request)
Gets information about an application.
getApplication
in interface AmazonCodeDeploy
getApplicationRequest
- Represents the input of a GetApplication
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.public GetApplicationRevisionResult getApplicationRevision(GetApplicationRevisionRequest request)
Gets information about an application revision.
getApplicationRevision
in interface AmazonCodeDeploy
getApplicationRevisionRequest
- Represents the input of a GetApplicationRevision
operation.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.InvalidApplicationNameException
- The application name was specified in an invalid format.RevisionDoesNotExistException
- The named revision does not exist with the user or Amazon Web Services account.RevisionRequiredException
- The revision ID was not specified.InvalidRevisionException
- The revision was specified in an invalid format.public GetDeploymentResult getDeployment(GetDeploymentRequest request)
Gets information about a deployment.
The content
property of the appSpecContent
object in the returned revision is always
null. Use GetApplicationRevision
and the sha256
property of the returned
appSpecContent
object to get the content of the deployment’s AppSpec file.
getDeployment
in interface AmazonCodeDeploy
getDeploymentRequest
- Represents the input of a GetDeployment
operation.DeploymentIdRequiredException
- At least one deployment ID must be specified.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.public GetDeploymentConfigResult getDeploymentConfig(GetDeploymentConfigRequest request)
Gets information about a deployment configuration.
getDeploymentConfig
in interface AmazonCodeDeploy
getDeploymentConfigRequest
- Represents the input of a GetDeploymentConfig
operation.InvalidDeploymentConfigNameException
- The deployment configuration name was specified in an invalid format.DeploymentConfigNameRequiredException
- The deployment configuration name was not specified.DeploymentConfigDoesNotExistException
- The deployment configuration does not exist with the user or Amazon Web Services account.InvalidComputePlatformException
- The computePlatform is invalid. The computePlatform should be Lambda
, Server
,
or ECS
.public GetDeploymentGroupResult getDeploymentGroup(GetDeploymentGroupRequest request)
Gets information about a deployment group.
getDeploymentGroup
in interface AmazonCodeDeploy
getDeploymentGroupRequest
- Represents the input of a GetDeploymentGroup
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.DeploymentGroupNameRequiredException
- The deployment group name was not specified.InvalidDeploymentGroupNameException
- The deployment group name was specified in an invalid format.DeploymentGroupDoesNotExistException
- The named deployment group with the user or Amazon Web Services account does not exist.DeploymentConfigDoesNotExistException
- The deployment configuration does not exist with the user or Amazon Web Services account.@Deprecated public GetDeploymentInstanceResult getDeploymentInstance(GetDeploymentInstanceRequest request)
Gets information about an instance as part of a deployment.
getDeploymentInstance
in interface AmazonCodeDeploy
getDeploymentInstanceRequest
- Represents the input of a GetDeploymentInstance
operation.DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.InstanceIdRequiredException
- The instance ID was not specified.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.InstanceDoesNotExistException
- The specified instance does not exist in the deployment group.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.InvalidComputePlatformException
- The computePlatform is invalid. The computePlatform should be Lambda
, Server
,
or ECS
.public GetDeploymentTargetResult getDeploymentTarget(GetDeploymentTargetRequest request)
Returns information about a deployment target.
getDeploymentTarget
in interface AmazonCodeDeploy
getDeploymentTargetRequest
- InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.DeploymentNotStartedException
- The specified deployment has not started.DeploymentTargetIdRequiredException
- A deployment target ID was not provided.InvalidDeploymentTargetIdException
- The target ID provided was not valid.DeploymentTargetDoesNotExistException
- The provided target ID does not belong to the attempted deployment.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.public GetOnPremisesInstanceResult getOnPremisesInstance(GetOnPremisesInstanceRequest request)
Gets information about an on-premises instance.
getOnPremisesInstance
in interface AmazonCodeDeploy
getOnPremisesInstanceRequest
- Represents the input of a GetOnPremisesInstance
operation.InstanceNameRequiredException
- An on-premises instance name was not specified.InstanceNotRegisteredException
- The specified on-premises instance is not registered.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.public ListApplicationRevisionsResult listApplicationRevisions(ListApplicationRevisionsRequest request)
Lists information about revisions for an application.
listApplicationRevisions
in interface AmazonCodeDeploy
listApplicationRevisionsRequest
- Represents the input of a ListApplicationRevisions
operation.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.InvalidApplicationNameException
- The application name was specified in an invalid format.InvalidSortByException
- The column name to sort by is either not present or was specified in an invalid format.InvalidSortOrderException
- The sort order was specified in an invalid format.InvalidBucketNameFilterException
- The bucket name either doesn't exist or was specified in an invalid format.InvalidKeyPrefixFilterException
- The specified key prefix filter was specified in an invalid format.BucketNameFilterRequiredException
- A bucket name is required, but was not provided.InvalidDeployedStateFilterException
- The deployed state filter was specified in an invalid format.InvalidNextTokenException
- The next token was specified in an invalid format.public ListApplicationsResult listApplications(ListApplicationsRequest request)
Lists the applications registered with the user or Amazon Web Services account.
listApplications
in interface AmazonCodeDeploy
listApplicationsRequest
- Represents the input of a ListApplications
operation.InvalidNextTokenException
- The next token was specified in an invalid format.public ListApplicationsResult listApplications()
AmazonCodeDeploy
listApplications
in interface AmazonCodeDeploy
AmazonCodeDeploy.listApplications(ListApplicationsRequest)
public ListDeploymentConfigsResult listDeploymentConfigs(ListDeploymentConfigsRequest request)
Lists the deployment configurations with the user or Amazon Web Services account.
listDeploymentConfigs
in interface AmazonCodeDeploy
listDeploymentConfigsRequest
- Represents the input of a ListDeploymentConfigs
operation.InvalidNextTokenException
- The next token was specified in an invalid format.public ListDeploymentConfigsResult listDeploymentConfigs()
AmazonCodeDeploy
listDeploymentConfigs
in interface AmazonCodeDeploy
AmazonCodeDeploy.listDeploymentConfigs(ListDeploymentConfigsRequest)
public ListDeploymentGroupsResult listDeploymentGroups(ListDeploymentGroupsRequest request)
Lists the deployment groups for an application registered with the Amazon Web Services user or Amazon Web Services account.
listDeploymentGroups
in interface AmazonCodeDeploy
listDeploymentGroupsRequest
- Represents the input of a ListDeploymentGroups
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.InvalidNextTokenException
- The next token was specified in an invalid format.@Deprecated public ListDeploymentInstancesResult listDeploymentInstances(ListDeploymentInstancesRequest request)
The newer BatchGetDeploymentTargets
should be used instead because it works with all compute types.
ListDeploymentInstances
throws an exception if it is used with a compute platform other than
EC2/On-premises or Lambda.
Lists the instance for a deployment associated with the user or Amazon Web Services account.
listDeploymentInstances
in interface AmazonCodeDeploy
listDeploymentInstancesRequest
- Represents the input of a ListDeploymentInstances
operation.DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.DeploymentNotStartedException
- The specified deployment has not started.InvalidNextTokenException
- The next token was specified in an invalid format.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.InvalidInstanceStatusException
- The specified instance status does not exist.InvalidInstanceTypeException
- An invalid instance type was specified for instances in a blue/green deployment. Valid values include
"Blue" for an original environment and "Green" for a replacement environment.InvalidDeploymentInstanceTypeException
- An instance type was specified for an in-place deployment. Instance types are supported for blue/green
deployments only.InvalidTargetFilterNameException
- The target filter name is invalid.InvalidComputePlatformException
- The computePlatform is invalid. The computePlatform should be Lambda
, Server
,
or ECS
.public ListDeploymentTargetsResult listDeploymentTargets(ListDeploymentTargetsRequest request)
Returns an array of target IDs that are associated a deployment.
listDeploymentTargets
in interface AmazonCodeDeploy
listDeploymentTargetsRequest
- DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.DeploymentNotStartedException
- The specified deployment has not started.InvalidNextTokenException
- The next token was specified in an invalid format.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.InvalidInstanceStatusException
- The specified instance status does not exist.InvalidInstanceTypeException
- An invalid instance type was specified for instances in a blue/green deployment. Valid values include
"Blue" for an original environment and "Green" for a replacement environment.InvalidDeploymentInstanceTypeException
- An instance type was specified for an in-place deployment. Instance types are supported for blue/green
deployments only.InvalidTargetFilterNameException
- The target filter name is invalid.public ListDeploymentsResult listDeployments(ListDeploymentsRequest request)
Lists the deployments in a deployment group for an application registered with the user or Amazon Web Services account.
listDeployments
in interface AmazonCodeDeploy
listDeploymentsRequest
- Represents the input of a ListDeployments
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.InvalidDeploymentGroupNameException
- The deployment group name was specified in an invalid format.DeploymentGroupDoesNotExistException
- The named deployment group with the user or Amazon Web Services account does not exist.DeploymentGroupNameRequiredException
- The deployment group name was not specified.InvalidTimeRangeException
- The specified time range was specified in an invalid format.InvalidDeploymentStatusException
- The specified deployment status doesn't exist or cannot be determined.InvalidNextTokenException
- The next token was specified in an invalid format.InvalidExternalIdException
- The external ID was specified in an invalid format.InvalidInputException
- The input was specified in an invalid format.public ListDeploymentsResult listDeployments()
AmazonCodeDeploy
listDeployments
in interface AmazonCodeDeploy
AmazonCodeDeploy.listDeployments(ListDeploymentsRequest)
public ListGitHubAccountTokenNamesResult listGitHubAccountTokenNames(ListGitHubAccountTokenNamesRequest request)
Lists the names of stored connections to GitHub accounts.
listGitHubAccountTokenNames
in interface AmazonCodeDeploy
listGitHubAccountTokenNamesRequest
- Represents the input of a ListGitHubAccountTokenNames
operation.InvalidNextTokenException
- The next token was specified in an invalid format.ResourceValidationException
- The specified resource could not be validated.OperationNotSupportedException
- The API used does not support the deployment.public ListOnPremisesInstancesResult listOnPremisesInstances(ListOnPremisesInstancesRequest request)
Gets a list of names for one or more on-premises instances.
Unless otherwise specified, both registered and deregistered on-premises instance names are listed. To list only registered or deregistered on-premises instance names, use the registration status parameter.
listOnPremisesInstances
in interface AmazonCodeDeploy
listOnPremisesInstancesRequest
- Represents the input of a ListOnPremisesInstances
operation.InvalidRegistrationStatusException
- The registration status was specified in an invalid format.InvalidTagFilterException
- The tag filter was specified in an invalid format.InvalidNextTokenException
- The next token was specified in an invalid format.public ListOnPremisesInstancesResult listOnPremisesInstances()
AmazonCodeDeploy
listOnPremisesInstances
in interface AmazonCodeDeploy
AmazonCodeDeploy.listOnPremisesInstances(ListOnPremisesInstancesRequest)
public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Returns a list of tags for the resource identified by a specified Amazon Resource Name (ARN). Tags are used to organize and categorize your CodeDeploy resources.
listTagsForResource
in interface AmazonCodeDeploy
listTagsForResourceRequest
- ArnNotSupportedException
- The specified ARN is not supported. For example, it might be an ARN for a resource that is not expected.InvalidArnException
- The specified ARN is not in a valid format.ResourceArnRequiredException
- The ARN of a resource is required, but was not found.public PutLifecycleEventHookExecutionStatusResult putLifecycleEventHookExecutionStatus(PutLifecycleEventHookExecutionStatusRequest request)
Sets the result of a Lambda validation function. The function validates lifecycle hooks during a deployment that
uses the Lambda or Amazon ECS compute platform. For Lambda deployments, the available lifecycle hooks are
BeforeAllowTraffic
and AfterAllowTraffic
. For Amazon ECS deployments, the available
lifecycle hooks are BeforeInstall
, AfterInstall
, AfterAllowTestTraffic
,
BeforeAllowTraffic
, and AfterAllowTraffic
. Lambda validation functions return
Succeeded
or Failed
. For more information, see AppSpec 'hooks' Section for an Lambda Deployment and AppSpec 'hooks' Section for an Amazon ECS Deployment.
putLifecycleEventHookExecutionStatus
in interface AmazonCodeDeploy
putLifecycleEventHookExecutionStatusRequest
- InvalidLifecycleEventHookExecutionStatusException
- The result of a Lambda validation function that verifies a lifecycle event is invalid. It should return
Succeeded
or Failed
.InvalidLifecycleEventHookExecutionIdException
- A lifecycle event hook is invalid. Review the hooks
section in your AppSpec file to ensure
the lifecycle events and hooks
functions are valid.LifecycleEventAlreadyCompletedException
- An attempt to return the status of an already completed lifecycle event occurred.DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.UnsupportedActionForDeploymentTypeException
- A call was submitted that is not supported for the specified deployment type.public RegisterApplicationRevisionResult registerApplicationRevision(RegisterApplicationRevisionRequest request)
Registers with CodeDeploy a revision for the specified application.
registerApplicationRevision
in interface AmazonCodeDeploy
registerApplicationRevisionRequest
- Represents the input of a RegisterApplicationRevision operation.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.InvalidApplicationNameException
- The application name was specified in an invalid format.DescriptionTooLongException
- The description is too long.RevisionRequiredException
- The revision ID was not specified.InvalidRevisionException
- The revision was specified in an invalid format.public RegisterOnPremisesInstanceResult registerOnPremisesInstance(RegisterOnPremisesInstanceRequest request)
Registers an on-premises instance.
Only one IAM ARN (an IAM session ARN or IAM user ARN) is supported in the request. You cannot use both.
registerOnPremisesInstance
in interface AmazonCodeDeploy
registerOnPremisesInstanceRequest
- Represents the input of the register on-premises instance operation.InstanceNameAlreadyRegisteredException
- The specified on-premises instance name is already registered.IamArnRequiredException
- No IAM ARN was included in the request. You must use an IAM session ARN or user ARN in the request.IamSessionArnAlreadyRegisteredException
- The request included an IAM session ARN that has already been used to register a different instance.IamUserArnAlreadyRegisteredException
- The specified user ARN is already registered with an on-premises instance.InstanceNameRequiredException
- An on-premises instance name was not specified.IamUserArnRequiredException
- An user ARN was not specified.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.InvalidIamSessionArnException
- The IAM session ARN was specified in an invalid format.InvalidIamUserArnException
- The user ARN was specified in an invalid format.MultipleIamArnsProvidedException
- Both an user ARN and an IAM session ARN were included in the request. Use only one ARN type.public RemoveTagsFromOnPremisesInstancesResult removeTagsFromOnPremisesInstances(RemoveTagsFromOnPremisesInstancesRequest request)
Removes one or more tags from one or more on-premises instances.
removeTagsFromOnPremisesInstances
in interface AmazonCodeDeploy
removeTagsFromOnPremisesInstancesRequest
- Represents the input of a RemoveTagsFromOnPremisesInstances
operation.InstanceNameRequiredException
- An on-premises instance name was not specified.InvalidInstanceNameException
- The on-premises instance name was specified in an invalid format.TagRequiredException
- A tag was not specified.InvalidTagException
- The tag was specified in an invalid format.TagLimitExceededException
- The maximum allowed number of tags was exceeded.InstanceLimitExceededException
- The maximum number of allowed on-premises instances in a single call was exceeded.InstanceNotRegisteredException
- The specified on-premises instance is not registered.@Deprecated public SkipWaitTimeForInstanceTerminationResult skipWaitTimeForInstanceTermination(SkipWaitTimeForInstanceTerminationRequest request)
In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after the traffic routing is complete.
skipWaitTimeForInstanceTermination
in interface AmazonCodeDeploy
skipWaitTimeForInstanceTerminationRequest
- DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.DeploymentAlreadyCompletedException
- The deployment is already complete.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.DeploymentNotStartedException
- The specified deployment has not started.UnsupportedActionForDeploymentTypeException
- A call was submitted that is not supported for the specified deployment type.public StopDeploymentResult stopDeployment(StopDeploymentRequest request)
Attempts to stop an ongoing deployment.
stopDeployment
in interface AmazonCodeDeploy
stopDeploymentRequest
- Represents the input of a StopDeployment
operation.DeploymentIdRequiredException
- At least one deployment ID must be specified.DeploymentDoesNotExistException
- The deployment with the user or Amazon Web Services account does not exist.DeploymentGroupDoesNotExistException
- The named deployment group with the user or Amazon Web Services account does not exist.DeploymentAlreadyCompletedException
- The deployment is already complete.InvalidDeploymentIdException
- At least one of the deployment IDs was specified in an invalid format.UnsupportedActionForDeploymentTypeException
- A call was submitted that is not supported for the specified deployment type.public TagResourceResult tagResource(TagResourceRequest request)
Associates the list of tags in the input Tags
parameter with the resource identified by the
ResourceArn
input parameter.
tagResource
in interface AmazonCodeDeploy
tagResourceRequest
- ResourceArnRequiredException
- The ARN of a resource is required, but was not found.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.DeploymentGroupDoesNotExistException
- The named deployment group with the user or Amazon Web Services account does not exist.DeploymentConfigDoesNotExistException
- The deployment configuration does not exist with the user or Amazon Web Services account.TagRequiredException
- A tag was not specified.InvalidTagsToAddException
- The specified tags are not valid.ArnNotSupportedException
- The specified ARN is not supported. For example, it might be an ARN for a resource that is not expected.InvalidArnException
- The specified ARN is not in a valid format.public UntagResourceResult untagResource(UntagResourceRequest request)
Disassociates a resource from a list of tags. The resource is identified by the ResourceArn
input
parameter. The tags are identified by the list of keys in the TagKeys
input parameter.
untagResource
in interface AmazonCodeDeploy
untagResourceRequest
- ResourceArnRequiredException
- The ARN of a resource is required, but was not found.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.DeploymentGroupDoesNotExistException
- The named deployment group with the user or Amazon Web Services account does not exist.DeploymentConfigDoesNotExistException
- The deployment configuration does not exist with the user or Amazon Web Services account.TagRequiredException
- A tag was not specified.InvalidTagsToAddException
- The specified tags are not valid.ArnNotSupportedException
- The specified ARN is not supported. For example, it might be an ARN for a resource that is not expected.InvalidArnException
- The specified ARN is not in a valid format.public UpdateApplicationResult updateApplication(UpdateApplicationRequest request)
Changes the name of an application.
updateApplication
in interface AmazonCodeDeploy
updateApplicationRequest
- Represents the input of an UpdateApplication
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationAlreadyExistsException
- An application with the specified name with the user or Amazon Web Services account already exists.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.public UpdateApplicationResult updateApplication()
AmazonCodeDeploy
updateApplication
in interface AmazonCodeDeploy
AmazonCodeDeploy.updateApplication(UpdateApplicationRequest)
public UpdateDeploymentGroupResult updateDeploymentGroup(UpdateDeploymentGroupRequest request)
Changes information about a deployment group.
updateDeploymentGroup
in interface AmazonCodeDeploy
updateDeploymentGroupRequest
- Represents the input of an UpdateDeploymentGroup
operation.ApplicationNameRequiredException
- The minimum number of required application names was not specified.InvalidApplicationNameException
- The application name was specified in an invalid format.ApplicationDoesNotExistException
- The application does not exist with the user or Amazon Web Services account.InvalidDeploymentGroupNameException
- The deployment group name was specified in an invalid format.DeploymentGroupAlreadyExistsException
- A deployment group with the specified name with the user or Amazon Web Services account already exists.DeploymentGroupNameRequiredException
- The deployment group name was not specified.DeploymentGroupDoesNotExistException
- The named deployment group with the user or Amazon Web Services account does not exist.InvalidEC2TagException
- The tag was specified in an invalid format.InvalidTagException
- The tag was specified in an invalid format.InvalidAutoScalingGroupException
- The Auto Scaling group was specified in an invalid format or does not exist.InvalidDeploymentConfigNameException
- The deployment configuration name was specified in an invalid format.DeploymentConfigDoesNotExistException
- The deployment configuration does not exist with the user or Amazon Web Services account.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.LifecycleHookLimitExceededException
- The limit for lifecycle hooks was exceeded.InvalidTriggerConfigException
- The trigger was specified in an invalid format.TriggerTargetsLimitExceededException
- The maximum allowed number of triggers was exceeded.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.
AlarmsLimitExceededException
- The maximum number of alarms for a deployment group (10) was exceeded.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.InvalidLoadBalancerInfoException
- An invalid load balancer name, or no load balancer name, was specified.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."InvalidBlueGreenDeploymentConfigurationException
- The configuration for the blue/green deployment group was provided in an invalid format. For information
about deployment configuration format, see CreateDeploymentConfig.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.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.TagSetListLimitExceededException
- The number of tag groups included in the tag set list exceeded the maximum allowed limit of 3.InvalidInputException
- The input was specified in an invalid format.ThrottlingException
- An API function was called too frequently.InvalidECSServiceException
- The Amazon ECS service identifier is not valid.InvalidTargetGroupPairException
- A target group pair associated with this deployment is not valid.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.InvalidTrafficRoutingConfigurationException
- The configuration that specifies how traffic is routed during a deployment is invalid.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata
in interface AmazonCodeDeploy
request
- The originally executed requestpublic AmazonCodeDeployWaiters waiters()
waiters
in interface AmazonCodeDeploy
public void shutdown()
AmazonWebServiceClient
shutdown
in interface AmazonCodeDeploy
shutdown
in class AmazonWebServiceClient