AutoCloseable
@Generated("software.amazon.awssdk:codegen") public interface CodeDeployAsyncClient extends AutoCloseable
builder()
method.
AWS CodeDeploy is a deployment service that automates application deployments to Amazon EC2 instances or on-premises instances running in your own facility.
You can deploy a nearly unlimited variety of application content, such as code, web and configuration files, executables, packages, scripts, multimedia files, and so on. AWS 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 AWS CodeDeploy.
AWS 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.
AWS CodeDeploy Components
Use the information in this guide to help you work with the following AWS CodeDeploy components:
Application: A name that uniquely identifies the application you want to deploy. AWS 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. A deployment group contains individually tagged instances, Amazon EC2 instances in Auto Scaling groups, or both.
Deployment configuration: A set of deployment rules and deployment success and failure conditions used by AWS CodeDeploy during a deployment.
Deployment: The process, and the components involved in the process, of installing content on one or more instances.
Application revisions: An archive file containing source content—source code, web pages, executable files, and deployment scripts—along with an application specification file (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 and to make on-premises instances available for AWS CodeDeploy deployments.
AWS CodeDeploy Information Resources
Modifier and Type | Method | Description |
---|---|---|
default CompletableFuture<AddTagsToOnPremisesInstancesResponse> |
addTagsToOnPremisesInstances(AddTagsToOnPremisesInstancesRequest addTagsToOnPremisesInstancesRequest) |
Adds tags to on-premises instances.
|
default CompletableFuture<BatchGetApplicationRevisionsResponse> |
batchGetApplicationRevisions(BatchGetApplicationRevisionsRequest batchGetApplicationRevisionsRequest) |
Gets information about one or more application revisions.
|
default CompletableFuture<BatchGetApplicationsResponse> |
batchGetApplications(BatchGetApplicationsRequest batchGetApplicationsRequest) |
Gets information about one or more applications.
|
default CompletableFuture<BatchGetDeploymentGroupsResponse> |
batchGetDeploymentGroups(BatchGetDeploymentGroupsRequest batchGetDeploymentGroupsRequest) |
Gets information about one or more deployment groups.
|
default CompletableFuture<BatchGetDeploymentInstancesResponse> |
batchGetDeploymentInstances(BatchGetDeploymentInstancesRequest batchGetDeploymentInstancesRequest) |
Gets information about one or more instance that are part of a deployment group.
|
default CompletableFuture<BatchGetDeploymentsResponse> |
batchGetDeployments(BatchGetDeploymentsRequest batchGetDeploymentsRequest) |
Gets information about one or more deployments.
|
default CompletableFuture<BatchGetOnPremisesInstancesResponse> |
batchGetOnPremisesInstances(BatchGetOnPremisesInstancesRequest batchGetOnPremisesInstancesRequest) |
Gets information about one or more on-premises instances.
|
static CodeDeployAsyncClientBuilder |
builder() |
Create a builder that can be used to configure and create a
CodeDeployAsyncClient . |
default CompletableFuture<ContinueDeploymentResponse> |
continueDeployment(ContinueDeploymentRequest continueDeploymentRequest) |
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.
|
static CodeDeployAsyncClient |
create() |
Create a
CodeDeployAsyncClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider . |
default CompletableFuture<CreateApplicationResponse> |
createApplication(CreateApplicationRequest createApplicationRequest) |
Creates an application.
|
default CompletableFuture<CreateDeploymentResponse> |
createDeployment(CreateDeploymentRequest createDeploymentRequest) |
Deploys an application revision through the specified deployment group.
|
default CompletableFuture<CreateDeploymentConfigResponse> |
createDeploymentConfig(CreateDeploymentConfigRequest createDeploymentConfigRequest) |
Creates a deployment configuration.
|
default CompletableFuture<CreateDeploymentGroupResponse> |
createDeploymentGroup(CreateDeploymentGroupRequest createDeploymentGroupRequest) |
Creates a deployment group to which application revisions will be deployed.
|
default CompletableFuture<DeleteApplicationResponse> |
deleteApplication(DeleteApplicationRequest deleteApplicationRequest) |
Deletes an application.
|
default CompletableFuture<DeleteDeploymentConfigResponse> |
deleteDeploymentConfig(DeleteDeploymentConfigRequest deleteDeploymentConfigRequest) |
Deletes a deployment configuration.
|
default CompletableFuture<DeleteDeploymentGroupResponse> |
deleteDeploymentGroup(DeleteDeploymentGroupRequest deleteDeploymentGroupRequest) |
Deletes a deployment group.
|
default CompletableFuture<DeregisterOnPremisesInstanceResponse> |
deregisterOnPremisesInstance(DeregisterOnPremisesInstanceRequest deregisterOnPremisesInstanceRequest) |
Deregisters an on-premises instance.
|
default CompletableFuture<GetApplicationResponse> |
getApplication(GetApplicationRequest getApplicationRequest) |
Gets information about an application.
|
default CompletableFuture<GetApplicationRevisionResponse> |
getApplicationRevision(GetApplicationRevisionRequest getApplicationRevisionRequest) |
Gets information about an application revision.
|
default CompletableFuture<GetDeploymentResponse> |
getDeployment(GetDeploymentRequest getDeploymentRequest) |
Gets information about a deployment.
|
default CompletableFuture<GetDeploymentConfigResponse> |
getDeploymentConfig(GetDeploymentConfigRequest getDeploymentConfigRequest) |
Gets information about a deployment configuration.
|
default CompletableFuture<GetDeploymentGroupResponse> |
getDeploymentGroup(GetDeploymentGroupRequest getDeploymentGroupRequest) |
Gets information about a deployment group.
|
default CompletableFuture<GetDeploymentInstanceResponse> |
getDeploymentInstance(GetDeploymentInstanceRequest getDeploymentInstanceRequest) |
Gets information about an instance as part of a deployment.
|
default CompletableFuture<GetOnPremisesInstanceResponse> |
getOnPremisesInstance(GetOnPremisesInstanceRequest getOnPremisesInstanceRequest) |
Gets information about an on-premises instance.
|
default CompletableFuture<ListApplicationRevisionsResponse> |
listApplicationRevisions(ListApplicationRevisionsRequest listApplicationRevisionsRequest) |
Lists information about revisions for an application.
|
default CompletableFuture<ListApplicationsResponse> |
listApplications(ListApplicationsRequest listApplicationsRequest) |
Lists the applications registered with the applicable IAM user or AWS account.
|
default CompletableFuture<ListDeploymentConfigsResponse> |
listDeploymentConfigs(ListDeploymentConfigsRequest listDeploymentConfigsRequest) |
Lists the deployment configurations with the applicable IAM user or AWS account.
|
default CompletableFuture<ListDeploymentGroupsResponse> |
listDeploymentGroups(ListDeploymentGroupsRequest listDeploymentGroupsRequest) |
Lists the deployment groups for an application registered with the applicable IAM user or AWS account.
|
default CompletableFuture<ListDeploymentInstancesResponse> |
listDeploymentInstances(ListDeploymentInstancesRequest listDeploymentInstancesRequest) |
Lists the instance for a deployment associated with the applicable IAM user or AWS account.
|
default CompletableFuture<ListDeploymentsResponse> |
listDeployments(ListDeploymentsRequest listDeploymentsRequest) |
Lists the deployments in a deployment group for an application registered with the applicable IAM user or AWS
account.
|
default CompletableFuture<ListGitHubAccountTokenNamesResponse> |
listGitHubAccountTokenNames(ListGitHubAccountTokenNamesRequest listGitHubAccountTokenNamesRequest) |
Lists the names of stored connections to GitHub accounts.
|
default CompletableFuture<ListOnPremisesInstancesResponse> |
listOnPremisesInstances(ListOnPremisesInstancesRequest listOnPremisesInstancesRequest) |
Gets a list of names for one or more on-premises instances.
|
default CompletableFuture<RegisterApplicationRevisionResponse> |
registerApplicationRevision(RegisterApplicationRevisionRequest registerApplicationRevisionRequest) |
Registers with AWS CodeDeploy a revision for the specified application.
|
default CompletableFuture<RegisterOnPremisesInstanceResponse> |
registerOnPremisesInstance(RegisterOnPremisesInstanceRequest registerOnPremisesInstanceRequest) |
Registers an on-premises instance.
|
default CompletableFuture<RemoveTagsFromOnPremisesInstancesResponse> |
removeTagsFromOnPremisesInstances(RemoveTagsFromOnPremisesInstancesRequest removeTagsFromOnPremisesInstancesRequest) |
Removes one or more tags from one or more on-premises instances.
|
default CompletableFuture<SkipWaitTimeForInstanceTerminationResponse> |
skipWaitTimeForInstanceTermination(SkipWaitTimeForInstanceTerminationRequest skipWaitTimeForInstanceTerminationRequest) |
In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after
the traffic routing is completed.
|
default CompletableFuture<StopDeploymentResponse> |
stopDeployment(StopDeploymentRequest stopDeploymentRequest) |
Attempts to stop an ongoing deployment.
|
default CompletableFuture<UpdateApplicationResponse> |
updateApplication(UpdateApplicationRequest updateApplicationRequest) |
Changes the name of an application.
|
default CompletableFuture<UpdateDeploymentGroupResponse> |
updateDeploymentGroup(UpdateDeploymentGroupRequest updateDeploymentGroupRequest) |
Changes information about a deployment group.
|
close
static CodeDeployAsyncClient create()
CodeDeployAsyncClient
with the region loaded from the
DefaultAwsRegionProviderChain
and credentials loaded from the
DefaultCredentialsProvider
.static CodeDeployAsyncClientBuilder builder()
CodeDeployAsyncClient
.default CompletableFuture<AddTagsToOnPremisesInstancesResponse> addTagsToOnPremisesInstances(AddTagsToOnPremisesInstancesRequest addTagsToOnPremisesInstancesRequest)
Adds tags to on-premises instances.
addTagsToOnPremisesInstancesRequest
- Represents the input of, and adds tags to, an on-premises instance operation.default CompletableFuture<BatchGetApplicationRevisionsResponse> batchGetApplicationRevisions(BatchGetApplicationRevisionsRequest batchGetApplicationRevisionsRequest)
Gets information about one or more application revisions.
batchGetApplicationRevisionsRequest
- Represents the input of a BatchGetApplicationRevisions operation.default CompletableFuture<BatchGetApplicationsResponse> batchGetApplications(BatchGetApplicationsRequest batchGetApplicationsRequest)
Gets information about one or more applications.
batchGetApplicationsRequest
- Represents the input of a BatchGetApplications operation.default CompletableFuture<BatchGetDeploymentGroupsResponse> batchGetDeploymentGroups(BatchGetDeploymentGroupsRequest batchGetDeploymentGroupsRequest)
Gets information about one or more deployment groups.
batchGetDeploymentGroupsRequest
- Represents the input of a BatchGetDeploymentGroups operation.default CompletableFuture<BatchGetDeploymentInstancesResponse> batchGetDeploymentInstances(BatchGetDeploymentInstancesRequest batchGetDeploymentInstancesRequest)
Gets information about one or more instance that are part of a deployment group.
batchGetDeploymentInstancesRequest
- Represents the input of a BatchGetDeploymentInstances operation.default CompletableFuture<BatchGetDeploymentsResponse> batchGetDeployments(BatchGetDeploymentsRequest batchGetDeploymentsRequest)
Gets information about one or more deployments.
batchGetDeploymentsRequest
- Represents the input of a BatchGetDeployments operation.default CompletableFuture<BatchGetOnPremisesInstancesResponse> batchGetOnPremisesInstances(BatchGetOnPremisesInstancesRequest batchGetOnPremisesInstancesRequest)
Gets information about one or more on-premises instances.
batchGetOnPremisesInstancesRequest
- Represents the input of a BatchGetOnPremisesInstances operation.default CompletableFuture<ContinueDeploymentResponse> continueDeployment(ContinueDeploymentRequest continueDeploymentRequest)
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.)
continueDeploymentRequest
- default CompletableFuture<CreateApplicationResponse> createApplication(CreateApplicationRequest createApplicationRequest)
Creates an application.
createApplicationRequest
- Represents the input of a CreateApplication operation.default CompletableFuture<CreateDeploymentResponse> createDeployment(CreateDeploymentRequest createDeploymentRequest)
Deploys an application revision through the specified deployment group.
createDeploymentRequest
- Represents the input of a CreateDeployment operation.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.
default CompletableFuture<CreateDeploymentConfigResponse> createDeploymentConfig(CreateDeploymentConfigRequest createDeploymentConfigRequest)
Creates a deployment configuration.
createDeploymentConfigRequest
- Represents the input of a CreateDeploymentConfig operation.default CompletableFuture<CreateDeploymentGroupResponse> createDeploymentGroup(CreateDeploymentGroupRequest createDeploymentGroupRequest)
Creates a deployment group to which application revisions will be deployed.
createDeploymentGroupRequest
- Represents the input of a CreateDeploymentGroup operation.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.
default CompletableFuture<DeleteApplicationResponse> deleteApplication(DeleteApplicationRequest deleteApplicationRequest)
Deletes an application.
deleteApplicationRequest
- Represents the input of a DeleteApplication operation.default CompletableFuture<DeleteDeploymentConfigResponse> deleteDeploymentConfig(DeleteDeploymentConfigRequest deleteDeploymentConfigRequest)
Deletes a deployment configuration.
A deployment configuration cannot be deleted if it is currently in use. Predefined configurations cannot be deleted.
deleteDeploymentConfigRequest
- Represents the input of a DeleteDeploymentConfig operation.default CompletableFuture<DeleteDeploymentGroupResponse> deleteDeploymentGroup(DeleteDeploymentGroupRequest deleteDeploymentGroupRequest)
Deletes a deployment group.
deleteDeploymentGroupRequest
- Represents the input of a DeleteDeploymentGroup operation.default CompletableFuture<DeregisterOnPremisesInstanceResponse> deregisterOnPremisesInstance(DeregisterOnPremisesInstanceRequest deregisterOnPremisesInstanceRequest)
Deregisters an on-premises instance.
deregisterOnPremisesInstanceRequest
- Represents the input of a DeregisterOnPremisesInstance operation.default CompletableFuture<GetApplicationResponse> getApplication(GetApplicationRequest getApplicationRequest)
Gets information about an application.
getApplicationRequest
- Represents the input of a GetApplication operation.default CompletableFuture<GetApplicationRevisionResponse> getApplicationRevision(GetApplicationRevisionRequest getApplicationRevisionRequest)
Gets information about an application revision.
getApplicationRevisionRequest
- Represents the input of a GetApplicationRevision operation.default CompletableFuture<GetDeploymentResponse> getDeployment(GetDeploymentRequest getDeploymentRequest)
Gets information about a deployment.
getDeploymentRequest
- Represents the input of a GetDeployment operation.default CompletableFuture<GetDeploymentConfigResponse> getDeploymentConfig(GetDeploymentConfigRequest getDeploymentConfigRequest)
Gets information about a deployment configuration.
getDeploymentConfigRequest
- Represents the input of a GetDeploymentConfig operation.default CompletableFuture<GetDeploymentGroupResponse> getDeploymentGroup(GetDeploymentGroupRequest getDeploymentGroupRequest)
Gets information about a deployment group.
getDeploymentGroupRequest
- Represents the input of a GetDeploymentGroup operation.default CompletableFuture<GetDeploymentInstanceResponse> getDeploymentInstance(GetDeploymentInstanceRequest getDeploymentInstanceRequest)
Gets information about an instance as part of a deployment.
getDeploymentInstanceRequest
- Represents the input of a GetDeploymentInstance operation.default CompletableFuture<GetOnPremisesInstanceResponse> getOnPremisesInstance(GetOnPremisesInstanceRequest getOnPremisesInstanceRequest)
Gets information about an on-premises instance.
getOnPremisesInstanceRequest
- Represents the input of a GetOnPremisesInstance operation.default CompletableFuture<ListApplicationRevisionsResponse> listApplicationRevisions(ListApplicationRevisionsRequest listApplicationRevisionsRequest)
Lists information about revisions for an application.
listApplicationRevisionsRequest
- Represents the input of a ListApplicationRevisions operation.default CompletableFuture<ListApplicationsResponse> listApplications(ListApplicationsRequest listApplicationsRequest)
Lists the applications registered with the applicable IAM user or AWS account.
listApplicationsRequest
- Represents the input of a ListApplications operation.default CompletableFuture<ListDeploymentConfigsResponse> listDeploymentConfigs(ListDeploymentConfigsRequest listDeploymentConfigsRequest)
Lists the deployment configurations with the applicable IAM user or AWS account.
listDeploymentConfigsRequest
- Represents the input of a ListDeploymentConfigs operation.default CompletableFuture<ListDeploymentGroupsResponse> listDeploymentGroups(ListDeploymentGroupsRequest listDeploymentGroupsRequest)
Lists the deployment groups for an application registered with the applicable IAM user or AWS account.
listDeploymentGroupsRequest
- Represents the input of a ListDeploymentGroups operation.default CompletableFuture<ListDeploymentInstancesResponse> listDeploymentInstances(ListDeploymentInstancesRequest listDeploymentInstancesRequest)
Lists the instance for a deployment associated with the applicable IAM user or AWS account.
listDeploymentInstancesRequest
- Represents the input of a ListDeploymentInstances operation.default CompletableFuture<ListDeploymentsResponse> listDeployments(ListDeploymentsRequest listDeploymentsRequest)
Lists the deployments in a deployment group for an application registered with the applicable IAM user or AWS account.
listDeploymentsRequest
- Represents the input of a ListDeployments operation.default CompletableFuture<ListGitHubAccountTokenNamesResponse> listGitHubAccountTokenNames(ListGitHubAccountTokenNamesRequest listGitHubAccountTokenNamesRequest)
Lists the names of stored connections to GitHub accounts.
listGitHubAccountTokenNamesRequest
- Represents the input of a ListGitHubAccountTokenNames operation.default CompletableFuture<ListOnPremisesInstancesResponse> listOnPremisesInstances(ListOnPremisesInstancesRequest listOnPremisesInstancesRequest)
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.
listOnPremisesInstancesRequest
- Represents the input of a ListOnPremisesInstances operation.default CompletableFuture<RegisterApplicationRevisionResponse> registerApplicationRevision(RegisterApplicationRevisionRequest registerApplicationRevisionRequest)
Registers with AWS CodeDeploy a revision for the specified application.
registerApplicationRevisionRequest
- Represents the input of a RegisterApplicationRevision operation.default CompletableFuture<RegisterOnPremisesInstanceResponse> registerOnPremisesInstance(RegisterOnPremisesInstanceRequest registerOnPremisesInstanceRequest)
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.
registerOnPremisesInstanceRequest
- Represents the input of the register on-premises instance operation.default CompletableFuture<RemoveTagsFromOnPremisesInstancesResponse> removeTagsFromOnPremisesInstances(RemoveTagsFromOnPremisesInstancesRequest removeTagsFromOnPremisesInstancesRequest)
Removes one or more tags from one or more on-premises instances.
removeTagsFromOnPremisesInstancesRequest
- Represents the input of a RemoveTagsFromOnPremisesInstances operation.default CompletableFuture<SkipWaitTimeForInstanceTerminationResponse> skipWaitTimeForInstanceTermination(SkipWaitTimeForInstanceTerminationRequest skipWaitTimeForInstanceTerminationRequest)
In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after the traffic routing is completed.
skipWaitTimeForInstanceTerminationRequest
- default CompletableFuture<StopDeploymentResponse> stopDeployment(StopDeploymentRequest stopDeploymentRequest)
Attempts to stop an ongoing deployment.
stopDeploymentRequest
- Represents the input of a StopDeployment operation.default CompletableFuture<UpdateApplicationResponse> updateApplication(UpdateApplicationRequest updateApplicationRequest)
Changes the name of an application.
updateApplicationRequest
- Represents the input of an UpdateApplication operation.default CompletableFuture<UpdateDeploymentGroupResponse> updateDeploymentGroup(UpdateDeploymentGroupRequest updateDeploymentGroupRequest)
Changes information about a deployment group.
updateDeploymentGroupRequest
- Represents the input of an UpdateDeploymentGroup operation.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.
Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.