Elastic Beanstalk
This page documents function available when using the Elastic_Beanstalk
module, created with @service Elastic_Beanstalk
.
Index
Main.Elastic_Beanstalk.abort_environment_update
Main.Elastic_Beanstalk.apply_environment_managed_action
Main.Elastic_Beanstalk.associate_environment_operations_role
Main.Elastic_Beanstalk.check_dnsavailability
Main.Elastic_Beanstalk.compose_environments
Main.Elastic_Beanstalk.create_application
Main.Elastic_Beanstalk.create_application_version
Main.Elastic_Beanstalk.create_configuration_template
Main.Elastic_Beanstalk.create_environment
Main.Elastic_Beanstalk.create_platform_version
Main.Elastic_Beanstalk.create_storage_location
Main.Elastic_Beanstalk.delete_application
Main.Elastic_Beanstalk.delete_application_version
Main.Elastic_Beanstalk.delete_configuration_template
Main.Elastic_Beanstalk.delete_environment_configuration
Main.Elastic_Beanstalk.delete_platform_version
Main.Elastic_Beanstalk.describe_account_attributes
Main.Elastic_Beanstalk.describe_application_versions
Main.Elastic_Beanstalk.describe_applications
Main.Elastic_Beanstalk.describe_configuration_options
Main.Elastic_Beanstalk.describe_configuration_settings
Main.Elastic_Beanstalk.describe_environment_health
Main.Elastic_Beanstalk.describe_environment_managed_action_history
Main.Elastic_Beanstalk.describe_environment_managed_actions
Main.Elastic_Beanstalk.describe_environment_resources
Main.Elastic_Beanstalk.describe_environments
Main.Elastic_Beanstalk.describe_events
Main.Elastic_Beanstalk.describe_instances_health
Main.Elastic_Beanstalk.describe_platform_version
Main.Elastic_Beanstalk.disassociate_environment_operations_role
Main.Elastic_Beanstalk.list_available_solution_stacks
Main.Elastic_Beanstalk.list_platform_branches
Main.Elastic_Beanstalk.list_platform_versions
Main.Elastic_Beanstalk.list_tags_for_resource
Main.Elastic_Beanstalk.rebuild_environment
Main.Elastic_Beanstalk.request_environment_info
Main.Elastic_Beanstalk.restart_app_server
Main.Elastic_Beanstalk.retrieve_environment_info
Main.Elastic_Beanstalk.swap_environment_cnames
Main.Elastic_Beanstalk.terminate_environment
Main.Elastic_Beanstalk.update_application
Main.Elastic_Beanstalk.update_application_resource_lifecycle
Main.Elastic_Beanstalk.update_application_version
Main.Elastic_Beanstalk.update_configuration_template
Main.Elastic_Beanstalk.update_environment
Main.Elastic_Beanstalk.update_tags_for_resource
Main.Elastic_Beanstalk.validate_configuration_settings
Documentation
Main.Elastic_Beanstalk.abort_environment_update
— Methodabort_environment_update()
abort_environment_update(params::Dict{String,<:Any})
Cancels in-progress environment configuration update or application version deployment.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: This specifies the ID of the environment with the in-progress update that you want to cancel."EnvironmentName"
: This specifies the name of the environment with the in-progress update that you want to cancel.
Main.Elastic_Beanstalk.apply_environment_managed_action
— Methodapply_environment_managed_action(action_id)
apply_environment_managed_action(action_id, params::Dict{String,<:Any})
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.
Arguments
action_id
: The action ID of the scheduled managed action to execute.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The environment ID of the target environment."EnvironmentName"
: The name of the target environment.
Main.Elastic_Beanstalk.associate_environment_operations_role
— Methodassociate_environment_operations_role(environment_name, operations_role)
associate_environment_operations_role(environment_name, operations_role, params::Dict{String,<:Any})
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.
Arguments
environment_name
: The name of the environment to which to set the operations role.operations_role
: The Amazon Resource Name (ARN) of an existing IAM role to be used as the environment's operations role.
Main.Elastic_Beanstalk.check_dnsavailability
— Methodcheck_dnsavailability(cnameprefix)
check_dnsavailability(cnameprefix, params::Dict{String,<:Any})
Checks if the specified CNAME is available.
Arguments
cnameprefix
: The prefix used when this CNAME is reserved.
Main.Elastic_Beanstalk.compose_environments
— Methodcompose_environments()
compose_environments(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ApplicationName"
: The name of the application to which the specified source bundles belong."GroupName"
: The name of the group to which the target environments belong. Specify a group name only if the environment name defined in each target environment's manifest ends with a + (plus) character. See Environment Manifest (env.yaml) for details."VersionLabels"
: A list of version labels, specifying one or more application source bundles that belong to the target application. Each source bundle must include an environment manifest that specifies the name of the environment and the name of the solution stack to use, and optionally can specify environment links to create.
Main.Elastic_Beanstalk.create_application
— Methodcreate_application(application_name)
create_application(application_name, params::Dict{String,<:Any})
Creates an application that has one configuration template named default and no application versions.
Arguments
application_name
: The name of the application. Must be unique within your account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"Description"
: Your description of the application."ResourceLifecycleConfig"
: Specifies an application resource lifecycle configuration to prevent your application from accumulating too many versions."Tags"
: Specifies the tags applied to the application. Elastic Beanstalk applies these tags only to the application. Environments that you create in the application don't inherit the tags.
Main.Elastic_Beanstalk.create_application_version
— Methodcreate_application_version(application_name, version_label)
create_application_version(application_name, version_label, params::Dict{String,<:Any})
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.
Arguments
application_name
: The name of the application. If no application is found with this name, and AutoCreateApplication is false, returns an InvalidParameterValue error.version_label
: A label identifying this version. Constraint: Must be unique per application. If an application version already exists with this label for the specified application, AWS Elastic Beanstalk returns an InvalidParameterValue error.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AutoCreateApplication"
: Set to true to create an application with the specified name if it doesn't already exist."BuildConfiguration"
: Settings for an AWS CodeBuild build."Description"
: A description of this application version."Process"
: Pre-processes and validates the environment manifest (env.yaml) and configuration files (*.config files in the .ebextensions folder) in the source bundle. Validating configuration files can identify issues prior to deploying the application version to an environment. You must turn processing on for application versions that you create using AWS CodeBuild or AWS CodeCommit. For application versions built from a source bundle in Amazon S3, processing is optional. The Process option validates Elastic Beanstalk configuration files. It doesn't validate your application's configuration files, like proxy server or Docker configuration."SourceBuildInformation"
: Specify a commit in an AWS CodeCommit Git repository to use as the source code for the application version."SourceBundle"
: The Amazon S3 bucket and key that identify the location of the source bundle for this version. The Amazon S3 bucket must be in the same region as the environment. Specify a source bundle in S3 or a commit in an AWS CodeCommit repository (with SourceBuildInformation), but not both. If neither SourceBundle nor SourceBuildInformation are provided, Elastic Beanstalk uses a sample application."Tags"
: Specifies the tags applied to the application version. Elastic Beanstalk applies these tags only to the application version. Environments that use the application version don't inherit the tags.
Main.Elastic_Beanstalk.create_configuration_template
— Methodcreate_configuration_template(application_name, template_name)
create_configuration_template(application_name, template_name, params::Dict{String,<:Any})
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 DescribeConfigurationOptions DescribeConfigurationSettings ListAvailableSolutionStacks
Arguments
application_name
: The name of the Elastic Beanstalk application to associate with this configuration template.template_name
: The name of the configuration template. Constraint: This name must be unique per application.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"Description"
: An optional description for this configuration."EnvironmentId"
: The ID of an environment whose settings you want to use to create the configuration template. You must specify EnvironmentId if you don't specify PlatformArn, SolutionStackName, or SourceConfiguration."OptionSettings"
: Option values for the Elastic Beanstalk configuration, such as the instance type. If specified, these values override the values obtained from the solution stack or the source configuration template. For a complete list of Elastic Beanstalk configuration options, see Option Values in the AWS Elastic Beanstalk Developer Guide."PlatformArn"
: The Amazon Resource Name (ARN) of the custom platform. For more information, see Custom Platforms in the AWS Elastic Beanstalk Developer Guide. If you specify PlatformArn, then don't specify SolutionStackName."SolutionStackName"
: The name of an Elastic Beanstalk solution stack (platform version) that this configuration uses. For example, 64bit Amazon Linux 2013.09 running Tomcat 7 Java- A solution stack specifies the operating system, runtime, and application server for a
"SourceConfiguration"
: An Elastic Beanstalk configuration template to base this one on. If specified, Elastic Beanstalk uses the configuration values from the specified configuration template to create a new configuration. Values specified in OptionSettings override any values obtained from the SourceConfiguration. You must specify SourceConfiguration if you don't specify PlatformArn, EnvironmentId, or SolutionStackName. Constraint: If both solution stack name and source configuration are specified, the solution stack of the source configuration template must match the specified solution stack name."Tags"
: Specifies the tags applied to the configuration template.
Main.Elastic_Beanstalk.create_environment
— Methodcreate_environment(application_name)
create_environment(application_name, params::Dict{String,<:Any})
Launches an AWS Elastic Beanstalk environment for the specified application using the specified configuration.
Arguments
application_name
: The name of the application that is associated with this environment.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"CNAMEPrefix"
: If specified, the environment attempts to use this value as the prefix for the CNAME in your Elastic Beanstalk environment URL. If not specified, the CNAME is generated automatically by appending a random alphanumeric string to the environment name."Description"
: Your description for this environment."EnvironmentName"
: A unique name for the environment. Constraint: Must be from 4 to 40 characters in length. The name can contain only letters, numbers, and hyphens. It can't start or end with a hyphen. This name must be unique within a region in your account. If the specified name already exists in the region, Elastic Beanstalk returns an InvalidParameterValue error. If you don't specify the CNAMEPrefix parameter, the environment name becomes part of the CNAME, and therefore part of the visible URL for your application."GroupName"
: The name of the group to which the target environment belongs. Specify a group name only if the environment's name is specified in an environment manifest and not with the environment name parameter. See Environment Manifest (env.yaml) for details."OperationsRole"
: The Amazon Resource Name (ARN) of an existing IAM role to be used as the environment's operations role. If specified, Elastic Beanstalk uses the operations role for permissions to downstream services during this call and during subsequent calls acting on this environment. To specify an operations role, you must have the iam:PassRole permission for the role. For more information, see Operations roles in the AWS Elastic Beanstalk Developer Guide."OptionSettings"
: If specified, AWS Elastic Beanstalk sets the specified configuration options to the requested value in the configuration set for the new environment. These override the values obtained from the solution stack or the configuration template."OptionsToRemove"
: A list of custom user-defined configuration options to remove from the configuration set for this new environment."PlatformArn"
: The Amazon Resource Name (ARN) of the custom platform to use with the environment. For more information, see Custom Platforms in the AWS Elastic Beanstalk Developer Guide. If you specify PlatformArn, don't specify SolutionStackName."SolutionStackName"
: The name of an Elastic Beanstalk solution stack (platform version) to use with the environment. If specified, Elastic Beanstalk sets the configuration values to the default values associated with the specified solution stack. For a list of current solution stacks, see Elastic Beanstalk Supported Platforms in the AWS Elastic Beanstalk Platforms guide. If you specify SolutionStackName, don't specify PlatformArn or TemplateName."Tags"
: Specifies the tags applied to resources in the environment."TemplateName"
: The name of the Elastic Beanstalk configuration template to use with the environment. If you specify TemplateName, then don't specify SolutionStackName."Tier"
: Specifies the tier to use in creating this environment. The environment tier that you choose determines whether Elastic Beanstalk provisions resources to support a web application that handles HTTP(S) requests or a web application that handles background-processing tasks."VersionLabel"
: The name of the application version to deploy. Default: If not specified, Elastic Beanstalk attempts to deploy the sample application.
Main.Elastic_Beanstalk.create_platform_version
— Methodcreate_platform_version(platform_definition_bundle, platform_name, platform_version)
create_platform_version(platform_definition_bundle, platform_name, platform_version, params::Dict{String,<:Any})
Create a new version of your custom platform.
Arguments
platform_definition_bundle
: The location of the platform definition archive in Amazon S3.platform_name
: The name of your custom platform.platform_version
: The number, such as 1.0.2, for the new platform version.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentName"
: The name of the builder environment."OptionSettings"
: The configuration option settings to apply to the builder environment."Tags"
: Specifies the tags applied to the new platform version. Elastic Beanstalk applies these tags only to the platform version. Environments that you create using the platform version don't inherit the tags.
Main.Elastic_Beanstalk.create_storage_location
— Methodcreate_storage_location()
create_storage_location(params::Dict{String,<:Any})
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.
Main.Elastic_Beanstalk.delete_application
— Methoddelete_application(application_name)
delete_application(application_name, params::Dict{String,<:Any})
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.
Arguments
application_name
: The name of the application to delete.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"TerminateEnvByForce"
: When set to true, running environments will be terminated before deleting the application.
Main.Elastic_Beanstalk.delete_application_version
— Methoddelete_application_version(application_name, version_label)
delete_application_version(application_name, version_label, params::Dict{String,<:Any})
Deletes the specified version from the specified application. You cannot delete an application version that is associated with a running environment.
Arguments
application_name
: The name of the application to which the version belongs.version_label
: The label of the version to delete.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"DeleteSourceBundle"
: Set to true to delete the source bundle from your storage bucket. Otherwise, the application version is deleted only from Elastic Beanstalk and the source bundle remains in Amazon S3.
Main.Elastic_Beanstalk.delete_configuration_template
— Methoddelete_configuration_template(application_name, template_name)
delete_configuration_template(application_name, template_name, params::Dict{String,<:Any})
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.
Arguments
application_name
: The name of the application to delete the configuration template from.template_name
: The name of the configuration template to delete.
Main.Elastic_Beanstalk.delete_environment_configuration
— Methoddelete_environment_configuration(application_name, environment_name)
delete_environment_configuration(application_name, environment_name, params::Dict{String,<:Any})
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.
Arguments
application_name
: The name of the application the environment is associated with.environment_name
: The name of the environment to delete the draft configuration from.
Main.Elastic_Beanstalk.delete_platform_version
— Methoddelete_platform_version()
delete_platform_version(params::Dict{String,<:Any})
Deletes the specified version of a custom platform.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"PlatformArn"
: The ARN of the version of the custom platform.
Main.Elastic_Beanstalk.describe_account_attributes
— Methoddescribe_account_attributes()
describe_account_attributes(params::Dict{String,<:Any})
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.
Main.Elastic_Beanstalk.describe_application_versions
— Methoddescribe_application_versions()
describe_application_versions(params::Dict{String,<:Any})
Retrieve a list of application versions.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ApplicationName"
: Specify an application name to show only application versions for that application."MaxRecords"
: For a paginated request. Specify a maximum number of application versions to include in each response. If no MaxRecords is specified, all available application versions are retrieved in a single response."NextToken"
: For a paginated request. Specify a token from a previous response page to retrieve the next response page. All other parameter values must be identical to the ones specified in the initial request. If no NextToken is specified, the first page is retrieved."VersionLabels"
: Specify a version label to show a specific application version.
Main.Elastic_Beanstalk.describe_applications
— Methoddescribe_applications()
describe_applications(params::Dict{String,<:Any})
Returns the descriptions of existing applications.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ApplicationNames"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to only include those with the specified names.
Main.Elastic_Beanstalk.describe_configuration_options
— Methoddescribe_configuration_options()
describe_configuration_options(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ApplicationName"
: The name of the application associated with the configuration template or environment. Only needed if you want to describe the configuration options associated with either the configuration template or environment."EnvironmentName"
: The name of the environment whose configuration options you want to describe."Options"
: If specified, restricts the descriptions to only the specified options."PlatformArn"
: The ARN of the custom platform."SolutionStackName"
: The name of the solution stack whose configuration options you want to describe."TemplateName"
: The name of the configuration template whose configuration options you want to describe.
Main.Elastic_Beanstalk.describe_configuration_settings
— Methoddescribe_configuration_settings(application_name)
describe_configuration_settings(application_name, params::Dict{String,<:Any})
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 DeleteEnvironmentConfiguration
Arguments
application_name
: The application for the environment or configuration template.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentName"
: The name of the environment to describe. Condition: You must specify either this or a TemplateName, but not both. If you specify both, AWS Elastic Beanstalk returns an InvalidParameterCombination error. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."TemplateName"
: The name of the configuration template to describe. Conditional: You must specify either this parameter or an EnvironmentName, but not both. If you specify both, AWS Elastic Beanstalk returns an InvalidParameterCombination error. If you do not specify either, AWS Elastic Beanstalk returns a MissingRequiredParameter error.
Main.Elastic_Beanstalk.describe_environment_health
— Methoddescribe_environment_health()
describe_environment_health(params::Dict{String,<:Any})
Returns information about the overall health of the specified environment. The DescribeEnvironmentHealth operation is only available with AWS Elastic Beanstalk Enhanced Health.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AttributeNames"
: Specify the response elements to return. To retrieve all attributes, set to All. If no attribute names are specified, returns the name of the environment."EnvironmentId"
: Specify the environment by ID. You must specify either this or an EnvironmentName, or both."EnvironmentName"
: Specify the environment by name. You must specify either this or an EnvironmentName, or both.
Main.Elastic_Beanstalk.describe_environment_managed_action_history
— Methoddescribe_environment_managed_action_history()
describe_environment_managed_action_history(params::Dict{String,<:Any})
Lists an environment's completed and failed managed actions.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The environment ID of the target environment."EnvironmentName"
: The name of the target environment."MaxItems"
: The maximum number of items to return for a single request."NextToken"
: The pagination token returned by a previous request.
Main.Elastic_Beanstalk.describe_environment_managed_actions
— Methoddescribe_environment_managed_actions()
describe_environment_managed_actions(params::Dict{String,<:Any})
Lists an environment's upcoming and in-progress managed actions.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The environment ID of the target environment."EnvironmentName"
: The name of the target environment."Status"
: To show only actions with a particular status, specify a status.
Main.Elastic_Beanstalk.describe_environment_resources
— Methoddescribe_environment_resources()
describe_environment_resources(params::Dict{String,<:Any})
Returns AWS resources for this environment.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The ID of the environment to retrieve AWS resource usage data. Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."EnvironmentName"
: The name of the environment to retrieve AWS resource usage data. Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.
Main.Elastic_Beanstalk.describe_environments
— Methoddescribe_environments()
describe_environments(params::Dict{String,<:Any})
Returns descriptions for existing environments.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ApplicationName"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those that are associated with this application."EnvironmentIds"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those that have the specified IDs."EnvironmentNames"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those that have the specified names."IncludeDeleted"
: Indicates whether to include deleted environments: true: Environments that have been deleted after IncludedDeletedBackTo are displayed. false: Do not include deleted environments."IncludedDeletedBackTo"
: If specified when IncludeDeleted is set to true, then environments deleted after this date are displayed."MaxRecords"
: For a paginated request. Specify a maximum number of environments to include in each response. If no MaxRecords is specified, all available environments are retrieved in a single response."NextToken"
: For a paginated request. Specify a token from a previous response page to retrieve the next response page. All other parameter values must be identical to the ones specified in the initial request. If no NextToken is specified, the first page is retrieved."VersionLabel"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those that are associated with this application version.
Main.Elastic_Beanstalk.describe_events
— Methoddescribe_events()
describe_events(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ApplicationName"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to include only those associated with this application."EndTime"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that occur up to, but not including, the EndTime."EnvironmentId"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this environment."EnvironmentName"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this environment."MaxRecords"
: Specifies the maximum number of events that can be returned, beginning with the most recent event."NextToken"
: Pagination token. If specified, the events return the next batch of results."PlatformArn"
: The ARN of a custom platform version. If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this custom platform version."RequestId"
: If specified, AWS Elastic Beanstalk restricts the described events to include only those associated with this request ID."Severity"
: If specified, limits the events returned from this call to include only those with the specified severity or higher."StartTime"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that occur on or after this time."TemplateName"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to those that are associated with this environment configuration."VersionLabel"
: If specified, AWS Elastic Beanstalk restricts the returned descriptions to those associated with this application version.
Main.Elastic_Beanstalk.describe_instances_health
— Methoddescribe_instances_health()
describe_instances_health(params::Dict{String,<:Any})
Retrieves detailed information about the health of instances in your AWS Elastic Beanstalk. This operation requires enhanced health reporting.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AttributeNames"
: Specifies the response elements you wish to receive. To retrieve all attributes, set to All. If no attribute names are specified, returns a list of instances."EnvironmentId"
: Specify the AWS Elastic Beanstalk environment by ID."EnvironmentName"
: Specify the AWS Elastic Beanstalk environment by name."NextToken"
: Specify the pagination token returned by a previous call.
Main.Elastic_Beanstalk.describe_platform_version
— Methoddescribe_platform_version()
describe_platform_version(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"PlatformArn"
: The ARN of the platform version.
Main.Elastic_Beanstalk.disassociate_environment_operations_role
— Methoddisassociate_environment_operations_role(environment_name)
disassociate_environment_operations_role(environment_name, params::Dict{String,<:Any})
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.
Arguments
environment_name
: The name of the environment from which to disassociate the operations role.
Main.Elastic_Beanstalk.list_available_solution_stacks
— Methodlist_available_solution_stacks()
list_available_solution_stacks(params::Dict{String,<:Any})
Returns a list of the available solution stack names, with the public version first and then in reverse chronological order.
Main.Elastic_Beanstalk.list_platform_branches
— Methodlist_platform_branches()
list_platform_branches(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"Filters"
: Criteria for restricting the resulting list of platform branches. The filter is evaluated as a logical conjunction (AND) of the separate SearchFilter terms. The following list shows valid attribute values for each of the SearchFilter terms. Most operators take a single value. The in and notin operators can take multiple values. Attribute = BranchName: Operator: = | != | beginswith | endswith | contains | in | notin Attribute = LifecycleState: Operator: = | != | in | notin Values: beta | supported | deprecated | retired Attribute = PlatformName: Operator: = | != | beginswith | endswith | contains | in | notin Attribute = TierType: Operator: = | != Values: WebServer/Standard | Worker/SQS/HTTP Array size: limited to 10 SearchFilter objects. Within each SearchFilter item, the Values array is limited to 10 items."MaxRecords"
: The maximum number of platform branch values returned in one call."NextToken"
: For a paginated request. Specify a token from a previous response page to retrieve the next response page. All other parameter values must be identical to the ones specified in the initial request. If no NextToken is specified, the first page is retrieved.
Main.Elastic_Beanstalk.list_platform_versions
— Methodlist_platform_versions()
list_platform_versions(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"Filters"
: Criteria for restricting the resulting list of platform versions. The filter is interpreted as a logical conjunction (AND) of the separate PlatformFilter terms."MaxRecords"
: The maximum number of platform version values returned in one call."NextToken"
: For a paginated request. Specify a token from a previous response page to retrieve the next response page. All other parameter values must be identical to the ones specified in the initial request. If no NextToken is specified, the first page is retrieved.
Main.Elastic_Beanstalk.list_tags_for_resource
— Methodlist_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})
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.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the resouce for which a tag list is requested. Must be the ARN of an Elastic Beanstalk resource.
Main.Elastic_Beanstalk.rebuild_environment
— Methodrebuild_environment()
rebuild_environment(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The ID of the environment to rebuild. Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."EnvironmentName"
: The name of the environment to rebuild. Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.
Main.Elastic_Beanstalk.request_environment_info
— Methodrequest_environment_info(info_type)
request_environment_info(info_type, params::Dict{String,<:Any})
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 RetrieveEnvironmentInfo
Arguments
info_type
: The type of information to request.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The ID of the environment of the requested data. If no such environment is found, RequestEnvironmentInfo returns an InvalidParameterValue error. Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."EnvironmentName"
: The name of the environment of the requested data. If no such environment is found, RequestEnvironmentInfo returns an InvalidParameterValue error. Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.
Main.Elastic_Beanstalk.restart_app_server
— Methodrestart_app_server()
restart_app_server(params::Dict{String,<:Any})
Causes the environment to restart the application container server running on each Amazon EC2 instance.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The ID of the environment to restart the server for. Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."EnvironmentName"
: The name of the environment to restart the server for. Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.
Main.Elastic_Beanstalk.retrieve_environment_info
— Methodretrieve_environment_info(info_type)
retrieve_environment_info(info_type, params::Dict{String,<:Any})
Retrieves the compiled information from a RequestEnvironmentInfo request. Related Topics RequestEnvironmentInfo
Arguments
info_type
: The type of information to retrieve.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The ID of the data's environment. If no such environment is found, returns an InvalidParameterValue error. Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."EnvironmentName"
: The name of the data's environment. If no such environment is found, returns an InvalidParameterValue error. Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error.
Main.Elastic_Beanstalk.swap_environment_cnames
— Methodswap_environment_cnames()
swap_environment_cnames(params::Dict{String,<:Any})
Swaps the CNAMEs of two environments.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"DestinationEnvironmentId"
: The ID of the destination environment. Condition: You must specify at least the DestinationEnvironmentID or the DestinationEnvironmentName. You may also specify both. You must specify the SourceEnvironmentId with the DestinationEnvironmentId."DestinationEnvironmentName"
: The name of the destination environment. Condition: You must specify at least the DestinationEnvironmentID or the DestinationEnvironmentName. You may also specify both. You must specify the SourceEnvironmentName with the DestinationEnvironmentName."SourceEnvironmentId"
: The ID of the source environment. Condition: You must specify at least the SourceEnvironmentID or the SourceEnvironmentName. You may also specify both. If you specify the SourceEnvironmentId, you must specify the DestinationEnvironmentId."SourceEnvironmentName"
: The name of the source environment. Condition: You must specify at least the SourceEnvironmentID or the SourceEnvironmentName. You may also specify both. If you specify the SourceEnvironmentName, you must specify the DestinationEnvironmentName.
Main.Elastic_Beanstalk.terminate_environment
— Methodterminate_environment()
terminate_environment(params::Dict{String,<:Any})
Terminates the specified environment.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentId"
: The ID of the environment to terminate. Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."EnvironmentName"
: The name of the environment to terminate. Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."ForceTerminate"
: Terminates the target environment even if another environment in the same group is dependent on it."TerminateResources"
: Indicates whether the associated AWS resources should shut down when the environment is terminated: true: The specified environment as well as the associated AWS resources, such as Auto Scaling group and LoadBalancer, are terminated. false: AWS Elastic Beanstalk resource management is removed from the environment, but the AWS resources continue to operate. For more information, see the AWS Elastic Beanstalk User Guide. Default: true Valid Values: true | false
Main.Elastic_Beanstalk.update_application
— Methodupdate_application(application_name)
update_application(application_name, params::Dict{String,<:Any})
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.
Arguments
application_name
: The name of the application to update. If no such application is found, UpdateApplication returns an InvalidParameterValue error.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"Description"
: A new description for the application. Default: If not specified, AWS Elastic Beanstalk does not update the description.
Main.Elastic_Beanstalk.update_application_resource_lifecycle
— Methodupdate_application_resource_lifecycle(application_name, resource_lifecycle_config)
update_application_resource_lifecycle(application_name, resource_lifecycle_config, params::Dict{String,<:Any})
Modifies lifecycle settings for an application.
Arguments
application_name
: The name of the application.resource_lifecycle_config
: The lifecycle configuration.
Main.Elastic_Beanstalk.update_application_version
— Methodupdate_application_version(application_name, version_label)
update_application_version(application_name, version_label, params::Dict{String,<:Any})
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.
Arguments
application_name
: The name of the application associated with this version. If no application is found with this name, UpdateApplication returns an InvalidParameterValue error.version_label
: The name of the version to update. If no application version is found with this label, UpdateApplication returns an InvalidParameterValue error.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"Description"
: A new description for this version.
Main.Elastic_Beanstalk.update_configuration_template
— Methodupdate_configuration_template(application_name, template_name)
update_configuration_template(application_name, template_name, params::Dict{String,<:Any})
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 DescribeConfigurationOptions
Arguments
application_name
: The name of the application associated with the configuration template to update. If no application is found with this name, UpdateConfigurationTemplate returns an InvalidParameterValue error.template_name
: The name of the configuration template to update. If no configuration template is found with this name, UpdateConfigurationTemplate returns an InvalidParameterValue error.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"Description"
: A new description for the configuration."OptionSettings"
: A list of configuration option settings to update with the new specified option value."OptionsToRemove"
: A list of configuration options to remove from the configuration set. Constraint: You can remove only UserDefined configuration options.
Main.Elastic_Beanstalk.update_environment
— Methodupdate_environment()
update_environment(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ApplicationName"
: The name of the application with which the environment is associated."Description"
: If this parameter is specified, AWS Elastic Beanstalk updates the description of this environment."EnvironmentId"
: The ID of the environment to update. If no environment with this ID exists, AWS Elastic Beanstalk returns an InvalidParameterValue error. Condition: You must specify either this or an EnvironmentName, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."EnvironmentName"
: The name of the environment to update. If no environment with this name exists, AWS Elastic Beanstalk returns an InvalidParameterValue error. Condition: You must specify either this or an EnvironmentId, or both. If you do not specify either, AWS Elastic Beanstalk returns MissingRequiredParameter error."GroupName"
: The name of the group to which the target environment belongs. Specify a group name only if the environment's name is specified in an environment manifest and not with the environment name or environment ID parameters. See Environment Manifest (env.yaml) for details."OptionSettings"
: If specified, AWS Elastic Beanstalk updates the configuration set associated with the running environment and sets the specified configuration options to the requested value."OptionsToRemove"
: A list of custom user-defined configuration options to remove from the configuration set for this environment."PlatformArn"
: The ARN of the platform, if used."SolutionStackName"
: This specifies the platform version that the environment will run after the environment is updated."TemplateName"
: If this parameter is specified, AWS Elastic Beanstalk deploys this configuration template to the environment. If no such configuration template is found, AWS Elastic Beanstalk returns an InvalidParameterValue error."Tier"
: This specifies the tier to use to update the environment. Condition: At this time, if you change the tier version, name, or type, AWS Elastic Beanstalk returns InvalidParameterValue error."VersionLabel"
: If this parameter is specified, AWS Elastic Beanstalk deploys the named application version to the environment. If no such application version is found, returns an InvalidParameterValue error.
Main.Elastic_Beanstalk.update_tags_for_resource
— Methodupdate_tags_for_resource(resource_arn)
update_tags_for_resource(resource_arn, params::Dict{String,<:Any})
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: elasticbeanstalk:AddTags Controls permission to call UpdateTagsForResource and pass a list of tags to add in the TagsToAdd parameter. elasticbeanstalk:RemoveTags 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.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the resouce to be updated. Must be the ARN of an Elastic Beanstalk resource.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"TagsToAdd"
: A list of tags to add or update. If a key of an existing tag is added, the tag's value is updated. Specify at least one of these parameters: TagsToAdd, TagsToRemove."TagsToRemove"
: A list of tag keys to remove. If a tag key doesn't exist, it is silently ignored. Specify at least one of these parameters: TagsToAdd, TagsToRemove.
Main.Elastic_Beanstalk.validate_configuration_settings
— Methodvalidate_configuration_settings(application_name, option_settings)
validate_configuration_settings(application_name, option_settings, params::Dict{String,<:Any})
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.
Arguments
application_name
: The name of the application that the configuration template or environment belongs to.option_settings
: A list of the options and desired values to evaluate.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EnvironmentName"
: The name of the environment to validate the settings against. Condition: You cannot specify both this and a configuration template name."TemplateName"
: The name of the configuration template to validate the settings against. Condition: You cannot specify both this and an environment name.