AppConfigurationClient class
Client pour le service Azure App Configuration.
Constructeurs
App |
Initialise une nouvelle instance de la classe AppConfigurationClient. |
App |
Initialise une nouvelle instance de la classe AppConfigurationClient à l’aide d’un TokenCredential. |
Méthodes
add |
Ajoutez un paramètre au service Azure App Configuration, en cas d’échec s’il existe déjà. Exemple d’utilisation :
|
archive |
Archiver un instantané prêt Exemple d’utilisation :
|
begin |
Commence à créer un instantané pour Le service Azure App Configuration, échoue s’il existe déjà. |
begin |
Commence à créer un instantané pour le service Azure App Configuration, attend qu’il soit terminé, échoue s’il existe déjà. |
delete |
Supprimer un paramètre du service Azure App Configuration Exemple d’utilisation :
|
get |
Obtient un paramètre à partir du service Azure App Configuration. Exemple de code :
|
get |
Obtenir un instantané à partir d’Azure App Configuration Service Exemple d’utilisation :
|
list |
Répertorie les paramètres du service Azure App Configuration, éventuellement filtrés par noms de clés, étiquettes et acceptation de datetime. Exemple de code :
|
list |
Répertorie les paramètres du service Azure App Configuration pour les instantanés en fonction du nom, éventuellement filtrés par noms de clés, étiquettes et acceptation de datetime. Exemple de code :
|
list |
Obtenir la liste des étiquettes à partir du service Azure App Configuration Exemple de code :
|
list |
Répertorie les révisions d’un ensemble de clés, éventuellement filtrées par noms de clés, étiquettes et acceptation de datetime. Exemple de code :
|
list |
Répertorier tous les instantanés à partir du service Azure App Configuration Exemple d’utilisation :
|
recover |
Récupérer un instantané archivé à l’état prêt Exemple d’utilisation :
|
set |
Définit la valeur d’une clé dans le service Azure App Configuration, ce qui permet un etag facultatif. |
set |
Définit ou efface l’état en lecture seule d’une clé. |
update |
Ajoute un jeton de synchronisation externe pour garantir que les demandes de service reçoivent des valeurs up-to-date. |
Détails du constructeur
AppConfigurationClient(string, AppConfigurationClientOptions)
Initialise une nouvelle instance de la classe AppConfigurationClient.
new AppConfigurationClient(connectionString: string, options?: AppConfigurationClientOptions)
Paramètres
- connectionString
-
string
Chaîne de connexion nécessaire pour qu’un client se connecte à Azure.
- options
- AppConfigurationClientOptions
Options pour AppConfigurationClient.
AppConfigurationClient(string, TokenCredential, AppConfigurationClientOptions)
Initialise une nouvelle instance de la classe AppConfigurationClient à l’aide d’un TokenCredential.
new AppConfigurationClient(endpoint: string, tokenCredential: TokenCredential, options?: AppConfigurationClientOptions)
Paramètres
- endpoint
-
string
Point de terminaison du service App Configuration (par exemple, https://sample.azconfig.io).
- tokenCredential
- TokenCredential
Objet qui implémente l’interface TokenCredential
utilisée pour authentifier les demandes auprès du service. Utilisez le package @azure/identity pour créer des informations d’identification qui correspondent à vos besoins.
- options
- AppConfigurationClientOptions
Options pour AppConfigurationClient.
Détails de la méthode
addConfigurationSetting(AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>, AddConfigurationSettingOptions)
Ajoutez un paramètre au service Azure App Configuration, en cas d’échec s’il existe déjà.
Exemple d’utilisation :
const result = await client.addConfigurationSetting({ key: "MyKey", label: "MyLabel", value: "MyValue" });
function addConfigurationSetting(configurationSetting: AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>, options?: AddConfigurationSettingOptions): Promise<AddConfigurationSettingResponse>
Paramètres
- configurationSetting
-
AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>
Paramètre de configuration.
- options
- AddConfigurationSettingOptions
Paramètres facultatifs pour la requête.
Retours
Promise<AddConfigurationSettingResponse>
archiveSnapshot(string, UpdateSnapshotOptions)
Archiver un instantané prêt
Exemple d’utilisation :
const result = await client.archiveSnapshot({name: "MySnapshot"});
function archiveSnapshot(name: string, options?: UpdateSnapshotOptions): Promise<UpdateSnapshotResponse>
Paramètres
- name
-
string
Nom de l’instantané.
- options
- UpdateSnapshotOptions
Paramètres facultatifs pour la requête.
Retours
Promise<UpdateSnapshotResponse>
beginCreateSnapshot(SnapshotInfo, CreateSnapshotOptions)
Commence à créer un instantané pour Le service Azure App Configuration, échoue s’il existe déjà.
function beginCreateSnapshot(snapshot: SnapshotInfo, options?: CreateSnapshotOptions): Promise<SimplePollerLike<OperationState<CreateSnapshotResponse>, CreateSnapshotResponse>>
Paramètres
- snapshot
- SnapshotInfo
- options
- CreateSnapshotOptions
Retours
Promise<@azure/core-lro.SimplePollerLike<OperationState<CreateSnapshotResponse>, CreateSnapshotResponse>>
beginCreateSnapshotAndWait(SnapshotInfo, CreateSnapshotOptions)
Commence à créer un instantané pour le service Azure App Configuration, attend qu’il soit terminé, échoue s’il existe déjà.
function beginCreateSnapshotAndWait(snapshot: SnapshotInfo, options?: CreateSnapshotOptions): Promise<CreateSnapshotResponse>
Paramètres
- snapshot
- SnapshotInfo
- options
- CreateSnapshotOptions
Retours
Promise<CreateSnapshotResponse>
deleteConfigurationSetting(ConfigurationSettingId, DeleteConfigurationSettingOptions)
Supprimer un paramètre du service Azure App Configuration
Exemple d’utilisation :
const deletedSetting = await client.deleteConfigurationSetting({ key: "MyKey", label: "MyLabel" });
function deleteConfigurationSetting(id: ConfigurationSettingId, options?: DeleteConfigurationSettingOptions): Promise<DeleteConfigurationSettingResponse>
Paramètres
ID du paramètre de configuration à supprimer.
Paramètres facultatifs pour la requête (ex : etag, étiquette)
Retours
Promise<DeleteConfigurationSettingResponse>
getConfigurationSetting(ConfigurationSettingId, GetConfigurationSettingOptions)
Obtient un paramètre à partir du service Azure App Configuration.
Exemple de code :
const setting = await client.getConfigurationSetting({ key: "MyKey", label: "MyLabel" });
function getConfigurationSetting(id: ConfigurationSettingId, options?: GetConfigurationSettingOptions): Promise<GetConfigurationSettingResponse>
Paramètres
ID du paramètre de configuration à obtenir.
- options
- GetConfigurationSettingOptions
Paramètres facultatifs pour la requête.
Retours
Promise<GetConfigurationSettingResponse>
getSnapshot(string, GetSnapshotOptions)
Obtenir un instantané à partir d’Azure App Configuration Service
Exemple d’utilisation :
const result = await client.getSnapshot("MySnapshot");
function getSnapshot(name: string, options?: GetSnapshotOptions): Promise<GetSnapshotResponse>
Paramètres
- name
-
string
Nom de l’instantané.
- options
- GetSnapshotOptions
Paramètres facultatifs pour la requête.
Retours
Promise<GetSnapshotResponse>
listConfigurationSettings(ListConfigurationSettingsOptions)
Répertorie les paramètres du service Azure App Configuration, éventuellement filtrés par noms de clés, étiquettes et acceptation de datetime.
Exemple de code :
const allSettingsWithLabel = client.listConfigurationSettings({ labelFilter: "MyLabel" });
function listConfigurationSettings(options?: ListConfigurationSettingsOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>
Paramètres
- options
- ListConfigurationSettingsOptions
Paramètres facultatifs pour la requête.
Retours
listConfigurationSettingsForSnapshot(string, ListConfigurationSettingsForSnapshotOptions)
Répertorie les paramètres du service Azure App Configuration pour les instantanés en fonction du nom, éventuellement filtrés par noms de clés, étiquettes et acceptation de datetime.
Exemple de code :
const allSettingsWithLabel = client.listConfigurationSettingsForSnashots({ snapshotName: "MySnapshot" });
function listConfigurationSettingsForSnapshot(snapshotName: string, options?: ListConfigurationSettingsForSnapshotOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>
Paramètres
- snapshotName
-
string
Paramètres facultatifs pour la requête.
Retours
listLabels(ListLabelsOptions)
Obtenir la liste des étiquettes à partir du service Azure App Configuration
Exemple de code :
const allSettingsWithLabel = client.listLabels({ nameFilter: "prod*" });
function listLabels(options?: ListLabelsOptions): PagedAsyncIterableIterator<SettingLabel, ListLabelsPage, PageSettings>
Paramètres
- options
- ListLabelsOptions
Paramètres facultatifs pour la requête.
Retours
listRevisions(ListRevisionsOptions)
Répertorie les révisions d’un ensemble de clés, éventuellement filtrées par noms de clés, étiquettes et acceptation de datetime.
Exemple de code :
const revisionsIterator = client.listRevisions({ keys: ["MyKey"] });
function listRevisions(options?: ListRevisionsOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListRevisionsPage, PageSettings>
Paramètres
- options
- ListRevisionsOptions
Paramètres facultatifs pour la requête.
Retours
listSnapshots(ListSnapshotsOptions)
Répertorier tous les instantanés à partir du service Azure App Configuration
Exemple d’utilisation :
const result = await client.listSnapshots();
function listSnapshots(options?: ListSnapshotsOptions): PagedAsyncIterableIterator<ConfigurationSnapshot, ListSnapshotsPage, PageSettings>
Paramètres
- options
- ListSnapshotsOptions
Paramètres facultatifs pour la requête.
Retours
recoverSnapshot(string, UpdateSnapshotOptions)
Récupérer un instantané archivé à l’état prêt
Exemple d’utilisation :
const result = await client.recoverSnapshot("MySnapshot");
function recoverSnapshot(name: string, options?: UpdateSnapshotOptions): Promise<UpdateSnapshotResponse>
Paramètres
- name
-
string
Nom de l’instantané.
- options
- UpdateSnapshotOptions
Paramètres facultatifs pour la requête.
Retours
Promise<UpdateSnapshotResponse>
setConfigurationSetting(SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>, SetConfigurationSettingOptions)
Définit la valeur d’une clé dans le service Azure App Configuration, ce qui permet un etag facultatif.
function setConfigurationSetting(configurationSetting: SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>, options?: SetConfigurationSettingOptions): Promise<SetConfigurationSettingResponse>
Paramètres
- configurationSetting
-
SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>
Valeur de configuration.
- options
- SetConfigurationSettingOptions
Paramètres facultatifs pour la requête.
Exemple de code :
await client.setConfigurationSetting({ key: "MyKey", value: "MyValue" });
Retours
Promise<SetConfigurationSettingResponse>
setReadOnly(ConfigurationSettingId, boolean, SetReadOnlyOptions)
Définit ou efface l’état en lecture seule d’une clé.
function setReadOnly(id: ConfigurationSettingId, readOnly: boolean, options?: SetReadOnlyOptions): Promise<SetReadOnlyResponse>
Paramètres
ID du paramètre de configuration à modifier.
- readOnly
-
boolean
- options
- SetReadOnlyOptions
Retours
Promise<SetReadOnlyResponse>
updateSyncToken(string)
Ajoute un jeton de synchronisation externe pour garantir que les demandes de service reçoivent des valeurs up-to-date.
function updateSyncToken(syncToken: string)
Paramètres
- syncToken
-
string
Valeur du jeton de synchronisation.