Share via


az appconfig kv

Administrar los valores de clave almacenados en una instancia de App Configuration.

Comandos

Nombre Description Tipo Estado
az appconfig kv delete

Elimine los valores de clave.

Principal GA
az appconfig kv export

Exportar configuraciones a otro lugar desde App Configuration.

Principal GA
az appconfig kv import

Importe las configuraciones en App Configuration desde otro lugar.

Principal GA
az appconfig kv list

Enumera los valores clave-valor.

Principal GA
az appconfig kv lock

Bloquear un valor de clave para prohibir las operaciones de escritura.

Principal GA
az appconfig kv restore

Restaure los valores de clave.

Principal GA
az appconfig kv set

Establezca un valor de clave.

Principal GA
az appconfig kv set-keyvault

Establezca una referencia de keyvault.

Principal GA
az appconfig kv show

Mostrar todos los atributos de un valor de clave.

Principal GA
az appconfig kv unlock

Desbloquee un valor de clave para obtener operaciones de escritura.

Principal GA

az appconfig kv delete

Elimine los valores de clave.

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

Ejemplos

Elimine una clave mediante el nombre de App Configuration sin confirmación.

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

Elimine una clave mediante cadena de conexión.

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

Elimine una clave mediante las credenciales de "az login" y el punto de conexión de App Configuration.

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

Parámetros requeridos

--key

Admite el signo de estrella como filtros, por ejemplo * significa todas las claves y abc* significa claves con abc como prefijo.

Parámetros opcionales

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--label

Si no se especifica ninguna etiqueta, elimine la entrada con la etiqueta NULL. Admitir el signo de estrella como filtros, por ejemplo * significa todas las etiquetas y abc* significa etiquetas con abc como prefijo.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv export

Exportar configuraciones a otro lugar desde App Configuration.

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]

Ejemplos

Exporte todas las claves y las marcas de características con la prueba de etiqueta a un archivo JSON.

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

Exporte todas las claves con etiqueta NULL a una aplicación de App Service.

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

Exporte todas las claves con pruebas de etiquetas, excepto las marcas de características a un archivo JSON.

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

Exporte todas las claves y marcas de características con todas las etiquetas a otra App Configuration.

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

Exporte todas las claves y marcas de características con todas las etiquetas a otra App Configuration y sobrescriba las etiquetas de destino.

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

Exporte todas las claves a otra instancia de App Configuration mediante las credenciales "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 las claves y marcas de características con la prueba de etiquetas mediante el perfil appconfig/kvset.

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

Exportación de todas las claves a otra instancia de App Configuration desde una instantánea de la configuración de origen

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

Parámetros requeridos

--destination -d

Destino de la exportación. Tenga en cuenta que no se admite la exportación de marcas de características a appservice.

valores aceptados: appconfig, appservice, file

Parámetros opcionales

--appservice-account

Id. de ARM para AppService O el nombre de AppService, suponiendo que se encuentra en la misma suscripción y grupo de recursos que App Configuration. Obligatorio para los argumentos appService.

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--dest-auth-mode

Modo de autenticación para conectarse a App Configuration de destino. Para obtener más información, consulte el argumento "--auth-mode".

valores aceptados: key, login
valor predeterminado: key
--dest-connection-string

Combinación de la clave de acceso y el punto de conexión del almacén de destino.

--dest-endpoint

Si --dest-auth-mode es "login", proporcione la dirección URL del punto de conexión de la configuración de la aplicación de destino.

--dest-label

Los KV exportados se etiquetarán con esta etiqueta de destino. Si no se especifica --dest-label ni --preserve-labels, asignará una etiqueta nula.

--dest-name

Nombre de app Configuration de destino.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--export-as-reference -r

Exporte los valores clave-valor como referencias de App Configuration. Para obtener más información, vea https://docs.microsoft.com/en-us/azure/app-service/app-service-configuration-references.

valores aceptados: false, true
valor predeterminado: False
--format

Formato de archivo al que se exporta. Necesario para los argumentos de archivo. Actualmente, las marcas de características no se admiten en formato de propiedades.

valores aceptados: json, properties, yaml
--key

Si no se especifica ninguna clave, devuelva todas las claves de forma predeterminada. Admitir el signo de estrella como filtros, por ejemplo abc* significa claves con abc como prefijo. Filtrado de claves no aplicable a las marcas de características. De forma predeterminada, se exportarán todas las marcas de características con la etiqueta especificada.

--label

Solo se exportarán las claves y las marcas de características con esta etiqueta. Si no se especifica ninguna etiqueta, exporte las claves y las marcas de características con la etiqueta NULL de forma predeterminada. Cuando el destino de exportación es appconfig, o cuando el destino de exportación es archivo con appconfig/kvset perfil, este argumento admite asterisco y signos de coma para el filtrado de etiquetas, por ejemplo, * significa todas las etiquetas, abc* significa etiquetas con abc como prefijo y abc,xyz significa etiquetas con abc o xyz.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--naming-convention

Convención de nomenclatura que se usará para la sección "Administración de características" del archivo. Ejemplo: pascal = FeatureManagement, camel = featureManagement, subrayado = feature_management, guion = administración de características.

valores aceptados: camel, hyphen, pascal, underscore
valor predeterminado: pascal
--path

Ruta de acceso del archivo de configuración local. Necesario para los argumentos de archivo.

--prefix

Prefijo que se va a recortar de las claves. El prefijo se omitirá para las marcas de características.

--preserve-labels

Marca para conservar las etiquetas de AppConfig de origen. Este argumento NO se debe especificar junto con --dest-label.

valores aceptados: false, true
valor predeterminado: False
--profile

Exporte el perfil que se va a usar para exportar los valores de clave. Las opciones "depth", "separator", "naming-convention", "prefix", "dest-label" y "resolve-keyvault" no se admiten al usar el perfil "appconfig/kvset".

valores aceptados: appconfig/default, appconfig/kvset
valor predeterminado: appconfig/default
--resolve-keyvault

Resuelva el contenido de la referencia del almacén de claves.

valores aceptados: false, true
valor predeterminado: False
--separator

Delimitador para aplanar los pares clave-valor en el archivo json o yaml. Necesario para exportar la estructura jerárquica. Se omitirá el separador para los archivos de propiedad y las marcas de características. Valores admitidos: '.', ',', ';', '-', '_', '__', '/', ':'.

--skip-features

Exportar elementos excepto todas las marcas de características. De forma predeterminada, todas las características con la etiqueta especificada se exportarán al archivo o appconfig. No es aplicable al servicio de aplicaciones.

valores aceptados: false, true
valor predeterminado: False
--skip-keyvault

Exportar elementos excepto todas las referencias del almacén de claves. De forma predeterminada, se exportarán todas las referencias del almacén de claves con la etiqueta especificada.

valores aceptados: false, true
valor predeterminado: False
--snapshot

Exporte todas las claves de una instantánea determinada del almacén de App Configuration. Si no se especifica ninguna instantánea, las claves que se encuentran actualmente en el almacén se exportan en función de los filtros de clave y etiqueta especificados.

--yes -y

No solicite la versión preliminar.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv import

Importe las configuraciones en App Configuration desde otro lugar.

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]

Ejemplos

Importe todas las claves y las marcas de características de un archivo y aplique la etiqueta de prueba.

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

Importe todas las claves y marcas de características con la etiqueta NULL y aplique una nueva etiqueta desde una instancia de App Configuration.

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

Importe todas las claves desde una instantánea de una instancia de App Configuration.

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

Importe todas las claves y aplique la etiqueta null desde una aplicación de App Service.

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

Importe todas las claves con la prueba de etiquetas y aplique la etiqueta test2 excepto las marcas de características de una instancia de App Configuration.

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

Importe todas las claves y marcas de características con todas las etiquetas a otra configuración de la aplicación.

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

Importe todas las claves y marcas de características desde un archivo JSON y aplique el tipo de contenido JSON.

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

Importe todas las claves a otra instancia de App Configuration mediante las credenciales "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 las claves y marcas de características de un archivo mediante el formato appconfig/kvset.

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

Parámetros requeridos

--source -s

Origen de la importación. Tenga en cuenta que no se admite la importación de marcas de características desde appservice.

valores aceptados: appconfig, appservice, file

Parámetros opcionales

--appservice-account

Id. de ARM para AppService O el nombre de AppService, suponiendo que se encuentra en la misma suscripción y grupo de recursos que App Configuration. Obligatorio para los argumentos appService.

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--content-type

Tipo de contenido de todos los elementos importados.

--depth

Profundidad para aplanar el archivo json o yaml a pares clave-valor. Se aplana al nivel más profundo de forma predeterminada si se proporciona --separator. No es aplicable a los archivos de propiedad ni a las marcas de características.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--format

Formato de archivo importado. Necesario para los argumentos de archivo. Actualmente, las marcas de características no se admiten en formato de propiedades.

valores aceptados: json, properties, yaml
--import-mode

Si el modo de importación es "ignore-match", los valores de clave de origen que ya existen en el destino no se sobrescribirán. El modo de importación "all" escribe todos los valores de clave en el destino, independientemente de si existen o no.

valores aceptados: all, ignore-match
valor predeterminado: ignore-match
--label

Los KV importados y las marcas de características se asignarán con esta etiqueta. Si no se especifica ninguna etiqueta, asignará una etiqueta nula.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--path

Ruta de acceso del archivo de configuración local. Necesario para los argumentos de archivo.

--prefix

Este prefijo se anexará al principio de las claves importadas. El prefijo se omitirá para las marcas de características.

--preserve-labels

Marca para conservar las etiquetas de AppConfig de origen. Este argumento NO se debe especificar junto con --label.

valores aceptados: false, true
valor predeterminado: False
--profile

Importe el perfil que se va a usar para importar los valores de clave. Las opciones "depth", "separator", "content-type", "label", "skip-features" y "prefix" no se admiten al usar el perfil "appconfig/kvset".

valores aceptados: appconfig/default, appconfig/kvset
valor predeterminado: appconfig/default
--separator

Delimitador para aplanar el archivo json o yaml a pares clave-valor. Se omitirá el separador para los archivos de propiedad y las marcas de características. Valores admitidos: '.', ',', ';', '-', '_', '__', '/', ':'.

--skip-features

Importe solo los valores de clave y excluya todas las marcas de características. De forma predeterminada, todas las marcas de características se importarán desde el archivo o appconfig. No es aplicable al servicio de aplicaciones.

valores aceptados: false, true
valor predeterminado: False
--src-auth-mode

Modo de autenticación para conectarse a App Configuration de origen. Para obtener más información, consulte el argumento "--auth-mode".

valores aceptados: key, login
valor predeterminado: key
--src-connection-string

Combinación de la clave de acceso y el punto de conexión del almacén de origen.

--src-endpoint

Si --src-auth-mode es "login", proporcione la dirección URL del punto de conexión de source App Configuration.

--src-key

Si no se especifica ninguna clave, importe todas las claves de forma predeterminada. Admitir el signo de estrella como filtros, por ejemplo abc* significa claves con abc como prefijo. Filtrado de claves no aplicable a las marcas de características. De forma predeterminada, se importarán todas las marcas de características con la etiqueta especificada.

--src-label

Solo se importarán las claves con esta etiqueta en appConfig de origen. Si no se especifica ningún valor, importe las claves con la etiqueta NULL de forma predeterminada. Admitir el signo de estrella como filtros, por ejemplo * significa todas las etiquetas, abc* significa etiquetas con abc como prefijo.

--src-name

Nombre de la configuración de la aplicación de origen.

--src-snapshot

Importe todas las claves en una instantánea determinada del almacén de App Configuration de origen. Si no se especifica ninguna instantánea, las claves que se encuentran actualmente en el almacén se importan en función de los filtros de clave y etiqueta especificados.

--strict

Elimine todos los demás valores clave-valor del almacén con el prefijo y la etiqueta especificados.

valores aceptados: false, true
valor predeterminado: False
--yes -y

No solicite la versión preliminar.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv list

Enumera los valores clave-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]

Ejemplos

Enumere todos los valores clave-valor con etiqueta NULL.

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

Enumere una clave específica para cualquier etiqueta que empiece por v1. usar cadena de conexión.

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

Enumere todas las claves con cualquier etiqueta y solo consulte la clave, el valor y las etiquetas.

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"

Enumere el contenido de la referencia del almacén de claves con el prefijo de clave "KVRef_" y seleccione solo la clave y el valor.

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

Enumera los valores clave-valor con varias etiquetas.

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

Enumere todos los valores de clave con todas las etiquetas con sus credenciales "az login".

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

Enumere todos los valores de clave en una instantánea determinada del almacén de configuración de aplicaciones.

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

Parámetros opcionales

--all

Enumera todos los elementos.

valor predeterminado: False
--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--datetime

Formato: «AAAA/MM/DDTHH:mm:ss». Si no se especifica ninguna zona horaria, use UTC de forma predeterminada.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--fields

Campos de salida personalizados separados por espacios.

valores aceptados: content_type, etag, key, label, last_modified, locked, tags, value
--key

Si no se especifica ninguna clave, devuelva todas las claves de forma predeterminada. Admitir el signo de estrella como filtros, por ejemplo abc* significa claves con abc como prefijo.

--label

Si no se especifica ninguna etiqueta, enumere todas las etiquetas. Admitir el signo de estrella como filtros, por ejemplo abc* significa etiquetas con abc como prefijo. Use '\0' para la etiqueta null.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--resolve-keyvault

Resuelva el contenido de la referencia del almacén de claves. Este argumento NO se debe especificar junto con --fields. En su lugar, use --query para la consulta personalizada.

valores aceptados: false, true
valor predeterminado: False
--snapshot

Enumere todas las claves de una instantánea determinada del almacén de App Configuration. Si no se especifica ninguna instantánea, se muestran las claves que se encuentran actualmente en el almacén.

--top -t

Número máximo de elementos que se van a devolver. Debe ser un entero positivo. El valor predeterminado es 100.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv lock

Bloquear un valor de clave para prohibir las operaciones de escritura.

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

Ejemplos

Bloquee un valor de clave mediante el nombre de App Configuration.

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

Forzar el bloqueo de un valor de clave mediante cadena de conexión.

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

Parámetros requeridos

--key

Clave que se va a bloquear.

Parámetros opcionales

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--label

Si no se especifica ninguna etiqueta, bloquee la entrada con la etiqueta NULL. No se admite el filtrado.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv restore

Restaure los valores de clave.

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

Ejemplos

Restaure todos los valores de clave a un momento dado

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

Restaure una clave específica para cualquier etiqueta que comience con la versión 1. usar cadena de conexión a un momento dado específico.

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 requeridos

--datetime

Formato: «AAAA/MM/DDTHH:mm:ss». Si no se especifica ninguna zona horaria, use UTC de forma predeterminada.

Parámetros opcionales

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--key

Si no se especifica ninguna clave, restaure todas las claves de forma predeterminada. Admitir el signo de estrella como filtros, por ejemplo abc* significa claves con abc como prefijo.

--label

Si no se especifica ninguna etiqueta, restaure todos los pares clave-valor con todas las etiquetas. Admitir el signo de estrella como filtros, por ejemplo abc* significa etiquetas con abc como prefijo. Use '\0' para la etiqueta null.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv set

Establezca un valor de clave.

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

Ejemplos

Establezca un valor de clave con la etiqueta MyLabel.

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

Establezca una clave con etiqueta null mediante cadena de conexión.

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

Establezca una clave con el valor de cadena y el tipo de contenido JSON.

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

Establezca una clave con el valor de lista y el tipo de contenido JSON.

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

Establezca una clave con un valor NULL y un tipo de contenido JSON.

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

Establezca un valor de clave con las credenciales de "az login".

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

Parámetros requeridos

--key

Clave que se va a establecer. La clave no puede ser '.' o '..', ni contener el carácter '%'.

Parámetros opcionales

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--content-type

Tipo de contenido del valor de clave que se va a establecer.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--label

Si no se especifica ninguna etiqueta, establezca la clave con etiqueta null de forma predeterminada.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--value

Valor del valor de keyvalue que se va a establecer.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv set-keyvault

Establezca una referencia de keyvault.

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

Ejemplos

Establezca una referencia de keyvault con la etiqueta MyLabel.

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

Establezca una referencia de keyvault con etiqueta NULL y varias etiquetas mediante cadena de conexión.

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 requeridos

--key

Clave que se va a establecer. La clave no puede ser '.' o '..', ni contener el carácter '%'.

--secret-identifier

Identificador del objeto Key Vault. Se puede encontrar mediante el comando "az keyvault {collection} show", donde la colección es clave, secreto o certificado. Para establecer la referencia a la versión más reciente del secreto, quite la información de versión del identificador secreto.

Parámetros opcionales

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--label

Si no se especifica ninguna etiqueta, establezca la clave con etiqueta null de forma predeterminada.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv show

Mostrar todos los atributos de un valor de clave.

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

Ejemplos

Mostrar un valor de clave mediante el nombre de App Configuration con una etiqueta específica y datetime

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

Mostrar un valor de clave mediante cadena de conexión con etiqueta

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

Muestre un valor de clave con las credenciales de "az login".

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

Parámetros requeridos

--key

Clave que se va a mostrar.

Parámetros opcionales

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--datetime

Formato: «AAAA/MM/DDTHH:mm:ss». Si no se especifica ninguna zona horaria, use UTC de forma predeterminada.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--label

Si no se especifica ninguna etiqueta, muestre la entrada con la etiqueta NULL. No se admite el filtrado.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az appconfig kv unlock

Desbloquee un valor de clave para obtener operaciones de escritura.

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

Ejemplos

Desbloquee un valor de clave mediante el nombre de App Configuration.

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

Forzar el desbloqueo de un valor de clave mediante cadena de conexión.

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

Parámetros requeridos

--key

Clave que se va a desbloquear.

Parámetros opcionales

--auth-mode

Este parámetro se puede usar para indicar cómo se va a autorizar una operación de datos. Si el modo de autenticación es "clave", proporcione cadena de conexión o el nombre del almacén y las claves de acceso de la cuenta se recuperarán para la autorización. Si el modo de autenticación es "inicio de sesión", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales de "az login" se usarán para la autorización. Puede configurar el modo de autenticación predeterminado mediante az configure --defaults appconfig_auth_mode=<auth_mode>. Para obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valores aceptados: key, login
valor predeterminado: key
--connection-string

Combinación de clave de acceso y punto de conexión de App Configuration. Se puede encontrar mediante "az appconfig credential list". Los usuarios pueden preestablecerlo mediante az configure --defaults appconfig_connection_string=<connection_string> o variable de entorno con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Si el modo de autenticación es "login", proporcione la dirección URL del punto de conexión de App Configuration. El punto de conexión se puede recuperar mediante el comando "az appconfig show". Puede configurar el punto de conexión predeterminado mediante az configure --defaults appconfig_endpoint=<endpoint>.

--label

Si no se especifica ninguna etiqueta, desbloquee la entrada con la etiqueta NULL. No se admite el filtrado.

--name -n

Nombre de App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.