public final class ConfigurationClient extends Object
ConfigurationSettings
in Azure App Configuration Store. Operations allowed by the client are adding, retrieving, deleting, set read-only
status ConfigurationSettings, and listing settings or revision of a setting based on a
filter
.
Instantiating a synchronous Configuration Client
ConfigurationClient configurationClient = new ConfigurationClientBuilder() .connectionString(connectionString) .buildClient();
View this
for additional ways to construct the client.
ConfigurationClientBuilder
Modifier and Type | Method and Description |
---|---|
ConfigurationSetting |
addConfigurationSetting(ConfigurationSetting setting)
Adds a configuration value in the service if that key and label does not exist.
|
ConfigurationSetting |
addConfigurationSetting(String key,
String label,
String value)
Adds a configuration value in the service if that key does not exist.
|
com.azure.core.http.rest.Response<ConfigurationSetting> |
addConfigurationSettingWithResponse(ConfigurationSetting setting,
com.azure.core.util.Context context)
Adds a configuration value in the service if that key and label does not exist.
|
ConfigurationSetting |
deleteConfigurationSetting(ConfigurationSetting setting)
Deletes the
ConfigurationSetting with a matching key , and optional
label and optional ETag combination. |
ConfigurationSetting |
deleteConfigurationSetting(String key,
String label)
|
com.azure.core.http.rest.Response<ConfigurationSetting> |
deleteConfigurationSettingWithResponse(ConfigurationSetting setting,
boolean ifUnchanged,
com.azure.core.util.Context context)
Deletes the
ConfigurationSetting with a matching key , and optional
label and optional ETag combination. |
ConfigurationSetting |
getConfigurationSetting(ConfigurationSetting setting)
|
ConfigurationSetting |
getConfigurationSetting(String key,
String label)
Attempts to get a ConfigurationSetting that matches the
key , and the optional label combination. |
ConfigurationSetting |
getConfigurationSetting(String key,
String label,
OffsetDateTime acceptDateTime)
Attempts to get a ConfigurationSetting that matches the
key , the optional label , and the optional
acceptDateTime combination. |
com.azure.core.http.rest.Response<ConfigurationSetting> |
getConfigurationSettingWithResponse(ConfigurationSetting setting,
OffsetDateTime acceptDateTime,
boolean ifChanged,
com.azure.core.util.Context context)
|
com.azure.core.http.rest.PagedIterable<ConfigurationSetting> |
listConfigurationSettings(SettingSelector selector)
Fetches the configuration settings that match the
selector . |
com.azure.core.http.rest.PagedIterable<ConfigurationSetting> |
listConfigurationSettings(SettingSelector selector,
com.azure.core.util.Context context)
Fetches the configuration settings that match the
selector . |
com.azure.core.http.rest.PagedIterable<ConfigurationSetting> |
listRevisions(SettingSelector selector)
Lists chronological/historical representation of
ConfigurationSetting resource(s). |
com.azure.core.http.rest.PagedIterable<ConfigurationSetting> |
listRevisions(SettingSelector selector,
com.azure.core.util.Context context)
Lists chronological/historical representation of
ConfigurationSetting resource(s). |
ConfigurationSetting |
setConfigurationSetting(ConfigurationSetting setting)
Creates or updates a configuration value in the service.
|
ConfigurationSetting |
setConfigurationSetting(String key,
String label,
String value)
Creates or updates a configuration value in the service with the given key and.
|
com.azure.core.http.rest.Response<ConfigurationSetting> |
setConfigurationSettingWithResponse(ConfigurationSetting setting,
boolean ifUnchanged,
com.azure.core.util.Context context)
Creates or updates a configuration value in the service.
|
ConfigurationSetting |
setReadOnly(ConfigurationSetting setting,
boolean isReadOnly)
Sets the read-only status for the
ConfigurationSetting . |
ConfigurationSetting |
setReadOnly(String key,
String label,
boolean isReadOnly)
|
com.azure.core.http.rest.Response<ConfigurationSetting> |
setReadOnlyWithResponse(ConfigurationSetting setting,
boolean isReadOnly,
com.azure.core.util.Context context)
Sets the read-only status for the
ConfigurationSetting . |
void |
updateSyncToken(String token)
Adds an external synchronization token to ensure service requests receive up-to-date values.
|
public ConfigurationSetting addConfigurationSetting(String key, String label, String value)
label
is optional.
Code Samples
Add a setting with the key "prodDBConnection", label "westUS" and value "db_connection".
ConfigurationSetting result = configurationClient .addConfigurationSetting("prodDBConnection", "westUS", "db_connection"); System.out.printf("Key: %s, Label: %s, Value: %s", result.getKey(), result.getLabel(), result.getValue());
key
- The key of the configuration setting to add.label
- The label of the configuration setting to create. If null
no label will be used.value
- The value associated with this configuration setting key.ConfigurationSetting
that was created, or null
if a key collision occurs or the key
is an invalid value (which will also throw ServiceRequestException described below).IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceModifiedException
- If a ConfigurationSetting with the same key exists.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting addConfigurationSetting(ConfigurationSetting setting)
Code Samples
Add a setting with the key "prodDBConnection", label "westUS" and value "db_connection".
ConfigurationSetting setting = configurationClient.addConfigurationSetting( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS").setValue("db_connection")); System.out.printf("Key: %s, Label: %s, Value: %s", setting.getKey(), setting.getLabel(), setting.getValue());
setting
- The setting to add based on its key and optional label combination.ConfigurationSetting
that was created, or null
if a key collision occurs or the key
is an invalid value (which will also throw ServiceRequestException described below).NullPointerException
- If setting
is null
.IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceModifiedException
- If a ConfigurationSetting with the same key and label exists.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public com.azure.core.http.rest.Response<ConfigurationSetting> addConfigurationSettingWithResponse(ConfigurationSetting setting, com.azure.core.util.Context context)
Code Samples
Add a setting with the key "prodDBConnection", label "westUS", and value "db_connection".
Response<ConfigurationSetting> responseResultSetting = configurationClient .addConfigurationSettingWithResponse( new ConfigurationSetting() .setKey("prodDBConnection").setLabel("westUS").setValue("db_connection"), new Context(key1, value1)); final ConfigurationSetting resultSetting = responseResultSetting.getValue(); System.out.printf("Key: %s, Label: %s, Value: %s", resultSetting.getKey(), resultSetting.getLabel(), resultSetting.getValue());
setting
- The setting to add based on its key and optional label combination.context
- Additional context that is passed through the Http pipeline during the service call.ConfigurationSetting
that was created, or null
, if a
key collision occurs or the key is an invalid value (which will also throw ServiceRequestException described
below).NullPointerException
- If setting
is null
.IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceModifiedException
- If a ConfigurationSetting with the same key and label exists.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting setConfigurationSetting(String key, String label, String value)
label
is optional.
Code Samples
Add a setting with the key "prodDBConnection", "westUS" and value "db_connection".
Update setting's value "db_connection" to "updated_db_connection"
ConfigurationSetting result = configurationClient .setConfigurationSetting("prodDBConnection", "westUS", "db_connection"); System.out.printf("Key: %s, Label: %s, Value: %s", result.getKey(), result.getLabel(), result.getValue()); // Update the value of the setting to "updated_db_connection". result = configurationClient.setConfigurationSetting( "prodDBConnection", "westUS", "updated_db_connection"); System.out.printf("Key: %s, Label: %s, Value: %s", result.getKey(), result.getLabel(), result.getValue());
key
- The key of the configuration setting to create or update.label
- The label of the configuration setting to create or update. If null
no label will be used.value
- The value of this configuration setting.ConfigurationSetting
that was created or updated, or null
if the key is an invalid
value (which will also throw ServiceRequestException described below).IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceModifiedException
- If the setting exists and is read-only.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting setConfigurationSetting(ConfigurationSetting setting)
Code Samples
Add a setting with the key "prodDBConnection" and value "db_connection".
Update setting's value "db_connection" to "updated_db_connection"
ConfigurationSetting setting = configurationClient.setConfigurationSetting( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS").setValue("db_connection")); System.out.printf("Key: %s, Label: %s, Value: %s", setting.getKey(), setting.getLabel(), setting.getValue()); // Update the value of the setting to "updated_db_connection". setting = configurationClient.setConfigurationSetting( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS").setValue("updated_db_connection")); System.out.printf("Key: %s, Label: %s, Value: %s", setting.getKey(), setting.getLabel(), setting.getValue());
setting
- The setting to create or update based on its key, optional label and optional ETag combination.ConfigurationSetting
that was created or updated, or null
if the key is an invalid
value (which will also throw ServiceRequestException described below).NullPointerException
- If setting
is null
.IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceModifiedException
- If the ETag
was specified, is not the
wildcard character, and the current configuration value's ETag does not match, or the setting exists and is
read-only.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public com.azure.core.http.rest.Response<ConfigurationSetting> setConfigurationSettingWithResponse(ConfigurationSetting setting, boolean ifUnchanged, com.azure.core.util.Context context)
ETag
is specified, the configuration value is updated if the current
setting's ETag matches. If the ETag's value is equal to the wildcard character ("*"
), the setting will
always be updated.
Code Samples
Add a setting with the key "prodDBConnection" and value "db_connection".
Update setting's value "db_connection" to "updated_db_connection"
// Add a setting with the key "prodDBConnection", label "westUS", and value "db_connection" Response<ConfigurationSetting> responseSetting = configurationClient.setConfigurationSettingWithResponse( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS").setValue("db_connection"), false, new Context(key2, value2)); final ConfigurationSetting initSetting = responseSetting.getValue(); System.out.printf("Key: %s, Value: %s", initSetting.getKey(), initSetting.getValue()); // Update the value of the setting to "updated_db_connection". responseSetting = configurationClient.setConfigurationSettingWithResponse( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS").setValue("updated_db_connection"), false, new Context(key2, value2)); final ConfigurationSetting updatedSetting = responseSetting.getValue(); System.out.printf("Key: %s, Value: %s", updatedSetting.getKey(), updatedSetting.getValue());
setting
- The setting to create or update based on its key, optional label and optional ETag combination.ifUnchanged
- A boolean indicates if setting
ETag
is used as a
IF-MATCH header.context
- Additional context that is passed through the Http pipeline during the service call.ConfigurationSetting
that was created or updated, or null
,
if the configuration value does not exist or the key is an invalid value (which will also throw
ServiceRequestException described below).NullPointerException
- If setting
is null
.IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceModifiedException
- If the ETag
was specified, is not the
wildcard character, and the current configuration value's ETag does not match, or the setting exists and is
read-only.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting getConfigurationSetting(String key, String label)
key
, and the optional label
combination.
Code Samples
Retrieve the setting with the key "prodDBConnection".
ConfigurationSetting resultNoDateTime = configurationClient.getConfigurationSetting("prodDBConnection", null); System.out.printf("Key: %s, Value: %s", resultNoDateTime.getKey(), resultNoDateTime.getValue());
key
- The key of the setting to retrieve.label
- The label of the configuration setting to retrieve. If null
no label will be used.ConfigurationSetting
stored in the service, or null
, if the configuration value does
not exist or the key is an invalid value (which will also throw ServiceRequestException described below).IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceNotFoundException
- If a ConfigurationSetting with key
does not exist.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting getConfigurationSetting(String key, String label, OffsetDateTime acceptDateTime)
key
, the optional label
, and the optional
acceptDateTime
combination.
Code Samples
Retrieve the setting with the key "prodDBConnection".
ConfigurationSetting result = configurationClient.getConfigurationSetting("prodDBConnection", null, null); System.out.printf("Key: %s, Value: %s", result.getKey(), result.getValue());
key
- The key of the setting to retrieve.label
- The label of the configuration setting to create or update. If null
no label will be used.acceptDateTime
- Datetime to access a past state of the configuration setting. If null
then the current state of the configuration setting will be returned.ConfigurationSetting
stored in the service, or null
, if the configuration value does
not exist or the key is an invalid value (which will also throw ServiceRequestException described below).IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceNotFoundException
- If a ConfigurationSetting with key
does not exist.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting getConfigurationSetting(ConfigurationSetting setting)
key
, and optional
label
, optional acceptDateTime
and optional ETag combination.
Code Samples
Retrieve the setting with the key "prodDBConnection".
ConfigurationSetting setting = configurationClient.getConfigurationSetting( new ConfigurationSetting().setKey("prodDBConnection")); System.out.printf("Key: %s, Value: %s", setting.getKey(), setting.getValue());
setting
- The setting to retrieve.ConfigurationSetting
stored in the service, or null
, if the configuration value does
not exist or the key is an invalid value (which will also throw ServiceRequestException described below).NullPointerException
- If setting
is null
.IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceNotFoundException
- If a ConfigurationSetting with the same key and label does not exist.com.azure.core.exception.HttpResponseException
- If the key
is an empty string.public com.azure.core.http.rest.Response<ConfigurationSetting> getConfigurationSettingWithResponse(ConfigurationSetting setting, OffsetDateTime acceptDateTime, boolean ifChanged, com.azure.core.util.Context context)
key
, and optional
label
, optional acceptDateTime
and optional ETag combination.
Code Samples
Retrieve the setting with the key "prodDBConnection".
// Retrieve the setting with the key-label "prodDBConnection"-"westUS". Response<ConfigurationSetting> responseResultSetting = configurationClient.getConfigurationSettingWithResponse( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS"), null, false, new Context(key1, value1)); System.out.printf("Key: %s, Value: %s", responseResultSetting.getValue().getKey(), responseResultSetting.getValue().getValue());
setting
- The setting to retrieve.acceptDateTime
- Datetime to access a past state of the configuration setting. If null
then the current state of the configuration setting will be returned.ifChanged
- Flag indicating if the setting
ETag
is used as a
If-None-Match header.context
- Additional context that is passed through the Http pipeline during the service call.ConfigurationSetting
stored in the service, or null
, if the
configuration value does not exist or the key is an invalid value (which will also throw ServiceRequestException
described below).NullPointerException
- If setting
is null
.IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceNotFoundException
- If a ConfigurationSetting with the same key and label does not exist.com.azure.core.exception.HttpResponseException
- If the key
is an empty string.public ConfigurationSetting deleteConfigurationSetting(String key, String label)
ConfigurationSetting
with a matching key
and optional label
combination.
Code Samples
Delete the setting with the key "prodDBConnection".
ConfigurationSetting result = configurationClient.deleteConfigurationSetting("prodDBConnection", null); System.out.printf("Key: %s, Value: %s", result.getKey(), result.getValue());
key
- The key of configuration setting to delete.label
- The label of configuration setting to delete. If null
no label will be used.null
if it didn't exist. null
is also returned if the
key
is an invalid value (which will also throw ServiceRequestException described below).IllegalArgumentException
- If key
is null
.com.azure.core.exception.ResourceModifiedException
- If setting
is read-only.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting deleteConfigurationSetting(ConfigurationSetting setting)
ConfigurationSetting
with a matching key
, and optional
label
and optional ETag combination.
Code Samples
Delete the setting with the key "prodDBConnection".
ConfigurationSetting setting = configurationClient.deleteConfigurationSetting( new ConfigurationSetting().setKey("prodDBConnection")); System.out.printf("Key: %s, Value: %s", setting.getKey(), setting.getValue());
setting
- The setting to delete based on its key, optional label and optional ETag combination.null
if it didn't exist. null
is also returned if the
key
is an invalid value (which will also throw ServiceRequestException described below).IllegalArgumentException
- If key
is null
.NullPointerException
- When setting
is null
.com.azure.core.exception.ResourceModifiedException
- If setting
is read-only.com.azure.core.exception.ResourceNotFoundException
- If ETag
is specified, not the wildcard
character, and does not match the current ETag value.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public com.azure.core.http.rest.Response<ConfigurationSetting> deleteConfigurationSettingWithResponse(ConfigurationSetting setting, boolean ifUnchanged, com.azure.core.util.Context context)
ConfigurationSetting
with a matching key
, and optional
label
and optional ETag combination.
If ETag
is specified and is not the wildcard character ("*"
), then
the setting is only deleted if the ETag matches the current ETag; this means that no one has updated the
ConfigurationSetting yet.
Code Samples
Delete the setting with the key "prodDBConnection".
Response<ConfigurationSetting> responseSetting = configurationClient.deleteConfigurationSettingWithResponse( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS"), false, new Context(key2, value2)); System.out.printf( "Key: %s, Value: %s", responseSetting.getValue().getKey(), responseSetting.getValue().getValue());
setting
- The setting to delete based on its key, optional label and optional ETag combination.ifUnchanged
- Flag indicating if the setting
ETag
is used as a
IF-MATCH header.context
- Additional context that is passed through the Http pipeline during the service call.null
if didn't exist. null
is also returned if the key
is an invalid value or
ETag
is set but does not match the current ETag
(which will also throw ServiceRequestException described below).IllegalArgumentException
- If key
is null
.NullPointerException
- When setting
is null
.com.azure.core.exception.ResourceModifiedException
- If setting
is read-only.com.azure.core.exception.ResourceNotFoundException
- If ETag
is specified, not the wildcard
character, and does not match the current ETag value.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting setReadOnly(String key, String label, boolean isReadOnly)
ConfigurationSetting
that matches the key
, the optional
label
.
Code Samples
Set the setting to read-only with the key-label "prodDBConnection"-"westUS".
ConfigurationSetting result = configurationClient.setReadOnly("prodDBConnection", "westUS", true); System.out.printf("Key: %s, Value: %s", result.getKey(), result.getValue());
Clear read-only of the setting with the key-label "prodDBConnection"-"westUS".
ConfigurationSetting result = configurationClient.setReadOnly("prodDBConnection", "westUS", false); System.out.printf("Key: %s, Value: %s", result.getKey(), result.getValue());
key
- The key of configuration setting to set to read-only or not read-only based on the isReadOnly
.label
- The label of configuration setting to set to read-only or not read-only based on the
isReadOnly
value, or optionally. If null
no label will be used.isReadOnly
- Flag used to set the read-only status of the configuration. true
will put the
configuration into a read-only state, false
will clear the state.ConfigurationSetting
that is read-only, or null
is also returned if a key collision
occurs or the key is an invalid value (which will also throw HttpResponseException described below).IllegalArgumentException
- If key
is null
.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public ConfigurationSetting setReadOnly(ConfigurationSetting setting, boolean isReadOnly)
ConfigurationSetting
.
Code Samples
Set the setting to read-only with the key-label "prodDBConnection"-"westUS".
ConfigurationSetting setting = configurationClient.setReadOnly( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS"), true); System.out.printf("Key: %s, Value: %s", setting.getKey(), setting.getValue());
Clear read-only of the setting with the key-label "prodDBConnection"-"westUS".
ConfigurationSetting setting = configurationClient.setReadOnly( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS"), false); System.out.printf("Key: %s, Value: %s", setting.getKey(), setting.getValue());
setting
- The configuration setting to set to read-only or not read-only based on the isReadOnly
.isReadOnly
- Flag used to set the read-only status of the configuration. true
will put the
configuration into a read-only state, false
will clear the state.ConfigurationSetting
that is read-only, or null
is also returned if a key collision
occurs or the key is an invalid value (which will also throw HttpResponseException described below).IllegalArgumentException
- If key
is null
.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public com.azure.core.http.rest.Response<ConfigurationSetting> setReadOnlyWithResponse(ConfigurationSetting setting, boolean isReadOnly, com.azure.core.util.Context context)
ConfigurationSetting
.
Code Samples
Set the setting to read-only with the key-label "prodDBConnection"-"westUS".
ConfigurationSetting resultSetting = configurationClient.setReadOnlyWithResponse( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS"), true, Context.NONE) .getValue(); System.out.printf("Key: %s, Value: %s", resultSetting.getKey(), resultSetting.getValue());
Clear read-only of the setting with the key-label "prodDBConnection"-"westUS".
Response<ConfigurationSetting> responseSetting = configurationClient .setConfigurationSettingWithResponse( new ConfigurationSetting().setKey("prodDBConnection").setLabel("westUS"), false, new Context(key2, value2)); System.out.printf("Key: %s, Value: %s", responseSetting.getValue().getKey(), responseSetting.getValue().getValue());
setting
- The configuration setting to set to read-only or not read-only based on the isReadOnly
.isReadOnly
- Flag used to set the read-only status of the configuration. true
will put the
configuration into a read-only state, false
will clear the state.context
- Additional context that is passed through the Http pipeline during the service call.isReadOnly
is true or null, or false respectively. Or return null
if the setting didn't exist.
null
is also returned if the key
is an invalid value.
(which will also throw HttpResponseException described below).IllegalArgumentException
- If key
is null
.com.azure.core.exception.HttpResponseException
- If key
is an empty string.public com.azure.core.http.rest.PagedIterable<ConfigurationSetting> listConfigurationSettings(SettingSelector selector)
selector
. If selector
is null
, then all
the configuration settings
are fetched with their current values.
Code Samples
Retrieve all settings that use the key "prodDBConnection".
SettingSelector settingSelector = new SettingSelector().setKeyFilter("prodDBConnection"); configurationClient.listConfigurationSettings(settingSelector).forEach(setting -> { System.out.printf("Key: %s, Value: %s", setting.getKey(), setting.getValue()); });
selector
- Optional. Selector to filter configuration setting results from the service.PagedIterable
of ConfigurationSettings that matches the selector
. If no options were
provided, the List contains all of the current settings in the service.public com.azure.core.http.rest.PagedIterable<ConfigurationSetting> listConfigurationSettings(SettingSelector selector, com.azure.core.util.Context context)
selector
. If selector
is null
, then all
the configuration settings
are fetched with their current values.
Code Samples
Retrieve all settings that use the key "prodDBConnection".
SettingSelector settingSelector = new SettingSelector().setKeyFilter("prodDBConnection"); Context ctx = new Context(key2, value2); configurationClient.listConfigurationSettings(settingSelector, ctx).forEach(setting -> { System.out.printf("Key: %s, Value: %s", setting.getKey(), setting.getValue()); });
selector
- Optional. Selector to filter configuration setting results from the service.context
- Additional context that is passed through the Http pipeline during the service call.PagedIterable
of ConfigurationSettings that matches the selector
. If no options were
provided, the PagedIterable
contains all of the current settings in the service.public com.azure.core.http.rest.PagedIterable<ConfigurationSetting> listRevisions(SettingSelector selector)
ConfigurationSetting
resource(s). Revisions are provided
in descending order from their lastModified
date.
Revisions expire after a period of time, see Pricing
for more information.
If selector
is null
, then all the ConfigurationSettings
are fetched
in their current state. Otherwise, the results returned match the parameters given in selector
.
Code Samples
Retrieve all revisions of the setting that has the key "prodDBConnection".
SettingSelector settingSelector = new SettingSelector().setKeyFilter("prodDBConnection"); client.listRevisions(settingSelector).streamByPage().forEach(resp -> { System.out.printf("Response headers are %s. Url %s and status code %d %n", resp.getHeaders(), resp.getRequest().getUrl(), resp.getStatusCode()); resp.getItems().forEach(value -> { System.out.printf("Response value is %d %n", value); }); });
selector
- Optional. Used to filter configuration setting revisions from the service.PagedIterable
of ConfigurationSetting
revisions.public com.azure.core.http.rest.PagedIterable<ConfigurationSetting> listRevisions(SettingSelector selector, com.azure.core.util.Context context)
ConfigurationSetting
resource(s). Revisions are provided
in descending order from their lastModified
date.
Revisions expire after a period of time, see Pricing
for more information.
If selector
is null
, then all the ConfigurationSettings
are fetched
in their current state. Otherwise, the results returned match the parameters given in selector
.
Code Samples
Retrieve all revisions of the setting that has the key "prodDBConnection".
SettingSelector settingSelector = new SettingSelector().setKeyFilter("prodDBConnection"); Context ctx = new Context(key2, value2); configurationClient.listRevisions(settingSelector, ctx).forEach(setting -> { System.out.printf("Key: %s, Value: %s", setting.getKey(), setting.getValue()); });
selector
- Optional. Used to filter configuration setting revisions from the service.context
- Additional context that is passed through the Http pipeline during the service call.PagedIterable
of ConfigurationSetting
revisions.public void updateSyncToken(String token)
token
- an external synchronization token to ensure service requests receive up-to-date values.NullPointerException
- if the given token is null.Copyright © 2021 Microsoft Corporation. All rights reserved.