@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSElasticBeanstalkClient extends AmazonWebServiceClient implements AWSElasticBeanstalk
AWS Elastic Beanstalk makes it easy for you to create, deploy, and manage scalable, fault-tolerant applications running on the Amazon Web Services cloud.
For more information about this product, go to the AWS Elastic Beanstalk details page. The location of the latest AWS Elastic Beanstalk WSDL is https://elasticbeanstalk.s3.amazonaws.com/doc/2010-12-01/AWSElasticBeanstalk.wsdl. To install the Software Development Kits (SDKs), Integrated Development Environment (IDE) Toolkits, and command line tools that enable you to access the API, go to Tools for Amazon Web Services.
Endpoints
For a list of region-specific endpoints that AWS Elastic Beanstalk supports, go to Regions and Endpoints in the Amazon Web Services Glossary.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Constructor and Description |
---|
AWSElasticBeanstalkClient()
Deprecated.
|
AWSElasticBeanstalkClient(AWSCredentials awsCredentials)
Deprecated.
use
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example:
AWSElasticBeanstalkClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build(); |
AWSElasticBeanstalkClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
|
AWSElasticBeanstalkClient(AWSCredentialsProvider awsCredentialsProvider)
Deprecated.
|
AWSElasticBeanstalkClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
|
AWSElasticBeanstalkClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
|
AWSElasticBeanstalkClient(ClientConfiguration clientConfiguration)
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
AbortEnvironmentUpdateResult |
abortEnvironmentUpdate()
Simplified method form for invoking the AbortEnvironmentUpdate operation.
|
AbortEnvironmentUpdateResult |
abortEnvironmentUpdate(AbortEnvironmentUpdateRequest request)
Cancels in-progress environment configuration update or application version deployment.
|
ApplyEnvironmentManagedActionResult |
applyEnvironmentManagedAction(ApplyEnvironmentManagedActionRequest request)
Applies a scheduled managed action immediately.
|
AssociateEnvironmentOperationsRoleResult |
associateEnvironmentOperationsRole(AssociateEnvironmentOperationsRoleRequest request)
Add or change the operations role used by an environment.
|
static AWSElasticBeanstalkClientBuilder |
builder() |
CheckDNSAvailabilityResult |
checkDNSAvailability(CheckDNSAvailabilityRequest request)
Checks if the specified CNAME is available.
|
ComposeEnvironmentsResult |
composeEnvironments(ComposeEnvironmentsRequest request)
Create or update a group of environments that each run a separate component of a single application.
|
CreateApplicationResult |
createApplication(CreateApplicationRequest request)
Creates an application that has one configuration template named
default and no application
versions. |
CreateApplicationVersionResult |
createApplicationVersion(CreateApplicationVersionRequest request)
Creates an application version for the specified application.
|
CreateConfigurationTemplateResult |
createConfigurationTemplate(CreateConfigurationTemplateRequest request)
Creates an AWS Elastic Beanstalk configuration template, associated with a specific Elastic Beanstalk
application.
|
CreateEnvironmentResult |
createEnvironment(CreateEnvironmentRequest request)
Launches an AWS Elastic Beanstalk environment for the specified application using the specified configuration.
|
CreatePlatformVersionResult |
createPlatformVersion(CreatePlatformVersionRequest request)
Create a new version of your custom platform.
|
CreateStorageLocationResult |
createStorageLocation()
Simplified method form for invoking the CreateStorageLocation operation.
|
CreateStorageLocationResult |
createStorageLocation(CreateStorageLocationRequest request)
Creates a bucket in Amazon S3 to store application versions, logs, and other files used by Elastic Beanstalk
environments.
|
DeleteApplicationResult |
deleteApplication(DeleteApplicationRequest request)
Deletes the specified application along with all associated versions and configurations.
|
DeleteApplicationVersionResult |
deleteApplicationVersion(DeleteApplicationVersionRequest request)
Deletes the specified version from the specified application.
|
DeleteConfigurationTemplateResult |
deleteConfigurationTemplate(DeleteConfigurationTemplateRequest request)
Deletes the specified configuration template.
|
DeleteEnvironmentConfigurationResult |
deleteEnvironmentConfiguration(DeleteEnvironmentConfigurationRequest request)
Deletes the draft configuration associated with the running environment.
|
DeletePlatformVersionResult |
deletePlatformVersion(DeletePlatformVersionRequest request)
Deletes the specified version of a custom platform.
|
DescribeAccountAttributesResult |
describeAccountAttributes(DescribeAccountAttributesRequest request)
Returns attributes related to AWS Elastic Beanstalk that are associated with the calling AWS account.
|
DescribeApplicationsResult |
describeApplications()
Simplified method form for invoking the DescribeApplications operation.
|
DescribeApplicationsResult |
describeApplications(DescribeApplicationsRequest request)
Returns the descriptions of existing applications.
|
DescribeApplicationVersionsResult |
describeApplicationVersions()
Simplified method form for invoking the DescribeApplicationVersions operation.
|
DescribeApplicationVersionsResult |
describeApplicationVersions(DescribeApplicationVersionsRequest request)
Retrieve a list of application versions.
|
DescribeConfigurationOptionsResult |
describeConfigurationOptions(DescribeConfigurationOptionsRequest request)
Describes the configuration options that are used in a particular configuration template or environment, or that
a specified solution stack defines.
|
DescribeConfigurationSettingsResult |
describeConfigurationSettings(DescribeConfigurationSettingsRequest request)
Returns a description of the settings for the specified configuration set, that is, either a configuration
template or the configuration set associated with a running environment.
|
DescribeEnvironmentHealthResult |
describeEnvironmentHealth(DescribeEnvironmentHealthRequest request)
Returns information about the overall health of the specified environment.
|
DescribeEnvironmentManagedActionHistoryResult |
describeEnvironmentManagedActionHistory(DescribeEnvironmentManagedActionHistoryRequest request)
Lists an environment's completed and failed managed actions.
|
DescribeEnvironmentManagedActionsResult |
describeEnvironmentManagedActions(DescribeEnvironmentManagedActionsRequest request)
Lists an environment's upcoming and in-progress managed actions.
|
DescribeEnvironmentResourcesResult |
describeEnvironmentResources(DescribeEnvironmentResourcesRequest request)
Returns AWS resources for this environment.
|
DescribeEnvironmentsResult |
describeEnvironments()
Simplified method form for invoking the DescribeEnvironments operation.
|
DescribeEnvironmentsResult |
describeEnvironments(DescribeEnvironmentsRequest request)
Returns descriptions for existing environments.
|
DescribeEventsResult |
describeEvents()
Simplified method form for invoking the DescribeEvents operation.
|
DescribeEventsResult |
describeEvents(DescribeEventsRequest request)
Returns list of event descriptions matching criteria up to the last 6 weeks.
|
DescribeInstancesHealthResult |
describeInstancesHealth(DescribeInstancesHealthRequest request)
Retrieves detailed information about the health of instances in your AWS Elastic Beanstalk.
|
DescribePlatformVersionResult |
describePlatformVersion(DescribePlatformVersionRequest request)
Describes a platform version.
|
DisassociateEnvironmentOperationsRoleResult |
disassociateEnvironmentOperationsRole(DisassociateEnvironmentOperationsRoleRequest request)
Disassociate the operations role from an environment.
|
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.
|
ListAvailableSolutionStacksResult |
listAvailableSolutionStacks()
Simplified method form for invoking the ListAvailableSolutionStacks operation.
|
ListAvailableSolutionStacksResult |
listAvailableSolutionStacks(ListAvailableSolutionStacksRequest request)
Returns a list of the available solution stack names, with the public version first and then in reverse
chronological order.
|
ListPlatformBranchesResult |
listPlatformBranches(ListPlatformBranchesRequest request)
Lists the platform branches available for your account in an AWS Region.
|
ListPlatformVersionsResult |
listPlatformVersions(ListPlatformVersionsRequest request)
Lists the platform versions available for your account in an AWS Region.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Return the tags applied to an AWS Elastic Beanstalk resource.
|
RebuildEnvironmentResult |
rebuildEnvironment(RebuildEnvironmentRequest request)
Deletes and recreates all of the AWS resources (for example: the Auto Scaling group, load balancer, etc.) for a
specified environment and forces a restart.
|
RequestEnvironmentInfoResult |
requestEnvironmentInfo(RequestEnvironmentInfoRequest request)
Initiates a request to compile the specified type of information of the deployed environment.
|
RestartAppServerResult |
restartAppServer(RestartAppServerRequest request)
Causes the environment to restart the application container server running on each Amazon EC2 instance.
|
RetrieveEnvironmentInfoResult |
retrieveEnvironmentInfo(RetrieveEnvironmentInfoRequest request)
Retrieves the compiled information from a RequestEnvironmentInfo request.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
SwapEnvironmentCNAMEsResult |
swapEnvironmentCNAMEs()
Simplified method form for invoking the SwapEnvironmentCNAMEs operation.
|
SwapEnvironmentCNAMEsResult |
swapEnvironmentCNAMEs(SwapEnvironmentCNAMEsRequest request)
Swaps the CNAMEs of two environments.
|
TerminateEnvironmentResult |
terminateEnvironment(TerminateEnvironmentRequest request)
Terminates the specified environment.
|
UpdateApplicationResult |
updateApplication(UpdateApplicationRequest request)
Updates the specified application to have the specified properties.
|
UpdateApplicationResourceLifecycleResult |
updateApplicationResourceLifecycle(UpdateApplicationResourceLifecycleRequest request)
Modifies lifecycle settings for an application.
|
UpdateApplicationVersionResult |
updateApplicationVersion(UpdateApplicationVersionRequest request)
Updates the specified application version to have the specified properties.
|
UpdateConfigurationTemplateResult |
updateConfigurationTemplate(UpdateConfigurationTemplateRequest request)
Updates the specified configuration template to have the specified properties or configuration option values.
|
UpdateEnvironmentResult |
updateEnvironment(UpdateEnvironmentRequest request)
Updates the environment description, deploys a new application version, updates the configuration settings to an
entirely new configuration template, or updates select configuration option values in the running environment.
|
UpdateTagsForResourceResult |
updateTagsForResource(UpdateTagsForResourceRequest request)
Update the list of tags applied to an AWS Elastic Beanstalk resource.
|
ValidateConfigurationSettingsResult |
validateConfigurationSettings(ValidateConfigurationSettingsRequest request)
Takes a set of configuration settings and either a configuration template or environment, and determines whether
those values are valid.
|
AWSElasticBeanstalkWaiters |
waiters() |
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 AWSElasticBeanstalkClient()
AWSElasticBeanstalkClientBuilder.defaultClient()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain
@Deprecated public AWSElasticBeanstalkClient(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 Elastic Beanstalk (ex: proxy
settings, retry counts, etc.).DefaultAWSCredentialsProviderChain
@Deprecated public AWSElasticBeanstalkClient(AWSCredentials awsCredentials)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
for example:
AWSElasticBeanstalkClientBuilder.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 AWSElasticBeanstalkClient(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 Elastic Beanstalk (ex: proxy
settings, retry counts, etc.).@Deprecated public AWSElasticBeanstalkClient(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 AWSElasticBeanstalkClient(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 Elastic Beanstalk (ex: proxy
settings, retry counts, etc.).@Deprecated public AWSElasticBeanstalkClient(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 Elastic Beanstalk (ex: proxy
settings, retry counts, etc.).requestMetricCollector
- optional request metric collectorpublic static AWSElasticBeanstalkClientBuilder builder()
public AbortEnvironmentUpdateResult abortEnvironmentUpdate(AbortEnvironmentUpdateRequest request)
Cancels in-progress environment configuration update or application version deployment.
abortEnvironmentUpdate
in interface AWSElasticBeanstalk
abortEnvironmentUpdateRequest
- InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); AbortEnvironmentUpdateRequest request = new AbortEnvironmentUpdateRequest().withEnvironmentName("my-env"); AbortEnvironmentUpdateResult response = client.abortEnvironmentUpdate(request);
public AbortEnvironmentUpdateResult abortEnvironmentUpdate()
AWSElasticBeanstalk
abortEnvironmentUpdate
in interface AWSElasticBeanstalk
AWSElasticBeanstalk.abortEnvironmentUpdate(AbortEnvironmentUpdateRequest)
public ApplyEnvironmentManagedActionResult applyEnvironmentManagedAction(ApplyEnvironmentManagedActionRequest request)
Applies a scheduled managed action immediately. A managed action can be applied only if its status is
Scheduled
. Get the status and action ID of a managed action with
DescribeEnvironmentManagedActions.
applyEnvironmentManagedAction
in interface AWSElasticBeanstalk
applyEnvironmentManagedActionRequest
- Request to execute a scheduled managed action immediately.ElasticBeanstalkServiceException
- A generic service exception has occurred.ManagedActionInvalidStateException
- Cannot modify the managed action in its current state.public AssociateEnvironmentOperationsRoleResult associateEnvironmentOperationsRole(AssociateEnvironmentOperationsRoleRequest request)
Add or change the operations role used by an environment. After this call is made, Elastic Beanstalk uses the associated operations role for permissions to downstream services during subsequent calls acting on this environment. For more information, see Operations roles in the AWS Elastic Beanstalk Developer Guide.
associateEnvironmentOperationsRole
in interface AWSElasticBeanstalk
associateEnvironmentOperationsRoleRequest
- Request to add or change the operations role used by an environment.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.public CheckDNSAvailabilityResult checkDNSAvailability(CheckDNSAvailabilityRequest request)
Checks if the specified CNAME is available.
checkDNSAvailability
in interface AWSElasticBeanstalk
checkDNSAvailabilityRequest
- Results message indicating whether a CNAME is available.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); CheckDNSAvailabilityRequest request = new CheckDNSAvailabilityRequest().withCNAMEPrefix("my-cname"); CheckDNSAvailabilityResult response = client.checkDNSAvailability(request);
public ComposeEnvironmentsResult composeEnvironments(ComposeEnvironmentsRequest request)
Create or update a group of environments that each run a separate component of a single application. Takes a list
of version labels that specify application source bundles for each of the environments to create or update. The
name of each environment and other required information must be included in the source bundles in an environment
manifest named env.yaml
. See Compose
Environments for details.
composeEnvironments
in interface AWSElasticBeanstalk
composeEnvironmentsRequest
- Request to create or update a group of environments.TooManyEnvironmentsException
- The specified account has reached its limit of environments.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.public CreateApplicationResult createApplication(CreateApplicationRequest request)
Creates an application that has one configuration template named default
and no application
versions.
createApplication
in interface AWSElasticBeanstalk
createApplicationRequest
- Request to create an application.TooManyApplicationsException
- The specified account has reached its limit of applications.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); CreateApplicationRequest request = new CreateApplicationRequest().withApplicationName("my-app").withDescription("my application"); CreateApplicationResult response = client.createApplication(request);
public CreateApplicationVersionResult createApplicationVersion(CreateApplicationVersionRequest request)
Creates an application version for the specified application. You can create an application version from a source bundle in Amazon S3, a commit in AWS CodeCommit, or the output of an AWS CodeBuild build as follows:
Specify a commit in an AWS CodeCommit repository with SourceBuildInformation
.
Specify a build in an AWS CodeBuild with SourceBuildInformation
and BuildConfiguration
.
Specify a source bundle in S3 with SourceBundle
Omit both SourceBuildInformation
and SourceBundle
to use the default sample
application.
After you create an application version with a specified Amazon S3 bucket and key location, you can't change that Amazon S3 location. If you change the Amazon S3 location, you receive an exception when you attempt to launch an environment from the application version.
createApplicationVersion
in interface AWSElasticBeanstalk
createApplicationVersionRequest
- TooManyApplicationsException
- The specified account has reached its limit of applications.TooManyApplicationVersionsException
- The specified account has reached its limit of application versions.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.S3LocationNotInServiceRegionException
- The specified S3 bucket does not belong to the S3 region in which the service is running. The following
regions are supported:
IAD/us-east-1
PDX/us-west-2
DUB/eu-west-1
CodeBuildNotInServiceRegionException
- AWS CodeBuild is not available in the specified region.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); CreateApplicationVersionRequest request = new CreateApplicationVersionRequest().withApplicationName("my-app").withVersionLabel("v1") .withDescription("my-app-v1").withSourceBundle(new S3Location().withS3Bucket("my-bucket").withS3Key("sample.war")) .withAutoCreateApplication(true).withProcess(true); CreateApplicationVersionResult response = client.createApplicationVersion(request);
public CreateConfigurationTemplateResult createConfigurationTemplate(CreateConfigurationTemplateRequest request)
Creates an AWS Elastic Beanstalk configuration template, associated with a specific Elastic Beanstalk application. You define application configuration settings in a configuration template. You can then use the configuration template to deploy different versions of the application with the same configuration settings.
Templates aren't associated with any environment. The EnvironmentName
response element is always
null
.
Related Topics
createConfigurationTemplate
in interface AWSElasticBeanstalk
createConfigurationTemplateRequest
- Request to create a configuration template.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.TooManyBucketsException
- The specified account has reached its limit of Amazon S3 buckets.TooManyConfigurationTemplatesException
- The specified account has reached its limit of configuration templates.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); CreateConfigurationTemplateRequest request = new CreateConfigurationTemplateRequest().withApplicationName("my-app").withTemplateName("my-app-v1") .withEnvironmentId("e-rpqsewtp2j"); CreateConfigurationTemplateResult response = client.createConfigurationTemplate(request);
public CreateEnvironmentResult createEnvironment(CreateEnvironmentRequest request)
Launches an AWS Elastic Beanstalk environment for the specified application using the specified configuration.
createEnvironment
in interface AWSElasticBeanstalk
createEnvironmentRequest
- TooManyEnvironmentsException
- The specified account has reached its limit of environments.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); CreateEnvironmentRequest request = new CreateEnvironmentRequest().withApplicationName("my-app").withEnvironmentName("my-env").withCNAMEPrefix("my-app") .withVersionLabel("v1").withSolutionStackName("64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"); CreateEnvironmentResult response = client.createEnvironment(request);
public CreatePlatformVersionResult createPlatformVersion(CreatePlatformVersionRequest request)
Create a new version of your custom platform.
createPlatformVersion
in interface AWSElasticBeanstalk
createPlatformVersionRequest
- Request to create a new platform version.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.ElasticBeanstalkServiceException
- A generic service exception has occurred.TooManyPlatformsException
- You have exceeded the maximum number of allowed platforms associated with the account.public CreateStorageLocationResult createStorageLocation(CreateStorageLocationRequest request)
Creates a bucket in Amazon S3 to store application versions, logs, and other files used by Elastic Beanstalk
environments. The Elastic Beanstalk console and EB CLI call this API the first time you create an environment in
a region. If the storage location already exists, CreateStorageLocation
still returns the bucket
name but does not create a new bucket.
createStorageLocation
in interface AWSElasticBeanstalk
createStorageLocationRequest
- TooManyBucketsException
- The specified account has reached its limit of Amazon S3 buckets.S3SubscriptionRequiredException
- The specified account does not have a subscription to Amazon S3.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); CreateStorageLocationRequest request = new CreateStorageLocationRequest(); CreateStorageLocationResult response = client.createStorageLocation(request);
public CreateStorageLocationResult createStorageLocation()
AWSElasticBeanstalk
createStorageLocation
in interface AWSElasticBeanstalk
AWSElasticBeanstalk.createStorageLocation(CreateStorageLocationRequest)
public DeleteApplicationResult deleteApplication(DeleteApplicationRequest request)
Deletes the specified application along with all associated versions and configurations. The application versions will not be deleted from your Amazon S3 bucket.
You cannot delete an application that has a running environment.
deleteApplication
in interface AWSElasticBeanstalk
deleteApplicationRequest
- Request to delete an application.OperationInProgressException
- Unable to perform the specified operation because another operation that effects an element in this
activity is already in progress.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DeleteApplicationRequest request = new DeleteApplicationRequest().withApplicationName("my-app"); DeleteApplicationResult response = client.deleteApplication(request);
public DeleteApplicationVersionResult deleteApplicationVersion(DeleteApplicationVersionRequest request)
Deletes the specified version from the specified application.
You cannot delete an application version that is associated with a running environment.
deleteApplicationVersion
in interface AWSElasticBeanstalk
deleteApplicationVersionRequest
- Request to delete an application version.SourceBundleDeletionException
- Unable to delete the Amazon S3 source bundle associated with the application version. The application
version was deleted successfully.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.OperationInProgressException
- Unable to perform the specified operation because another operation that effects an element in this
activity is already in progress.S3LocationNotInServiceRegionException
- The specified S3 bucket does not belong to the S3 region in which the service is running. The following
regions are supported:
IAD/us-east-1
PDX/us-west-2
DUB/eu-west-1
AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DeleteApplicationVersionRequest request = new DeleteApplicationVersionRequest().withApplicationName("my-app") .withVersionLabel("22a0-stage-150819_182129").withDeleteSourceBundle(true); DeleteApplicationVersionResult response = client.deleteApplicationVersion(request);
public DeleteConfigurationTemplateResult deleteConfigurationTemplate(DeleteConfigurationTemplateRequest request)
Deletes the specified configuration template.
When you launch an environment using a configuration template, the environment gets a copy of the template. You can delete or modify the environment's copy of the template without affecting the running environment.
deleteConfigurationTemplate
in interface AWSElasticBeanstalk
deleteConfigurationTemplateRequest
- Request to delete a configuration template.OperationInProgressException
- Unable to perform the specified operation because another operation that effects an element in this
activity is already in progress.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DeleteConfigurationTemplateRequest request = new DeleteConfigurationTemplateRequest().withApplicationName("my-app").withTemplateName("my-template"); DeleteConfigurationTemplateResult response = client.deleteConfigurationTemplate(request);
public DeleteEnvironmentConfigurationResult deleteEnvironmentConfiguration(DeleteEnvironmentConfigurationRequest request)
Deletes the draft configuration associated with the running environment.
Updating a running environment with any configuration changes creates a draft configuration set. You can get the
draft configuration using DescribeConfigurationSettings while the update is in progress or if the update
fails. The DeploymentStatus
for the draft configuration indicates whether the deployment is in
process or has failed. The draft configuration remains in existence until it is deleted with this action.
deleteEnvironmentConfiguration
in interface AWSElasticBeanstalk
deleteEnvironmentConfigurationRequest
- Request to delete a draft environment configuration.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DeleteEnvironmentConfigurationRequest request = new DeleteEnvironmentConfigurationRequest().withApplicationName("my-app").withEnvironmentName("my-env"); DeleteEnvironmentConfigurationResult response = client.deleteEnvironmentConfiguration(request);
public DeletePlatformVersionResult deletePlatformVersion(DeletePlatformVersionRequest request)
Deletes the specified version of a custom platform.
deletePlatformVersion
in interface AWSElasticBeanstalk
deletePlatformVersionRequest
- OperationInProgressException
- Unable to perform the specified operation because another operation that effects an element in this
activity is already in progress.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.ElasticBeanstalkServiceException
- A generic service exception has occurred.PlatformVersionStillReferencedException
- You cannot delete the platform version because there are still environments running on it.public DescribeAccountAttributesResult describeAccountAttributes(DescribeAccountAttributesRequest request)
Returns attributes related to AWS Elastic Beanstalk that are associated with the calling AWS account.
The result currently has one set of attributes—resource quotas.
describeAccountAttributes
in interface AWSElasticBeanstalk
describeAccountAttributesRequest
- InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.public DescribeApplicationVersionsResult describeApplicationVersions(DescribeApplicationVersionsRequest request)
Retrieve a list of application versions.
describeApplicationVersions
in interface AWSElasticBeanstalk
describeApplicationVersionsRequest
- Request to describe application versions.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeApplicationVersionsRequest request = new DescribeApplicationVersionsRequest().withApplicationName("my-app").withVersionLabels("v2"); DescribeApplicationVersionsResult response = client.describeApplicationVersions(request);
public DescribeApplicationVersionsResult describeApplicationVersions()
AWSElasticBeanstalk
describeApplicationVersions
in interface AWSElasticBeanstalk
AWSElasticBeanstalk.describeApplicationVersions(DescribeApplicationVersionsRequest)
public DescribeApplicationsResult describeApplications(DescribeApplicationsRequest request)
Returns the descriptions of existing applications.
describeApplications
in interface AWSElasticBeanstalk
describeApplicationsRequest
- Request to describe one or more applications.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeApplicationsRequest request = new DescribeApplicationsRequest(); DescribeApplicationsResult response = client.describeApplications(request);
public DescribeApplicationsResult describeApplications()
AWSElasticBeanstalk
describeApplications
in interface AWSElasticBeanstalk
AWSElasticBeanstalk.describeApplications(DescribeApplicationsRequest)
public DescribeConfigurationOptionsResult describeConfigurationOptions(DescribeConfigurationOptionsRequest request)
Describes the configuration options that are used in a particular configuration template or environment, or that a specified solution stack defines. The description includes the values the options, their default values, and an indication of the required action on a running environment if an option value is changed.
describeConfigurationOptions
in interface AWSElasticBeanstalk
describeConfigurationOptionsRequest
- Result message containing a list of application version descriptions.TooManyBucketsException
- The specified account has reached its limit of Amazon S3 buckets.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeConfigurationOptionsRequest request = new DescribeConfigurationOptionsRequest().withApplicationName("my-app").withEnvironmentName("my-env"); DescribeConfigurationOptionsResult response = client.describeConfigurationOptions(request);
public DescribeConfigurationSettingsResult describeConfigurationSettings(DescribeConfigurationSettingsRequest request)
Returns a description of the settings for the specified configuration set, that is, either a configuration template or the configuration set associated with a running environment.
When describing the settings for the configuration set associated with a running environment, it is possible to receive two sets of setting descriptions. One is the deployed configuration set, and the other is a draft configuration of an environment that is either in the process of deployment or that failed to deploy.
Related Topics
describeConfigurationSettings
in interface AWSElasticBeanstalk
describeConfigurationSettingsRequest
- Result message containing all of the configuration settings for a specified solution stack or
configuration template.TooManyBucketsException
- The specified account has reached its limit of Amazon S3 buckets.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeConfigurationSettingsRequest request = new DescribeConfigurationSettingsRequest().withApplicationName("my-app").withEnvironmentName("my-env"); DescribeConfigurationSettingsResult response = client.describeConfigurationSettings(request);
public DescribeEnvironmentHealthResult describeEnvironmentHealth(DescribeEnvironmentHealthRequest request)
Returns information about the overall health of the specified environment. The DescribeEnvironmentHealth operation is only available with AWS Elastic Beanstalk Enhanced Health.
describeEnvironmentHealth
in interface AWSElasticBeanstalk
describeEnvironmentHealthRequest
- See the example below to learn how to create a request body.InvalidRequestException
- One or more input parameters is not valid. Please correct the input parameters and try the operation
again.ElasticBeanstalkServiceException
- A generic service exception has occurred.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeEnvironmentHealthRequest request = new DescribeEnvironmentHealthRequest().withEnvironmentName("my-env").withAttributeNames("All"); DescribeEnvironmentHealthResult response = client.describeEnvironmentHealth(request);
public DescribeEnvironmentManagedActionHistoryResult describeEnvironmentManagedActionHistory(DescribeEnvironmentManagedActionHistoryRequest request)
Lists an environment's completed and failed managed actions.
describeEnvironmentManagedActionHistory
in interface AWSElasticBeanstalk
describeEnvironmentManagedActionHistoryRequest
- Request to list completed and failed managed actions.ElasticBeanstalkServiceException
- A generic service exception has occurred.public DescribeEnvironmentManagedActionsResult describeEnvironmentManagedActions(DescribeEnvironmentManagedActionsRequest request)
Lists an environment's upcoming and in-progress managed actions.
describeEnvironmentManagedActions
in interface AWSElasticBeanstalk
describeEnvironmentManagedActionsRequest
- Request to list an environment's upcoming and in-progress managed actions.ElasticBeanstalkServiceException
- A generic service exception has occurred.public DescribeEnvironmentResourcesResult describeEnvironmentResources(DescribeEnvironmentResourcesRequest request)
Returns AWS resources for this environment.
describeEnvironmentResources
in interface AWSElasticBeanstalk
describeEnvironmentResourcesRequest
- Request to describe the resources in an environment.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeEnvironmentResourcesRequest request = new DescribeEnvironmentResourcesRequest().withEnvironmentName("my-env"); DescribeEnvironmentResourcesResult response = client.describeEnvironmentResources(request);
public DescribeEnvironmentsResult describeEnvironments(DescribeEnvironmentsRequest request)
Returns descriptions for existing environments.
describeEnvironments
in interface AWSElasticBeanstalk
describeEnvironmentsRequest
- Request to describe one or more environments.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeEnvironmentsRequest request = new DescribeEnvironmentsRequest().withEnvironmentNames("my-env"); DescribeEnvironmentsResult response = client.describeEnvironments(request);
public DescribeEnvironmentsResult describeEnvironments()
AWSElasticBeanstalk
describeEnvironments
in interface AWSElasticBeanstalk
AWSElasticBeanstalk.describeEnvironments(DescribeEnvironmentsRequest)
public DescribeEventsResult describeEvents(DescribeEventsRequest request)
Returns list of event descriptions matching criteria up to the last 6 weeks.
This action returns the most recent 1,000 events from the specified NextToken
.
describeEvents
in interface AWSElasticBeanstalk
describeEventsRequest
- Request to retrieve a list of events for an environment.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeEventsRequest request = new DescribeEventsRequest().withEnvironmentName("my-env"); DescribeEventsResult response = client.describeEvents(request);
public DescribeEventsResult describeEvents()
AWSElasticBeanstalk
describeEvents
in interface AWSElasticBeanstalk
AWSElasticBeanstalk.describeEvents(DescribeEventsRequest)
public DescribeInstancesHealthResult describeInstancesHealth(DescribeInstancesHealthRequest request)
Retrieves detailed information about the health of instances in your AWS Elastic Beanstalk. This operation requires enhanced health reporting.
describeInstancesHealth
in interface AWSElasticBeanstalk
describeInstancesHealthRequest
- Parameters for a call to DescribeInstancesHealth
.InvalidRequestException
- One or more input parameters is not valid. Please correct the input parameters and try the operation
again.ElasticBeanstalkServiceException
- A generic service exception has occurred.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); DescribeInstancesHealthRequest request = new DescribeInstancesHealthRequest().withEnvironmentName("my-env").withAttributeNames("All"); DescribeInstancesHealthResult response = client.describeInstancesHealth(request);
public DescribePlatformVersionResult describePlatformVersion(DescribePlatformVersionRequest request)
Describes a platform version. Provides full details. Compare to ListPlatformVersions, which provides summary information about a list of platform versions.
For definitions of platform version and other platform-related terms, see AWS Elastic Beanstalk Platforms Glossary.
describePlatformVersion
in interface AWSElasticBeanstalk
describePlatformVersionRequest
- InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.ElasticBeanstalkServiceException
- A generic service exception has occurred.public DisassociateEnvironmentOperationsRoleResult disassociateEnvironmentOperationsRole(DisassociateEnvironmentOperationsRoleRequest request)
Disassociate the operations role from an environment. After this call is made, Elastic Beanstalk uses the caller's permissions for permissions to downstream services during subsequent calls acting on this environment. For more information, see Operations roles in the AWS Elastic Beanstalk Developer Guide.
disassociateEnvironmentOperationsRole
in interface AWSElasticBeanstalk
disassociateEnvironmentOperationsRoleRequest
- Request to disassociate the operations role from an environment.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.public ListAvailableSolutionStacksResult listAvailableSolutionStacks(ListAvailableSolutionStacksRequest request)
Returns a list of the available solution stack names, with the public version first and then in reverse chronological order.
listAvailableSolutionStacks
in interface AWSElasticBeanstalk
listAvailableSolutionStacksRequest
- AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); ListAvailableSolutionStacksRequest request = new ListAvailableSolutionStacksRequest(); ListAvailableSolutionStacksResult response = client.listAvailableSolutionStacks(request);
public ListAvailableSolutionStacksResult listAvailableSolutionStacks()
AWSElasticBeanstalk
listAvailableSolutionStacks
in interface AWSElasticBeanstalk
AWSElasticBeanstalk.listAvailableSolutionStacks(ListAvailableSolutionStacksRequest)
public ListPlatformBranchesResult listPlatformBranches(ListPlatformBranchesRequest request)
Lists the platform branches available for your account in an AWS Region. Provides summary information about each platform branch.
For definitions of platform branch and other platform-related terms, see AWS Elastic Beanstalk Platforms Glossary.
listPlatformBranches
in interface AWSElasticBeanstalk
listPlatformBranchesRequest
- public ListPlatformVersionsResult listPlatformVersions(ListPlatformVersionsRequest request)
Lists the platform versions available for your account in an AWS Region. Provides summary information about each platform version. Compare to DescribePlatformVersion, which provides full details about a single platform version.
For definitions of platform version and other platform-related terms, see AWS Elastic Beanstalk Platforms Glossary.
listPlatformVersions
in interface AWSElasticBeanstalk
listPlatformVersionsRequest
- InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.ElasticBeanstalkServiceException
- A generic service exception has occurred.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Return the tags applied to an AWS Elastic Beanstalk resource. The response contains a list of tag key-value pairs.
Elastic Beanstalk supports tagging of all of its resources. For details about resource tagging, see Tagging Application Resources.
listTagsForResource
in interface AWSElasticBeanstalk
listTagsForResourceRequest
- InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.ResourceNotFoundException
- A resource doesn't exist for the specified Amazon Resource Name (ARN).ResourceTypeNotSupportedException
- The type of the specified Amazon Resource Name (ARN) isn't supported for this operation.public RebuildEnvironmentResult rebuildEnvironment(RebuildEnvironmentRequest request)
Deletes and recreates all of the AWS resources (for example: the Auto Scaling group, load balancer, etc.) for a specified environment and forces a restart.
rebuildEnvironment
in interface AWSElasticBeanstalk
rebuildEnvironmentRequest
- InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); RebuildEnvironmentRequest request = new RebuildEnvironmentRequest().withEnvironmentName("my-env"); RebuildEnvironmentResult response = client.rebuildEnvironment(request);
public RequestEnvironmentInfoResult requestEnvironmentInfo(RequestEnvironmentInfoRequest request)
Initiates a request to compile the specified type of information of the deployed environment.
Setting the InfoType
to tail
compiles the last lines from the application server log
files of every Amazon EC2 instance in your environment.
Setting the InfoType
to bundle
compresses the application server log files for every
Amazon EC2 instance into a .zip
file. Legacy and .NET containers do not support bundle logs.
Use RetrieveEnvironmentInfo to obtain the set of logs.
Related Topics
requestEnvironmentInfo
in interface AWSElasticBeanstalk
requestEnvironmentInfoRequest
- Request to retrieve logs from an environment and store them in your Elastic Beanstalk storage bucket.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); RequestEnvironmentInfoRequest request = new RequestEnvironmentInfoRequest().withEnvironmentName("my-env").withInfoType("tail"); RequestEnvironmentInfoResult response = client.requestEnvironmentInfo(request);
public RestartAppServerResult restartAppServer(RestartAppServerRequest request)
Causes the environment to restart the application container server running on each Amazon EC2 instance.
restartAppServer
in interface AWSElasticBeanstalk
restartAppServerRequest
- AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); RestartAppServerRequest request = new RestartAppServerRequest().withEnvironmentName("my-env"); RestartAppServerResult response = client.restartAppServer(request);
public RetrieveEnvironmentInfoResult retrieveEnvironmentInfo(RetrieveEnvironmentInfoRequest request)
Retrieves the compiled information from a RequestEnvironmentInfo request.
Related Topics
retrieveEnvironmentInfo
in interface AWSElasticBeanstalk
retrieveEnvironmentInfoRequest
- Request to download logs retrieved with RequestEnvironmentInfo.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); RetrieveEnvironmentInfoRequest request = new RetrieveEnvironmentInfoRequest().withEnvironmentName("my-env").withInfoType("tail"); RetrieveEnvironmentInfoResult response = client.retrieveEnvironmentInfo(request);
public SwapEnvironmentCNAMEsResult swapEnvironmentCNAMEs(SwapEnvironmentCNAMEsRequest request)
Swaps the CNAMEs of two environments.
swapEnvironmentCNAMEs
in interface AWSElasticBeanstalk
swapEnvironmentCNAMEsRequest
- Swaps the CNAMEs of two environments.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); SwapEnvironmentCNAMEsRequest request = new SwapEnvironmentCNAMEsRequest().withSourceEnvironmentName("my-env-blue").withDestinationEnvironmentName( "my-env-green"); SwapEnvironmentCNAMEsResult response = client.swapEnvironmentCNAMEs(request);
public SwapEnvironmentCNAMEsResult swapEnvironmentCNAMEs()
AWSElasticBeanstalk
swapEnvironmentCNAMEs
in interface AWSElasticBeanstalk
AWSElasticBeanstalk.swapEnvironmentCNAMEs(SwapEnvironmentCNAMEsRequest)
public TerminateEnvironmentResult terminateEnvironment(TerminateEnvironmentRequest request)
Terminates the specified environment.
terminateEnvironment
in interface AWSElasticBeanstalk
terminateEnvironmentRequest
- Request to terminate an environment.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); TerminateEnvironmentRequest request = new TerminateEnvironmentRequest().withEnvironmentName("my-env"); TerminateEnvironmentResult response = client.terminateEnvironment(request);
public UpdateApplicationResult updateApplication(UpdateApplicationRequest request)
Updates the specified application to have the specified properties.
If a property (for example, description
) is not provided, the value remains unchanged. To clear
these properties, specify an empty string.
updateApplication
in interface AWSElasticBeanstalk
updateApplicationRequest
- Request to update an application.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); UpdateApplicationRequest request = new UpdateApplicationRequest().withApplicationName("my-app").withDescription("my Elastic Beanstalk application"); UpdateApplicationResult response = client.updateApplication(request);
public UpdateApplicationResourceLifecycleResult updateApplicationResourceLifecycle(UpdateApplicationResourceLifecycleRequest request)
Modifies lifecycle settings for an application.
updateApplicationResourceLifecycle
in interface AWSElasticBeanstalk
updateApplicationResourceLifecycleRequest
- InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.public UpdateApplicationVersionResult updateApplicationVersion(UpdateApplicationVersionRequest request)
Updates the specified application version to have the specified properties.
If a property (for example, description
) is not provided, the value remains unchanged. To clear
properties, specify an empty string.
updateApplicationVersion
in interface AWSElasticBeanstalk
updateApplicationVersionRequest
- AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); UpdateApplicationVersionRequest request = new UpdateApplicationVersionRequest().withApplicationName("my-app") .withVersionLabel("22a0-stage-150819_185942").withDescription("new description"); UpdateApplicationVersionResult response = client.updateApplicationVersion(request);
public UpdateConfigurationTemplateResult updateConfigurationTemplate(UpdateConfigurationTemplateRequest request)
Updates the specified configuration template to have the specified properties or configuration option values.
If a property (for example, ApplicationName
) is not provided, its value remains unchanged. To clear
such properties, specify an empty string.
Related Topics
updateConfigurationTemplate
in interface AWSElasticBeanstalk
updateConfigurationTemplateRequest
- The result message containing the options for the specified solution stack.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.TooManyBucketsException
- The specified account has reached its limit of Amazon S3 buckets.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); UpdateConfigurationTemplateRequest request = new UpdateConfigurationTemplateRequest().withApplicationName("my-app").withTemplateName("my-template") .withOptionsToRemove(new OptionSpecification().withNamespace("aws:elasticbeanstalk:healthreporting:system").withOptionName("ConfigDocument")); UpdateConfigurationTemplateResult response = client.updateConfigurationTemplate(request);
public UpdateEnvironmentResult updateEnvironment(UpdateEnvironmentRequest request)
Updates the environment description, deploys a new application version, updates the configuration settings to an entirely new configuration template, or updates select configuration option values in the running environment.
Attempting to update both the release and configuration is not allowed and AWS Elastic Beanstalk returns an
InvalidParameterCombination
error.
When updating the configuration settings to a new template or individual settings, a draft configuration is
created and DescribeConfigurationSettings for this environment returns two setting descriptions with
different DeploymentStatus
values.
updateEnvironment
in interface AWSElasticBeanstalk
updateEnvironmentRequest
- Request to update an environment.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.TooManyBucketsException
- The specified account has reached its limit of Amazon S3 buckets.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); UpdateEnvironmentRequest request = new UpdateEnvironmentRequest().withEnvironmentName("my-env").withVersionLabel("v2"); UpdateEnvironmentResult response = client.updateEnvironment(request);AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); UpdateEnvironmentRequest request = new UpdateEnvironmentRequest().withEnvironmentName("my-env").withOptionSettings( new ConfigurationOptionSetting().withNamespace("aws:elb:healthcheck").withOptionName("Interval").withValue("15"), new ConfigurationOptionSetting().withNamespace("aws:elb:healthcheck").withOptionName("Timeout").withValue("8"), new ConfigurationOptionSetting().withNamespace("aws:elb:healthcheck").withOptionName("HealthyThreshold").withValue("2"), new ConfigurationOptionSetting().withNamespace("aws:elb:healthcheck").withOptionName("UnhealthyThreshold").withValue("3")); UpdateEnvironmentResult response = client.updateEnvironment(request);
public UpdateTagsForResourceResult updateTagsForResource(UpdateTagsForResourceRequest request)
Update the list of tags applied to an AWS Elastic Beanstalk resource. Two lists can be passed:
TagsToAdd
for tags to add or update, and TagsToRemove
.
Elastic Beanstalk supports tagging of all of its resources. For details about resource tagging, see Tagging Application Resources.
If you create a custom IAM user policy to control permission to this operation, specify one of the following two virtual actions (or both) instead of the API operation name:
Controls permission to call UpdateTagsForResource
and pass a list of tags to add in the
TagsToAdd
parameter.
Controls permission to call UpdateTagsForResource
and pass a list of tag keys to remove in the
TagsToRemove
parameter.
For details about creating a custom user policy, see Creating a Custom User Policy.
updateTagsForResource
in interface AWSElasticBeanstalk
updateTagsForResourceRequest
- InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.OperationInProgressException
- Unable to perform the specified operation because another operation that effects an element in this
activity is already in progress.TooManyTagsException
- The number of tags in the resource would exceed the number of tags that each resource can have.
To calculate this, the operation considers both the number of tags the resource already has and the tags this operation would add if it succeeded.
ResourceNotFoundException
- A resource doesn't exist for the specified Amazon Resource Name (ARN).ResourceTypeNotSupportedException
- The type of the specified Amazon Resource Name (ARN) isn't supported for this operation.public ValidateConfigurationSettingsResult validateConfigurationSettings(ValidateConfigurationSettingsRequest request)
Takes a set of configuration settings and either a configuration template or environment, and determines whether those values are valid.
This action returns a list of messages indicating any errors or warnings associated with the selection of option values.
validateConfigurationSettings
in interface AWSElasticBeanstalk
validateConfigurationSettingsRequest
- A list of validation messages for a specified configuration template.InsufficientPrivilegesException
- The specified account does not have sufficient privileges for one or more AWS services.TooManyBucketsException
- The specified account has reached its limit of Amazon S3 buckets.AWSElasticBeanstalk client = AWSElasticBeanstalkClientBuilder.standard().build(); ValidateConfigurationSettingsRequest request = new ValidateConfigurationSettingsRequest() .withApplicationName("my-app") .withEnvironmentName("my-env") .withOptionSettings( new ConfigurationOptionSetting() .withNamespace("aws:elasticbeanstalk:healthreporting:system") .withOptionName("ConfigDocument") .withValue( "{\"CloudWatchMetrics\": {\"Environment\": {\"ApplicationLatencyP99.9\": null,\"InstancesSevere\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": 60,\"InstancesUnknown\": 60,\"ApplicationLatencyP85\": 60,\"InstancesInfo\": null,\"ApplicationRequests2xx\": null,\"InstancesDegraded\": null,\"InstancesWarning\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": null,\"InstancesNoData\": null,\"InstancesPending\": 60,\"ApplicationLatencyP10\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": null,\"InstancesOk\": 60,\"ApplicationRequests3xx\": null,\"ApplicationRequests4xx\": null},\"Instance\": {\"ApplicationLatencyP99.9\": null,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": null,\"ApplicationLatencyP85\": null,\"CPUUser\": 60,\"ApplicationRequests2xx\": null,\"CPUIdle\": null,\"ApplicationLatencyP50\": null,\"ApplicationRequestsTotal\": 60,\"RootFilesystemUtil\": null,\"LoadAverage1min\": null,\"CPUIrq\": null,\"CPUNice\": 60,\"CPUIowait\": 60,\"ApplicationLatencyP10\": null,\"LoadAverage5min\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": 60,\"CPUSystem\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": null,\"InstanceHealth\": null,\"CPUSoftirq\": 60}},\"Version\": 1}")); ValidateConfigurationSettingsResult response = client.validateConfigurationSettings(request);
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 AWSElasticBeanstalk
request
- The originally executed requestpublic AWSElasticBeanstalkWaiters waiters()
waiters
in interface AWSElasticBeanstalk
public void shutdown()
AmazonWebServiceClient
shutdown
in interface AWSElasticBeanstalk
shutdown
in class AmazonWebServiceClient