36
36
* To prevent errors when deploying application configurations, especially for production systems where a simple typo
37
37
* could cause an unexpected outage, AppConfig includes validators. A validator provides a syntactic or semantic check
38
38
* to ensure that the configuration you want to deploy works as intended. To validate your application configuration
39
- * data, you provide a schema or a Lambda function that runs against the configuration. The configuration deployment or
40
- * update can only proceed when the configuration data is valid.
39
+ * data, you provide a schema or an Amazon Web Services Lambda function that runs against the configuration. The
40
+ * configuration deployment or update can only proceed when the configuration data is valid.
41
41
* </p>
42
42
* <p>
43
43
* During a configuration deployment, AppConfig monitors the application to ensure that the deployment is successful. If
52
52
* <ul>
53
53
* <li>
54
54
* <p>
55
- * <b>Application tuning </b>: Use AppConfig to carefully introduce changes to your application that can only be tested
56
- * with production traffic .
55
+ * <b>Feature flags </b>: Use AppConfig to turn on new features that require a timely deployment, such as a product
56
+ * launch or announcement .
57
57
* </p>
58
58
* </li>
59
59
* <li>
60
60
* <p>
61
- * <b>Feature toggle </b>: Use AppConfig to turn on new features that require a timely deployment, such as a product
62
- * launch or announcement .
61
+ * <b>Application tuning </b>: Use AppConfig to carefully introduce changes to your application that can only be tested
62
+ * with production traffic .
63
63
* </p>
64
64
* </li>
65
65
* <li>
@@ -132,7 +132,8 @@ public interface AmazonAppConfig {
132
132
* </li>
133
133
* <li>
134
134
* <p>
135
- * A validator for the configuration data. Available validators include either a JSON Schema or an Lambda function.
135
+ * A validator for the configuration data. Available validators include either a JSON Schema or an Amazon Web
136
+ * Services Lambda function.
136
137
* </p>
137
138
* </li>
138
139
* </ul>
@@ -345,21 +346,49 @@ public interface AmazonAppConfig {
345
346
346
347
/**
347
348
* <p>
348
- * Retrieves information about a configuration.
349
+ * Retrieves the latest deployed configuration.
349
350
* </p>
350
351
* <important>
351
352
* <p>
353
+ * Note the following important information.
354
+ * </p>
355
+ * <ul>
356
+ * <li>
357
+ * <p>
358
+ * This API action has been deprecated. Calls to receive configuration data should use the <a href=
359
+ * "https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html"
360
+ * >StartConfigurationSession</a> and <a href=
361
+ * "https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html"
362
+ * >GetLatestConfiguration</a> APIs instead.
363
+ * </p>
364
+ * </li>
365
+ * <li>
366
+ * <p>
367
+ * <code>GetConfiguration</code> is a priced call. For more information, see <a
368
+ * href="https://aws.amazon.com/systems-manager/pricing/">Pricing</a>.
369
+ * </p>
370
+ * </li>
371
+ * <li>
372
+ * <p>
352
373
* AppConfig uses the value of the <code>ClientConfigurationVersion</code> parameter to identify the configuration
353
374
* version on your clients. If you don’t send <code>ClientConfigurationVersion</code> with each call to
354
375
* <code>GetConfiguration</code>, your clients receive the current configuration. You are charged each time your
355
376
* clients receive a configuration.
356
377
* </p>
357
378
* <p>
358
- * To avoid excess charges, we recommend that you include the <code>ClientConfigurationVersion</code> value with
359
- * every call to <code>GetConfiguration</code>. This value must be saved on your client. Subsequent calls to
360
- * <code>GetConfiguration</code> must pass this value by using the <code>ClientConfigurationVersion</code>
361
- * parameter.
379
+ * To avoid excess charges, we recommend you use the <a
380
+ * href="https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/StartConfigurationSession.html"
381
+ * >StartConfigurationSession</a> and <a
382
+ * href="https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/GetLatestConfiguration.html"
383
+ * >GetLatestConfiguration</a> APIs, which track the client configuration version on your behalf. If you choose to
384
+ * continue using <code>GetConfiguration</code>, we recommend that you include the
385
+ * <code>ClientConfigurationVersion</code> value with every call to <code>GetConfiguration</code>. The value to use
386
+ * for <code>ClientConfigurationVersion</code> comes from the <code>ConfigurationVersion</code> attribute returned
387
+ * by <code>GetConfiguration</code> when there is new or updated data, and should be saved for subsequent calls to
388
+ * <code>GetConfiguration</code>.
362
389
* </p>
390
+ * </li>
391
+ * </ul>
363
392
* </important>
364
393
*
365
394
* @param getConfigurationRequest
@@ -374,6 +403,7 @@ public interface AmazonAppConfig {
374
403
* @see <a href="http://docs.aws.amazon.com/goto/WebAPI/appconfig-2019-10-09/GetConfiguration" target="_top">AWS API
375
404
* Documentation</a>
376
405
*/
406
+ @ Deprecated
377
407
GetConfigurationResult getConfiguration (GetConfigurationRequest getConfigurationRequest );
378
408
379
409
/**
@@ -532,7 +562,7 @@ public interface AmazonAppConfig {
532
562
533
563
/**
534
564
* <p>
535
- * Lists the deployments for an environment.
565
+ * Lists the deployments for an environment in descending deployment number order .
536
566
* </p>
537
567
*
538
568
* @param listDeploymentsRequest
0 commit comments