Partager via


AppConfigurationClient class

Client pour le service Azure App Configuration.

Constructeurs

AppConfigurationClient(string, AppConfigurationClientOptions)

Initialise une nouvelle instance de la classe AppConfigurationClient.

AppConfigurationClient(string, TokenCredential, AppConfigurationClientOptions)

Initialise une nouvelle instance de la classe AppConfigurationClient à l’aide d’un TokenCredential.

Méthodes

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" });
archiveSnapshot(string, UpdateSnapshotOptions)

Archiver un instantané prêt

Exemple d’utilisation :

const result = await client.archiveSnapshot({name: "MySnapshot"});
beginCreateSnapshot(SnapshotInfo, CreateSnapshotOptions)

Commence à créer un instantané pour Le service Azure App Configuration, échoue s’il existe déjà.

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à.

deleteConfigurationSetting(ConfigurationSettingId, DeleteConfigurationSettingOptions)

Supprimer un paramètre du service Azure App Configuration

Exemple d’utilisation :

const deletedSetting = await client.deleteConfigurationSetting({ key: "MyKey", label: "MyLabel" });
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" });
getSnapshot(string, GetSnapshotOptions)

Obtenir un instantané à partir d’Azure App Configuration Service

Exemple d’utilisation :

const result = await client.getSnapshot("MySnapshot");
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" });
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" });
listLabels(ListLabelsOptions)

Obtenir la liste des étiquettes à partir du service Azure App Configuration

Exemple de code :

const allSettingsWithLabel = client.listLabels({ nameFilter: "prod*" });
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"] });
listSnapshots(ListSnapshotsOptions)

Répertorier tous les instantanés à partir du service Azure App Configuration

Exemple d’utilisation :

const result = await client.listSnapshots();
recoverSnapshot(string, UpdateSnapshotOptions)

Récupérer un instantané archivé à l’état prêt

Exemple d’utilisation :

const result = await client.recoverSnapshot("MySnapshot");
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.

setReadOnly(ConfigurationSettingId, boolean, SetReadOnlyOptions)

Définit ou efface l’état en lecture seule d’une clé.

updateSyncToken(string)

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

options
AddConfigurationSettingOptions

Paramètres facultatifs pour la requête.

Retours

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

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

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

Retours

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
ConfigurationSettingId

ID du paramètre de configuration à supprimer.

options
DeleteConfigurationSettingOptions

Paramètres facultatifs pour la requête (ex : etag, étiquette)

Retours

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
ConfigurationSettingId

ID du paramètre de configuration à obtenir.

options
GetConfigurationSettingOptions

Paramètres facultatifs pour la requête.

Retours

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

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

options
ListConfigurationSettingsForSnapshotOptions

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

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

options
SetConfigurationSettingOptions

Paramètres facultatifs pour la requête.

Exemple de code :

await client.setConfigurationSetting({ key: "MyKey", value: "MyValue" });

Retours

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
ConfigurationSettingId

ID du paramètre de configuration à modifier.

readOnly

boolean

Retours

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.