@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonCodeDeployClient extends AmazonWebServiceClient implements AmazonCodeDeploy
Overview
This reference guide provides descriptions of the AWS CodeDeploy APIs. For more information about AWS CodeDeploy, see the AWS CodeDeploy User Guide.
Using the APIs
You can use the AWS CodeDeploy APIs to work with the following:
Applications are unique identifiers used by AWS CodeDeploy to ensure the correct combinations of revisions, deployment configurations, and deployment groups are being referenced during deployments.
You can use the AWS CodeDeploy APIs to create, delete, get, list, and update applications.
Deployment configurations are sets of deployment rules and success and failure conditions used by AWS CodeDeploy during deployments.
You can use the AWS CodeDeploy APIs to create, delete, get, and list deployment configurations.
Deployment groups are groups of instances to which application revisions can be deployed.
You can use the AWS CodeDeploy APIs to create, delete, get, list, and update deployment groups.
Instances represent Amazon EC2 instances to which application revisions are deployed. Instances are identified by their Amazon EC2 tags or Auto Scaling group names. Instances belong to deployment groups.
You can use the AWS CodeDeploy APIs to get and list instance.
Deployments represent the process of deploying revisions to instances.
You can use the AWS CodeDeploy APIs to create, get, list, and stop deployments.
Application revisions are archive files stored in Amazon S3 buckets or GitHub repositories. These revisions contain source content (such as source code, web pages, executable files, and deployment scripts) along with an application specification (AppSpec) file. (The AppSpec file is unique to AWS CodeDeploy; it defines the deployment actions you want AWS CodeDeploy to execute.) For application revisions stored in Amazon S3 buckets, an application revision is uniquely identified by its Amazon S3 object key and its ETag, version, or both. For application revisions stored in GitHub repositories, an application revision is uniquely identified by its repository name and commit ID. Application revisions are deployed through deployment groups.
You can use the AWS CodeDeploy APIs to get, list, and register application revisions.
LOGGING_AWS_REQUEST_METRICENDPOINT_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.
|
| Modifier and Type | Method and Description |
|---|---|
AddTagsToOnPremisesInstancesResult |
addTagsToOnPremisesInstances(AddTagsToOnPremisesInstancesRequest request)
Adds tags to on-premises instances.
|
BatchGetApplicationRevisionsResult |
batchGetApplicationRevisions(BatchGetApplicationRevisionsRequest request)
Gets information about one or more application revisions.
|
BatchGetApplicationsResult |
batchGetApplications()
Simplified method form for invoking the BatchGetApplications operation.
|
BatchGetApplicationsResult |
batchGetApplications(BatchGetApplicationsRequest request)
Gets information about one or more applications.
|
BatchGetDeploymentGroupsResult |
batchGetDeploymentGroups(BatchGetDeploymentGroupsRequest request)
Gets information about one or more deployment groups.
|
BatchGetDeploymentInstancesResult |
batchGetDeploymentInstances(BatchGetDeploymentInstancesRequest request)
Gets information about one or more instance that are part of a deployment group.
|
BatchGetDeploymentsResult |
batchGetDeployments()
Simplified method form for invoking the BatchGetDeployments operation.
|
BatchGetDeploymentsResult |
batchGetDeployments(BatchGetDeploymentsRequest request)
Gets information about one or more deployments.
|
BatchGetOnPremisesInstancesResult |
batchGetOnPremisesInstances()
Simplified method form for invoking the BatchGetOnPremisesInstances operation.
|
BatchGetOnPremisesInstancesResult |
batchGetOnPremisesInstances(BatchGetOnPremisesInstancesRequest request)
Gets information about one or more on-premises instances.
|
static AmazonCodeDeployClientBuilder |
builder() |
ContinueDeploymentResult |
continueDeployment(ContinueDeploymentRequest request)
Starts the process of rerouting traffic from instances in the original environment to instances in thereplacement
environment without waiting for a specified wait time to elapse.
|
CreateApplicationResult |
createApplication(CreateApplicationRequest request)
Creates an application.
|
CreateDeploymentResult |
createDeployment(CreateDeploymentRequest request)
Deploys an application revision through the specified deployment group.
|
CreateDeploymentConfigResult |
createDeploymentConfig(CreateDeploymentConfigRequest request)
Creates a deployment configuration.
|
CreateDeploymentGroupResult |
createDeploymentGroup(CreateDeploymentGroupRequest request)
Creates a deployment group to which application revisions will be deployed.
|
DeleteApplicationResult |
deleteApplication(DeleteApplicationRequest request)
Deletes an application.
|
DeleteDeploymentConfigResult |
deleteDeploymentConfig(DeleteDeploymentConfigRequest request)
Deletes a deployment configuration.
|
DeleteDeploymentGroupResult |
deleteDeploymentGroup(DeleteDeploymentGroupRequest request)
Deletes a deployment group.
|
DeregisterOnPremisesInstanceResult |
deregisterOnPremisesInstance(DeregisterOnPremisesInstanceRequest request)
Deregisters an on-premises instance.
|
GetApplicationResult |
getApplication(GetApplicationRequest request)
Gets information about an application.
|
GetApplicationRevisionResult |
getApplicationRevision(GetApplicationRevisionRequest request)
Gets information about an application revision.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues
where a service isn't acting as expected.
|
GetDeploymentResult |
getDeployment(GetDeploymentRequest request)
Gets information about a deployment.
|
GetDeploymentConfigResult |
getDeploymentConfig(GetDeploymentConfigRequest request)
Gets information about a deployment configuration.
|
GetDeploymentGroupResult |
getDeploymentGroup(GetDeploymentGroupRequest request)
Gets information about a deployment group.
|
GetDeploymentInstanceResult |
getDeploymentInstance(GetDeploymentInstanceRequest request)
Gets information about an instance as part of a deployment.
|
GetOnPremisesInstanceResult |
getOnPremisesInstance(GetOnPremisesInstanceRequest request)
Gets information about an on-premises instance.
|
ListApplicationRevisionsResult |
listApplicationRevisions(ListApplicationRevisionsRequest request)
Lists information about revisions for an application.
|
ListApplicationsResult |
listApplications()
Simplified method form for invoking the ListApplications operation.
|
ListApplicationsResult |
listApplications(ListApplicationsRequest request)
Lists the applications registered with the applicable IAM user or AWS account.
|
ListDeploymentConfigsResult |
listDeploymentConfigs()
Simplified method form for invoking the ListDeploymentConfigs operation.
|
ListDeploymentConfigsResult |
listDeploymentConfigs(ListDeploymentConfigsRequest request)
Lists the deployment configurations with the applicable IAM user or AWS account.
|
ListDeploymentGroupsResult |
listDeploymentGroups(ListDeploymentGroupsRequest request)
Lists the deployment groups for an application registered with the applicable IAM user or AWS account.
|
ListDeploymentInstancesResult |
listDeploymentInstances(ListDeploymentInstancesRequest request)
Lists the instance for a deployment associated with the applicable IAM user or AWS account.
|
ListDeploymentsResult |
listDeployments()
Simplified method form for invoking the ListDeployments operation.
|
ListDeploymentsResult |
listDeployments(ListDeploymentsRequest request)
Lists the deployments in a deployment group for an application registered with the applicable IAM user or AWS
account.
|
ListOnPremisesInstancesResult |
listOnPremisesInstances()
Simplified method form for invoking the ListOnPremisesInstances operation.
|
ListOnPremisesInstancesResult |
listOnPremisesInstances(ListOnPremisesInstancesRequest request)
Gets a list of names for one or more on-premises instances.
|
RegisterApplicationRevisionResult |
registerApplicationRevision(RegisterApplicationRevisionRequest request)
Registers with AWS CodeDeploy a revision for the specified application.
|
RegisterOnPremisesInstanceResult |
registerOnPremisesInstance(RegisterOnPremisesInstanceRequest request)
Registers an on-premises instance.
|
RemoveTagsFromOnPremisesInstancesResult |
removeTagsFromOnPremisesInstances(RemoveTagsFromOnPremisesInstancesRequest request)
Removes one or more tags from one or more on-premises instances.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
SkipWaitTimeForInstanceTerminationResult |
skipWaitTimeForInstanceTermination(SkipWaitTimeForInstanceTerminationRequest request)
In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after
the traffic routing is completed.
|
StopDeploymentResult |
stopDeployment(StopDeploymentRequest request)
Attempts to stop an ongoing deployment.
|
UpdateApplicationResult |
updateApplication()
Simplified method form for invoking the UpdateApplication operation.
|
UpdateApplicationResult |
updateApplication(UpdateApplicationRequest request)
Changes the name of an application.
|
UpdateDeploymentGroupResult |
updateDeploymentGroup(UpdateDeploymentGroupRequest request)
Changes information about a deployment group.
|
AmazonCodeDeployWaiters |
waiters() |
addRequestHandler, addRequestHandler, configureRegion, getEndpointPrefix, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetequals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitsetEndpoint, 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 AmazonCodeDeployaddTagsToOnPremisesInstancesRequest - Represents the input of, and adds tags to, an on-premises instance operation.InstanceNameRequiredException - An on-premises instance name was not specified.TagRequiredException - A tag was not specified.InvalidTagException - The specified 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.
batchGetApplicationRevisions in interface AmazonCodeDeploybatchGetApplicationRevisionsRequest - Represents the input of a batch get application revisions operation.ApplicationDoesNotExistException - The application does not exist with the applicable IAM user or AWS 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.
batchGetApplications in interface AmazonCodeDeploybatchGetApplicationsRequest - Represents the input of a batch get applications 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 applicable IAM user or AWS account.BatchLimitExceededException - The maximum number of names or IDs allowed for this request (100) was exceeded.public BatchGetApplicationsResult batchGetApplications()
AmazonCodeDeploybatchGetApplications in interface AmazonCodeDeployAmazonCodeDeploy.batchGetApplications(BatchGetApplicationsRequest)public BatchGetDeploymentGroupsResult batchGetDeploymentGroups(BatchGetDeploymentGroupsRequest request)
Gets information about one or more deployment groups.
batchGetDeploymentGroups in interface AmazonCodeDeploybatchGetDeploymentGroupsRequest - Represents the input of a batch get deployment groups 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 applicable IAM user or AWS 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.public BatchGetDeploymentInstancesResult batchGetDeploymentInstances(BatchGetDeploymentInstancesRequest request)
Gets information about one or more instance that are part of a deployment group.
batchGetDeploymentInstances in interface AmazonCodeDeploybatchGetDeploymentInstancesRequest - Represents the input of a batch get deployment instances operation.DeploymentIdRequiredException - At least one deployment ID must be specified.DeploymentDoesNotExistException - The deployment does not exist with the applicable IAM user or AWS account.InstanceIdRequiredException - The instance ID was not specified.InvalidDeploymentIdException - At least one of the deployment IDs was specified in an invalid format.InvalidInstanceNameException - The specified 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 BatchGetDeploymentsResult batchGetDeployments(BatchGetDeploymentsRequest request)
Gets information about one or more deployments.
batchGetDeployments in interface AmazonCodeDeploybatchGetDeploymentsRequest - Represents the input of a batch get deployments 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()
AmazonCodeDeploybatchGetDeployments in interface AmazonCodeDeployAmazonCodeDeploy.batchGetDeployments(BatchGetDeploymentsRequest)public BatchGetOnPremisesInstancesResult batchGetOnPremisesInstances(BatchGetOnPremisesInstancesRequest request)
Gets information about one or more on-premises instances.
batchGetOnPremisesInstances in interface AmazonCodeDeploybatchGetOnPremisesInstancesRequest - Represents the input of a batch get on-premises instances operation.InstanceNameRequiredException - An on-premises instance name was not specified.InvalidInstanceNameException - The specified 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()
AmazonCodeDeploybatchGetOnPremisesInstances in interface AmazonCodeDeployAmazonCodeDeploy.batchGetOnPremisesInstances(BatchGetOnPremisesInstancesRequest)public ContinueDeploymentResult continueDeployment(ContinueDeploymentRequest request)
Starts the process of rerouting traffic from instances in the original environment to instances in thereplacement 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 AmazonCodeDeploycontinueDeploymentRequest - DeploymentIdRequiredException - At least one deployment ID must be specified.DeploymentDoesNotExistException - The deployment does not exist with the applicable IAM user or AWS account.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.public CreateApplicationResult createApplication(CreateApplicationRequest request)
Creates an application.
createApplication in interface AmazonCodeDeploycreateApplicationRequest - Represents the input of a create application 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 already exists with the applicable IAM user or AWS account.ApplicationLimitExceededException - More applications were attempted to be created than are allowed.public CreateDeploymentResult createDeployment(CreateDeploymentRequest request)
Deploys an application revision through the specified deployment group.
createDeployment in interface AmazonCodeDeploycreateDeploymentRequest - Represents the input of a create deployment 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 applicable IAM user or AWS 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 does not exist with the applicable IAM user or AWS account.RevisionRequiredException - The revision ID was not specified.RevisionDoesNotExistException - The named revision does not exist with the applicable IAM user or AWS 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 applicable IAM user or AWS 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.
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.public CreateDeploymentConfigResult createDeploymentConfig(CreateDeploymentConfigRequest request)
Creates a deployment configuration.
createDeploymentConfig in interface AmazonCodeDeploycreateDeploymentConfigRequest - Represents the input of a create deployment configuration 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 already exists with the applicable IAM user or AWS
account.InvalidMinimumHealthyHostValueException - The minimum healthy instance value was specified in an invalid format.DeploymentConfigLimitExceededException - The deployment configurations limit was exceeded.public CreateDeploymentGroupResult createDeploymentGroup(CreateDeploymentGroupRequest request)
Creates a deployment group to which application revisions will be deployed.
createDeploymentGroup in interface AmazonCodeDeploycreateDeploymentGroupRequest - Represents the input of a create deployment group 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 applicable IAM user or AWS 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 already exists with the applicable IAM user or AWS account.InvalidEC2TagException - The tag was specified in an invalid format.InvalidTagException - The specified 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 applicable IAM user or AWS 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 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 255 character limit.
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 for blue/green deployments 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.public DeleteApplicationResult deleteApplication(DeleteApplicationRequest request)
Deletes an application.
deleteApplication in interface AmazonCodeDeploydeleteApplicationRequest - Represents the input of a delete application operation.ApplicationNameRequiredException - The minimum number of required application names was not specified.InvalidApplicationNameException - The application name was specified in an invalid format.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 AmazonCodeDeploydeleteDeploymentConfigRequest - Represents the input of a delete deployment configuration 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 AmazonCodeDeploydeleteDeploymentGroupRequest - Represents the input of a delete deployment group 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 Auto Scaling.public DeregisterOnPremisesInstanceResult deregisterOnPremisesInstance(DeregisterOnPremisesInstanceRequest request)
Deregisters an on-premises instance.
deregisterOnPremisesInstance in interface AmazonCodeDeployderegisterOnPremisesInstanceRequest - Represents the input of a deregister on-premises instance operation.InstanceNameRequiredException - An on-premises instance name was not specified.InvalidInstanceNameException - The specified on-premises instance name was specified in an invalid format.public GetApplicationResult getApplication(GetApplicationRequest request)
Gets information about an application.
getApplication in interface AmazonCodeDeploygetApplicationRequest - Represents the input of a get application 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 applicable IAM user or AWS account.public GetApplicationRevisionResult getApplicationRevision(GetApplicationRevisionRequest request)
Gets information about an application revision.
getApplicationRevision in interface AmazonCodeDeploygetApplicationRevisionRequest - Represents the input of a get application revision operation.ApplicationDoesNotExistException - The application does not exist with the applicable IAM user or AWS 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 applicable IAM user or AWS 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.
getDeployment in interface AmazonCodeDeploygetDeploymentRequest - Represents the input of a get deployment 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 does not exist with the applicable IAM user or AWS account.public GetDeploymentConfigResult getDeploymentConfig(GetDeploymentConfigRequest request)
Gets information about a deployment configuration.
getDeploymentConfig in interface AmazonCodeDeploygetDeploymentConfigRequest - Represents the input of a get deployment configuration 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 applicable IAM user or AWS account.public GetDeploymentGroupResult getDeploymentGroup(GetDeploymentGroupRequest request)
Gets information about a deployment group.
getDeploymentGroup in interface AmazonCodeDeploygetDeploymentGroupRequest - Represents the input of a get deployment group 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 applicable IAM user or AWS 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 does not exist with the applicable IAM user or AWS account.public GetDeploymentInstanceResult getDeploymentInstance(GetDeploymentInstanceRequest request)
Gets information about an instance as part of a deployment.
getDeploymentInstance in interface AmazonCodeDeploygetDeploymentInstanceRequest - Represents the input of a get deployment instance operation.DeploymentIdRequiredException - At least one deployment ID must be specified.DeploymentDoesNotExistException - The deployment does not exist with the applicable IAM user or AWS account.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 specified 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 AmazonCodeDeploygetOnPremisesInstanceRequest - Represents the input of a get on-premises instance operation.InstanceNameRequiredException - An on-premises instance name was not specified.InstanceNotRegisteredException - The specified on-premises instance is not registered.InvalidInstanceNameException - The specified 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 AmazonCodeDeploylistApplicationRevisionsRequest - Represents the input of a list application revisions operation.ApplicationDoesNotExistException - The application does not exist with the applicable IAM user or AWS 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 applicable IAM user or AWS account.
listApplications in interface AmazonCodeDeploylistApplicationsRequest - Represents the input of a list applications operation.InvalidNextTokenException - The next token was specified in an invalid format.public ListApplicationsResult listApplications()
AmazonCodeDeploylistApplications in interface AmazonCodeDeployAmazonCodeDeploy.listApplications(ListApplicationsRequest)public ListDeploymentConfigsResult listDeploymentConfigs(ListDeploymentConfigsRequest request)
Lists the deployment configurations with the applicable IAM user or AWS account.
listDeploymentConfigs in interface AmazonCodeDeploylistDeploymentConfigsRequest - Represents the input of a list deployment configurations operation.InvalidNextTokenException - The next token was specified in an invalid format.public ListDeploymentConfigsResult listDeploymentConfigs()
AmazonCodeDeploylistDeploymentConfigs in interface AmazonCodeDeployAmazonCodeDeploy.listDeploymentConfigs(ListDeploymentConfigsRequest)public ListDeploymentGroupsResult listDeploymentGroups(ListDeploymentGroupsRequest request)
Lists the deployment groups for an application registered with the applicable IAM user or AWS account.
listDeploymentGroups in interface AmazonCodeDeploylistDeploymentGroupsRequest - Represents the input of a list deployment groups 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 applicable IAM user or AWS account.InvalidNextTokenException - The next token was specified in an invalid format.public ListDeploymentInstancesResult listDeploymentInstances(ListDeploymentInstancesRequest request)
Lists the instance for a deployment associated with the applicable IAM user or AWS account.
listDeploymentInstances in interface AmazonCodeDeploylistDeploymentInstancesRequest - Represents the input of a list deployment instances operation.DeploymentIdRequiredException - At least one deployment ID must be specified.DeploymentDoesNotExistException - The deployment does not exist with the applicable IAM user or AWS account.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.public ListDeploymentsResult listDeployments(ListDeploymentsRequest request)
Lists the deployments in a deployment group for an application registered with the applicable IAM user or AWS account.
listDeployments in interface AmazonCodeDeploylistDeploymentsRequest - Represents the input of a list deployments 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 applicable IAM user or AWS account.InvalidDeploymentGroupNameException - The deployment group name was specified in an invalid format.DeploymentGroupDoesNotExistException - The named deployment group does not exist with the applicable IAM user or AWS account.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.public ListDeploymentsResult listDeployments()
AmazonCodeDeploylistDeployments in interface AmazonCodeDeployAmazonCodeDeploy.listDeployments(ListDeploymentsRequest)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 will be listed. To list only registered or deregistered on-premises instance names, use the registration status parameter.
listOnPremisesInstances in interface AmazonCodeDeploylistOnPremisesInstancesRequest - Represents the input of a list on-premises instances operation.InvalidRegistrationStatusException - The registration status was specified in an invalid format.InvalidTagFilterException - The specified tag filter was specified in an invalid format.InvalidNextTokenException - The next token was specified in an invalid format.public ListOnPremisesInstancesResult listOnPremisesInstances()
AmazonCodeDeploylistOnPremisesInstances in interface AmazonCodeDeployAmazonCodeDeploy.listOnPremisesInstances(ListOnPremisesInstancesRequest)public RegisterApplicationRevisionResult registerApplicationRevision(RegisterApplicationRevisionRequest request)
Registers with AWS CodeDeploy a revision for the specified application.
registerApplicationRevision in interface AmazonCodeDeployregisterApplicationRevisionRequest - Represents the input of a register application revision operation.ApplicationDoesNotExistException - The application does not exist with the applicable IAM user or AWS 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 AmazonCodeDeployregisterOnPremisesInstanceRequest - 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 IAM 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 IAM user ARN is already registered with an on-premises instance.InstanceNameRequiredException - An on-premises instance name was not specified.IamUserArnRequiredException - An IAM user ARN was not specified.InvalidInstanceNameException - The specified on-premises instance name was specified in an invalid format.InvalidIamSessionArnException - The IAM session ARN was specified in an invalid format.InvalidIamUserArnException - The IAM user ARN was specified in an invalid format.MultipleIamArnsProvidedException - Both an IAM 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 AmazonCodeDeployremoveTagsFromOnPremisesInstancesRequest - Represents the input of a remove tags from on-premises instances operation.InstanceNameRequiredException - An on-premises instance name was not specified.TagRequiredException - A tag was not specified.InvalidTagException - The specified 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 SkipWaitTimeForInstanceTerminationResult skipWaitTimeForInstanceTermination(SkipWaitTimeForInstanceTerminationRequest request)
In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after the traffic routing is completed.
skipWaitTimeForInstanceTermination in interface AmazonCodeDeployskipWaitTimeForInstanceTerminationRequest - DeploymentIdRequiredException - At least one deployment ID must be specified.DeploymentDoesNotExistException - The deployment does not exist with the applicable IAM user or AWS account.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 AmazonCodeDeploystopDeploymentRequest - Represents the input of a stop deployment operation.DeploymentIdRequiredException - At least one deployment ID must be specified.DeploymentDoesNotExistException - The deployment does not exist with the applicable IAM user or AWS account.DeploymentAlreadyCompletedException - The deployment is already complete.InvalidDeploymentIdException - At least one of the deployment IDs was specified in an invalid format.public UpdateApplicationResult updateApplication(UpdateApplicationRequest request)
Changes the name of an application.
updateApplication in interface AmazonCodeDeployupdateApplicationRequest - Represents the input of an update application 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 already exists with the applicable IAM user or AWS account.ApplicationDoesNotExistException - The application does not exist with the applicable IAM user or AWS account.public UpdateApplicationResult updateApplication()
AmazonCodeDeployupdateApplication in interface AmazonCodeDeployAmazonCodeDeploy.updateApplication(UpdateApplicationRequest)public UpdateDeploymentGroupResult updateDeploymentGroup(UpdateDeploymentGroupRequest request)
Changes information about a deployment group.
updateDeploymentGroup in interface AmazonCodeDeployupdateDeploymentGroupRequest - Represents the input of an update deployment group 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 applicable IAM user or AWS account.InvalidDeploymentGroupNameException - The deployment group name was specified in an invalid format.DeploymentGroupAlreadyExistsException - A deployment group with the specified name already exists with the applicable IAM user or AWS account.DeploymentGroupNameRequiredException - The deployment group name was not specified.DeploymentGroupDoesNotExistException - The named deployment group does not exist with the applicable IAM user or AWS account.InvalidEC2TagException - The tag was specified in an invalid format.InvalidTagException - The specified 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 applicable IAM user or AWS 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 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 255 character limit.
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 for blue/green deployments 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.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 AmazonCodeDeployrequest - The originally executed requestpublic AmazonCodeDeployWaiters waiters()
waiters in interface AmazonCodeDeploypublic void shutdown()
AmazonWebServiceClientshutdown in interface AmazonCodeDeployshutdown in class AmazonWebServiceClientCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.