AppConfigurationClient class
Cliente para o serviço de Configuração de Aplicativo do Azure.
Construtores
App |
Inicializa uma nova instância da classe AppConfigurationClient. |
App |
Inicializa uma nova instância da classe AppConfigurationClient usando um TokenCredential. |
Métodos
add |
Adicione uma configuração ao serviço de Configuração de Aplicativo do Azure, falhando se ela já existir. Exemplo de uso:
|
archive |
Arquivar um snapshot pronto Exemplo de uso:
|
begin |
Começa a criar um instantâneo para o serviço de Configuração de Aplicativo do Azure, falhará se ele já existir. |
begin |
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. |
delete |
Excluir uma configuração do serviço de Configuração de Aplicativo do Azure Exemplo de uso:
|
get |
Obtém uma configuração do serviço de Configuração de Aplicativo do Azure. Código de exemplo:
|
get |
Obter um instantâneo do serviço de Configuração de Aplicativo do Azure Exemplo de uso:
|
list |
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:
|
list |
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:
|
list |
Obter uma lista de rótulos do serviço de Configuração de Aplicativo do Azure Código de exemplo:
|
list |
Lista revisões de um conjunto de chaves, opcionalmente filtradas por nomes de chaves, rótulos e aceitar datetime. Código de exemplo:
|
list |
Listar todos os instantâneos do serviço de Configuração de Aplicativo do Azure Exemplo de uso:
|
recover |
Recupere um instantâneo arquivado de volta ao status pronto Exemplo de uso:
|
set |
Define o valor de uma chave no serviço de Configuração de Aplicativo do Azure, permitindo uma etag opcional. |
set |
Define ou limpa o status somente leitura de uma chave. |
update |
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
- configurationSetting
-
AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>
Uma definição de configuração.
- options
- AddConfigurationSettingOptions
Parâmetros opcionais para a solicitação.
Devoluções
Promise<AddConfigurationSettingResponse>
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
Promise<UpdateSnapshotResponse>
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
- options
- CreateSnapshotOptions
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
- options
- CreateSnapshotOptions
Devoluções
Promise<CreateSnapshotResponse>
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
A id da definição de configuração a ser excluída.
Parâmetros opcionais para o pedido (ex: etag, label)
Devoluções
Promise<DeleteConfigurationSettingResponse>
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
A id da definição de configuração a ser obtida.
- options
- GetConfigurationSettingOptions
Parâmetros opcionais para a solicitação.
Devoluções
Promise<GetConfigurationSettingResponse>
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
Promise<GetSnapshotResponse>
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
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
Promise<UpdateSnapshotResponse>
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
- configurationSetting
-
SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>
Um valor de configuração.
- options
- SetConfigurationSettingOptions
Parâmetros opcionais para a solicitação.
Código de exemplo:
await client.setConfigurationSetting({ key: "MyKey", value: "MyValue" });
Devoluções
Promise<SetConfigurationSettingResponse>
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
A id da definição de configuração a ser modificada.
- readOnly
-
boolean
- options
- SetReadOnlyOptions
Devoluções
Promise<SetReadOnlyResponse>
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.