Compartir vía

az appconfig snapshot

  • Referencia

Administrar instantáneas asociadas a un almacén de configuración de aplicaciones.

Comandos

Nombre Description Tipo Estado
az appconfig snapshot archive

Archivar una instantánea.

 Core GA
az appconfig snapshot create

Cree una instantánea de configuración de la aplicación.

 Core GA
az appconfig snapshot list

Enumerar instantáneas.

 Core GA
az appconfig snapshot recover

Recuperar una instantánea archivada.

 Core GA
az appconfig snapshot show

Mostrar todos los atributos de una instantánea de configuración de la aplicación.

 Core GA

az appconfig snapshot archive

Editar

Archivar una instantánea.

az appconfig snapshot archive --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

Ejemplos

Archivar instantánea MySnapshot en el almacén de configuración MyAppConfiguration.

az appconfig snapshot archive -s MySnapshot -n MyAppConfiguration

Parámetros requeridos

--snapshot-name -s

Nombre de la instantánea de App Configuration.

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 "login", proporcione o --endpoint --name 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 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 la clave de acceso y el punto de conexión del almacé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 "inicio de sesión", proporcione la dirección URL del punto de conexión del almacé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>.

--name -n

Nombre del almacén 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 snapshot create

Editar

Cree una instantánea de configuración de la aplicación.

az appconfig snapshot create --filters
                             --snapshot-name
                             [--auth-mode {key, login}]
                             [--composition-type {key, key_label}]
                             [--connection-string]
                             [--endpoint]
                             [--name]
                             [--retention-period]
                             [--tags]

Ejemplos

Cree una instantánea MySnapshot de todas las claves a partir de "Probar" en el almacén de configuración MyAppConfiguration.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"Test*\"}'

Cree una instantánea MySnapshot de todas las claves a partir de "abc" y un período de retención de 1 hora.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"abc*\"}' --retention-period 3600

Cree una instantánea de todas las claves a partir de "app/" y ninguna etiqueta como predeterminada, invalide los valores de clave con claves con la etiqueta "prod" si existen.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"app/*\"}' '{\"key\":\"app/*\", \"label\":\"prod\"}' --composition-type 'key'

Parámetros requeridos

--filters

Lista separada por espacios de objetos JSON con escape que representan los filtros de clave y etiqueta usados para compilar una instantánea de App Configuration.

--snapshot-name -s

Nombre de la instantánea de App Configuration.

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 "login", proporcione o --endpoint --name 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 obtener más información, vea https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valores aceptados: key, login
Valor predeterminado: key
--composition-type

Tipo de composición usado en la creación de instantáneas de App Configuration. Si no se especifica, el valor predeterminado es key.

Valores aceptados: key, key_label
--connection-string

Combinación de la clave de acceso y el punto de conexión del almacé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 "inicio de sesión", proporcione la dirección URL del punto de conexión del almacé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>.

--name -n

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

--retention-period

Duración en segundos para la que una instantánea puede permanecer archivada antes de la expiración. Una instantánea se puede archivar durante un máximo de 7 días (604.800s) para almacenes de nivel gratis y 90 días (776 000s) para almacenes de niveles estándar. Si se especifica, el período de retención debe ser al menos 1 hora (3600s).

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...].

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

Editar

Enumerar instantáneas.

az appconfig snapshot list [--all]
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]
                           [--snapshot-name]
                           [--status {archived, failed, provisioning, ready}]
                           [--top]

Ejemplos

Enumere todas las instantáneas con nombres a partir del prefijo "abc".

az appconfig snapshot list -s abc* -n MyAppConfiguration

Enumera todas las instantáneas archivadas.

az appconfig snapshot list --status archived -n MyAppConfiguration

Enumere todas las instantáneas de aprovisionamiento con nombres a partir del prefijo "app".

az appconfig snapshot list -s app* --status provisioning -n MyAppConfiguration

Enumere todos los errores y las instantáneas de aprovisionamiento.

az appconfig snapshot list --status failed provisioning -n MyAppConfiguration

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 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 o --endpoint --name 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 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 la clave de acceso y el punto de conexión del almacé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 "inicio de sesión", proporcione la dirección URL del punto de conexión del almacé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

Personalice los campos de salida para instantáneas.

Valores aceptados: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

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

--snapshot-name -s

Si no se especifica ningún nombre, devuelva todas las instantáneas de forma predeterminada. Admitir el signo de estrella como filtros, por ejemplo abc* significa instantáneas con abc como prefijo para el nombre.

Valor predeterminado: *
--status

Filtre las instantáneas por su estado. Si no se especifica ningún estado, devuelva todas las instantáneas de forma predeterminada.

Valores aceptados: archived, failed, provisioning, ready
--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 snapshot recover

Editar

Recuperar una instantánea archivada.

az appconfig snapshot recover --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

Ejemplos

Recupere la instantánea MySnapshot en el almacén de configuración MyAppConfiguration.

az appconfig snapshot recover -s MySnapshot -n MyAppConfiguration

Parámetros requeridos

--snapshot-name -s

Nombre de la instantánea de App Configuration.

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 "login", proporcione o --endpoint --name 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 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 la clave de acceso y el punto de conexión del almacé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 "inicio de sesión", proporcione la dirección URL del punto de conexión del almacé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>.

--name -n

Nombre del almacén 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 snapshot show

Editar

Mostrar todos los atributos de una instantánea de configuración de la aplicación.

az appconfig snapshot show --snapshot-name
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]

Ejemplos

Muestra una instantánea de configuración de la aplicación con el nombre MySnapshot en el almacén de configuración MyAppConfiguration.

az appconfig snapshot show -s MySnapshot -n MyAppConfiguration

Parámetros requeridos

--snapshot-name -s

Nombre de la instantánea de App Configuration.

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 "login", proporcione o --endpoint --name 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 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 la clave de acceso y el punto de conexión del almacé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 "inicio de sesión", proporcione la dirección URL del punto de conexión del almacé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

Personalice los campos de salida para instantáneas.

Valores aceptados: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Nombre del almacén 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.