Copyright | (c) 2013-2021 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Terminates the specified environment.
Synopsis
- data TerminateEnvironment = TerminateEnvironment' {}
- newTerminateEnvironment :: TerminateEnvironment
- terminateEnvironment_forceTerminate :: Lens' TerminateEnvironment (Maybe Bool)
- terminateEnvironment_terminateResources :: Lens' TerminateEnvironment (Maybe Bool)
- terminateEnvironment_environmentName :: Lens' TerminateEnvironment (Maybe Text)
- terminateEnvironment_environmentId :: Lens' TerminateEnvironment (Maybe Text)
- data EnvironmentDescription = EnvironmentDescription' {
- status :: Maybe EnvironmentStatus
- cname :: Maybe Text
- templateName :: Maybe Text
- abortableOperationInProgress :: Maybe Bool
- endpointURL :: Maybe Text
- resources :: Maybe EnvironmentResourcesDescription
- dateUpdated :: Maybe ISO8601
- dateCreated :: Maybe ISO8601
- health :: Maybe EnvironmentHealth
- versionLabel :: Maybe Text
- operationsRole :: Maybe Text
- platformArn :: Maybe Text
- tier :: Maybe EnvironmentTier
- environmentName :: Maybe Text
- applicationName :: Maybe Text
- environmentArn :: Maybe Text
- solutionStackName :: Maybe Text
- environmentId :: Maybe Text
- healthStatus :: Maybe EnvironmentHealthStatus
- environmentLinks :: Maybe [EnvironmentLink]
- description :: Maybe Text
- newEnvironmentDescription :: EnvironmentDescription
- environmentDescription_status :: Lens' EnvironmentDescription (Maybe EnvironmentStatus)
- environmentDescription_cname :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_templateName :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_abortableOperationInProgress :: Lens' EnvironmentDescription (Maybe Bool)
- environmentDescription_endpointURL :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_resources :: Lens' EnvironmentDescription (Maybe EnvironmentResourcesDescription)
- environmentDescription_dateUpdated :: Lens' EnvironmentDescription (Maybe UTCTime)
- environmentDescription_dateCreated :: Lens' EnvironmentDescription (Maybe UTCTime)
- environmentDescription_health :: Lens' EnvironmentDescription (Maybe EnvironmentHealth)
- environmentDescription_versionLabel :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_operationsRole :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_platformArn :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_tier :: Lens' EnvironmentDescription (Maybe EnvironmentTier)
- environmentDescription_environmentName :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_applicationName :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_environmentArn :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_solutionStackName :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_environmentId :: Lens' EnvironmentDescription (Maybe Text)
- environmentDescription_healthStatus :: Lens' EnvironmentDescription (Maybe EnvironmentHealthStatus)
- environmentDescription_environmentLinks :: Lens' EnvironmentDescription (Maybe [EnvironmentLink])
- environmentDescription_description :: Lens' EnvironmentDescription (Maybe Text)
Creating a Request
data TerminateEnvironment Source #
Request to terminate an environment.
See: newTerminateEnvironment
smart constructor.
TerminateEnvironment' | |
|
Instances
newTerminateEnvironment :: TerminateEnvironment Source #
Create a value of TerminateEnvironment
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:forceTerminate:TerminateEnvironment'
, terminateEnvironment_forceTerminate
- Terminates the target environment even if another environment in the
same group is dependent on it.
$sel:terminateResources:TerminateEnvironment'
, terminateEnvironment_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
$sel:environmentName:TerminateEnvironment'
, terminateEnvironment_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.
$sel:environmentId:TerminateEnvironment'
, terminateEnvironment_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.
Request Lenses
terminateEnvironment_forceTerminate :: Lens' TerminateEnvironment (Maybe Bool) Source #
Terminates the target environment even if another environment in the same group is dependent on it.
terminateEnvironment_terminateResources :: Lens' TerminateEnvironment (Maybe Bool) Source #
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
terminateEnvironment_environmentName :: Lens' TerminateEnvironment (Maybe Text) Source #
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.
terminateEnvironment_environmentId :: Lens' TerminateEnvironment (Maybe Text) Source #
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.
Destructuring the Response
data EnvironmentDescription Source #
Describes the properties of an environment.
See: newEnvironmentDescription
smart constructor.
EnvironmentDescription' | |
|
Instances
newEnvironmentDescription :: EnvironmentDescription Source #
Create a value of EnvironmentDescription
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:status:EnvironmentDescription'
, environmentDescription_status
- The current operational status of the environment:
Launching
: Environment is in the process of initial deployment.Updating
: Environment is in the process of updating its configuration settings or application version.Ready
: Environment is available to have an action performed on it, such as update or terminate.Terminating
: Environment is in the shut-down process.Terminated
: Environment is not running.
$sel:cname:EnvironmentDescription'
, environmentDescription_cname
- The URL to the CNAME for this environment.
$sel:templateName:EnvironmentDescription'
, environmentDescription_templateName
- The name of the configuration template used to originally launch this
environment.
$sel:abortableOperationInProgress:EnvironmentDescription'
, environmentDescription_abortableOperationInProgress
- Indicates if there is an in-progress environment configuration update or
application version deployment that you can cancel.
true:
There is an update in progress.
false:
There are no updates currently in progress.
$sel:endpointURL:EnvironmentDescription'
, environmentDescription_endpointURL
- For load-balanced, autoscaling environments, the URL to the
LoadBalancer. For single-instance environments, the IP address of the
instance.
$sel:resources:EnvironmentDescription'
, environmentDescription_resources
- The description of the AWS resources used by this environment.
$sel:dateUpdated:EnvironmentDescription'
, environmentDescription_dateUpdated
- The last modified date for this environment.
$sel:dateCreated:EnvironmentDescription'
, environmentDescription_dateCreated
- The creation date for this environment.
$sel:health:EnvironmentDescription'
, environmentDescription_health
- Describes the health status of the environment. AWS Elastic Beanstalk
indicates the failure levels for a running environment:
Red
: Indicates the environment is not responsive. Occurs when three or more consecutive failures occur for an environment.Yellow
: Indicates that something is wrong. Occurs when two consecutive failures occur for an environment.Green
: Indicates the environment is healthy and fully functional.Grey
: Default health for a new environment. The environment is not fully launched and health checks have not started or health checks are suspended during anUpdateEnvironment
orRestartEnvironment
request.
Default: Grey
$sel:versionLabel:EnvironmentDescription'
, environmentDescription_versionLabel
- The application version deployed in this environment.
$sel:operationsRole:EnvironmentDescription'
, environmentDescription_operationsRole
- The Amazon Resource Name (ARN) of the environment's operations role.
For more information, see
Operations roles
in the AWS Elastic Beanstalk Developer Guide.
$sel:platformArn:EnvironmentDescription'
, environmentDescription_platformArn
- The ARN of the platform version.
$sel:tier:EnvironmentDescription'
, environmentDescription_tier
- Describes the current tier of this environment.
$sel:environmentName:EnvironmentDescription'
, environmentDescription_environmentName
- The name of this environment.
$sel:applicationName:EnvironmentDescription'
, environmentDescription_applicationName
- The name of the application associated with this environment.
$sel:environmentArn:EnvironmentDescription'
, environmentDescription_environmentArn
- The environment's Amazon Resource Name (ARN), which can be used in
other API requests that require an ARN.
$sel:solutionStackName:EnvironmentDescription'
, environmentDescription_solutionStackName
- The name of the SolutionStack
deployed with this environment.
$sel:environmentId:EnvironmentDescription'
, environmentDescription_environmentId
- The ID of this environment.
$sel:healthStatus:EnvironmentDescription'
, environmentDescription_healthStatus
- Returns the health status of the application running in your
environment. For more information, see
Health Colors and Statuses.
$sel:environmentLinks:EnvironmentDescription'
, environmentDescription_environmentLinks
- A list of links to other environments in the same group.
$sel:description:EnvironmentDescription'
, environmentDescription_description
- Describes this environment.
Response Lenses
environmentDescription_status :: Lens' EnvironmentDescription (Maybe EnvironmentStatus) Source #
The current operational status of the environment:
Launching
: Environment is in the process of initial deployment.Updating
: Environment is in the process of updating its configuration settings or application version.Ready
: Environment is available to have an action performed on it, such as update or terminate.Terminating
: Environment is in the shut-down process.Terminated
: Environment is not running.
environmentDescription_cname :: Lens' EnvironmentDescription (Maybe Text) Source #
The URL to the CNAME for this environment.
environmentDescription_templateName :: Lens' EnvironmentDescription (Maybe Text) Source #
The name of the configuration template used to originally launch this environment.
environmentDescription_abortableOperationInProgress :: Lens' EnvironmentDescription (Maybe Bool) Source #
Indicates if there is an in-progress environment configuration update or application version deployment that you can cancel.
true:
There is an update in progress.
false:
There are no updates currently in progress.
environmentDescription_endpointURL :: Lens' EnvironmentDescription (Maybe Text) Source #
For load-balanced, autoscaling environments, the URL to the LoadBalancer. For single-instance environments, the IP address of the instance.
environmentDescription_resources :: Lens' EnvironmentDescription (Maybe EnvironmentResourcesDescription) Source #
The description of the AWS resources used by this environment.
environmentDescription_dateUpdated :: Lens' EnvironmentDescription (Maybe UTCTime) Source #
The last modified date for this environment.
environmentDescription_dateCreated :: Lens' EnvironmentDescription (Maybe UTCTime) Source #
The creation date for this environment.
environmentDescription_health :: Lens' EnvironmentDescription (Maybe EnvironmentHealth) Source #
Describes the health status of the environment. AWS Elastic Beanstalk indicates the failure levels for a running environment:
Red
: Indicates the environment is not responsive. Occurs when three or more consecutive failures occur for an environment.Yellow
: Indicates that something is wrong. Occurs when two consecutive failures occur for an environment.Green
: Indicates the environment is healthy and fully functional.Grey
: Default health for a new environment. The environment is not fully launched and health checks have not started or health checks are suspended during anUpdateEnvironment
orRestartEnvironment
request.
Default: Grey
environmentDescription_versionLabel :: Lens' EnvironmentDescription (Maybe Text) Source #
The application version deployed in this environment.
environmentDescription_operationsRole :: Lens' EnvironmentDescription (Maybe Text) Source #
The Amazon Resource Name (ARN) of the environment's operations role. For more information, see Operations roles in the AWS Elastic Beanstalk Developer Guide.
environmentDescription_platformArn :: Lens' EnvironmentDescription (Maybe Text) Source #
The ARN of the platform version.
environmentDescription_tier :: Lens' EnvironmentDescription (Maybe EnvironmentTier) Source #
Describes the current tier of this environment.
environmentDescription_environmentName :: Lens' EnvironmentDescription (Maybe Text) Source #
The name of this environment.
environmentDescription_applicationName :: Lens' EnvironmentDescription (Maybe Text) Source #
The name of the application associated with this environment.
environmentDescription_environmentArn :: Lens' EnvironmentDescription (Maybe Text) Source #
The environment's Amazon Resource Name (ARN), which can be used in other API requests that require an ARN.
environmentDescription_solutionStackName :: Lens' EnvironmentDescription (Maybe Text) Source #
The name of the SolutionStack
deployed with this environment.
environmentDescription_environmentId :: Lens' EnvironmentDescription (Maybe Text) Source #
The ID of this environment.
environmentDescription_healthStatus :: Lens' EnvironmentDescription (Maybe EnvironmentHealthStatus) Source #
Returns the health status of the application running in your environment. For more information, see Health Colors and Statuses.
environmentDescription_environmentLinks :: Lens' EnvironmentDescription (Maybe [EnvironmentLink]) Source #
A list of links to other environments in the same group.
environmentDescription_description :: Lens' EnvironmentDescription (Maybe Text) Source #
Describes this environment.