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>配置默认组。
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
通过 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>配置默认名称。
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
资源组的名称。 可以使用 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
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
资源组的名称。 可以使用 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>配置默认名称。
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
已删除的应用配置存储区的位置。 可以使用命令 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>配置默认名称。
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
已删除的应用配置存储区的位置。 可以使用命令 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>配置默认名称。
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
资源组的名称。 可以使用 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>配置默认名称。
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
已删除的应用配置存储区的位置。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | 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>配置默认名称。
可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
通过 ARM 访问应用配置存储的身份验证模式。 “直通”(建议)使用 Microsoft Entra ID 通过 ARM 使用适当的授权访问存储。“local”使用访问密钥进行身份验证。 这需要启用访问密钥。
| 属性 | 值 |
|---|---|
| 接受的值: | local, pass-through |
禁用除 AAD 身份验证以外的所有身份验证方法。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
如果资源仅限于专用网络访问,则通过 ARM 专用链接启用对应用配置存储的访问。 需要直通 ARM 身份验证模式。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
如果为 true,来自公用网络的请求有权在启用专用终结点时访问此存储。 如果为 false,则只有通过专用链接发出的请求才能访问此存储。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
指定是否为此应用程序配置存储启用针对清除的保护的属性。 将此属性设置为 true 可激活针对此应用程序配置存储及其内容的清除保护。 启用此功能不可逆。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
KeyVault 密钥的名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Customer Managed Key Arguments |
KeyVault 的 URI。
| 属性 | 值 |
|---|---|
| Parameter group: | Customer Managed Key Arguments |
KeyVault 密钥的版本。 默认情况下使用最新版本。
| 属性 | 值 |
|---|---|
| Parameter group: | Customer Managed Key Arguments |
对加密密钥进行包装和解包访问的托管标识的客户端 ID。 默认情况下使用系统分配的托管标识。
| 属性 | 值 |
|---|---|
| Parameter group: | 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 |