az appconfig kv

  • Referência

Gerencie valores-chave armazenados em uma loja de configuração de aplicativos.

Comandos

Name Description Tipo Status
az appconfig kv delete

Exclua valores-chave.

 Principal GA
az appconfig kv export

Exporte as configurações para outro local a partir da sua loja de Configuração de Aplicações.

 Principal GA
az appconfig kv import

Importe configurações para a sua App Configuration Store a partir de outro local.

 Principal GA
az appconfig kv list

Listar valores-chave.

 Principal GA
az appconfig kv lock

Bloqueie um valor-chave para proibir operações de gravação.

 Principal GA
az appconfig kv restore

Restaure valores-chave.

 Principal GA
az appconfig kv set

Defina um valor-chave.

 Principal GA
az appconfig kv set-keyvault

Defina uma referência keyvault.

 Principal GA
az appconfig kv show

Mostrar todos os atributos de um valor-chave.

 Principal GA
az appconfig kv unlock

Desbloqueie um valor-chave para obter operações de gravação.

 Principal GA

az appconfig kv delete

Editar

Exclua valores-chave.

az appconfig kv delete --key
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--endpoint]
                       [--label]
                       [--name]
                       [--yes]

Exemplos

Exclua uma chave usando o nome da App Configuration Store sem confirmação.

az appconfig kv delete -n MyAppConfiguration --key color --label MyLabel --yes

Exclua uma chave usando a cadeia de conexão.

az appconfig kv delete --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label MyLabel

Exclua uma chave usando suas credenciais de 'az login' e o ponto de extremidade da App Configuration Store.

az appconfig kv delete --endpoint https://myappconfiguration.azconfig.io --key color --auth-mode login --yes

Parâmetros Obrigatórios

--key

Suporte sinal de estrela como filtros, por exemplo, * significa todas as chaves e abc* significa chaves com abc como prefixo.

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>o . Para obter mais informações, veja https://docs.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>o .

--label

Se nenhum rótulo for especificado, exclua a entrada com rótulo nulo. Suporte sinal de estrela como filtros, por exemplo, * significa todos os rótulos e abc* significa rótulos com abc como prefixo.

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

--yes -y

Não solicite confirmação.

Default value: False
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

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

--verbose

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

az appconfig kv export

Editar

Exporte as configurações para outro local a partir da sua loja de Configuração de Aplicações.

az appconfig kv export --destination {appconfig, appservice, file}
                       [--appservice-account]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--dest-auth-mode {key, login}]
                       [--dest-connection-string]
                       [--dest-endpoint]
                       [--dest-label]
                       [--dest-name]
                       [--endpoint]
                       [--export-as-reference {false, true}]
                       [--format {json, properties, yaml}]
                       [--key]
                       [--label]
                       [--name]
                       [--naming-convention {camel, hyphen, pascal, underscore}]
                       [--path]
                       [--prefix]
                       [--preserve-labels {false, true}]
                       [--profile {appconfig/default, appconfig/kvset}]
                       [--resolve-keyvault {false, true}]
                       [--separator]
                       [--skip-features {false, true}]
                       [--skip-keyvault {false, true}]
                       [--snapshot]
                       [--yes]

Exemplos

Exporte todas as teclas e sinalizadores de recursos com teste de rótulo para um arquivo json.

az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json

Exporte todas as chaves com rótulo nulo para um aplicativo do Serviço de Aplicativo.

az appconfig kv export -n MyAppConfiguration -d appservice --appservice-account MyAppService

Exporte todas as chaves com teste de rótulo, excluindo sinalizadores de recursos, para um arquivo json.

az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json --skip-features

Exporte todas as teclas e sinalizadores de recursos com todos os rótulos para outra loja de configuração de aplicativos.

az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --key * --label * --preserve-labels

Exporte todas as teclas e sinalizadores de recursos com todos os rótulos para outra loja de Configuração de Aplicativo e substitua os rótulos de destino.

az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --key * --label * --dest-label ExportedKeys

Exporte todas as chaves para outra loja de configuração de aplicativos usando suas credenciais de 'az login'.

az appconfig kv export -d appconfig --endpoint https://myappconfiguration.azconfig.io --auth-mode login --dest-endpoint https://anotherappconfiguration.azconfig.io --dest-auth-mode login --key * --label * --preserve-labels

Exporte todas as teclas e sinalizadores de recursos com o teste de rótulo usando o perfil appconfig/kvset.

az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json --profile appconfig/kvset

Exportar todas as chaves para outra App Configuration Store a partir de um instantâneo da configuração de origem

az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --snapshot MySnapshot

Parâmetros Obrigatórios

--destination -d

O destino da exportação. Observe que a exportação de sinalizadores de recursos para appservice não é suportada.

Valores aceites: appconfig, appservice, file

Parâmetros Opcionais

--appservice-account

ID ARM para AppService OU o nome do AppService, supondo que ele esteja no mesmo grupo de assinatura e recursos que a App Configuration store. Necessário para argumentos do AppService.

--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>o . Para obter mais informações, veja https://docs.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.

--dest-auth-mode

Modo de autenticação para se conectar à loja de configuração de aplicativos de destino. Para obter detalhes, consulte o argumento "--auth-mode".

Valores aceites: key, login
Default value: key
--dest-connection-string

Combinação de chave de acesso e ponto de extremidade do armazenamento de destino.

--dest-endpoint

Se --dest-auth-mode for "login", forneça o URL do ponto de extremidade da loja de configuração do aplicativo de destino.

--dest-label

Os KVs exportados serão rotulados com este rótulo de destino. Se nem --dest-label nem --preserve-labels forem especificados, atribuirá rótulo nulo.

--dest-name

O nome da loja de Configuração de Aplicativo de destino.

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

--export-as-reference -r

Exporte valores-chave como referências de Configuração do Aplicativo. Para obter mais informações, veja https://docs.microsoft.com/en-us/azure/app-service/app-service-configuration-references.

Valores aceites: false, true
Default value: False
--format

Exportação de formato de arquivo para. Necessário para argumentos de arquivo. Atualmente, os sinalizadores de recursos não são suportados no formato de propriedades.

Valores aceites: json, properties, yaml
--key

Se nenhuma chave for especificada, retorne todas as chaves por padrão. Suporte sinal de estrela como filtros, por exemplo, abc* significa chaves com abc como prefixo. Filtragem de chaves não aplicável a sinalizadores de recursos. Por padrão, todos os sinalizadores de recursos com rótulo especificado serão exportados.

--label

Apenas as teclas e sinalizadores de funcionalidades com esta etiqueta serão exportados. Se nenhum rótulo for especificado, exporte chaves e sinalizadores de recursos com rótulo nulo por padrão. Quando o destino da exportação é appconfig, ou quando o destino da exportação é o arquivo com appconfig/kvset perfil, esse argumento suporta sinais de asterisco e vírgula para filtragem de rótulos, por exemplo, * significa todos os rótulos, abc* significa rótulos com abc como prefixo e abc,xyz significa rótulos com abc ou xyz.

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

--naming-convention

Convenção de nomenclatura a ser usada para a seção "Gerenciamento de recursos" do arquivo. Exemplo: pascal = FeatureManagement, camel = featureManagement, underscore = feature_management, hífen = feature-management.

Valores aceites: camel, hyphen, pascal, underscore
Default value: pascal
--path

Caminho do arquivo de configuração local. Necessário para argumentos de arquivo.

--prefix

Prefixo a ser cortado das chaves. O prefixo será ignorado para sinalizadores de recursos.

--preserve-labels

Sinalize para preservar rótulos do AppConfig de origem. Esse argumento NÃO deve ser especificado junto com --dest-label.

Valores aceites: false, true
Default value: False
--profile

Perfil de exportação a ser usado para exportar os valores-chave. As opções 'depth', 'separator', 'naming-convention', 'prefix', 'dest-label' e 'resolve-keyvault' não são suportadas ao usar o perfil 'appconfig/kvset'.

Valores aceites: appconfig/default, appconfig/kvset
Default value: appconfig/default
--resolve-keyvault

Resolva o conteúdo da referência do cofre de chaves.

Valores aceites: false, true
Default value: False
--separator

Delimitador para nivelar os pares chave-valor para o arquivo json ou yaml. Necessário para exportar a estrutura hierárquica. O separador será ignorado para arquivos de propriedade e sinalizadores de recursos. Valores suportados: '.', ',', ';', '-', '_', '__', '/', ':'.

--skip-features

Exporte itens excluindo todos os sinalizadores de recursos. Por padrão, todos os recursos com o rótulo especificado serão exportados para file ou appconfig. Não aplicável para appservice.

Valores aceites: false, true
Default value: False
--skip-keyvault

Exporte itens excluindo todas as referências do cofre de chaves. Por padrão, todas as referências do cofre de chaves com o rótulo especificado serão exportadas.

Valores aceites: false, true
Default value: False
--snapshot

Exporte todas as chaves em um determinado instantâneo da App Configuration Store. Se nenhum instantâneo for especificado, as chaves atualmente no armazenamento serão exportadas com base nos filtros de chave e rótulo especificados.

--yes -y

Não solicite a visualização.

Default value: False
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

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

--verbose

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

az appconfig kv import

Editar

Importe configurações para a sua App Configuration Store a partir de outro local.

az appconfig kv import --source {appconfig, appservice, file}
                       [--appservice-account]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--content-type]
                       [--depth]
                       [--endpoint]
                       [--format {json, properties, yaml}]
                       [--import-mode {all, ignore-match}]
                       [--label]
                       [--name]
                       [--path]
                       [--prefix]
                       [--preserve-labels {false, true}]
                       [--profile {appconfig/default, appconfig/kvset}]
                       [--separator]
                       [--skip-features {false, true}]
                       [--src-auth-mode {key, login}]
                       [--src-connection-string]
                       [--src-endpoint]
                       [--src-key]
                       [--src-label]
                       [--src-name]
                       [--src-snapshot]
                       [--strict {false, true}]
                       [--yes]

Exemplos

Importe todas as chaves e sinalizadores de recursos de um arquivo e aplique o rótulo de teste.

az appconfig kv import -n MyAppConfiguration --label test -s file --path D:/abc.json --format json

Importe todas as chaves e sinalizadores de recursos com rótulo nulo e aplique um novo rótulo de uma loja de configuração de aplicativos.

az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --label ImportedKeys

Importe todas as chaves de um instantâneo de uma loja de configuração de aplicativos.

az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --src-snapshot MySnapshot

Importe todas as chaves e aplique rótulo nulo de um aplicativo do Serviço de Aplicativo.

az appconfig kv import -n MyAppConfiguration -s appservice --appservice-account MyAppService

Importe todas as chaves com o teste de rótulo e aplique o rótulo test2 excluindo sinalizadores de recursos de uma loja de configuração de aplicativos.

az appconfig kv import -n MyAppConfiguration -s appconfig --src-label test --label test2 --src-name AnotherAppConfiguration --skip-features

Importe todas as teclas e sinalizadores de recursos com todos os rótulos para outra loja de configuração de aplicativos.

az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --src-key * --src-label * --preserve-labels

Importe todas as chaves e sinalizadores de recursos de um arquivo JSON e aplique o tipo de conteúdo JSON.

az appconfig kv import -n MyAppConfiguration -s file --path D:/abc.json --format json --separator . --content-type application/json

Importe todas as chaves para outra loja de configuração de aplicativos usando suas credenciais de 'az login'.

az appconfig kv import -s appconfig --endpoint https://myappconfiguration.azconfig.io --auth-mode login --src-endpoint https://anotherappconfiguration.azconfig.io --src-auth-mode login --src-key * --src-label * --preserve-labels

Importe todas as chaves e sinalizadores de recursos de um arquivo usando o formato appconfig/kvset.

az appconfig kv import -n MyAppConfiguration -s file --path D:/abc.json --format json --profile appconfig/kvset

Parâmetros Obrigatórios

--source -s

A fonte de importação. Observe que a importação de sinalizadores de recursos do appservice não é suportada.

Valores aceites: appconfig, appservice, file

Parâmetros Opcionais

--appservice-account

ID ARM para AppService OU o nome do AppService, supondo que ele esteja no mesmo grupo de assinatura e recursos que a App Configuration store. Necessário para argumentos do AppService.

--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>o . Para obter mais informações, veja https://docs.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.

--content-type

Tipo de conteúdo de todos os itens importados.

--depth

Profundidade para nivelar o arquivo json ou yaml para pares chave-valor. Nivelar para o nível mais profundo por padrão se --separador for fornecido. Não aplicável a arquivos de propriedade ou sinalizadores de recursos.

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

--format

Formato de arquivo importado. Necessário para argumentos de arquivo. Atualmente, os sinalizadores de recursos não são suportados no formato de propriedades.

Valores aceites: json, properties, yaml
--import-mode

Se o modo de importação for "ignore-match", somente os valores-chave de origem que ainda não existem ou cujo valor, tipo de conteúdo ou tags são diferentes dos de um valor-chave existente com a mesma chave e rótulo, serão gravados. O modo de importação "todos" grava todos os valores-chave no destino, independentemente de existirem ou não.

Valores aceites: all, ignore-match
Default value: ignore-match
--label

KVs importados e sinalizadores de recursos serão atribuídos com esse rótulo. Se nenhum rótulo for especificado, atribuirá rótulo nulo.

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

--path

Caminho do arquivo de configuração local. Necessário para argumentos de arquivo.

--prefix

Este prefixo será anexado à frente das chaves importadas. O prefixo será ignorado para sinalizadores de recursos.

--preserve-labels

Sinalize para preservar rótulos do AppConfig de origem. Este argumento NÃO deve ser especificado junto com --label.

Valores aceites: false, true
Default value: False
--profile

Importar perfil a ser usado para importar os valores-chave. As opções 'depth', 'separator', 'content-type', 'label', 'skip-features' e 'prefix' não são suportadas ao usar o perfil 'appconfig/kvset'.

Valores aceites: appconfig/default, appconfig/kvset
Default value: appconfig/default
--separator

Delimitador para nivelar o arquivo json ou yaml para pares chave-valor. O separador será ignorado para arquivos de propriedade e sinalizadores de recursos. Valores suportados: '.', ',', ';', '-', '_', '__', '/', ':'.

--skip-features

Importe apenas valores de chave e exclua todos os sinalizadores de recursos. Por padrão, todos os sinalizadores de recursos serão importados do arquivo ou appconfig. Não aplicável para appservice.

Valores aceites: false, true
Default value: False
--src-auth-mode

Modo de autenticação para conexão com a loja de configuração de aplicativos de origem. Para obter detalhes, consulte o argumento "--auth-mode".

Valores aceites: key, login
Default value: key
--src-connection-string

Combinação de chave de acesso e ponto de extremidade do armazenamento de origem.

--src-endpoint

Se --src-auth-mode for "login", forneça o URL do ponto de extremidade da loja de configuração do aplicativo de origem.

--src-key

Se nenhuma chave for especificada, importe todas as chaves por padrão. Suporte sinal de estrela como filtros, por exemplo, abc* significa chaves com abc como prefixo. Filtragem de chaves não aplicável a sinalizadores de recursos. Por padrão, todos os sinalizadores de recursos com rótulo especificado serão importados.

--src-label

Somente as chaves com esse rótulo no AppConfig de origem serão importadas. Se nenhum valor for especificado, importe chaves com rótulo nulo por padrão. Suporte sinal de estrela como filtros, por exemplo, * significa todos os rótulos, abc* significa rótulos com abc como prefixo.

--src-name

O nome da loja de configuração de aplicativos de origem.

--src-snapshot

Importe todas as chaves em um determinado instantâneo da loja de configuração de aplicativos de origem. Se nenhum instantâneo for especificado, as chaves atualmente no armazenamento serão importadas com base nos filtros de chave e rótulo especificados.

--strict

Exclua todos os outros valores-chave no repositório com prefixo e rótulo especificados.

Valores aceites: false, true
Default value: False
--yes -y

Não solicite a visualização.

Default value: False
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

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

--verbose

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

az appconfig kv list

Editar

Listar valores-chave.

az appconfig kv list [--all]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--datetime]
                     [--endpoint]
                     [--fields {content_type, etag, key, label, last_modified, locked, tags, value}]
                     [--key]
                     [--label]
                     [--name]
                     [--resolve-keyvault {false, true}]
                     [--snapshot]
                     [--top]

Exemplos

Liste todos os valores-chave com rótulo nulo.

az appconfig kv list -n MyAppConfiguration --label \0

Liste uma chave específica para qualquer rótulo que comece com v1. usando a cadeia de conexão.

az appconfig kv list --key color --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --label v1.*

Liste todas as chaves com quaisquer rótulos e consulte apenas chave, valor e tags.

az appconfig kv list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --fields key value tags --datetime "2019-05-01T11:24:12Z"

Liste o conteúdo da referência do cofre de chaves com o prefixo de chave 'KVRef_' e selecione apenas chave e valor.

az appconfig kv list -n MyAppConfiguration --key "KVRef_*" --resolve-keyvault --query "[*].{key:key, value:value}"

Liste valores-chave com vários rótulos.

az appconfig kv list --label test,prod,\0 -n MyAppConfiguration

Liste todos os valores-chave com todos os rótulos usando suas credenciais 'az login'.

az appconfig kv list --endpoint https://myappconfiguration.azconfig.io --auth-mode login

Liste todos os valores-chave em um determinado instantâneo do repositório de configuração do aplicativo.

az appconfig kv list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --snapshot MySnapshot

Parâmetros Opcionais

--all

Listar todos os itens.

Default value: False
--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>o . Para obter mais informações, veja https://docs.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.

--datetime

Formato: "AAAA-MM-DDThh:mm:ssZ". Se nenhum fuso horário for especificado, use UTC por padrão.

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

--fields

Campos de saída personalizados separados por espaço.

Valores aceites: content_type, etag, key, label, last_modified, locked, tags, value
--key

Se nenhuma chave for especificada, retorne todas as chaves por padrão. Suporte sinal de estrela como filtros, por exemplo, abc* significa chaves com abc como prefixo.

--label

Se nenhum rótulo for especificado, liste todos os rótulos. Suporte sinal de estrela como filtros, por exemplo, abc* significa rótulos com abc como prefixo. Use '\0' para rótulo nulo.

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

--resolve-keyvault

Resolva o conteúdo da referência do cofre de chaves. Este argumento NÃO deve ser especificado juntamente com --fields. Em vez disso, use --query para consulta personalizada.

Valores aceites: false, true
Default value: False
--snapshot

Liste todas as chaves em um determinado instantâneo da App Configuration Store. Se nenhum instantâneo for especificado, as chaves atualmente no armazenamento serão listadas.

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

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

--verbose

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

az appconfig kv lock

Editar

Bloqueie um valor-chave para proibir operações de gravação.

az appconfig kv lock --key
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--endpoint]
                     [--label]
                     [--name]
                     [--yes]

Exemplos

Bloqueie um valor-chave usando o nome da loja de Configuração de Aplicativos.

az appconfig kv lock -n MyAppConfiguration --key color --label test

Força o bloqueio de um valor-chave usando a cadeia de conexão.

az appconfig kv lock --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label test --yes

Parâmetros Obrigatórios

--key

Chave a ser trancada.

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>o . Para obter mais informações, veja https://docs.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>o .

--label

Se nenhum rótulo for especificado, bloqueie a entrada com rótulo nulo. A filtragem não é suportada.

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

--yes -y

Não solicite confirmação.

Default value: False
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

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

--verbose

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

az appconfig kv restore

Editar

Restaure valores-chave.

az appconfig kv restore --datetime
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--endpoint]
                        [--key]
                        [--label]
                        [--name]
                        [--yes]

Exemplos

Restaure todos os valores-chave para um point-in-time específico.

az appconfig kv restore -n MyAppConfiguration --datetime "2019-05-01T11:24:12Z"

Restaure uma chave específica para qualquer rótulo que comece com v1. usando a cadeia de conexão para um ponto específico no tempo.

az appconfig kv restore --key color --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --label v1.* --datetime "2019-05-01T11:24:12Z"

Parâmetros Obrigatórios

--datetime

Formato: "AAAA-MM-DDThh:mm:ssZ". Se nenhum fuso horário for especificado, use UTC por padrão.

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>o . Para obter mais informações, veja https://docs.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>o .

--key

Se nenhuma chave for especificada, restaure todas as chaves por padrão. Suporte sinal de estrela como filtros, por exemplo, abc* significa chaves com abc como prefixo.

--label

Se nenhum rótulo for especificado, restaure todos os pares chave-valor com todos os rótulos. Suporte sinal de estrela como filtros, por exemplo, abc* significa rótulos com abc como prefixo. Use '\0' para rótulo nulo.

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

--yes -y

Não solicite confirmação.

Default value: False
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

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

--verbose

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

az appconfig kv set

Editar

Defina um valor-chave.

az appconfig kv set --key
                    [--auth-mode {key, login}]
                    [--connection-string]
                    [--content-type]
                    [--endpoint]
                    [--label]
                    [--name]
                    [--tags]
                    [--value]
                    [--yes]

Exemplos

Defina um valor-chave com o rótulo MyLabel.

az appconfig kv set -n MyAppConfiguration --key color --label MyLabel --value red

Defina uma chave com rótulo nulo usando a cadeia de conexão.

az appconfig kv set --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --value red --tags key1=value1 key2=value2

Defina uma chave com valor de cadeia de caracteres e tipo de conteúdo JSON.

az appconfig kv set -n MyAppConfiguration --key color --value \"red\" --content-type application/json

Defina uma chave com valor de lista e tipo de conteúdo JSON.

az appconfig kv set -n MyAppConfiguration --key options --value [1,2,3] --content-type application/activity+json;charset=utf-8

Defina uma chave com valor nulo e tipo de conteúdo JSON.

az appconfig kv set -n MyAppConfiguration --key foo --value null --content-type application/json

Defina um valor-chave usando suas credenciais 'az login'.

az appconfig kv set --endpoint https://myappconfiguration.azconfig.io --key color --value red --auth-mode login

Parâmetros Obrigatórios

--key

Chave a definir. A chave não pode ser um '.' ou '..', ou conter o caractere '%'.

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>o . Para obter mais informações, veja https://docs.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.

--content-type

Tipo de conteúdo do valor-chave a ser definido.

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

--label

Se nenhum rótulo for especificado, defina a chave com rótulo nulo por padrão.

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

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--value

Valor do valor-chave a ser definido.

--yes -y

Não solicite confirmação.

Default value: False
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

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

--verbose

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

az appconfig kv set-keyvault

Editar

Defina uma referência keyvault.

az appconfig kv set-keyvault --key
                             --secret-identifier
                             [--auth-mode {key, login}]
                             [--connection-string]
                             [--endpoint]
                             [--label]
                             [--name]
                             [--tags]
                             [--yes]

Exemplos

Defina uma referência keyvault com o rótulo MyLabel.

az appconfig kv set-keyvault -n MyAppConfiguration --key HostSecret --label MyLabel --secret-identifier https://contoso.vault.azure.net/Secrets/DummySecret/Dummyversion

Defina uma referência keyvault com rótulo nulo e várias tags usando a cadeia de conexão.

az appconfig kv set-keyvault --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key HostSecret --secret-identifier https://contoso.vault.azure.net/Secrets/DummySecret --tags tag1=value1 tag2=value2

Parâmetros Obrigatórios

--key

Chave a definir. A chave não pode ser um '.' ou '..', ou conter o caractere '%'.

--secret-identifier

ID do objeto Key Vault. Pode ser encontrado usando o comando 'az keyvault {collection} show', onde collection é key, secret ou certificate. Para definir a referência à versão mais recente do seu segredo, remova as informações da versão do identificador secreto.

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>o . Para obter mais informações, veja https://docs.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>o .

--label

Se nenhum rótulo for especificado, defina a chave com rótulo nulo por padrão.

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

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--yes -y

Não solicite confirmação.

Default value: False
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

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

--verbose

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

az appconfig kv show

Editar

Mostrar todos os atributos de um valor-chave.

az appconfig kv show --key
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--datetime]
                     [--endpoint]
                     [--label]
                     [--name]

Exemplos

Mostrar um valor-chave usando o nome da App Configuration Store com um rótulo e datetime específicos

az appconfig kv show -n MyAppConfiguration --key color --label MyLabel --datetime "2019-05-01T11:24:12Z"

Mostrar um valor-chave usando cadeia de conexão com rótulo

az appconfig kv show --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label MyLabel

Mostre um valor-chave usando suas credenciais 'az login'.

az appconfig kv show --key color --auth-mode login --endpoint https://myappconfiguration.azconfig.io

Parâmetros Obrigatórios

--key

Chave a ser mostrada.

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>o . Para obter mais informações, veja https://docs.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.

--datetime

Formato: "AAAA-MM-DDThh:mm:ssZ". Se nenhum fuso horário for especificado, use UTC por padrão.

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

--label

Se nenhum rótulo for especificado, mostre a entrada com rótulo nulo. A filtragem não é suportada.

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

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

--verbose

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

az appconfig kv unlock

Editar

Desbloqueie um valor-chave para obter operações de gravação.

az appconfig kv unlock --key
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--endpoint]
                       [--label]
                       [--name]
                       [--yes]

Exemplos

Desbloqueie um valor-chave usando o nome da App Configuration Store.

az appconfig kv unlock -n MyAppConfiguration --key color --label test

Força o desbloqueio de um valor-chave usando a cadeia de conexão.

az appconfig kv unlock --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label test --yes

Parâmetros Obrigatórios

--key

Chave a ser desbloqueada.

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>o . Para obter mais informações, veja https://docs.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>o .

--label

Se nenhum rótulo for especificado, desbloqueie a entrada com rótulo nulo. A filtragem não é suportada.

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

--yes -y

Não solicite confirmação.

Default value: False
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

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

--verbose

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