Compartilhar via


az appconfig snapshot

Gerenciar instantâneos associados a um repositório de configuração de aplicativos.

Comandos

Nome Description Tipo Status
az appconfig snapshot archive

Arquive um instantâneo.

Núcleo GA
az appconfig snapshot create

Criar um instantâneo de configuração de aplicativo.

Núcleo GA
az appconfig snapshot list

Listar instantâneos.

Núcleo GA
az appconfig snapshot recover

Recuperar um instantâneo arquivado.

Núcleo GA
az appconfig snapshot show

Mostrar todos os atributos de um instantâneo de configuração de aplicativo.

Núcleo GA

az appconfig snapshot archive

Arquive um instantâneo.

az appconfig snapshot archive --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

Exemplos

Arquivar o instantâneo MySnapshot no repositório de configuração MyAppConfiguration.

az appconfig snapshot archive -s MySnapshot -n MyAppConfiguration

Parâmetros Exigidos

--snapshot-name -s

Nome do instantâneo da Configuração do Aplicativo.

Parâmetros Opcionais

--auth-mode

Esse parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "key", forneça o nome da cadeia de conexão ou do repositório e as chaves de acesso da conta serão recuperadas para autorização. Se o modo de autenticação for "logon", forneça o --endpoint ou --name e suas credenciais de "az login" serão usadas para autorização. Você pode configurar o modo de autenticação padrão usando az configure --defaults appconfig_auth_mode=<auth_mode>. Para obter mais informações, consulte https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valores aceitos: key, login
Valor padrão: key
--connection-string

Combinação de chave de acesso e ponto de extremidade do repositório de Configuração de Aplicativos. Pode ser encontrado usando 'az appconfig credential list'. Os usuários podem predefini-lo usando az configure --defaults appconfig_connection_string=<connection_string> ou variável de ambiente com o nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se o modo de autenticação for "logon", forneça a URL do ponto de extremidade do repositório de Configuração de Aplicativos. O ponto de extremidade pode ser recuperado usando o comando "az appconfig show". Você pode configurar o ponto de extremidade padrão usando az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Nome do repositório de Configuração de Aplicativos. Você pode configurar o nome padrão usando az configure --defaults app_configuration_store=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az appconfig snapshot create

Criar um instantâneo de configuração de aplicativo.

az appconfig snapshot create --filters
                             --snapshot-name
                             [--auth-mode {key, login}]
                             [--composition-type {key, key_label}]
                             [--connection-string]
                             [--endpoint]
                             [--name]
                             [--retention-period]
                             [--tags]

Exemplos

Crie um mySnapshot de instantâneo de todas as chaves começando com 'Test' no repositório de configuração MyAppConfiguration.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"Test*\"}'

Crie um instantâneo mySnapshot de todas as chaves começando com 'abc' e um período de retenção de 1 hora.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"abc*\"}' --retention-period 3600

Crie um instantâneo de todas as chaves começando com 'app/' e sem rótulo como padrão e substitua os valores de chave com chaves com o rótulo 'prod' se existirem.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"app/*\"}' '{\"key\":\"app/*\", \"label\":\"prod\"}' --composition-type 'key'

Parâmetros Exigidos

--filters

Lista separada por espaço de objetos JSON com escape que representam os filtros de chave e rótulo usados para criar um instantâneo de Configuração de Aplicativo.

--snapshot-name -s

Nome do instantâneo da Configuração do Aplicativo.

Parâmetros Opcionais

--auth-mode

Esse parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "key", forneça o nome da cadeia de conexão ou do repositório e as chaves de acesso da conta serão recuperadas para autorização. Se o modo de autenticação for "logon", forneça o --endpoint ou --name e suas credenciais de "az login" serão usadas para autorização. Você pode configurar o modo de autenticação padrão usando az configure --defaults appconfig_auth_mode=<auth_mode>. Para obter mais informações, consulte https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valores aceitos: key, login
Valor padrão: key
--composition-type

Tipo de composição usado na criação de instantâneos da Configuração de Aplicativos. Se não for especificado, o padrão será a chave.

Valores aceitos: key, key_label
--connection-string

Combinação de chave de acesso e ponto de extremidade do repositório de Configuração de Aplicativos. Pode ser encontrado usando 'az appconfig credential list'. Os usuários podem predefini-lo usando az configure --defaults appconfig_connection_string=<connection_string> ou variável de ambiente com o nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se o modo de autenticação for "logon", forneça a URL do ponto de extremidade do repositório de Configuração de Aplicativos. O ponto de extremidade pode ser recuperado usando o comando "az appconfig show". Você pode configurar o ponto de extremidade padrão usando az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Nome do repositório de Configuração de Aplicativos. Você pode configurar o nome padrão usando az configure --defaults app_configuration_store=<name>.

--retention-period

Duração em segundos para a qual um instantâneo pode permanecer arquivado antes da expiração. Um instantâneo pode ser arquivado por um máximo de 7 dias (604.800s) para lojas de camadas gratuitas e 90 dias (7.776.000s) para lojas de camadas standard e premium. Se especificado, o período de retenção deve ser de pelo menos 1 hora (3600s).

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...].

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az appconfig snapshot list

Listar instantâneos.

az appconfig snapshot list [--all]
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]
                           [--snapshot-name]
                           [--status {archived, failed, provisioning, ready}]
                           [--top]

Exemplos

Liste todos os instantâneos com nomes começando com o prefixo 'abc'.

az appconfig snapshot list -s abc* -n MyAppConfiguration

Listar todos os instantâneos arquivados.

az appconfig snapshot list --status archived -n MyAppConfiguration

Liste todos os instantâneos de provisionamento com nomes começando com o prefixo 'app'.

az appconfig snapshot list -s app* --status provisioning -n MyAppConfiguration

Listar todos os instantâneos com falha e provisionamento.

az appconfig snapshot list --status failed provisioning -n MyAppConfiguration

Parâmetros Opcionais

--all

Listar todos os itens.

--auth-mode

Esse parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "key", forneça o nome da cadeia de conexão ou do repositório e as chaves de acesso da conta serão recuperadas para autorização. Se o modo de autenticação for "logon", forneça o --endpoint ou --name e suas credenciais de "az login" serão usadas para autorização. Você pode configurar o modo de autenticação padrão usando az configure --defaults appconfig_auth_mode=<auth_mode>. Para obter mais informações, consulte https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valores aceitos: key, login
Valor padrão: key
--connection-string

Combinação de chave de acesso e ponto de extremidade do repositório de Configuração de Aplicativos. Pode ser encontrado usando 'az appconfig credential list'. Os usuários podem predefini-lo usando az configure --defaults appconfig_connection_string=<connection_string> ou variável de ambiente com o nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se o modo de autenticação for "logon", forneça a URL do ponto de extremidade do repositório de Configuração de Aplicativos. O ponto de extremidade pode ser recuperado usando o comando "az appconfig show". Você pode configurar o ponto de extremidade padrão usando az configure --defaults appconfig_endpoint=<endpoint>.

--fields

Personalize os campos de saída para instantâneos.

Valores aceitos: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Nome do repositório de Configuração de Aplicativos. Você pode configurar o nome padrão usando az configure --defaults app_configuration_store=<name>.

--snapshot-name -s

Se nenhum nome especificado, retorne todos os instantâneos por padrão. Dar suporte ao sinal de estrela como filtros, por exemplo, abc* significa instantâneos com abc como prefixo para o nome.

Valor padrão: *
--status

Filtrar instantâneos por seu status. Se nenhum status especificado, retorne todos os instantâneos por padrão.

Valores aceitos: archived, failed, provisioning, ready
--top -t

Número máximo de itens a serem retornados. Deve ser um inteiro positivo. Padrão para 100.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az appconfig snapshot recover

Recuperar um instantâneo arquivado.

az appconfig snapshot recover --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

Exemplos

Recuperar o instantâneo MySnapshot no repositório de configuração MyAppConfiguration.

az appconfig snapshot recover -s MySnapshot -n MyAppConfiguration

Parâmetros Exigidos

--snapshot-name -s

Nome do instantâneo da Configuração do Aplicativo.

Parâmetros Opcionais

--auth-mode

Esse parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "key", forneça o nome da cadeia de conexão ou do repositório e as chaves de acesso da conta serão recuperadas para autorização. Se o modo de autenticação for "logon", forneça o --endpoint ou --name e suas credenciais de "az login" serão usadas para autorização. Você pode configurar o modo de autenticação padrão usando az configure --defaults appconfig_auth_mode=<auth_mode>. Para obter mais informações, consulte https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valores aceitos: key, login
Valor padrão: key
--connection-string

Combinação de chave de acesso e ponto de extremidade do repositório de Configuração de Aplicativos. Pode ser encontrado usando 'az appconfig credential list'. Os usuários podem predefini-lo usando az configure --defaults appconfig_connection_string=<connection_string> ou variável de ambiente com o nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se o modo de autenticação for "logon", forneça a URL do ponto de extremidade do repositório de Configuração de Aplicativos. O ponto de extremidade pode ser recuperado usando o comando "az appconfig show". Você pode configurar o ponto de extremidade padrão usando az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Nome do repositório de Configuração de Aplicativos. Você pode configurar o nome padrão usando az configure --defaults app_configuration_store=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az appconfig snapshot show

Mostrar todos os atributos de um instantâneo de configuração de aplicativo.

az appconfig snapshot show --snapshot-name
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]

Exemplos

Mostrar um instantâneo de configuração de aplicativo com o nome MySnapshot no repositório de configuração MyAppConfiguration.

az appconfig snapshot show -s MySnapshot -n MyAppConfiguration

Parâmetros Exigidos

--snapshot-name -s

Nome do instantâneo da Configuração do Aplicativo.

Parâmetros Opcionais

--auth-mode

Esse parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "key", forneça o nome da cadeia de conexão ou do repositório e as chaves de acesso da conta serão recuperadas para autorização. Se o modo de autenticação for "logon", forneça o --endpoint ou --name e suas credenciais de "az login" serão usadas para autorização. Você pode configurar o modo de autenticação padrão usando az configure --defaults appconfig_auth_mode=<auth_mode>. Para obter mais informações, consulte https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valores aceitos: key, login
Valor padrão: key
--connection-string

Combinação de chave de acesso e ponto de extremidade do repositório de Configuração de Aplicativos. Pode ser encontrado usando 'az appconfig credential list'. Os usuários podem predefini-lo usando az configure --defaults appconfig_connection_string=<connection_string> ou variável de ambiente com o nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se o modo de autenticação for "logon", forneça a URL do ponto de extremidade do repositório de Configuração de Aplicativos. O ponto de extremidade pode ser recuperado usando o comando "az appconfig show". Você pode configurar o ponto de extremidade padrão usando az configure --defaults appconfig_endpoint=<endpoint>.

--fields

Personalize os campos de saída para instantâneos.

Valores aceitos: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Nome do repositório de Configuração de Aplicativos. Você pode configurar o nome padrão usando az configure --defaults app_configuration_store=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.