az appconfig
管理应用程序配置。
命令
az appconfig create
创建应用配置。
az appconfig create --location
--name
--resource-group
[--arm-auth-mode {local, pass-through}]
[--assign-identity]
[--disable-local-auth {false, true}]
[--enable-arm-private-network-access {false, true}]
[--enable-public-network {false, true}]
[--enable-purge-protection {false, true}]
[--kv-revision-retention-period]
[--no-replica {false, true}]
[--replica-location]
[--replica-name]
[--retention-days]
[--sku {Developer, Free, Premium, Standard}]
[--tags]
示例
创建名称、位置、SKU、标记和资源组的应用配置存储区。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --tags key1=value1 key2=value2
使用开发人员 SKU 创建应用程序配置存储
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Developer
使用副本创建高级 SKU 应用配置存储
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Premium --replica-name MyReplica --replica-location eastus
创建没有副本的高级 SKU 应用配置存储
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Premium --no-replica
创建具有系统分配标识的名称、位置、SKU 和资源组的应用配置存储区。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --assign-identity
创建具有用户分配标识的名称、位置、SKU 和资源组的应用配置存储区。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --assign-identity /subscriptions/<SUBSCRIPTON ID>/resourcegroups/<RESOURCEGROUP>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myUserAssignedIdentity
创建名称、位置和资源组的应用配置存储区,其中启用了公用网络访问,并禁用了本地身份验证。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --enable-public-network --disable-local-auth
创建名称、位置和资源组的应用配置存储,并将 ARM 身份验证模式设置为直通。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --arm-auth-mode pass-through
创建名称、位置和资源组的应用配置存储,其 ARM 身份验证模式设置为启用 ARM 专用链接的直通和专用网络访问。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --arm-auth-mode pass-through --enable-arm-private-network-access true
创建一个应用配置存储区,其密钥值修订保留期为一天(以秒为单位)。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --kv-revision-retention-period 86400
必需参数
Location.
az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>配置默认名称。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
通过 ARM 访问应用配置存储的身份验证模式。 “直通”(建议)使用 Microsoft Entra ID 通过 ARM 使用适当的授权访问存储。“local”使用访问密钥进行身份验证。 这需要启用访问密钥。
| 属性 | 值 |
|---|---|
| 接受的值: | local, pass-through |
要分配的托管标识的空间分隔列表。 使用“[system]”来引用系统分配的托管标识或资源 ID 来引用用户分配的托管标识。 如果未提供此参数任何值,则默认情况下将分配系统分配的托管标识。 如果未提供此参数,则不会向此应用程序配置存储区分配托管标识。
禁用除 AAD 身份验证以外的所有身份验证方法。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
如果资源仅限于专用网络访问,则通过 ARM 专用链接启用对应用配置存储的访问。 需要直通 ARM 身份验证模式。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
如果为 true,来自公用网络的请求有权在启用专用终结点时访问此存储。 如果为 false,则只有通过专用链接发出的请求才能访问此存储。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
指定是否为此应用程序配置存储启用针对清除的保护的属性。 将此属性设置为 true 可激活针对此应用程序配置存储及其内容的清除保护。 启用此功能不可逆。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
在应用程序配置存储中保留键值修订的持续时间(以秒为单位)。 对于免费和开发人员 SKU 存储,修订最多可以保留 7 天(604,800s):对于标准和高级 SKU 存储,最多 30 天(2,592,000s)。 只有非免费层才能更新此值。 如果指定,则保留期必须至少为 1 小时(3600s)。
继续为高级层存储创建副本。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
应用程序配置存储的副本的位置。
应用程序配置存储的副本的名称。
删除后保留启用软删除的应用配置存储的天数。 必须是介于 0 和 7 之间的正整数。
应用配置存储的 SKU。
| 属性 | 值 |
|---|---|
| 默认值: | Standard |
| 接受的值: | Developer, Free, Premium, Standard |
空格分隔标记:key[=value] [key[=value] ...]。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az appconfig delete
删除应用配置存储区。
az appconfig delete --name
[--resource-group]
[--yes]
示例
删除资源组下的应用配置存储区
az appconfig delete -g MyResourceGroup -n MyAppConfiguration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>配置默认名称。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
不要提示确认。
| 属性 | 值 |
|---|---|
| 默认值: | False |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az appconfig list
列出当前订阅下的所有应用配置存储区。
az appconfig list [--resource-group]
示例
列出资源组下的所有应用配置存储区
az appconfig list -g MyResourceGroup
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az appconfig list-deleted
列出所有已删除但尚未清除的应用配置存储区。
az appconfig list-deleted
示例
列出所有已删除但尚未清除的应用配置存储区。
az appconfig list-deleted
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az appconfig purge
永久删除应用配置存储区。 Aka“清除”已删除的应用配置存储区。
az appconfig purge --name
[--location]
[--yes]
示例
清除名为“sample-app-configuration”的已删除应用配置存储区。
az appconfig purge --name sample-app-configuration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>配置默认名称。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
已删除的应用配置存储区的位置。 可以使用命令 az appconfig show-deleted查看 。
不要提示确认。
| 属性 | 值 |
|---|---|
| 默认值: | False |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az appconfig recover
恢复以前删除但尚未清除的应用配置存储。
az appconfig recover --name
[--location]
[--resource-group]
[--yes]
示例
恢复名为“sample-app-configuration”的已删除应用配置存储区。
az appconfig recover --name sample-app-configuration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>配置默认名称。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
已删除的应用配置存储区的位置。 可以使用命令 az appconfig show-deleted查看 。
已删除的应用配置存储的资源组。
不要提示确认。
| 属性 | 值 |
|---|---|
| 默认值: | False |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az appconfig show
显示应用配置存储区的属性。
az appconfig show --name
[--resource-group]
示例
显示应用配置存储区的属性
az appconfig show -g MyResourceGroup -n MyAppConfiguration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>配置默认名称。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az appconfig show-deleted
显示已删除但尚未清除的应用配置存储的属性。
az appconfig show-deleted --name
[--location]
示例
显示名为“sample-app-configuration”的已删除应用配置存储的属性。
az appconfig show-deleted --name sample-app-configuration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>配置默认名称。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
已删除的应用配置存储区的位置。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az appconfig update
更新应用配置存储区。
az appconfig update --name
[--arm-auth-mode {local, pass-through}]
[--disable-local-auth {false, true}]
[--enable-arm-private-network-access {false, true}]
[--enable-public-network {false, true}]
[--enable-purge-protection {false, true}]
[--encryption-key-name]
[--encryption-key-vault]
[--encryption-key-version]
[--identity-client-id]
[--kv-revision-retention-period]
[--resource-group]
[--sku {Developer, Free, Premium, Standard}]
[--tags]
示例
更新应用配置存储的标记
az appconfig update -g MyResourceGroup -n MyAppConfiguration --tags key1=value1 key2=value2
将应用配置存储的 SKU 升级到标准层
az appconfig update -g MyResourceGroup -n MyAppConfiguration --sku Standard
将应用配置存储的 SKU 升级到高级层
az appconfig update -g MyResourceGroup -n MyAppConfiguration --sku Premium
使用系统分配的标识启用客户加密密钥
az appconfig update -g MyResourceGroup -n MyAppConfiguration --encryption-key-name myKey --encryption-key-version keyVersion --encryption-key-vault https://keyVaultName.vault.azure.net
删除客户加密密钥
az appconfig update -g MyResourceGroup -n MyAppConfiguration --encryption-key-name ""
更新应用配置存储区以启用公共网络访问并禁用本地身份验证。
az appconfig update -g MyResourceGroup -n MyAppConfiguration --enable-public-network true --disable-local-auth true
更新应用配置存储区,将 ARM 身份验证模式设置为直通。
az appconfig update -g MyResourceGroup -n MyAppConfiguration --arm-auth-mode pass-through
更新应用配置存储区,将 ARM 身份验证模式设置为直通,并通过 ARM 专用链接启用专用网络访问。
az appconfig update -g MyResourceGroup -n MyAppConfiguration --arm-auth-mode pass-through --enable-arm-private-network-access true
更新应用配置存储区以设置一天(以秒为单位)的键值修订保留期。
az appconfig update -g MyResourceGroup -n MyAppConfiguration --kv-revision-retention-period 86400
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>配置默认名称。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
通过 ARM 访问应用配置存储的身份验证模式。 “直通”(建议)使用 Microsoft Entra ID 通过 ARM 使用适当的授权访问存储。“local”使用访问密钥进行身份验证。 这需要启用访问密钥。
| 属性 | 值 |
|---|---|
| 接受的值: | local, pass-through |
禁用除 AAD 身份验证以外的所有身份验证方法。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
如果资源仅限于专用网络访问,则通过 ARM 专用链接启用对应用配置存储的访问。 需要直通 ARM 身份验证模式。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
如果为 true,来自公用网络的请求有权在启用专用终结点时访问此存储。 如果为 false,则只有通过专用链接发出的请求才能访问此存储。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
指定是否为此应用程序配置存储启用针对清除的保护的属性。 将此属性设置为 true 可激活针对此应用程序配置存储及其内容的清除保护。 启用此功能不可逆。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
KeyVault 密钥的名称。
| 属性 | 值 |
|---|---|
| 参数组: | Customer Managed Key Arguments |
KeyVault 的 URI。
| 属性 | 值 |
|---|---|
| 参数组: | Customer Managed Key Arguments |
KeyVault 密钥的版本。 默认情况下使用最新版本。
| 属性 | 值 |
|---|---|
| 参数组: | Customer Managed Key Arguments |
对加密密钥进行包装和解包访问的托管标识的客户端 ID。 默认情况下使用系统分配的托管标识。
| 属性 | 值 |
|---|---|
| 参数组: | Customer Managed Key Arguments |
在应用程序配置存储中保留键值修订的持续时间(以秒为单位)。 对于免费和开发人员 SKU 存储,修订最多可以保留 7 天(604,800s):对于标准和高级 SKU 存储,最多 30 天(2,592,000s)。 只有非免费层才能更新此值。 如果指定,则保留期必须至少为 1 小时(3600s)。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
应用配置存储的 SKU。
| 属性 | 值 |
|---|---|
| 接受的值: | Developer, Free, Premium, Standard |
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |