@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonAppConfigAsyncClient extends AmazonAppConfigClient implements AmazonAppConfigAsync
AsyncHandler
can be used to receive notification when
an asynchronous operation completes.
AppConfig feature flags and dynamic configurations help software builders quickly and securely adjust application behavior in production environments without full code deployments. AppConfig speeds up software release frequency, improves application resiliency, and helps you address emergent issues more quickly. With feature flags, you can gradually release new capabilities to users and measure the impact of those changes before fully deploying the new capabilities to all users. With operational flags and dynamic configurations, you can update block lists, allow lists, throttling limits, logging verbosity, and perform other operational tuning to quickly respond to issues in production environments.
AppConfig is a capability of Amazon Web Services Systems Manager.
Despite the fact that application configuration content can vary greatly from application to application, AppConfig supports the following use cases, which cover a broad spectrum of customer needs:
Feature flags and toggles - Safely release new capabilities to your customers in a controlled environment. Instantly roll back changes if you experience a problem.
Application tuning - Carefully introduce application changes while testing the impact of those changes with users in production environments.
Allow list or block list - Control access to premium features or instantly block specific users without deploying new code.
Centralized configuration storage - Keep your configuration data organized and consistent across all of your workloads. You can use AppConfig to deploy configuration data stored in the AppConfig hosted configuration store, Secrets Manager, Systems Manager, Parameter Store, or Amazon S3.
How AppConfig works
This section provides a high-level description of how AppConfig works and how you get started.
Before you start creating AppConfig artifacts, we recommend you identify configuration data in your code that you want to dynamically manage using AppConfig. Good examples include feature flags or toggles, allow and block lists, logging verbosity, service limits, and throttling rules, to name a few.
If your configuration data already exists in the cloud, you can take advantage of AppConfig validation, deployment, and extension features to further streamline configuration data management.
To create a namespace, you create an AppConfig artifact called an application. An application is simply an organizational construct like a folder.
For each AppConfig application, you define one or more environments. An environment is a logical grouping of targets,
such as applications in a Beta
or Production
environment, Lambda functions, or containers.
You can also define environments for application subcomponents, such as the Web
, Mobile
,
and Back-end
.
You can configure Amazon CloudWatch alarms for each environment. The system monitors alarms during a configuration deployment. If an alarm is triggered, the system rolls back the configuration.
A configuration profile includes, among other things, a URI that enables AppConfig to locate your configuration data
in its stored location and a profile type. AppConfig supports two configuration profile types: feature flags and
freeform configurations. Feature flag configuration profiles store their data in the AppConfig hosted configuration
store and the URI is simply hosted
. For freeform configuration profiles, you can store your data in the
AppConfig hosted configuration store or any Amazon Web Services service that integrates with AppConfig, as described
in
Creating a free form configuration profile in the the AppConfig User Guide.
A configuration profile can also include optional validators to ensure your configuration data is syntactically and semantically correct. AppConfig performs a check using the validators when you start a deployment. If any errors are detected, the deployment rolls back to the previous configuration data.
When you create a new deployment, you specify the following:
An application ID
A configuration profile ID
A configuration version
An environment ID where you want to deploy the configuration data
A deployment strategy ID that defines how fast you want the changes to take effect
When you call the StartDeployment API action, AppConfig performs the following tasks:
Retrieves the configuration data from the underlying data store by using the location URI in the configuration profile.
Verifies the configuration data is syntactically and semantically correct by using the validators you specified when you created your configuration profile.
Caches a copy of the data so it is ready to be retrieved by your application. This cached copy is called the deployed data.
You can configure AppConfig Agent as a local host and have the agent poll AppConfig for configuration updates. The agent calls the StartConfigurationSession and GetLatestConfiguration API actions and caches your configuration data locally. To retrieve the data, your application makes an HTTP call to the localhost server. AppConfig Agent supports several use cases, as described in Simplified retrieval methods in the the AppConfig User Guide.
If AppConfig Agent isn't supported for your use case, you can configure your application to poll AppConfig for configuration updates by directly calling the StartConfigurationSession and GetLatestConfiguration API actions.
This reference is intended to be used with the AppConfig User Guide.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
builder, createApplication, createConfigurationProfile, createDeploymentStrategy, createEnvironment, createExtension, createExtensionAssociation, createHostedConfigurationVersion, deleteApplication, deleteConfigurationProfile, deleteDeploymentStrategy, deleteEnvironment, deleteExtension, deleteExtensionAssociation, deleteHostedConfigurationVersion, getApplication, getCachedResponseMetadata, getConfiguration, getConfigurationProfile, getDeployment, getDeploymentStrategy, getEnvironment, getExtension, getExtensionAssociation, getHostedConfigurationVersion, listApplications, listConfigurationProfiles, listDeployments, listDeploymentStrategies, listEnvironments, listExtensionAssociations, listExtensions, listHostedConfigurationVersions, listTagsForResource, startDeployment, stopDeployment, tagResource, untagResource, updateApplication, updateConfigurationProfile, updateDeploymentStrategy, updateEnvironment, updateExtension, updateExtensionAssociation, validateConfiguration
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
createApplication, createConfigurationProfile, createDeploymentStrategy, createEnvironment, createExtension, createExtensionAssociation, createHostedConfigurationVersion, deleteApplication, deleteConfigurationProfile, deleteDeploymentStrategy, deleteEnvironment, deleteExtension, deleteExtensionAssociation, deleteHostedConfigurationVersion, getApplication, getCachedResponseMetadata, getConfiguration, getConfigurationProfile, getDeployment, getDeploymentStrategy, getEnvironment, getExtension, getExtensionAssociation, getHostedConfigurationVersion, listApplications, listConfigurationProfiles, listDeployments, listDeploymentStrategies, listEnvironments, listExtensionAssociations, listExtensions, listHostedConfigurationVersions, listTagsForResource, startDeployment, stopDeployment, tagResource, untagResource, updateApplication, updateConfigurationProfile, updateDeploymentStrategy, updateEnvironment, updateExtension, updateExtensionAssociation, validateConfiguration
public static AmazonAppConfigAsyncClientBuilder asyncBuilder()
public ExecutorService getExecutorService()
public Future<CreateApplicationResult> createApplicationAsync(CreateApplicationRequest request)
AmazonAppConfigAsync
Creates an application. In AppConfig, an application is simply an organizational construct like a folder. This organizational construct has a relationship with some unit of executable code. For example, you could create an application called MyMobileApp to organize and manage configuration data for a mobile application installed by your users.
createApplicationAsync
in interface AmazonAppConfigAsync
public Future<CreateApplicationResult> createApplicationAsync(CreateApplicationRequest request, AsyncHandler<CreateApplicationRequest,CreateApplicationResult> asyncHandler)
AmazonAppConfigAsync
Creates an application. In AppConfig, an application is simply an organizational construct like a folder. This organizational construct has a relationship with some unit of executable code. For example, you could create an application called MyMobileApp to organize and manage configuration data for a mobile application installed by your users.
createApplicationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateConfigurationProfileResult> createConfigurationProfileAsync(CreateConfigurationProfileRequest request)
AmazonAppConfigAsync
Creates a configuration profile, which is information that enables AppConfig to access the configuration source. Valid configuration sources include the following:
Configuration data in YAML, JSON, and other formats stored in the AppConfig hosted configuration store
Configuration data stored as objects in an Amazon Simple Storage Service (Amazon S3) bucket
Pipelines stored in CodePipeline
Secrets stored in Secrets Manager
Standard and secure string parameters stored in Amazon Web Services Systems Manager Parameter Store
Configuration data in SSM documents stored in the Systems Manager document store
A configuration profile includes the following information:
The URI location of the configuration data.
The Identity and Access Management (IAM) role that provides access to the configuration data.
A validator for the configuration data. Available validators include either a JSON Schema or an Amazon Web Services Lambda function.
For more information, see Create a Configuration and a Configuration Profile in the AppConfig User Guide.
createConfigurationProfileAsync
in interface AmazonAppConfigAsync
public Future<CreateConfigurationProfileResult> createConfigurationProfileAsync(CreateConfigurationProfileRequest request, AsyncHandler<CreateConfigurationProfileRequest,CreateConfigurationProfileResult> asyncHandler)
AmazonAppConfigAsync
Creates a configuration profile, which is information that enables AppConfig to access the configuration source. Valid configuration sources include the following:
Configuration data in YAML, JSON, and other formats stored in the AppConfig hosted configuration store
Configuration data stored as objects in an Amazon Simple Storage Service (Amazon S3) bucket
Pipelines stored in CodePipeline
Secrets stored in Secrets Manager
Standard and secure string parameters stored in Amazon Web Services Systems Manager Parameter Store
Configuration data in SSM documents stored in the Systems Manager document store
A configuration profile includes the following information:
The URI location of the configuration data.
The Identity and Access Management (IAM) role that provides access to the configuration data.
A validator for the configuration data. Available validators include either a JSON Schema or an Amazon Web Services Lambda function.
For more information, see Create a Configuration and a Configuration Profile in the AppConfig User Guide.
createConfigurationProfileAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateDeploymentStrategyResult> createDeploymentStrategyAsync(CreateDeploymentStrategyRequest request)
AmazonAppConfigAsync
Creates a deployment strategy that defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.
createDeploymentStrategyAsync
in interface AmazonAppConfigAsync
public Future<CreateDeploymentStrategyResult> createDeploymentStrategyAsync(CreateDeploymentStrategyRequest request, AsyncHandler<CreateDeploymentStrategyRequest,CreateDeploymentStrategyResult> asyncHandler)
AmazonAppConfigAsync
Creates a deployment strategy that defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.
createDeploymentStrategyAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateEnvironmentResult> createEnvironmentAsync(CreateEnvironmentRequest request)
AmazonAppConfigAsync
Creates an environment. For each application, you define one or more environments. An environment is a deployment
group of AppConfig targets, such as applications in a Beta
or Production
environment.
You can also define environments for application subcomponents such as the Web
, Mobile
and Back-end
components for your application. You can configure Amazon CloudWatch alarms for each
environment. The system monitors alarms during a configuration deployment. If an alarm is triggered, the system
rolls back the configuration.
createEnvironmentAsync
in interface AmazonAppConfigAsync
public Future<CreateEnvironmentResult> createEnvironmentAsync(CreateEnvironmentRequest request, AsyncHandler<CreateEnvironmentRequest,CreateEnvironmentResult> asyncHandler)
AmazonAppConfigAsync
Creates an environment. For each application, you define one or more environments. An environment is a deployment
group of AppConfig targets, such as applications in a Beta
or Production
environment.
You can also define environments for application subcomponents such as the Web
, Mobile
and Back-end
components for your application. You can configure Amazon CloudWatch alarms for each
environment. The system monitors alarms during a configuration deployment. If an alarm is triggered, the system
rolls back the configuration.
createEnvironmentAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateExtensionResult> createExtensionAsync(CreateExtensionRequest request)
AmazonAppConfigAsync
Creates an AppConfig extension. An extension augments your ability to inject logic or behavior at different points during the AppConfig workflow of creating or deploying a configuration.
You can create your own extensions or use the Amazon Web Services authored extensions provided by AppConfig. For
an AppConfig extension that uses Lambda, you must create a Lambda function to perform any computation and
processing defined in the extension. If you plan to create custom versions of the Amazon Web Services authored
notification extensions, you only need to specify an Amazon Resource Name (ARN) in the Uri
field for
the new extension version.
For a custom EventBridge notification extension, enter the ARN of the EventBridge default events in the
Uri
field.
For a custom Amazon SNS notification extension, enter the ARN of an Amazon SNS topic in the Uri
field.
For a custom Amazon SQS notification extension, enter the ARN of an Amazon SQS message queue in the
Uri
field.
For more information about extensions, see Extending workflows in the AppConfig User Guide.
createExtensionAsync
in interface AmazonAppConfigAsync
public Future<CreateExtensionResult> createExtensionAsync(CreateExtensionRequest request, AsyncHandler<CreateExtensionRequest,CreateExtensionResult> asyncHandler)
AmazonAppConfigAsync
Creates an AppConfig extension. An extension augments your ability to inject logic or behavior at different points during the AppConfig workflow of creating or deploying a configuration.
You can create your own extensions or use the Amazon Web Services authored extensions provided by AppConfig. For
an AppConfig extension that uses Lambda, you must create a Lambda function to perform any computation and
processing defined in the extension. If you plan to create custom versions of the Amazon Web Services authored
notification extensions, you only need to specify an Amazon Resource Name (ARN) in the Uri
field for
the new extension version.
For a custom EventBridge notification extension, enter the ARN of the EventBridge default events in the
Uri
field.
For a custom Amazon SNS notification extension, enter the ARN of an Amazon SNS topic in the Uri
field.
For a custom Amazon SQS notification extension, enter the ARN of an Amazon SQS message queue in the
Uri
field.
For more information about extensions, see Extending workflows in the AppConfig User Guide.
createExtensionAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateExtensionAssociationResult> createExtensionAssociationAsync(CreateExtensionAssociationRequest request)
AmazonAppConfigAsync
When you create an extension or configure an Amazon Web Services authored extension, you associate the extension
with an AppConfig application, environment, or configuration profile. For example, you can choose to run the
AppConfig deployment events to Amazon SNS
Amazon Web Services authored extension and receive
notifications on an Amazon SNS topic anytime a configuration deployment is started for a specific application.
Defining which extension to associate with an AppConfig resource is called an extension association. An
extension association is a specified relationship between an extension and an AppConfig resource, such as an
application or a configuration profile. For more information about extensions and associations, see Extending
workflows in the AppConfig User Guide.
createExtensionAssociationAsync
in interface AmazonAppConfigAsync
public Future<CreateExtensionAssociationResult> createExtensionAssociationAsync(CreateExtensionAssociationRequest request, AsyncHandler<CreateExtensionAssociationRequest,CreateExtensionAssociationResult> asyncHandler)
AmazonAppConfigAsync
When you create an extension or configure an Amazon Web Services authored extension, you associate the extension
with an AppConfig application, environment, or configuration profile. For example, you can choose to run the
AppConfig deployment events to Amazon SNS
Amazon Web Services authored extension and receive
notifications on an Amazon SNS topic anytime a configuration deployment is started for a specific application.
Defining which extension to associate with an AppConfig resource is called an extension association. An
extension association is a specified relationship between an extension and an AppConfig resource, such as an
application or a configuration profile. For more information about extensions and associations, see Extending
workflows in the AppConfig User Guide.
createExtensionAssociationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateHostedConfigurationVersionResult> createHostedConfigurationVersionAsync(CreateHostedConfigurationVersionRequest request)
AmazonAppConfigAsync
Creates a new configuration in the AppConfig hosted configuration store.
createHostedConfigurationVersionAsync
in interface AmazonAppConfigAsync
public Future<CreateHostedConfigurationVersionResult> createHostedConfigurationVersionAsync(CreateHostedConfigurationVersionRequest request, AsyncHandler<CreateHostedConfigurationVersionRequest,CreateHostedConfigurationVersionResult> asyncHandler)
AmazonAppConfigAsync
Creates a new configuration in the AppConfig hosted configuration store.
createHostedConfigurationVersionAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteApplicationResult> deleteApplicationAsync(DeleteApplicationRequest request)
AmazonAppConfigAsync
Deletes an application. Deleting an application does not delete a configuration from a host.
deleteApplicationAsync
in interface AmazonAppConfigAsync
public Future<DeleteApplicationResult> deleteApplicationAsync(DeleteApplicationRequest request, AsyncHandler<DeleteApplicationRequest,DeleteApplicationResult> asyncHandler)
AmazonAppConfigAsync
Deletes an application. Deleting an application does not delete a configuration from a host.
deleteApplicationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteConfigurationProfileResult> deleteConfigurationProfileAsync(DeleteConfigurationProfileRequest request)
AmazonAppConfigAsync
Deletes a configuration profile. Deleting a configuration profile does not delete a configuration from a host.
deleteConfigurationProfileAsync
in interface AmazonAppConfigAsync
public Future<DeleteConfigurationProfileResult> deleteConfigurationProfileAsync(DeleteConfigurationProfileRequest request, AsyncHandler<DeleteConfigurationProfileRequest,DeleteConfigurationProfileResult> asyncHandler)
AmazonAppConfigAsync
Deletes a configuration profile. Deleting a configuration profile does not delete a configuration from a host.
deleteConfigurationProfileAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteDeploymentStrategyResult> deleteDeploymentStrategyAsync(DeleteDeploymentStrategyRequest request)
AmazonAppConfigAsync
Deletes a deployment strategy. Deleting a deployment strategy does not delete a configuration from a host.
deleteDeploymentStrategyAsync
in interface AmazonAppConfigAsync
public Future<DeleteDeploymentStrategyResult> deleteDeploymentStrategyAsync(DeleteDeploymentStrategyRequest request, AsyncHandler<DeleteDeploymentStrategyRequest,DeleteDeploymentStrategyResult> asyncHandler)
AmazonAppConfigAsync
Deletes a deployment strategy. Deleting a deployment strategy does not delete a configuration from a host.
deleteDeploymentStrategyAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteEnvironmentResult> deleteEnvironmentAsync(DeleteEnvironmentRequest request)
AmazonAppConfigAsync
Deletes an environment. Deleting an environment does not delete a configuration from a host.
deleteEnvironmentAsync
in interface AmazonAppConfigAsync
public Future<DeleteEnvironmentResult> deleteEnvironmentAsync(DeleteEnvironmentRequest request, AsyncHandler<DeleteEnvironmentRequest,DeleteEnvironmentResult> asyncHandler)
AmazonAppConfigAsync
Deletes an environment. Deleting an environment does not delete a configuration from a host.
deleteEnvironmentAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteExtensionResult> deleteExtensionAsync(DeleteExtensionRequest request)
AmazonAppConfigAsync
Deletes an AppConfig extension. You must delete all associations to an extension before you delete the extension.
deleteExtensionAsync
in interface AmazonAppConfigAsync
public Future<DeleteExtensionResult> deleteExtensionAsync(DeleteExtensionRequest request, AsyncHandler<DeleteExtensionRequest,DeleteExtensionResult> asyncHandler)
AmazonAppConfigAsync
Deletes an AppConfig extension. You must delete all associations to an extension before you delete the extension.
deleteExtensionAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteExtensionAssociationResult> deleteExtensionAssociationAsync(DeleteExtensionAssociationRequest request)
AmazonAppConfigAsync
Deletes an extension association. This action doesn't delete extensions defined in the association.
deleteExtensionAssociationAsync
in interface AmazonAppConfigAsync
public Future<DeleteExtensionAssociationResult> deleteExtensionAssociationAsync(DeleteExtensionAssociationRequest request, AsyncHandler<DeleteExtensionAssociationRequest,DeleteExtensionAssociationResult> asyncHandler)
AmazonAppConfigAsync
Deletes an extension association. This action doesn't delete extensions defined in the association.
deleteExtensionAssociationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteHostedConfigurationVersionResult> deleteHostedConfigurationVersionAsync(DeleteHostedConfigurationVersionRequest request)
AmazonAppConfigAsync
Deletes a version of a configuration from the AppConfig hosted configuration store.
deleteHostedConfigurationVersionAsync
in interface AmazonAppConfigAsync
public Future<DeleteHostedConfigurationVersionResult> deleteHostedConfigurationVersionAsync(DeleteHostedConfigurationVersionRequest request, AsyncHandler<DeleteHostedConfigurationVersionRequest,DeleteHostedConfigurationVersionResult> asyncHandler)
AmazonAppConfigAsync
Deletes a version of a configuration from the AppConfig hosted configuration store.
deleteHostedConfigurationVersionAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetApplicationResult> getApplicationAsync(GetApplicationRequest request)
AmazonAppConfigAsync
Retrieves information about an application.
getApplicationAsync
in interface AmazonAppConfigAsync
public Future<GetApplicationResult> getApplicationAsync(GetApplicationRequest request, AsyncHandler<GetApplicationRequest,GetApplicationResult> asyncHandler)
AmazonAppConfigAsync
Retrieves information about an application.
getApplicationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.@Deprecated public Future<GetConfigurationResult> getConfigurationAsync(GetConfigurationRequest request)
AmazonAppConfigAsync
(Deprecated) Retrieves the latest deployed configuration.
Note the following important information.
This API action is deprecated. Calls to receive configuration data should use the StartConfigurationSession and GetLatestConfiguration APIs instead.
GetConfiguration
is a priced call. For more information, see Pricing.
getConfigurationAsync
in interface AmazonAppConfigAsync
@Deprecated public Future<GetConfigurationResult> getConfigurationAsync(GetConfigurationRequest request, AsyncHandler<GetConfigurationRequest,GetConfigurationResult> asyncHandler)
AmazonAppConfigAsync
(Deprecated) Retrieves the latest deployed configuration.
Note the following important information.
This API action is deprecated. Calls to receive configuration data should use the StartConfigurationSession and GetLatestConfiguration APIs instead.
GetConfiguration
is a priced call. For more information, see Pricing.
getConfigurationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetConfigurationProfileResult> getConfigurationProfileAsync(GetConfigurationProfileRequest request)
AmazonAppConfigAsync
Retrieves information about a configuration profile.
getConfigurationProfileAsync
in interface AmazonAppConfigAsync
public Future<GetConfigurationProfileResult> getConfigurationProfileAsync(GetConfigurationProfileRequest request, AsyncHandler<GetConfigurationProfileRequest,GetConfigurationProfileResult> asyncHandler)
AmazonAppConfigAsync
Retrieves information about a configuration profile.
getConfigurationProfileAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetDeploymentResult> getDeploymentAsync(GetDeploymentRequest request)
AmazonAppConfigAsync
Retrieves information about a configuration deployment.
getDeploymentAsync
in interface AmazonAppConfigAsync
public Future<GetDeploymentResult> getDeploymentAsync(GetDeploymentRequest request, AsyncHandler<GetDeploymentRequest,GetDeploymentResult> asyncHandler)
AmazonAppConfigAsync
Retrieves information about a configuration deployment.
getDeploymentAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetDeploymentStrategyResult> getDeploymentStrategyAsync(GetDeploymentStrategyRequest request)
AmazonAppConfigAsync
Retrieves information about a deployment strategy. A deployment strategy defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.
getDeploymentStrategyAsync
in interface AmazonAppConfigAsync
public Future<GetDeploymentStrategyResult> getDeploymentStrategyAsync(GetDeploymentStrategyRequest request, AsyncHandler<GetDeploymentStrategyRequest,GetDeploymentStrategyResult> asyncHandler)
AmazonAppConfigAsync
Retrieves information about a deployment strategy. A deployment strategy defines important criteria for rolling out your configuration to the designated targets. A deployment strategy includes the overall duration required, a percentage of targets to receive the deployment during each interval, an algorithm that defines how percentage grows, and bake time.
getDeploymentStrategyAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetEnvironmentResult> getEnvironmentAsync(GetEnvironmentRequest request)
AmazonAppConfigAsync
Retrieves information about an environment. An environment is a deployment group of AppConfig applications, such
as applications in a Production
environment or in an EU_Region
environment. Each
configuration deployment targets an environment. You can enable one or more Amazon CloudWatch alarms for an
environment. If an alarm is triggered during a deployment, AppConfig roles back the configuration.
getEnvironmentAsync
in interface AmazonAppConfigAsync
public Future<GetEnvironmentResult> getEnvironmentAsync(GetEnvironmentRequest request, AsyncHandler<GetEnvironmentRequest,GetEnvironmentResult> asyncHandler)
AmazonAppConfigAsync
Retrieves information about an environment. An environment is a deployment group of AppConfig applications, such
as applications in a Production
environment or in an EU_Region
environment. Each
configuration deployment targets an environment. You can enable one or more Amazon CloudWatch alarms for an
environment. If an alarm is triggered during a deployment, AppConfig roles back the configuration.
getEnvironmentAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetExtensionResult> getExtensionAsync(GetExtensionRequest request)
AmazonAppConfigAsync
Returns information about an AppConfig extension.
getExtensionAsync
in interface AmazonAppConfigAsync
public Future<GetExtensionResult> getExtensionAsync(GetExtensionRequest request, AsyncHandler<GetExtensionRequest,GetExtensionResult> asyncHandler)
AmazonAppConfigAsync
Returns information about an AppConfig extension.
getExtensionAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetExtensionAssociationResult> getExtensionAssociationAsync(GetExtensionAssociationRequest request)
AmazonAppConfigAsync
Returns information about an AppConfig extension association. For more information about extensions and associations, see Extending workflows in the AppConfig User Guide.
getExtensionAssociationAsync
in interface AmazonAppConfigAsync
public Future<GetExtensionAssociationResult> getExtensionAssociationAsync(GetExtensionAssociationRequest request, AsyncHandler<GetExtensionAssociationRequest,GetExtensionAssociationResult> asyncHandler)
AmazonAppConfigAsync
Returns information about an AppConfig extension association. For more information about extensions and associations, see Extending workflows in the AppConfig User Guide.
getExtensionAssociationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetHostedConfigurationVersionResult> getHostedConfigurationVersionAsync(GetHostedConfigurationVersionRequest request)
AmazonAppConfigAsync
Retrieves information about a specific configuration version.
getHostedConfigurationVersionAsync
in interface AmazonAppConfigAsync
public Future<GetHostedConfigurationVersionResult> getHostedConfigurationVersionAsync(GetHostedConfigurationVersionRequest request, AsyncHandler<GetHostedConfigurationVersionRequest,GetHostedConfigurationVersionResult> asyncHandler)
AmazonAppConfigAsync
Retrieves information about a specific configuration version.
getHostedConfigurationVersionAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListApplicationsResult> listApplicationsAsync(ListApplicationsRequest request)
AmazonAppConfigAsync
Lists all applications in your Amazon Web Services account.
listApplicationsAsync
in interface AmazonAppConfigAsync
public Future<ListApplicationsResult> listApplicationsAsync(ListApplicationsRequest request, AsyncHandler<ListApplicationsRequest,ListApplicationsResult> asyncHandler)
AmazonAppConfigAsync
Lists all applications in your Amazon Web Services account.
listApplicationsAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListConfigurationProfilesResult> listConfigurationProfilesAsync(ListConfigurationProfilesRequest request)
AmazonAppConfigAsync
Lists the configuration profiles for an application.
listConfigurationProfilesAsync
in interface AmazonAppConfigAsync
public Future<ListConfigurationProfilesResult> listConfigurationProfilesAsync(ListConfigurationProfilesRequest request, AsyncHandler<ListConfigurationProfilesRequest,ListConfigurationProfilesResult> asyncHandler)
AmazonAppConfigAsync
Lists the configuration profiles for an application.
listConfigurationProfilesAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListDeploymentStrategiesResult> listDeploymentStrategiesAsync(ListDeploymentStrategiesRequest request)
AmazonAppConfigAsync
Lists deployment strategies.
listDeploymentStrategiesAsync
in interface AmazonAppConfigAsync
public Future<ListDeploymentStrategiesResult> listDeploymentStrategiesAsync(ListDeploymentStrategiesRequest request, AsyncHandler<ListDeploymentStrategiesRequest,ListDeploymentStrategiesResult> asyncHandler)
AmazonAppConfigAsync
Lists deployment strategies.
listDeploymentStrategiesAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListDeploymentsResult> listDeploymentsAsync(ListDeploymentsRequest request)
AmazonAppConfigAsync
Lists the deployments for an environment in descending deployment number order.
listDeploymentsAsync
in interface AmazonAppConfigAsync
public Future<ListDeploymentsResult> listDeploymentsAsync(ListDeploymentsRequest request, AsyncHandler<ListDeploymentsRequest,ListDeploymentsResult> asyncHandler)
AmazonAppConfigAsync
Lists the deployments for an environment in descending deployment number order.
listDeploymentsAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListEnvironmentsResult> listEnvironmentsAsync(ListEnvironmentsRequest request)
AmazonAppConfigAsync
Lists the environments for an application.
listEnvironmentsAsync
in interface AmazonAppConfigAsync
public Future<ListEnvironmentsResult> listEnvironmentsAsync(ListEnvironmentsRequest request, AsyncHandler<ListEnvironmentsRequest,ListEnvironmentsResult> asyncHandler)
AmazonAppConfigAsync
Lists the environments for an application.
listEnvironmentsAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListExtensionAssociationsResult> listExtensionAssociationsAsync(ListExtensionAssociationsRequest request)
AmazonAppConfigAsync
Lists all AppConfig extension associations in the account. For more information about extensions and associations, see Extending workflows in the AppConfig User Guide.
listExtensionAssociationsAsync
in interface AmazonAppConfigAsync
public Future<ListExtensionAssociationsResult> listExtensionAssociationsAsync(ListExtensionAssociationsRequest request, AsyncHandler<ListExtensionAssociationsRequest,ListExtensionAssociationsResult> asyncHandler)
AmazonAppConfigAsync
Lists all AppConfig extension associations in the account. For more information about extensions and associations, see Extending workflows in the AppConfig User Guide.
listExtensionAssociationsAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListExtensionsResult> listExtensionsAsync(ListExtensionsRequest request)
AmazonAppConfigAsync
Lists all custom and Amazon Web Services authored AppConfig extensions in the account. For more information about extensions, see Extending workflows in the AppConfig User Guide.
listExtensionsAsync
in interface AmazonAppConfigAsync
public Future<ListExtensionsResult> listExtensionsAsync(ListExtensionsRequest request, AsyncHandler<ListExtensionsRequest,ListExtensionsResult> asyncHandler)
AmazonAppConfigAsync
Lists all custom and Amazon Web Services authored AppConfig extensions in the account. For more information about extensions, see Extending workflows in the AppConfig User Guide.
listExtensionsAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListHostedConfigurationVersionsResult> listHostedConfigurationVersionsAsync(ListHostedConfigurationVersionsRequest request)
AmazonAppConfigAsync
Lists configurations stored in the AppConfig hosted configuration store by version.
listHostedConfigurationVersionsAsync
in interface AmazonAppConfigAsync
public Future<ListHostedConfigurationVersionsResult> listHostedConfigurationVersionsAsync(ListHostedConfigurationVersionsRequest request, AsyncHandler<ListHostedConfigurationVersionsRequest,ListHostedConfigurationVersionsResult> asyncHandler)
AmazonAppConfigAsync
Lists configurations stored in the AppConfig hosted configuration store by version.
listHostedConfigurationVersionsAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest request)
AmazonAppConfigAsync
Retrieves the list of key-value tags assigned to the resource.
listTagsForResourceAsync
in interface AmazonAppConfigAsync
public Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest request, AsyncHandler<ListTagsForResourceRequest,ListTagsForResourceResult> asyncHandler)
AmazonAppConfigAsync
Retrieves the list of key-value tags assigned to the resource.
listTagsForResourceAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<StartDeploymentResult> startDeploymentAsync(StartDeploymentRequest request)
AmazonAppConfigAsync
Starts a deployment.
startDeploymentAsync
in interface AmazonAppConfigAsync
public Future<StartDeploymentResult> startDeploymentAsync(StartDeploymentRequest request, AsyncHandler<StartDeploymentRequest,StartDeploymentResult> asyncHandler)
AmazonAppConfigAsync
Starts a deployment.
startDeploymentAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<StopDeploymentResult> stopDeploymentAsync(StopDeploymentRequest request)
AmazonAppConfigAsync
Stops a deployment. This API action works only on deployments that have a status of DEPLOYING
. This
action moves the deployment to a status of ROLLED_BACK
.
stopDeploymentAsync
in interface AmazonAppConfigAsync
public Future<StopDeploymentResult> stopDeploymentAsync(StopDeploymentRequest request, AsyncHandler<StopDeploymentRequest,StopDeploymentResult> asyncHandler)
AmazonAppConfigAsync
Stops a deployment. This API action works only on deployments that have a status of DEPLOYING
. This
action moves the deployment to a status of ROLLED_BACK
.
stopDeploymentAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<TagResourceResult> tagResourceAsync(TagResourceRequest request)
AmazonAppConfigAsync
Assigns metadata to an AppConfig resource. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define. You can specify a maximum of 50 tags for a resource.
tagResourceAsync
in interface AmazonAppConfigAsync
public Future<TagResourceResult> tagResourceAsync(TagResourceRequest request, AsyncHandler<TagResourceRequest,TagResourceResult> asyncHandler)
AmazonAppConfigAsync
Assigns metadata to an AppConfig resource. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define. You can specify a maximum of 50 tags for a resource.
tagResourceAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest request)
AmazonAppConfigAsync
Deletes a tag key and value from an AppConfig resource.
untagResourceAsync
in interface AmazonAppConfigAsync
public Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest request, AsyncHandler<UntagResourceRequest,UntagResourceResult> asyncHandler)
AmazonAppConfigAsync
Deletes a tag key and value from an AppConfig resource.
untagResourceAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateApplicationResult> updateApplicationAsync(UpdateApplicationRequest request)
AmazonAppConfigAsync
Updates an application.
updateApplicationAsync
in interface AmazonAppConfigAsync
public Future<UpdateApplicationResult> updateApplicationAsync(UpdateApplicationRequest request, AsyncHandler<UpdateApplicationRequest,UpdateApplicationResult> asyncHandler)
AmazonAppConfigAsync
Updates an application.
updateApplicationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateConfigurationProfileResult> updateConfigurationProfileAsync(UpdateConfigurationProfileRequest request)
AmazonAppConfigAsync
Updates a configuration profile.
updateConfigurationProfileAsync
in interface AmazonAppConfigAsync
public Future<UpdateConfigurationProfileResult> updateConfigurationProfileAsync(UpdateConfigurationProfileRequest request, AsyncHandler<UpdateConfigurationProfileRequest,UpdateConfigurationProfileResult> asyncHandler)
AmazonAppConfigAsync
Updates a configuration profile.
updateConfigurationProfileAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateDeploymentStrategyResult> updateDeploymentStrategyAsync(UpdateDeploymentStrategyRequest request)
AmazonAppConfigAsync
Updates a deployment strategy.
updateDeploymentStrategyAsync
in interface AmazonAppConfigAsync
public Future<UpdateDeploymentStrategyResult> updateDeploymentStrategyAsync(UpdateDeploymentStrategyRequest request, AsyncHandler<UpdateDeploymentStrategyRequest,UpdateDeploymentStrategyResult> asyncHandler)
AmazonAppConfigAsync
Updates a deployment strategy.
updateDeploymentStrategyAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateEnvironmentResult> updateEnvironmentAsync(UpdateEnvironmentRequest request)
AmazonAppConfigAsync
Updates an environment.
updateEnvironmentAsync
in interface AmazonAppConfigAsync
public Future<UpdateEnvironmentResult> updateEnvironmentAsync(UpdateEnvironmentRequest request, AsyncHandler<UpdateEnvironmentRequest,UpdateEnvironmentResult> asyncHandler)
AmazonAppConfigAsync
Updates an environment.
updateEnvironmentAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateExtensionResult> updateExtensionAsync(UpdateExtensionRequest request)
AmazonAppConfigAsync
Updates an AppConfig extension. For more information about extensions, see Extending workflows in the AppConfig User Guide.
updateExtensionAsync
in interface AmazonAppConfigAsync
public Future<UpdateExtensionResult> updateExtensionAsync(UpdateExtensionRequest request, AsyncHandler<UpdateExtensionRequest,UpdateExtensionResult> asyncHandler)
AmazonAppConfigAsync
Updates an AppConfig extension. For more information about extensions, see Extending workflows in the AppConfig User Guide.
updateExtensionAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateExtensionAssociationResult> updateExtensionAssociationAsync(UpdateExtensionAssociationRequest request)
AmazonAppConfigAsync
Updates an association. For more information about extensions and associations, see Extending workflows in the AppConfig User Guide.
updateExtensionAssociationAsync
in interface AmazonAppConfigAsync
public Future<UpdateExtensionAssociationResult> updateExtensionAssociationAsync(UpdateExtensionAssociationRequest request, AsyncHandler<UpdateExtensionAssociationRequest,UpdateExtensionAssociationResult> asyncHandler)
AmazonAppConfigAsync
Updates an association. For more information about extensions and associations, see Extending workflows in the AppConfig User Guide.
updateExtensionAssociationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ValidateConfigurationResult> validateConfigurationAsync(ValidateConfigurationRequest request)
AmazonAppConfigAsync
Uses the validators in a configuration profile to validate a configuration.
validateConfigurationAsync
in interface AmazonAppConfigAsync
public Future<ValidateConfigurationResult> validateConfigurationAsync(ValidateConfigurationRequest request, AsyncHandler<ValidateConfigurationRequest,ValidateConfigurationResult> asyncHandler)
AmazonAppConfigAsync
Uses the validators in a configuration profile to validate a configuration.
validateConfigurationAsync
in interface AmazonAppConfigAsync
asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public void shutdown()
getExecutorService().shutdown()
followed by getExecutorService().awaitTermination()
prior to
calling this method.shutdown
in interface AmazonAppConfig
shutdown
in class AmazonAppConfigClient