az appconfig kv

Referência

Gerencie chaves-valor armazenadas em um repositório da Configuração de Aplicativos.

Comandos

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

az appconfig kv delete

Editar

Exclua chaves-valor.

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

Exemplos

Exclua uma chave usando o nome da loja da 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 'az login' e o ponto de extremidade do repositório da Configuração de Aplicativos.

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

Parâmetros Exigidos

--key

Apoie o sinal de estrela como filtros, por exemplo * significa todas as chaves 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 "chave", forneça a cadeia de conexão ou o nome do repositório 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 "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://docs.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 da 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> uma variável de ambiente com o nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se o modo de autenticação for "login", forneça a URL do ponto de extremidade do repositório da 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>o .

--label

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

--name -n

Nome do repositório da 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 o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az appconfig kv export

Editar

Exporte as configurações para outro local do repositório da 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 todos os sinalizadores de recurso 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 chaves e sinalizadores de recursos com todos os rótulos para outro repositório da 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 da 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 da Configuração de Aplicativos usando suas credenciais '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 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 da Configuração de Aplicativos 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 Exigidos

--destination -d

O destino da exportação. Observe que não há suporte para a exportação de 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 ele esteja na mesma assinatura e grupo de recursos que o repositório da Configuração de Aplicativos. Necessário para argumentos 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 da 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 forem especificados, atribuirá rótulo nulo.

--dest-name

O nome do repositório de configuração de aplicativos de destino.

--endpoint

--export-as-reference -r

Exporte chaves-valor como referências da Configuração de Aplicativos. Para obter mais informações, consulte https://docs.microsoft.com/en-us/azure/app-service/app-service-configuration-references.

Valores aceitos: false, true

Valor padrão: False

--format

Formato de arquivo exportando para. 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 for especificada, retorne todas as chaves por padrão. Suporte ao sinal de estrela como filtros, por exemplo, abc* significa chaves com abc como prefixo. A filtragem de chave não se aplica a sinalizadores de recursos. Por padrão, todos os sinalizadores de recursos com rótulo especificado serão exportados.

--label

Somente chaves e sinalizadores de recursos com esse rótulo 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 de exportação é appconfig ou quando o destino de exportação é um arquivo com appconfig/kvset perfil, esse argumento suporta asterisco e sinais de 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 da 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. Este argumento NÃO deve ser especificado junto com --dest-label.

Valores aceitos: false, true

Valor padrão: False

--profile

Perfil de exportação a ser usado para exportar as chaves-valor. 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 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 de 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 recurso. 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 ao appservice.

Valores aceitos: false, true

Valor padrão: 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 aceitos: false, true

Valor padrão: False

--snapshot

Exporte todas as chaves em um determinado instantâneo do repositório da Configuração de Aplicativos. Se nenhum snapshot 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 o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az appconfig kv import

Editar

Importe configurações para o repositório da 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 recurso 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 da 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 da 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 teste de rótulo e aplique o rótulo test2 excluindo sinalizadores de recursos de um repositório da 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 da 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 da Configuração de Aplicativos usando suas credenciais '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 para pares chave-valor. Nivele para o nível mais profundo por padrão se --separator for fornecido. Não aplicável a arquivos de propriedade ou sinalizadores de recurso.

--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 as chaves-valor de origem que ainda não existem ou cujo valor, tipo de conteúdo ou tags são diferentes dos de uma chave-valor existente com a mesma chave e rótulo serão gravados. O modo de importação "all" grava todas as chaves-valor no destino, independentemente de existirem ou não.

Valores aceitos: all, ignore-match

Valor padrão: ignore-match

--label

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

--name -n

Nome do repositório da 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á anexado à frente das chaves importadas. O prefixo será ignorado para sinalizadores de recursos.

--preserve-labels

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

Valores aceitos: false, true

Valor padrão: False

--profile

Perfil de importação a ser usado para importar as chaves-valor. As opções 'depth', 'separator', 'content-type', 'label', 'skip-features' e 'prefix' não são suportadas 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 para pares chave-valor. O separador será ignorado para arquivos de propriedade e sinalizadores de recurso. 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 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 da Configuração de Aplicativos de origem.

--src-key

Se nenhuma chave for especificada, importe todas as chaves por padrão. Suporte ao sinal de estrela como filtros, por exemplo, abc* significa chaves com abc como prefixo. A filtragem de chave não se aplica 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 as chaves com rótulo nulo por padrão. Suporte o 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 da Configuração de Aplicativos de origem. Se nenhum snapshot for especificado, as chaves atualmente no repositório serão importadas com base nos filtros de chave e rótulo especificados.

--strict

Exclua todas as outras chaves-valor no repositório com prefixo e 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 o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az appconfig kv list

Editar

Liste chaves-valor.

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 todas as chaves-valor 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 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 a chave e o valor.

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

Liste chaves-valor com vários rótulos.

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

Liste todas as chaves-valor com todos os rótulos usando suas credenciais 'az login'.

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

Liste todas as chaves-valor 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

Liste todos os itens.

Valor padrão: False

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--datetime

Formato: "YYYY-MM-DDThh:mm:ssZ". Se nenhum fuso horário for 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 for especificada, retorne todas as chaves por padrão. Suporte ao 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 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 da 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 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 da 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 devolvidos. Deve ser um número inteiro positivo. O padrão é 100.

Parâmetros Globais

--debug

Aumente o detalhamento 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 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 o detalhamento do log. 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 da 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 trancada.

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--endpoint

--label

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

--name -n

Nome do repositório da 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 o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az appconfig kv restore

Editar

Restaure chaves-valor.

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

Exemplos

Restaurar todas as chaves-valor em um momento 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 Exigidos

--datetime

Formato: "YYYY-MM-DDThh:mm:ssZ". Se nenhum fuso horário for 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. Suporte ao 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 de 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 da 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 o detalhamento 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 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 o detalhamento do 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 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 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 '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 um '.' 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 for especificado, defina a chave com rótulo nulo por padrão.

--name -n

Nome do repositório da 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 as tags existentes.

--value

Valor da chave-valor a ser definida.

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az appconfig kv set-keyvault

Editar

Defina uma referência de cofre de chaves.

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 cofre de chaves 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 cofre de chaves 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 um '.' ou '..', ou conter o caractere '%'.

--secret-identifier

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

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--endpoint

--label

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

--name -n

Nome do repositório da 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 as tags existentes.

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento 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 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 o detalhamento do 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 da loja da Configuração de Aplicativos com um rótulo e data e hora 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 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 Exigidos

--key

Chave a ser mostrada.

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--datetime

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

--endpoint

--label

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

--name -n

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

Parâmetros Globais

--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az appconfig kv unlock

Editar

Desbloqueie uma chave-valor 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 loja da Configuração de Aplicativos.

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

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

Parâmetros Opcionais

--auth-mode

Valores aceitos: key, login

Valor padrão: key

--connection-string

--endpoint

--label

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

--name -n

Nome do repositório da 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 o detalhamento 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 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 o detalhamento do 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