amazonaws.com – elasticbeanstalk
AWS Elastic Beanstalk
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 details page. The location of the latest AWS Elastic Beanstalk WSDL is . 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 .
Endpoints
For a list of region-specific endpoints that AWS Elastic Beanstalk supports, go to in the Amazon Web Services Glossary.
- Homepage
- https://api.apis.guru/v2/specs/amazonaws.com:elasticbeanstalk/2010-12-01.json
- Provider
- amazonaws.com:elasticbeanstalk / elasticbeanstalk
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/amazonaws.com/elasticbeanstalk/2010-12-01/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/amazonaws.com/elasticbeanstalk/2010-12-01/openapi.yaml
Tools (96)
Extracted live via the executor SDK.
-
actionAbortEnvironmentUpdate.getAbortEnvironmentUpdateCancels in-progress environment configuration update or application version deployment.
-
actionAbortEnvironmentUpdate.postAbortEnvironmentUpdateCancels in-progress environment configuration update or application version deployment.
-
actionApplyEnvironmentManagedAction.getApplyEnvironmentManagedActionApplies 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 [blocked]. -
actionApplyEnvironmentManagedAction.postApplyEnvironmentManagedActionApplies 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 [blocked]. -
actionAssociateEnvironmentOperationsRole.getAssociateEnvironmentOperationsRoleAdd 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 in the AWS Elastic Beanstalk Developer Guide.
-
actionAssociateEnvironmentOperationsRole.postAssociateEnvironmentOperationsRoleAdd 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 in the AWS Elastic Beanstalk Developer Guide.
-
actionCheckDnsAvailability.getCheckDnsAvailabilityChecks if the specified CNAME is available.
-
actionCheckDnsAvailability.postCheckDnsAvailabilityChecks if the specified CNAME is available.
-
actionComposeEnvironments.getComposeEnvironmentsCreate 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 for details. -
actionComposeEnvironments.postComposeEnvironmentsCreate 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 for details. -
actionCreateApplication.getCreateApplicationCreates an application that has one configuration template named
defaultand no application versions. -
actionCreateApplication.postCreateApplicationCreates an application that has one configuration template named
defaultand no application versions. -
actionCreateApplicationVersion.getCreateApplicationVersionCreates 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
SourceBuildInformationandBuildConfiguration.Specify a source bundle in S3 with
SourceBundleOmit both
SourceBuildInformationandSourceBundleto 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.
-
actionCreateApplicationVersion.postCreateApplicationVersionCreates 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
SourceBuildInformationandBuildConfiguration.Specify a source bundle in S3 with
SourceBundleOmit both
SourceBuildInformationandSourceBundleto 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.
-
actionCreateConfigurationTemplate.getCreateConfigurationTemplateCreates 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
EnvironmentNameresponse element is alwaysnull.Related Topics
-
DescribeConfigurationOptions [blocked]
-
DescribeConfigurationSettings [blocked]
-
ListAvailableSolutionStacks [blocked]
-
-
actionCreateConfigurationTemplate.postCreateConfigurationTemplateCreates 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
EnvironmentNameresponse element is alwaysnull.Related Topics
-
DescribeConfigurationOptions [blocked]
-
DescribeConfigurationSettings [blocked]
-
ListAvailableSolutionStacks [blocked]
-
-
actionCreateEnvironment.getCreateEnvironmentLaunches an AWS Elastic Beanstalk environment for the specified application using the specified configuration.
-
actionCreateEnvironment.postCreateEnvironmentLaunches an AWS Elastic Beanstalk environment for the specified application using the specified configuration.
-
actionCreatePlatformVersion.getCreatePlatformVersionCreate a new version of your custom platform.
-
actionCreatePlatformVersion.postCreatePlatformVersionCreate a new version of your custom platform.
-
actionCreateStorageLocation.getCreateStorageLocationCreates 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,
CreateStorageLocationstill returns the bucket name but does not create a new bucket. -
actionCreateStorageLocation.postCreateStorageLocationCreates 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,
CreateStorageLocationstill returns the bucket name but does not create a new bucket. -
actionDeleteApplication.getDeleteApplicationDeletes 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.
-
actionDeleteApplication.postDeleteApplicationDeletes 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.
-
actionDeleteApplicationVersion.getDeleteApplicationVersionDeletes the specified version from the specified application.
You cannot delete an application version that is associated with a running environment.
-
actionDeleteApplicationVersion.postDeleteApplicationVersionDeletes the specified version from the specified application.
You cannot delete an application version that is associated with a running environment.
-
actionDeleteConfigurationTemplate.getDeleteConfigurationTemplateDeletes 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.
-
actionDeleteConfigurationTemplate.postDeleteConfigurationTemplateDeletes 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.
-
actionDeleteEnvironmentConfiguration.getDeleteEnvironmentConfigurationDeletes 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 [blocked] while the update is in progress or if the update fails. The
DeploymentStatusfor 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. -
actionDeleteEnvironmentConfiguration.postDeleteEnvironmentConfigurationDeletes 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 [blocked] while the update is in progress or if the update fails. The
DeploymentStatusfor 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. -
actionDeletePlatformVersion.getDeletePlatformVersionDeletes the specified version of a custom platform.
-
actionDeletePlatformVersion.postDeletePlatformVersionDeletes the specified version of a custom platform.
-
actionDescribeAccountAttributes.getDescribeAccountAttributesReturns attributes related to AWS Elastic Beanstalk that are associated with the calling AWS account.
The result currently has one set of attributes—resource quotas.
-
actionDescribeAccountAttributes.postDescribeAccountAttributesReturns attributes related to AWS Elastic Beanstalk that are associated with the calling AWS account.
The result currently has one set of attributes—resource quotas.
-
actionDescribeApplications.getDescribeApplicationsReturns the descriptions of existing applications.
-
actionDescribeApplications.postDescribeApplicationsReturns the descriptions of existing applications.
-
actionDescribeApplicationVersions.getDescribeApplicationVersionsRetrieve a list of application versions.
-
actionDescribeApplicationVersions.postDescribeApplicationVersionsRetrieve a list of application versions.
-
actionDescribeConfigurationOptions.getDescribeConfigurationOptionsDescribes 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.
-
actionDescribeConfigurationOptions.postDescribeConfigurationOptionsDescribes 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.
-
actionDescribeConfigurationSettings.getDescribeConfigurationSettingsReturns 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
-
DeleteEnvironmentConfiguration [blocked]
-
-
actionDescribeConfigurationSettings.postDescribeConfigurationSettingsReturns 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
-
DeleteEnvironmentConfiguration [blocked]
-
-
actionDescribeEnvironmentHealth.getDescribeEnvironmentHealthReturns information about the overall health of the specified environment. The DescribeEnvironmentHealth operation is only available with AWS Elastic Beanstalk Enhanced Health.
-
actionDescribeEnvironmentHealth.postDescribeEnvironmentHealthReturns information about the overall health of the specified environment. The DescribeEnvironmentHealth operation is only available with AWS Elastic Beanstalk Enhanced Health.
-
actionDescribeEnvironmentManagedActionHistory.getDescribeEnvironmentManagedActionHistoryLists an environment's completed and failed managed actions.
-
actionDescribeEnvironmentManagedActionHistory.postDescribeEnvironmentManagedActionHistoryLists an environment's completed and failed managed actions.
-
actionDescribeEnvironmentManagedActions.getDescribeEnvironmentManagedActionsLists an environment's upcoming and in-progress managed actions.
-
actionDescribeEnvironmentManagedActions.postDescribeEnvironmentManagedActionsLists an environment's upcoming and in-progress managed actions.
-
actionDescribeEnvironmentResources.getDescribeEnvironmentResourcesReturns AWS resources for this environment.
-
actionDescribeEnvironmentResources.postDescribeEnvironmentResourcesReturns AWS resources for this environment.
-
actionDescribeEnvironments.getDescribeEnvironmentsReturns descriptions for existing environments.
-
actionDescribeEnvironments.postDescribeEnvironmentsReturns descriptions for existing environments.
-
actionDescribeEvents.getDescribeEventsReturns 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. -
actionDescribeEvents.postDescribeEventsReturns 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. -
actionDescribeInstancesHealth.getDescribeInstancesHealthRetrieves detailed information about the health of instances in your AWS Elastic Beanstalk. This operation requires .
-
actionDescribeInstancesHealth.postDescribeInstancesHealthRetrieves detailed information about the health of instances in your AWS Elastic Beanstalk. This operation requires .
-
actionDescribePlatformVersion.getDescribePlatformVersionDescribes a platform version. Provides full details. Compare to ListPlatformVersions [blocked], which provides summary information about a list of platform versions.
For definitions of platform version and other platform-related terms, see .
-
actionDescribePlatformVersion.postDescribePlatformVersionDescribes a platform version. Provides full details. Compare to ListPlatformVersions [blocked], which provides summary information about a list of platform versions.
For definitions of platform version and other platform-related terms, see .
-
actionDisassociateEnvironmentOperationsRole.getDisassociateEnvironmentOperationsRoleDisassociate 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 in the AWS Elastic Beanstalk Developer Guide.
-
actionDisassociateEnvironmentOperationsRole.postDisassociateEnvironmentOperationsRoleDisassociate 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 in the AWS Elastic Beanstalk Developer Guide.
-
actionListAvailableSolutionStacks.getListAvailableSolutionStacksReturns a list of the available solution stack names, with the public version first and then in reverse chronological order.
-
actionListAvailableSolutionStacks.postListAvailableSolutionStacksReturns a list of the available solution stack names, with the public version first and then in reverse chronological order.
-
actionListPlatformBranches.getListPlatformBranchesLists 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 .
-
actionListPlatformBranches.postListPlatformBranchesLists 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 .
-
actionListPlatformVersions.getListPlatformVersionsLists the platform versions available for your account in an AWS Region. Provides summary information about each platform version. Compare to DescribePlatformVersion [blocked], which provides full details about a single platform version.
For definitions of platform version and other platform-related terms, see .
-
actionListPlatformVersions.postListPlatformVersionsLists the platform versions available for your account in an AWS Region. Provides summary information about each platform version. Compare to DescribePlatformVersion [blocked], which provides full details about a single platform version.
For definitions of platform version and other platform-related terms, see .
-
actionListTagsForResource.getListTagsForResourceReturn 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 .
-
actionListTagsForResource.postListTagsForResourceReturn 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 .
-
actionRebuildEnvironment.getRebuildEnvironmentDeletes and recreates all of the AWS resources (for example: the Auto Scaling group, load balancer, etc.) for a specified environment and forces a restart.
-
actionRebuildEnvironment.postRebuildEnvironmentDeletes and recreates all of the AWS resources (for example: the Auto Scaling group, load balancer, etc.) for a specified environment and forces a restart.
-
actionRequestEnvironmentInfo.getRequestEnvironmentInfoInitiates a request to compile the specified type of information of the deployed environment.
Setting the
InfoTypetotailcompiles the last lines from the application server log files of every Amazon EC2 instance in your environment.Setting the
InfoTypetobundlecompresses the application server log files for every Amazon EC2 instance into a.zipfile. Legacy and .NET containers do not support bundle logs.Use RetrieveEnvironmentInfo [blocked] to obtain the set of logs.
Related Topics
-
RetrieveEnvironmentInfo [blocked]
-
-
actionRequestEnvironmentInfo.postRequestEnvironmentInfoInitiates a request to compile the specified type of information of the deployed environment.
Setting the
InfoTypetotailcompiles the last lines from the application server log files of every Amazon EC2 instance in your environment.Setting the
InfoTypetobundlecompresses the application server log files for every Amazon EC2 instance into a.zipfile. Legacy and .NET containers do not support bundle logs.Use RetrieveEnvironmentInfo [blocked] to obtain the set of logs.
Related Topics
-
RetrieveEnvironmentInfo [blocked]
-
-
actionRestartAppServer.getRestartAppServerCauses the environment to restart the application container server running on each Amazon EC2 instance.
-
actionRestartAppServer.postRestartAppServerCauses the environment to restart the application container server running on each Amazon EC2 instance.
-
actionRetrieveEnvironmentInfo.getRetrieveEnvironmentInfoRetrieves the compiled information from a RequestEnvironmentInfo [blocked] request.
Related Topics
-
RequestEnvironmentInfo [blocked]
-
-
actionRetrieveEnvironmentInfo.postRetrieveEnvironmentInfoRetrieves the compiled information from a RequestEnvironmentInfo [blocked] request.
Related Topics
-
RequestEnvironmentInfo [blocked]
-
-
actionSwapEnvironmentCnamEs.getSwapEnvironmentCnamEsSwaps the CNAMEs of two environments.
-
actionSwapEnvironmentCnamEs.postSwapEnvironmentCnamEsSwaps the CNAMEs of two environments.
-
actionTerminateEnvironment.getTerminateEnvironmentTerminates the specified environment.
-
actionTerminateEnvironment.postTerminateEnvironmentTerminates the specified environment.
-
actionUpdateApplication.getUpdateApplicationUpdates 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. -
actionUpdateApplication.postUpdateApplicationUpdates 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. -
actionUpdateApplicationResourceLifecycle.getUpdateApplicationResourceLifecycleModifies lifecycle settings for an application.
-
actionUpdateApplicationResourceLifecycle.postUpdateApplicationResourceLifecycleModifies lifecycle settings for an application.
-
actionUpdateApplicationVersion.getUpdateApplicationVersionUpdates 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. -
actionUpdateApplicationVersion.postUpdateApplicationVersionUpdates 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. -
actionUpdateConfigurationTemplate.getUpdateConfigurationTemplateUpdates 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
-
DescribeConfigurationOptions [blocked]
-
-
actionUpdateConfigurationTemplate.postUpdateConfigurationTemplateUpdates 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
-
DescribeConfigurationOptions [blocked]
-
-
actionUpdateEnvironment.getUpdateEnvironmentUpdates 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
InvalidParameterCombinationerror.When updating the configuration settings to a new template or individual settings, a draft configuration is created and DescribeConfigurationSettings [blocked] for this environment returns two setting descriptions with different
DeploymentStatusvalues. -
actionUpdateEnvironment.postUpdateEnvironmentUpdates 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
InvalidParameterCombinationerror.When updating the configuration settings to a new template or individual settings, a draft configuration is created and DescribeConfigurationSettings [blocked] for this environment returns two setting descriptions with different
DeploymentStatusvalues. -
actionUpdateTagsForResource.getUpdateTagsForResourceUpdate the list of tags applied to an AWS Elastic Beanstalk resource. Two lists can be passed:
TagsToAddfor tags to add or update, andTagsToRemove.Elastic Beanstalk supports tagging of all of its resources. For details about resource tagging, see .
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:
- elasticbeanstalk:AddTags
-
Controls permission to call
UpdateTagsForResourceand pass a list of tags to add in theTagsToAddparameter. - elasticbeanstalk:RemoveTags
-
Controls permission to call
UpdateTagsForResourceand pass a list of tag keys to remove in theTagsToRemoveparameter.
For details about creating a custom user policy, see .
-
actionUpdateTagsForResource.postUpdateTagsForResourceUpdate the list of tags applied to an AWS Elastic Beanstalk resource. Two lists can be passed:
TagsToAddfor tags to add or update, andTagsToRemove.Elastic Beanstalk supports tagging of all of its resources. For details about resource tagging, see .
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:
- elasticbeanstalk:AddTags
-
Controls permission to call
UpdateTagsForResourceand pass a list of tags to add in theTagsToAddparameter. - elasticbeanstalk:RemoveTags
-
Controls permission to call
UpdateTagsForResourceand pass a list of tag keys to remove in theTagsToRemoveparameter.
For details about creating a custom user policy, see .
-
actionValidateConfigurationSettings.getValidateConfigurationSettingsTakes 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.
-
actionValidateConfigurationSettings.postValidateConfigurationSettingsTakes 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.
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools