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

az appconfig snapshot

  • 参考

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

命令

名称 说明 类型 状态
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”，请提供存储终结点或存储名称，并将使用“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”，请提供存储终结点或存储名称，并将使用“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”，请提供存储终结点或存储名称，并将使用“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”，请提供存储终结点或存储名称，并将使用“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”，请提供存储终结点或存储名称，并将使用“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 获取完整的调试日志。