Partilhar via


AppConfigurationClient class

Cliente para o serviço de Configuração de Aplicativo do Azure.

Construtores

AppConfigurationClient(string, AppConfigurationClientOptions)

Inicializa uma nova instância da classe AppConfigurationClient.

AppConfigurationClient(string, TokenCredential, AppConfigurationClientOptions)

Inicializa uma nova instância da classe AppConfigurationClient usando um TokenCredential.

Métodos

addConfigurationSetting(AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>, AddConfigurationSettingOptions)

Adicione uma configuração ao serviço de Configuração de Aplicativo do Azure, falhando se ela já existir.

Exemplo de uso:

const result = await client.addConfigurationSetting({ key: "MyKey", label: "MyLabel", value: "MyValue" });
archiveSnapshot(string, UpdateSnapshotOptions)

Arquivar um snapshot pronto

Exemplo de uso:

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

Começa a criar um instantâneo para o serviço de Configuração de Aplicativo do Azure, falhará se ele já existir.

beginCreateSnapshotAndWait(SnapshotInfo, CreateSnapshotOptions)

Começa a criar um instantâneo para o serviço de Configuração de Aplicativo do Azure, aguarda até que seja concluído, falha se ele já existir.

deleteConfigurationSetting(ConfigurationSettingId, DeleteConfigurationSettingOptions)

Excluir uma configuração do serviço de Configuração de Aplicativo do Azure

Exemplo de uso:

const deletedSetting = await client.deleteConfigurationSetting({ key: "MyKey", label: "MyLabel" });
getConfigurationSetting(ConfigurationSettingId, GetConfigurationSettingOptions)

Obtém uma configuração do serviço de Configuração de Aplicativo do Azure.

Código de exemplo:

const setting = await client.getConfigurationSetting({ key: "MyKey", label: "MyLabel" });
getSnapshot(string, GetSnapshotOptions)

Obter um instantâneo do serviço de Configuração de Aplicativo do Azure

Exemplo de uso:

const result = await client.getSnapshot("MySnapshot");
listConfigurationSettings(ListConfigurationSettingsOptions)

Lista as configurações do serviço de Configuração de Aplicativo do Azure, opcionalmente filtradas por nomes de chave, rótulos e datetime de aceitação.

Código de exemplo:

const allSettingsWithLabel = client.listConfigurationSettings({ labelFilter: "MyLabel" });
listConfigurationSettingsForSnapshot(string, ListConfigurationSettingsForSnapshotOptions)

Lista as configurações do serviço de Configuração de Aplicativo do Azure para instantâneos com base no nome, opcionalmente filtrados por nomes de chave, rótulos e aceitar datetime.

Código de exemplo:

const allSettingsWithLabel = client.listConfigurationSettingsForSnashots({ snapshotName: "MySnapshot" });
listLabels(ListLabelsOptions)

Obter uma lista de rótulos do serviço de Configuração de Aplicativo do Azure

Código de exemplo:

const allSettingsWithLabel = client.listLabels({ nameFilter: "prod*" });
listRevisions(ListRevisionsOptions)

Lista revisões de um conjunto de chaves, opcionalmente filtradas por nomes de chaves, rótulos e aceitar datetime.

Código de exemplo:

const revisionsIterator = client.listRevisions({ keys: ["MyKey"] });
listSnapshots(ListSnapshotsOptions)

Listar todos os instantâneos do serviço de Configuração de Aplicativo do Azure

Exemplo de uso:

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

Recupere um instantâneo arquivado de volta ao status pronto

Exemplo de uso:

const result = await client.recoverSnapshot("MySnapshot");
setConfigurationSetting(SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>, SetConfigurationSettingOptions)

Define o valor de uma chave no serviço de Configuração de Aplicativo do Azure, permitindo uma etag opcional.

setReadOnly(ConfigurationSettingId, boolean, SetReadOnlyOptions)

Define ou limpa o status somente leitura de uma chave.

updateSyncToken(string)

Adiciona um token de sincronização externo para garantir que as solicitações de serviço recebam valores de data up-to.

Detalhes do Construtor

AppConfigurationClient(string, AppConfigurationClientOptions)

Inicializa uma nova instância da classe AppConfigurationClient.

new AppConfigurationClient(connectionString: string, options?: AppConfigurationClientOptions)

Parâmetros

connectionString

string

Cadeia de conexão necessária para um cliente se conectar ao Azure.

options
AppConfigurationClientOptions

Opções para o AppConfigurationClient.

AppConfigurationClient(string, TokenCredential, AppConfigurationClientOptions)

Inicializa uma nova instância da classe AppConfigurationClient usando um TokenCredential.

new AppConfigurationClient(endpoint: string, tokenCredential: TokenCredential, options?: AppConfigurationClientOptions)

Parâmetros

endpoint

string

O ponto de extremidade do serviço de Configuração de Aplicativo (por exemplo, https://sample.azconfig.io).

tokenCredential
TokenCredential

Um objeto que implementa a interface TokenCredential usada para autenticar solicitações para o serviço. Use o pacote @azure/identity para criar uma credencial que atenda às suas necessidades.

options
AppConfigurationClientOptions

Opções para o AppConfigurationClient.

Detalhes de Método

addConfigurationSetting(AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>, AddConfigurationSettingOptions)

Adicione uma configuração ao serviço de Configuração de Aplicativo do Azure, falhando se ela já existir.

Exemplo de uso:

const result = await client.addConfigurationSetting({ key: "MyKey", label: "MyLabel", value: "MyValue" });
function addConfigurationSetting(configurationSetting: AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>, options?: AddConfigurationSettingOptions): Promise<AddConfigurationSettingResponse>

Parâmetros

options
AddConfigurationSettingOptions

Parâmetros opcionais para a solicitação.

Devoluções

archiveSnapshot(string, UpdateSnapshotOptions)

Arquivar um snapshot pronto

Exemplo de uso:

const result = await client.archiveSnapshot({name: "MySnapshot"});
function archiveSnapshot(name: string, options?: UpdateSnapshotOptions): Promise<UpdateSnapshotResponse>

Parâmetros

name

string

O nome do instantâneo.

options
UpdateSnapshotOptions

Parâmetros opcionais para a solicitação.

Devoluções

beginCreateSnapshot(SnapshotInfo, CreateSnapshotOptions)

Começa a criar um instantâneo para o serviço de Configuração de Aplicativo do Azure, falhará se ele já existir.

function beginCreateSnapshot(snapshot: SnapshotInfo, options?: CreateSnapshotOptions): Promise<SimplePollerLike<OperationState<CreateSnapshotResponse>, CreateSnapshotResponse>>

Parâmetros

snapshot
SnapshotInfo

Devoluções

Promise<@azure/core-lro.SimplePollerLike<OperationState<CreateSnapshotResponse>, CreateSnapshotResponse>>

beginCreateSnapshotAndWait(SnapshotInfo, CreateSnapshotOptions)

Começa a criar um instantâneo para o serviço de Configuração de Aplicativo do Azure, aguarda até que seja concluído, falha se ele já existir.

function beginCreateSnapshotAndWait(snapshot: SnapshotInfo, options?: CreateSnapshotOptions): Promise<CreateSnapshotResponse>

Parâmetros

snapshot
SnapshotInfo

Devoluções

deleteConfigurationSetting(ConfigurationSettingId, DeleteConfigurationSettingOptions)

Excluir uma configuração do serviço de Configuração de Aplicativo do Azure

Exemplo de uso:

const deletedSetting = await client.deleteConfigurationSetting({ key: "MyKey", label: "MyLabel" });
function deleteConfigurationSetting(id: ConfigurationSettingId, options?: DeleteConfigurationSettingOptions): Promise<DeleteConfigurationSettingResponse>

Parâmetros

id
ConfigurationSettingId

A id da definição de configuração a ser excluída.

options
DeleteConfigurationSettingOptions

Parâmetros opcionais para o pedido (ex: etag, label)

Devoluções

getConfigurationSetting(ConfigurationSettingId, GetConfigurationSettingOptions)

Obtém uma configuração do serviço de Configuração de Aplicativo do Azure.

Código de exemplo:

const setting = await client.getConfigurationSetting({ key: "MyKey", label: "MyLabel" });
function getConfigurationSetting(id: ConfigurationSettingId, options?: GetConfigurationSettingOptions): Promise<GetConfigurationSettingResponse>

Parâmetros

id
ConfigurationSettingId

A id da definição de configuração a ser obtida.

options
GetConfigurationSettingOptions

Parâmetros opcionais para a solicitação.

Devoluções

getSnapshot(string, GetSnapshotOptions)

Obter um instantâneo do serviço de Configuração de Aplicativo do Azure

Exemplo de uso:

const result = await client.getSnapshot("MySnapshot");
function getSnapshot(name: string, options?: GetSnapshotOptions): Promise<GetSnapshotResponse>

Parâmetros

name

string

O nome do instantâneo.

options
GetSnapshotOptions

Parâmetros opcionais para a solicitação.

Devoluções

listConfigurationSettings(ListConfigurationSettingsOptions)

Lista as configurações do serviço de Configuração de Aplicativo do Azure, opcionalmente filtradas por nomes de chave, rótulos e datetime de aceitação.

Código de exemplo:

const allSettingsWithLabel = client.listConfigurationSettings({ labelFilter: "MyLabel" });
function listConfigurationSettings(options?: ListConfigurationSettingsOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>

Parâmetros

options
ListConfigurationSettingsOptions

Parâmetros opcionais para a solicitação.

Devoluções

listConfigurationSettingsForSnapshot(string, ListConfigurationSettingsForSnapshotOptions)

Lista as configurações do serviço de Configuração de Aplicativo do Azure para instantâneos com base no nome, opcionalmente filtrados por nomes de chave, rótulos e aceitar datetime.

Código de exemplo:

const allSettingsWithLabel = client.listConfigurationSettingsForSnashots({ snapshotName: "MySnapshot" });
function listConfigurationSettingsForSnapshot(snapshotName: string, options?: ListConfigurationSettingsForSnapshotOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>

Parâmetros

snapshotName

string

options
ListConfigurationSettingsForSnapshotOptions

Parâmetros opcionais para a solicitação.

Devoluções

listLabels(ListLabelsOptions)

Obter uma lista de rótulos do serviço de Configuração de Aplicativo do Azure

Código de exemplo:

const allSettingsWithLabel = client.listLabels({ nameFilter: "prod*" });
function listLabels(options?: ListLabelsOptions): PagedAsyncIterableIterator<SettingLabel, ListLabelsPage, PageSettings>

Parâmetros

options
ListLabelsOptions

Parâmetros opcionais para a solicitação.

Devoluções

listRevisions(ListRevisionsOptions)

Lista revisões de um conjunto de chaves, opcionalmente filtradas por nomes de chaves, rótulos e aceitar datetime.

Código de exemplo:

const revisionsIterator = client.listRevisions({ keys: ["MyKey"] });
function listRevisions(options?: ListRevisionsOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListRevisionsPage, PageSettings>

Parâmetros

options
ListRevisionsOptions

Parâmetros opcionais para a solicitação.

Devoluções

listSnapshots(ListSnapshotsOptions)

Listar todos os instantâneos do serviço de Configuração de Aplicativo do Azure

Exemplo de uso:

const result = await client.listSnapshots();
function listSnapshots(options?: ListSnapshotsOptions): PagedAsyncIterableIterator<ConfigurationSnapshot, ListSnapshotsPage, PageSettings>

Parâmetros

options
ListSnapshotsOptions

Parâmetros opcionais para a solicitação.

Devoluções

recoverSnapshot(string, UpdateSnapshotOptions)

Recupere um instantâneo arquivado de volta ao status pronto

Exemplo de uso:

const result = await client.recoverSnapshot("MySnapshot");
function recoverSnapshot(name: string, options?: UpdateSnapshotOptions): Promise<UpdateSnapshotResponse>

Parâmetros

name

string

O nome do instantâneo.

options
UpdateSnapshotOptions

Parâmetros opcionais para a solicitação.

Devoluções

setConfigurationSetting(SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>, SetConfigurationSettingOptions)

Define o valor de uma chave no serviço de Configuração de Aplicativo do Azure, permitindo uma etag opcional.

function setConfigurationSetting(configurationSetting: SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>, options?: SetConfigurationSettingOptions): Promise<SetConfigurationSettingResponse>

Parâmetros

options
SetConfigurationSettingOptions

Parâmetros opcionais para a solicitação.

Código de exemplo:

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

Devoluções

setReadOnly(ConfigurationSettingId, boolean, SetReadOnlyOptions)

Define ou limpa o status somente leitura de uma chave.

function setReadOnly(id: ConfigurationSettingId, readOnly: boolean, options?: SetReadOnlyOptions): Promise<SetReadOnlyResponse>

Parâmetros

id
ConfigurationSettingId

A id da definição de configuração a ser modificada.

readOnly

boolean

Devoluções

updateSyncToken(string)

Adiciona um token de sincronização externo para garantir que as solicitações de serviço recebam valores de data up-to.

function updateSyncToken(syncToken: string)

Parâmetros

syncToken

string

O valor do token de sincronização.