Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Retrieves the latest deployed configuration. This API may return empty configuration data if the client already has the latest version. For more information about this API action and to view example CLI commands that show how to use it with the StartConfigurationSession API action, see Receiving the configuration in the AppConfig User Guide.
Note the following important information.
- Each configuration token is only valid for one call to
GetLatestConfiguration
. TheGetLatestConfiguration
response includes aNextPollConfigurationToken
that should always replace the token used for the just-completed call in preparation for the next one. GetLatestConfiguration
is a priced call. For more information, see Pricing.
Synopsis
- data GetLatestConfiguration = GetLatestConfiguration' {}
- newGetLatestConfiguration :: Text -> GetLatestConfiguration
- getLatestConfiguration_configurationToken :: Lens' GetLatestConfiguration Text
- data GetLatestConfigurationResponse = GetLatestConfigurationResponse' {}
- newGetLatestConfigurationResponse :: Int -> GetLatestConfigurationResponse
- getLatestConfigurationResponse_configuration :: Lens' GetLatestConfigurationResponse (Maybe ByteString)
- getLatestConfigurationResponse_contentType :: Lens' GetLatestConfigurationResponse (Maybe Text)
- getLatestConfigurationResponse_nextPollConfigurationToken :: Lens' GetLatestConfigurationResponse (Maybe Text)
- getLatestConfigurationResponse_nextPollIntervalInSeconds :: Lens' GetLatestConfigurationResponse (Maybe Int)
- getLatestConfigurationResponse_httpStatus :: Lens' GetLatestConfigurationResponse Int
Creating a Request
data GetLatestConfiguration Source #
See: newGetLatestConfiguration
smart constructor.
GetLatestConfiguration' | |
|
Instances
newGetLatestConfiguration Source #
Create a value of GetLatestConfiguration
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:configurationToken:GetLatestConfiguration'
, getLatestConfiguration_configurationToken
- Token describing the current state of the configuration session. To
obtain a token, first call the StartConfigurationSession API. Note that
every call to GetLatestConfiguration
will return a new
ConfigurationToken
(NextPollConfigurationToken
in the response) and
MUST be provided to subsequent GetLatestConfiguration
API calls.
Request Lenses
getLatestConfiguration_configurationToken :: Lens' GetLatestConfiguration Text Source #
Token describing the current state of the configuration session. To
obtain a token, first call the StartConfigurationSession API. Note that
every call to GetLatestConfiguration
will return a new
ConfigurationToken
(NextPollConfigurationToken
in the response) and
MUST be provided to subsequent GetLatestConfiguration
API calls.
Destructuring the Response
data GetLatestConfigurationResponse Source #
See: newGetLatestConfigurationResponse
smart constructor.
GetLatestConfigurationResponse' | |
|
Instances
newGetLatestConfigurationResponse Source #
Create a value of GetLatestConfigurationResponse
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:configuration:GetLatestConfigurationResponse'
, getLatestConfigurationResponse_configuration
- The data of the configuration. This may be empty if the client already
has the latest version of configuration.
$sel:contentType:GetLatestConfigurationResponse'
, getLatestConfigurationResponse_contentType
- A standard MIME type describing the format of the configuration content.
$sel:nextPollConfigurationToken:GetLatestConfigurationResponse'
, getLatestConfigurationResponse_nextPollConfigurationToken
- The latest token describing the current state of the configuration
session. This MUST be provided to the next call to
GetLatestConfiguration.
$sel:nextPollIntervalInSeconds:GetLatestConfigurationResponse'
, getLatestConfigurationResponse_nextPollIntervalInSeconds
- The amount of time the client should wait before polling for
configuration updates again. Use RequiredMinimumPollIntervalInSeconds
to set the desired poll interval.
$sel:httpStatus:GetLatestConfigurationResponse'
, getLatestConfigurationResponse_httpStatus
- The response's http status code.
Response Lenses
getLatestConfigurationResponse_configuration :: Lens' GetLatestConfigurationResponse (Maybe ByteString) Source #
The data of the configuration. This may be empty if the client already has the latest version of configuration.
getLatestConfigurationResponse_contentType :: Lens' GetLatestConfigurationResponse (Maybe Text) Source #
A standard MIME type describing the format of the configuration content.
getLatestConfigurationResponse_nextPollConfigurationToken :: Lens' GetLatestConfigurationResponse (Maybe Text) Source #
The latest token describing the current state of the configuration
session. This MUST be provided to the next call to
GetLatestConfiguration.
getLatestConfigurationResponse_nextPollIntervalInSeconds :: Lens' GetLatestConfigurationResponse (Maybe Int) Source #
The amount of time the client should wait before polling for
configuration updates again. Use RequiredMinimumPollIntervalInSeconds
to set the desired poll interval.
getLatestConfigurationResponse_httpStatus :: Lens' GetLatestConfigurationResponse Int Source #
The response's http status code.