az appconfig kv

Referência

Gerenciar valores-chave armazenados em um repositório de Configuração de Aplicativos.

Comandos

Nome	Description	Tipo	Status
az appconfig kv delete	Excluir valores-chave.	Núcleo	GA
az appconfig kv export	Exportar configurações para outro local do repositório de Configuração de Aplicativos.	Núcleo	GA
az appconfig kv import	Importe as configurações para o repositório de Configuração de Aplicativos de outro local.	Núcleo	GA
az appconfig kv list	Listar valores-chave.	Núcleo	GA
az appconfig kv lock	Bloqueie um valor de chave para proibir operações de gravação.	Núcleo	GA
az appconfig kv restore	Restaurar valores-chave.	Núcleo	GA
az appconfig kv set	Defina um valor-chave.	Núcleo	GA
az appconfig kv set-keyvault	Defina uma referência de keyvault.	Núcleo	GA
az appconfig kv show	Mostrar todos os atributos de um valor-chave.	Núcleo	GA
az appconfig kv unlock	Desbloqueie um valor-chave para obter operações de gravação.	Núcleo	GA

az appconfig kv delete

Editar

Excluir valores-chave.

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

Exemplos

Exclua uma chave usando o nome do repositório de Configuração de Aplicativos 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 do repositório de Configuração de Aplicativos.

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

Parâmetros Exigidos

--key

Dar suporte ao sinal de estrela como filtros, por exemplo * significa que toda chave e abc* significa chaves com abc como prefixo.

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

--label

Se nenhum rótulo especificado, exclua a entrada com rótulo nulo. Dar suporte ao sinal de estrela como filtros, por exemplo * significa que todo o rótulo e abc* significa rótulos com abc como prefixo.

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

--yes -y

Não solicite confirmação.

Valor padrão: False

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

Editar

Exportar configurações para outro local do repositório de Configuração de Aplicativos.

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 chaves e sinalizadores de recursos com o teste de rótulo para um arquivo json. Para usar o esquema de Gerenciamento de Recursos da Microsoft ao exportar sinalizadores de recursos para um arquivo, defina a variável de ambiente AZURE_APPCONFIG_FM_COMPATIBLE como False.

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 o 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 chaves e sinalizadores de recursos com todos os rótulos para outro repositório de Configuração de Aplicativos.

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

Exporte todas as chaves e sinalizadores de recursos com todos os rótulos para outro repositório de Configuração de Aplicativos 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 outro repositório 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 chaves 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 outro repositório de Configuração de Aplicativos de um instantâneo da configuração de origem

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

Parâmetros Exigidos

--destination -d

O destino da exportação. Observe que não há suporte para exportar sinalizadores de recursos para o appservice.

Valores aceitos: appconfig, appservice, file

Parâmetros Opcionais

--appservice-account

ID do ARM para AppService OU o nome do AppService, supondo que esteja na mesma assinatura e grupo de recursos que o repositório de Configuração de Aplicativos. Necessário para argumentos do AppService.

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--dest-auth-mode

Modo de autenticação para se conectar ao repositório de Configuração de Aplicativos de destino. Para obter detalhes, consulte o argumento "--auth-mode".

Valores aceitos: key, login

Valor padrão: key

--dest-connection-string

Combinação de chave de acesso e ponto de extremidade do repositório de destino.

--dest-endpoint

Se --dest-auth-mode for "login", forneça a URL do ponto de extremidade do repositório de Configuração de Aplicativos de destino.

--dest-label

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

--dest-name

O nome do repositório de Configuração de Aplicativos de destino.

--endpoint

--export-as-reference -r

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

Valores aceitos: false, true

Valor padrão: False

--format

Formato de arquivo para o qual exportar. Necessário para argumentos de arquivo. Atualmente, não há suporte para sinalizadores de recursos no formato de propriedades.

Valores aceitos: json, properties, yaml

--key

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

--label

Somente chaves e sinalizadores de recursos com esse rótulo serão exportados. Se nenhum rótulo especificado, exporte chaves e sinalizadores de recursos com rótulo nulo por padrão. Quando o destino de exportação é appconfig ou quando o destino de exportação é arquivo com appconfig/kvset perfil, esse argumento dá suporte a 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 do repositório 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, sublinhado = feature_management, hífen = gerenciamento de recursos.

Valores aceitos: camel, hyphen, pascal, underscore

Valor padrão: 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

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

Valores aceitos: false, true

Valor padrão: False

--profile

Exportar o perfil a ser usado para exportar os valores-chave. As opções 'depth', 'separator', 'naming-convention', 'prefix', 'dest-label' e , 'resolve-keyvault' não têm suporte ao usar o perfil 'appconfig/kvset'.

Valores aceitos: appconfig/default, appconfig/kvset

Valor padrão: appconfig/default

--resolve-keyvault

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

Valores aceitos: false, true

Valor padrão: False

--separator

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

--skip-features

Exportar itens excluindo todos os sinalizadores de recursos. Por padrão, todos os recursos com o rótulo especificado serão exportados para arquivo ou configuração. Não aplicável ao appservice.

Valores aceitos: false, true

Valor padrão: False

--skip-keyvault

Exportar 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 aceitos: false, true

Valor padrão: False

--snapshot

Exporte todas as chaves em um determinado instantâneo do repositório de Configuração de Aplicativos. Se nenhum instantâneo for especificado, as chaves atualmente no repositório serão exportadas com base nos filtros de chave e rótulo especificados.

--yes -y

Não solicite a visualização.

Valor padrão: False

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

Editar

Importe as configurações para o repositório de Configuração de Aplicativos 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 um repositório 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 um repositório 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 o 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 um repositório 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 chaves e sinalizadores de recursos com todos os rótulos para outro repositório 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 outro repositório 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 Exigidos

--source -s

A origem da importação. Observe que não há suporte para a importação de sinalizadores de recursos do appservice.

Valores aceitos: appconfig, appservice, file

Parâmetros Opcionais

--appservice-account

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--content-type

Tipo de conteúdo de todos os itens importados.

--depth

Profundidade para nivelar o arquivo json ou yaml em pares chave-valor. Nivele 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

--format

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

Valores aceitos: json, properties, yaml

--import-mode

Se o modo de importação for "ignore-match", somente os valores de chave de origem que ainda não existem ou cujo valor, tipo de conteúdo ou marcas 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 aceitos: all, ignore-match

Valor padrão: ignore-match

--label

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

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

--path

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

--prefix

Esse prefixo será acrescentado à frente das chaves importadas. O prefixo será ignorado para sinalizadores de recursos.

--preserve-labels

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

Valores aceitos: false, true

Valor padrão: False

--profile

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

Valores aceitos: appconfig/default, appconfig/kvset

Valor padrão: appconfig/default

--separator

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

--skip-features

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

Valores aceitos: false, true

Valor padrão: False

--src-auth-mode

Modo de autenticação para se conectar ao repositório de Configuração de Aplicativos de origem. Para obter detalhes, consulte o argumento "--auth-mode".

Valores aceitos: key, login

Valor padrão: key

--src-connection-string

Combinação de chave de acesso e ponto de extremidade do repositório de origem.

--src-endpoint

Se --src-auth-mode for "login", forneça a URL do ponto de extremidade do repositório de Configuração de Aplicativos de origem.

--src-key

Se nenhuma chave for especificada, importe todas as chaves por padrão. Dar suporte ao sinal de estrela como filtros, por exemplo, abc* significa chaves com abc como prefixo. Filtragem de chave não aplicável a sinalizadores de recursos. Por padrão, todos os sinalizadores de recursos com o 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 especificado, importe chaves com rótulo nulo por padrão. Suporte ao sinal de estrela como filtros, por exemplo * significa todos os rótulos, abc* significa rótulos com abc como prefixo.

--src-name

O nome do repositório de Configuração de Aplicativos de origem.

--src-snapshot

Importe todas as chaves em um determinado instantâneo do repositório de Configuração de Aplicativos de origem. Se nenhum instantâneo for especificado, as chaves atualmente no repositório serão importadas com base nos filtros de chave e rótulo especificados.

--strict

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

Valores aceitos: false, true

Valor padrão: False

--yes -y

Não solicite a visualização.

Valor padrão: False

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

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

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

Liste uma chave específica para qualquer início de rótulo 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 qualquer rótulo e consulta somente chave, valor e marcas.

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

Listar 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 de "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.

Valor padrão: False

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--datetime

Formato: "YYYYY-MM-DDThh:mm:ss["Z"/±hh:mm]. Se nenhum fuso horário ou deslocamento especificado, use UTC por padrão.

--endpoint

--fields

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

Valores aceitos: content_type, etag, key, label, last_modified, locked, tags, value

--key

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

--label

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

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

--resolve-keyvault

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

Valores aceitos: false, true

Valor padrão: False

--snapshot

Liste todas as chaves em um determinado instantâneo do repositório de Configuração de Aplicativos. Se nenhum instantâneo for especificado, as chaves atualmente no repositório serão listadas.

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

Editar

Bloqueie um valor de 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 de chave usando o nome do repositório de Configuração de Aplicativos.

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

Forçar 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 Exigidos

--key

Chave a ser bloqueada.

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--endpoint

--label

Se nenhum rótulo especificado, bloqueie a entrada com rótulo nulo. Não há suporte para filtragem.

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

--yes -y

Não solicite confirmação.

Valor padrão: False

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

Editar

Restaurar 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 ponto específico no tempo.

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 Exigidos

--datetime

Formato: "YYYYY-MM-DDThh:mm:ss["Z"/±hh:mm]. Se nenhum fuso horário ou deslocamento especificado, use UTC por padrão.

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--endpoint

--key

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

--label

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

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

--yes -y

Não solicite confirmação.

Valor padrão: False

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 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 o valor da cadeia de caracteres e o tipo de conteúdo JSON.

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

Defina uma chave com o valor da lista e o 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 de "az login".

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

Parâmetros Exigidos

--key

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

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--content-type

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

--endpoint

--label

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

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

--tags

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

--value

Valor do valor-chave a ser definido.

--yes -y

Não solicite confirmação.

Valor padrão: False

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 kv set-keyvault

Editar

Defina uma referência de 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 de 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 de keyvault com rótulo nulo e várias marcas 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 Exigidos

--key

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

--secret-identifier

ID do objeto Key Vault. Pode ser encontrado usando o comando 'az keyvault {collection} show', em que a coleção é chave, segredo ou certificado. Para definir a referência à versão mais recente do seu segredo, remova as informações de versão do identificador secreto.

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--endpoint

--label

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

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

--tags

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

--yes -y

Não solicite confirmação.

Valor padrão: False

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 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 do repositório de Configuração de Aplicativos 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 a cadeia de conexão com o rótulo

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

Mostrar um valor-chave usando suas credenciais de "az login".

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

Parâmetros Exigidos

--key

Chave a ser mostrada.

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--datetime

Formato: "YYYYY-MM-DDThh:mm:ss["Z"/±hh:mm]. Se nenhum fuso horário ou deslocamento especificado, use UTC por padrão.

--endpoint

--label

Se nenhum rótulo especificado, mostre a entrada com rótulo nulo. Não há suporte para filtragem.

--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 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 do repositório de Configuração de Aplicativos.

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

Forçar 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 Exigidos

--key

Chave a ser desbloqueada.

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--endpoint

--label

Se nenhum rótulo especificado, desbloqueie a entrada com rótulo nulo. Não há suporte para filtragem.

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

--yes -y

Não solicite confirmação.

Valor padrão: False

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.

Compartilhar via

az appconfig kv

Comandos

az appconfig kv delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az appconfig kv export

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az appconfig kv import

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az appconfig kv list

Exemplos

Parâmetros Opcionais

az appconfig kv lock

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az appconfig kv restore

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az appconfig kv set

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az appconfig kv set-keyvault

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az appconfig kv show

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az appconfig kv unlock

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Recursos adicionais