你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az appconfig snapshot

管理与应用配置存储关联的快照。

命令

名称	说明	类型	Status
az appconfig snapshot archive	存档快照。	核心	GA
az appconfig snapshot create	创建应用配置快照。	核心	GA
az appconfig snapshot list	列出快照。	核心	GA
az appconfig snapshot recover	恢复存档的快照。	核心	GA
az appconfig snapshot show	显示应用配置快照的所有属性。	核心	GA

az appconfig snapshot archive

存档快照。

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

示例

在配置存储 MyAppConfiguration 中存档快照 MySnapshot。

az appconfig snapshot archive -s MySnapshot -n MyAppConfiguration

必需参数

--snapshot-name -s

应用程序配置快照的名称。

可选参数

--auth-mode

此参数可用于指示如何授权数据操作。 如果身份验证模式为“密钥”，请提供连接字符串或存储名称，并检索帐户访问密钥以进行授权。 如果身份验证模式为“login”，请提供 --endpoint 或 --name “az login”凭据用于授权。 可以使用 . 配置默认身份验证模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 有关详细信息，请参阅 https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login

默认值: key

--connection-string

应用程序配置存储的访问密钥和终结点的组合。 可以使用“az appconfig credential list”找到。 用户可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或环境变量预设其名称AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果身份验证模式为“登录”，请提供应用程序配置存储的终结点 URL。 可以使用“az appconfig show”命令检索终结点。 可以使用 . 配置默认终结点 az configure --defaults appconfig_endpoint=<endpoint>。

--name -n

应用程序配置存储的名称。 可以使用 .. 配置默认名称 az configure --defaults app_configuration_store=<name>。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az appconfig snapshot create

创建应用配置快照。

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

示例

在配置存储 MyAppConfiguration 中创建以“Test”开头的所有密钥的快照 MySnapshot。

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

创建从“abc”开始的所有密钥的快照 MySnapshot，保留期为 1 小时。

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

创建以“app/”开头的所有键的快照，并且没有默认标签，然后使用标签“prod”的键替代键值（如果存在）。

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

必需参数

--filters

转义 JSON 对象的空格分隔列表，这些对象表示用于生成应用程序配置快照的键和标签筛选器。

--snapshot-name -s

应用程序配置快照的名称。

可选参数

--auth-mode

此参数可用于指示如何授权数据操作。 如果身份验证模式为“密钥”，请提供连接字符串或存储名称，并检索帐户访问密钥以进行授权。 如果身份验证模式为“login”，请提供 --endpoint 或 --name “az login”凭据用于授权。 可以使用 . 配置默认身份验证模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 有关详细信息，请参阅 https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login

默认值: key

--composition-type

用于生成应用程序配置快照的合成类型。 如果未指定，则默认为键。

接受的值: key, key_label

--connection-string

应用程序配置存储的访问密钥和终结点的组合。 可以使用“az appconfig credential list”找到。 用户可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或环境变量预设其名称AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果身份验证模式为“登录”，请提供应用程序配置存储的终结点 URL。 可以使用“az appconfig show”命令检索终结点。 可以使用 . 配置默认终结点 az configure --defaults appconfig_endpoint=<endpoint>。

--name -n

应用程序配置存储的名称。 可以使用 .. 配置默认名称 az configure --defaults app_configuration_store=<name>。

--retention-period

快照在过期前可以保持存档状态的持续时间（以秒为单位）。 对于免费层存储，快照最多可存档 7 天（604,800s），标准层存储可以存档 90 天（7,776,000s）。 如果指定，则保留期必须至少为 1 小时（3600s）。

--tags

空格分隔标记：key[=value] [key[=value] ...]。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az appconfig snapshot list

列出快照。

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]

示例

列出名称以前缀“abc”开头的所有快照。

az appconfig snapshot list -s abc* -n MyAppConfiguration

列出所有存档的快照。

az appconfig snapshot list --status archived -n MyAppConfiguration

列出名称以前缀“app”开头的所有预配快照。

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

列出所有失败的快照和预配快照。

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

可选参数

--all

列出所有项。

--auth-mode

此参数可用于指示如何授权数据操作。 如果身份验证模式为“密钥”，请提供连接字符串或存储名称，并检索帐户访问密钥以进行授权。 如果身份验证模式为“login”，请提供 --endpoint 或 --name “az login”凭据用于授权。 可以使用 . 配置默认身份验证模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 有关详细信息，请参阅 https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login

默认值: key

--connection-string

应用程序配置存储的访问密钥和终结点的组合。 可以使用“az appconfig credential list”找到。 用户可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或环境变量预设其名称AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果身份验证模式为“登录”，请提供应用程序配置存储的终结点 URL。 可以使用“az appconfig show”命令检索终结点。 可以使用 . 配置默认终结点 az configure --defaults appconfig_endpoint=<endpoint>。

--fields

自定义快照的输出字段。

接受的值: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags

--name -n

应用程序配置存储的名称。 可以使用 .. 配置默认名称 az configure --defaults app_configuration_store=<name>。

--snapshot-name -s

如果未指定任何名称，则默认返回所有快照。 支持星号作为筛选器，例如 abc* 表示具有 abc 作为名称前缀的快照。

默认值: *

--status

按快照的状态筛选快照。 如果未指定状态，则默认返回所有快照。

接受的值: archived, failed, provisioning, ready

--top -t

要返回的最大项目数。 必须是正整数。 默认值为 100。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az appconfig snapshot recover

恢复存档的快照。

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

示例

在配置存储 MyAppConfiguration 中恢复快照 MySnapshot。

az appconfig snapshot recover -s MySnapshot -n MyAppConfiguration

必需参数

--snapshot-name -s

应用程序配置快照的名称。

可选参数

--auth-mode

此参数可用于指示如何授权数据操作。 如果身份验证模式为“密钥”，请提供连接字符串或存储名称，并检索帐户访问密钥以进行授权。 如果身份验证模式为“login”，请提供 --endpoint 或 --name “az login”凭据用于授权。 可以使用 . 配置默认身份验证模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 有关详细信息，请参阅 https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login

默认值: key

--connection-string

应用程序配置存储的访问密钥和终结点的组合。 可以使用“az appconfig credential list”找到。 用户可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或环境变量预设其名称AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果身份验证模式为“登录”，请提供应用程序配置存储的终结点 URL。 可以使用“az appconfig show”命令检索终结点。 可以使用 . 配置默认终结点 az configure --defaults appconfig_endpoint=<endpoint>。

--name -n

应用程序配置存储的名称。 可以使用 .. 配置默认名称 az configure --defaults app_configuration_store=<name>。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az appconfig snapshot show

显示应用配置快照的所有属性。

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]

示例

在配置存储 MyAppConfiguration 中显示名为 MySnapshot 的应用配置快照。

az appconfig snapshot show -s MySnapshot -n MyAppConfiguration

必需参数

--snapshot-name -s

应用程序配置快照的名称。

可选参数

--auth-mode

此参数可用于指示如何授权数据操作。 如果身份验证模式为“密钥”，请提供连接字符串或存储名称，并检索帐户访问密钥以进行授权。 如果身份验证模式为“login”，请提供 --endpoint 或 --name “az login”凭据用于授权。 可以使用 . 配置默认身份验证模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 有关详细信息，请参阅 https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login

默认值: key

--connection-string

应用程序配置存储的访问密钥和终结点的组合。 可以使用“az appconfig credential list”找到。 用户可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或环境变量预设其名称AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果身份验证模式为“登录”，请提供应用程序配置存储的终结点 URL。 可以使用“az appconfig show”命令检索终结点。 可以使用 . 配置默认终结点 az configure --defaults appconfig_endpoint=<endpoint>。

--fields

自定义快照的输出字段。

接受的值: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags

--name -n

应用程序配置存储的名称。 可以使用 .. 配置默认名称 az configure --defaults app_configuration_store=<name>。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。