az appconfig kv

Administre los valores de clave almacenados en un App Configuration.

Comandos

az appconfig kv delete

Elimine los valores de clave.

az appconfig kv export

Exporte configuraciones a otro lugar desde la App Configuration.

az appconfig kv import

Importe las configuraciones en el App Configuration desde otro lugar.

az appconfig kv list

Enumera los pares clave-valor.

az appconfig kv lock

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

az appconfig kv restore

Restaure los valores de clave.

az appconfig kv set

Establezca un valor de clave.

az appconfig kv set-keyvault

Establezca una referencia de keyvault.

az appconfig kv show

Muestra todos los atributos de un valor de clave.

az appconfig kv unlock

Desbloquee un valor de clave para obtener operaciones de escritura.

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 App Configuration nombre sin confirmación.

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

Elimine una clave mediante una 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 con las credenciales de "az login" y App Configuration punto de conexión.

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

Parámetros requeridos

--key

Admitir 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 la 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 "login", proporcione el nombre del almacén o el punto de conexión de la tienda y las credenciales "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 más información, consulte https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

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

Combinación de la clave de acceso y el 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> la variable de entorno o con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Si el modo de autenticación es "inicio de sesión", proporcione la dirección URL del punto de conexión del 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. Se admite el signo de estrella como filtros, por ejemplo * significa que todas las etiquetas y abc* significan etiquetas con abc como prefijo.

--name -n

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

--yes -y

No solicita confirmación.

az appconfig kv export

Exporte configuraciones a otro lugar desde la 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}]
                       [--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 la 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 prueba 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 App Configuration con 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 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

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 el App Configuration. Obligatorio para los argumentos de 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 la 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 "login", proporcione el nombre del almacén o el punto de conexión de la tienda y las credenciales "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 más información, consulte https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

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

Combinación de la clave de acceso y el 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> la variable de entorno o con el nombre AZURE_APPCONFIG_CONNECTION_STRING.

--dest-auth-mode

Modo de autenticación para conectarse al 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 del App Configuration 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 del App Configuration de destino.

--endpoint

Si el modo de autenticación es "inicio de sesión", proporcione la dirección URL del punto de conexión del 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 de clave como referencias de App Configuration. Para más información, consulte https://docs.microsoft.com/en-us/azure/app-service/app-service-configuration-references.

valores aceptados: false, true
--format

Formato de archivo al que se exporta. Obligatorio 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. El filtrado de claves no es 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 signos de asterisco y 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 del 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. Obligatorio 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
--profile

Exporte el perfil que se va a usar para exportar los pares clave-valor. 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
--separator

Delimitador para acoplar los pares clave-valor al archivo json o yaml. Necesario para exportar la estructura jerárquica. El separador se omitirá para los archivos de propiedades 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
--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
--yes -y

No solicite la versión preliminar.

az appconfig kv import

Importe las configuraciones en el 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}]
                       [--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]
                       [--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 las marcas de características con la etiqueta NULL y aplique una nueva etiqueta desde un App Configuration.

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

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 prueba de etiquetas y aplique la etiqueta test2 excepto las marcas de características de un 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 App Configuration.

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

Importe todas las claves y las marcas de características de 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 App Configuration con 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 las 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 el App Configuration. Obligatorio para los argumentos de 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 la 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 "login", proporcione el nombre del almacén o el punto de conexión de la tienda y las credenciales "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 más información, consulte https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

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

Combinación de la clave de acceso y el 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> la variable de entorno o 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 en 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 o las marcas de características.

--endpoint

Si el modo de autenticación es "inicio de sesión", proporcione la dirección URL del punto de conexión del 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. Obligatorio para los argumentos de archivo. Actualmente, las marcas de características no se admiten en formato de propiedades.

valores aceptados: json, properties, yaml
--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 del 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. Obligatorio 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
--profile

Importe el perfil que se va a usar para importar los pares clave-valor. 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 en pares clave-valor. El separador se omitirá para los archivos de propiedades 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
--src-auth-mode

Modo de autenticación para conectarse al 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 del App Configuration de origen.

--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. El filtrado de claves no es 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. Se admite el signo de estrella como filtros, por ejemplo * significa todas las etiquetas, abc* significa etiquetas con abc como prefijo.

--src-name

Nombre del App Configuration de origen.

--strict

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

valores aceptados: false, true
--yes -y

No solicite la versión preliminar.

az appconfig kv list

Enumerar los valores de clave.

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}]
                     [--top]

Ejemplos

Enumere todos los valores de clave con etiqueta null.

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

Enumere una clave específica para cualquier etiqueta que empiece por v1. mediante la 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 consulte solo 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 pares 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 las credenciales de "az login".

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

Parámetros opcionales

--all

Enumera todos los elementos.

--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 la 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 "login", proporcione el nombre del almacén o el punto de conexión de la tienda y las credenciales "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 más información, consulte https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

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

Combinación de la clave de acceso y el 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> la variable de entorno o 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 "inicio de sesión", proporcione la dirección URL del punto de conexión del 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 del 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 debe especificarse junto con --fields. En su lugar, use --query para la consulta personalizada.

valores aceptados: false, true
--top -t

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

az appconfig kv lock

Bloquee 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 App Configuration nombre.

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

Forzar el bloqueo de un valor de clave mediante la 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 la 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 "login", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales "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 más información, consulte 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 con "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 del 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 del App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--yes -y

No solicita confirmación.

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. mediante la 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 la 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 "login", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales "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 más información, consulte 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 con "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 del 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 del App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--yes -y

No solicita confirmación.

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 la 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 mediante 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 '.' ni '..', 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 la 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 "login", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales "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 más información, consulte 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 con "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 del 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 del 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 keyvalue que se va a establecer.

--yes -y

No solicita confirmación.

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 la etiqueta NULL y varias etiquetas mediante la 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 '.' ni '..', 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 del 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 la 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 "login", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales "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 más información, consulte 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 con "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 del 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 del 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.

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 App Configuration nombre 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 una 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 la 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 "login", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales "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 más información, consulte 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 con "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 del 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 del App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

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 App Configuration nombre.

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

Forzar el desbloqueo de un valor de clave mediante la 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 la 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 "login", proporcione el nombre del punto de conexión o almacén de la tienda y las credenciales "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 más información, consulte 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 con "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 del 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 del App Configuration. Puede configurar el nombre predeterminado mediante az configure --defaults app_configuration_store=<name>.

--yes -y

No solicita confirmación.