Partilhar via

az appconfig snapshot

  • Referência

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

Comandos

Name Description Tipo Status
az appconfig snapshot archive

Arquivar um instantâneo.

 Núcleo GA
az appconfig snapshot create

Crie um instantâneo de configuração do aplicativo.

 Núcleo GA
az appconfig snapshot list

Listar instantâneos.

 Núcleo GA
az appconfig snapshot recover

Recupere um snapshot arquivado.

 Núcleo GA
az appconfig snapshot show

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

 Núcleo GA

az appconfig snapshot archive

Editar

Arquivar um instantâneo.

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

Exemplos

Arquive o snapshot MySnapshot no repositório de configuração MyAppConfiguration.

az appconfig snapshot archive -s MySnapshot -n MyAppConfiguration

Parâmetros Obrigatórios

--snapshot-name -s

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

Parâmetros Opcionais

--auth-mode

Este parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "chave", forneça a cadeia de conexão ou o nome da loja e as chaves de acesso da sua conta serão recuperadas para autorização. Se o modo de autenticação for "login", 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 aceites: key, login
Default value: key
--connection-string

Combinação de chave de acesso e ponto de extremidade da App Configuration Store. 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 "login", forneça o URL do ponto de extremidade da loja de configuração do aplicativo. O endpoint 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 da loja de configuração de aplicativos. Você pode configurar o nome padrão usando az configure --defaults app_configuration_store=<name>.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az appconfig snapshot create

Editar

Crie um instantâneo de configuração do 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 instantâneo MySnapshot 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, em seguida, substitua os valores-chave por 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 Obrigatórios

--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 do Aplicativo.

--snapshot-name -s

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

Parâmetros Opcionais

--auth-mode

Este parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "chave", forneça a cadeia de conexão ou o nome da loja e as chaves de acesso da sua conta serão recuperadas para autorização. Se o modo de autenticação for "login", 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 aceites: key, login
Default value: key
--composition-type

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

Valores aceites: key, key_label
--connection-string

Combinação de chave de acesso e ponto de extremidade da App Configuration Store. 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 "login", forneça o URL do ponto de extremidade da loja de configuração do aplicativo. O endpoint 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 da loja 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, durante a qual um instantâneo pode permanecer arquivado antes de expirar. Um snapshot pode ser arquivado por um máximo de 7 dias (604.800) para lojas de nível gratuito e 90 dias (7.776.000s) para lojas de nível padrão e premium. Se especificado, o período de retenção deve ser de pelo menos 1 hora (3600s).

--tags

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az appconfig snapshot list

Editar

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

Liste 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

Liste todos os snapshots com falha e provisionamento.

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

Parâmetros Opcionais

--all

Listar todos os itens.

--auth-mode

Este parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "chave", forneça a cadeia de conexão ou o nome da loja e as chaves de acesso da sua conta serão recuperadas para autorização. Se o modo de autenticação for "login", 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 aceites: key, login
Default value: key
--connection-string

Combinação de chave de acesso e ponto de extremidade da App Configuration Store. 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 "login", forneça o URL do ponto de extremidade da loja de configuração do aplicativo. O endpoint 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 aceites: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Nome da loja 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 for especificado, retorne todos os instantâneos por padrão. Suporte sinal de estrela como filtros, por exemplo, abc* significa instantâneos com abc como prefixo para o nome.

Default value: *
--status

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

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

Número máximo de itens a devolver. Deve ser um número inteiro positivo. O padrão é 100.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az appconfig snapshot recover

Editar

Recupere um snapshot arquivado.

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

Exemplos

Recupere o snapshot MySnapshot no repositório de configuração MyAppConfiguration.

az appconfig snapshot recover -s MySnapshot -n MyAppConfiguration

Parâmetros Obrigatórios

--snapshot-name -s

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

Parâmetros Opcionais

--auth-mode

Este parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "chave", forneça a cadeia de conexão ou o nome da loja e as chaves de acesso da sua conta serão recuperadas para autorização. Se o modo de autenticação for "login", 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 aceites: key, login
Default value: key
--connection-string

Combinação de chave de acesso e ponto de extremidade da App Configuration Store. 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 "login", forneça o URL do ponto de extremidade da loja de configuração do aplicativo. O endpoint 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 da loja de configuração de aplicativos. Você pode configurar o nome padrão usando az configure --defaults app_configuration_store=<name>.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az appconfig snapshot show

Editar

Mostrar todos os atributos de um instantâneo de configuração do 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 do aplicativo com o nome MySnapshot no repositório de configurações MyAppConfiguration.

az appconfig snapshot show -s MySnapshot -n MyAppConfiguration

Parâmetros Obrigatórios

--snapshot-name -s

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

Parâmetros Opcionais

--auth-mode

Este parâmetro pode ser usado para indicar como uma operação de dados deve ser autorizada. Se o modo de autenticação for "chave", forneça a cadeia de conexão ou o nome da loja e as chaves de acesso da sua conta serão recuperadas para autorização. Se o modo de autenticação for "login", 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 aceites: key, login
Default value: key
--connection-string

Combinação de chave de acesso e ponto de extremidade da App Configuration Store. 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 "login", forneça o URL do ponto de extremidade da loja de configuração do aplicativo. O endpoint 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 aceites: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Nome da loja de configuração de aplicativos. Você pode configurar o nome padrão usando az configure --defaults app_configuration_store=<name>.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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