你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az spring
注意
此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展,使其受益于其扩展功能。 详细了解扩展。
用于管理 Azure Spring Apps 的命令。
命令
az spring create
创建 Azure Spring Apps 实例。
az spring create --name
--resource-group
[--acs-gen {Gen1, Gen2}]
[--ap-instance]
[--app-insights]
[--app-insights-key]
[--app-network-resource-group]
[--app-subnet]
[--build-pool-size {S1, S2, S3, S4, S5, S6, S7, S8, S9}]
[--disable-app-insights {false, true}]
[--disable-build-service {false, true}]
[--enable-acs]
[--enable-alv]
[--enable-api-portal]
[--enable-app-acc]
[--enable-config-server]
[--enable-dataplane-public-endpoint {false, true}]
[--enable-gateway]
[--enable-java-agent {false, true}]
[--enable-log-stream-public-endpoint {false, true}]
[--enable-private-storage-access {false, true}]
[--enable-service-registry]
[--gateway-instance-count]
[--infra-resource-group]
[--ingress-read-timeout]
[--location]
[--managed-environment]
[--marketplace-plan-id]
[--no-wait]
[--outbound-type]
[--registry-password]
[--registry-server]
[--registry-username]
[--reserved-cidr-range]
[--sampling-rate]
[--service-runtime-network-resource-group]
[--service-runtime-subnet]
[--sku {Basic, Enterprise, Standard, StandardGen2}]
[--tags]
[--vnet]
[--zone-redundant {false, true}]
示例
在 westus 中创建新的 Azure Spring Apps。
az spring create -n MyService -g MyResourceGroup -l westus
使用连接字符串(建议)或检测密钥,在 westus 中使用现有的 Application Insights 创建新的 Azure Spring Apps。
az spring create -n MyService -g MyResourceGroup -l westus --app-insights-key "MyConnectionString"
使用现有的 Application Insights 在 westus 中创建新的 Azure Spring Apps。
az spring create -n MyService -g MyResourceGroup -l westus --app-insights appInsightsName
使用现有的 Application Insights 在 westus 中创建新的 Azure Spring Apps 并指定采样率。
az spring create -n MyService -g MyResourceGroup -l westus --app-insights appInsightsName --sampling-rate 10
使用 Application Insights 禁用创建新的 Azure Spring Apps。
az spring create -n MyService -g MyResourceGroup --disable-app-insights
通过为当前资源组中的 VNet 名称注入 VNet 创建新的 Azure Spring Apps
az spring create -n MyService -g MyResourceGroup --vnet MyVNet --app-subnet MyAppSubnet --service-runtime-subnet MyServiceRuntimeSubnet
通过为子网资源 ID 注入 VNet 创建新的 Azure Spring Apps
az spring create -n MyService -g MyResourceGroup --app-subnet /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyVnetRg/providers/Microsoft.Network/VirtualNetworks/test-vnet/subnets/app --service-runtime-subnet /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyVnetRg/providers/Microsoft.Network/VirtualNetworks/test-vnet/subnets/svc --reserved-cidr-range 10.0.0.0/16,10.1.0.0/16,10.2.0.1/16
如果 Azure 订阅从未托管 Azure Spring Apps Enterprise 实例,则创建 Azure Spring Apps Enterprise 实例
az provider register -n Microsoft.SaaS
az term accept --publisher vmware-inc --product azure-spring-cloud-vmware-tanzu-2 --plan asa-ent-hr-mtr
az spring create -n MyService -g MyResourceGroup --sku Enterprise
创建启用了 Tanzu 组件的 Azure Spring Apps Enterprise 实例。
az provider register -n Microsoft.SaaS
az term accept --publisher vmware-inc --product azure-spring-cloud-vmware-tanzu-2 --plan asa-ent-hr-mtr
az spring create -n MyService -g MyResourceGroup --sku Enterprise --enable-application-configuration-service --enable-config-server --enable-service-registry --enable-gateway --enable-api-portal --enable-application-live-view --enable-application-accelerator
必需参数
Azure Spring Apps 实例的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
(仅限企业层)要启用的应用程序配置服务生成。
(仅限企业层)API 门户实例数。
同一资源组中现有 Application Insights 的名称。 或不同资源组中现有 Application Insights 的资源 ID。
现有 Application Insights 的连接字符串(建议)或检测密钥。
将在其中创建应用的所有网络资源的资源组。
要在其中部署 Spring Apps 应用的“vnet”中现有子网的名称或 ID。 部署到虚拟网络时是必需的。 支持较小的子网大小,请参阅:https://aka.ms/azure-spring-cloud-smaller-subnet-vnet-docs。
(仅限企业层)生成代理池的大小。 请参阅 https://aka.ms/azure-spring-cloud-build-service-docs 了解大小信息。
禁用 Application Insights(如果未禁用)且未使用 --app-insights-key 或 --app-insights 指定的现有 Application Insights,则会在同一资源组中创建新的 Application Insights 实例。
(仅限企业层)禁用生成服务。
(仅限企业层)启用应用程序配置服务。
(仅限企业层)启用应用程序实时视图。
(仅限企业层)启用 API 门户。
(仅限企业层)启用应用程序加速器。
(仅限企业层)启用配置服务器。
如果为 true,请为日志流式处理、远程调试分配公共终结点,在可从虚拟网络访问的 vnet 注入实例中连接应用。
(仅限企业层)启用 Spring Cloud Gateway。
选项“--enable-java-agent”已弃用,将在将来的版本中删除。
进程代理中的 Java 现已正式发布,在 Application Insights 启用时默认使用。 不再需要此参数,将在将来的版本中删除。
选项“--enable-log-stream-public-endpoint”已弃用,将在将来的版本中删除。 请改用“--enable-dataplane-public-endpoint”。
如果为 true,请为 vnet 注入实例中的日志流分配公共终结点,该实例可从虚拟网络访问。
如果为 true,请将专用网络访问设置为 vnet 注入实例中的后端存储。
(仅限企业层)启用服务注册表。
(仅限企业层)Spring Cloud Gateway 实例数。
包含基础结构资源的资源组的名称。
入口读取超时值(以秒为单位)。 默认值 300,最小值为 1,最大值为 1800。
位置。 值来自:az account list-locations
。 可以使用 az configure --defaults location=<location>
配置默认位置。
Spring Apps 实例所基于的容器应用环境的资源 ID。
(仅限企业层)指定要使用 Spring 实例购买的其他市场计划。 通过运行 az spring list-marketplace-plan -o table
列出所有计划。
不要等待长时间运行的操作完成。
Azure Spring Apps VNet 实例的出站类型。
(仅限企业层)生成服务中使用的容器注册表密码。
(仅限企业层)生成服务中使用的容器注册表服务器。
(仅限企业层)生成服务中使用的容器注册表用户名。
CIDR 格式的 IP 地址范围的逗号分隔列表。 IP 范围保留为托管基础 Azure Spring Apps 基础结构(至少为 3 个未使用的 IP 范围)不得与任何子网 IP 范围重叠。
Application Insights 的采样率。 最小值为 0,最大值为 100。
将在其中创建 Azure Spring Apps 服务运行时的所有网络资源的资源组。
要在其中部署 Spring Apps 服务运行时的“vnet”中现有子网的名称或 ID。 部署到虚拟网络时是必需的。
SKU 的名称。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
要在其中部署 Spring Apps 实例的现有虚拟网络的名称或 ID。
在 Azure 可用性区域中创建 Azure Spring Apps 服务,目前只能在多个区域支持此功能。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring delete
删除 Azure Spring Apps。
az spring delete --name
--resource-group
[--no-wait]
必需参数
Azure Spring Apps 实例的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
不要等待长时间运行的操作完成。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring flush-virtualnetwork-dns-settings
此命令处于预览阶段,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus
(仅限标准和企业层)刷新 Azure Spring Apps 的虚拟网络 DNS 设置。
az spring flush-virtualnetwork-dns-settings --name
--resource-group
[--no-wait]
必需参数
Azure Spring Apps 实例的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
不要等待长时间运行的操作完成。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring list
列出给定资源组中的所有 Azure Spring Apps,否则列出订阅。
az spring list [--resource-group]
可选参数
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring list-marketplace-plan
此命令处于预览阶段,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus
(仅限企业层)列出要购买的市场计划。
az spring list-marketplace-plan
示例
列出所有计划。
az spring list-marketplace-plan -o table
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring list-support-server-versions
此命令处于预览阶段,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus
(仅限标准和基本层)列出受支持的服务器版本。
az spring list-support-server-versions --resource-group
--service
示例
列出受支持的服务器版本。
az spring list-support-server-versions -o table -s MyService -g MyResourceGroup
必需参数
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure Spring Apps 实例的名称,可以使用 az configure --defaults spring=<name>
配置默认服务。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring show
显示 Azure Spring Apps 的详细信息。
az spring show --name
--resource-group
必需参数
Azure Spring Apps 实例的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring start
启动 Azure Spring Apps。
az spring start --name
--resource-group
[--no-wait]
必需参数
Azure Spring Apps 实例的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
不要等待长时间运行的操作完成。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring stop
停止 Azure Spring Apps。
az spring stop --name
--resource-group
[--no-wait]
必需参数
Azure Spring Apps 实例的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
不要等待长时间运行的操作完成。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az spring update
更新 Azure Spring Apps。
az spring update --name
--resource-group
[--app-insights]
[--app-insights-key]
[--build-pool-size {S1, S2, S3, S4, S5, S6, S7, S8, S9}]
[--disable-app-insights {false, true}]
[--enable-dataplane-public-endpoint {false, true}]
[--enable-log-stream-public-endpoint {false, true}]
[--enable-planned-maintenance]
[--enable-private-storage-access {false, true}]
[--ingress-read-timeout]
[--no-wait]
[--planned-maintenance-day {Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
[--planned-maintenance-start-hour]
[--sku {Basic, Enterprise, Standard, StandardGen2}]
[--tags]
示例
更新定价层。
az spring update -n MyService --sku Standard -g MyResourceGroup
更新现有 Azure Spring Apps 的标记。
az spring update -n MyService -g MyResourceGroup --tags key1=value1 key2=value2
配置计划内维护
az spring update -n MyService -g MyResourceGroup --enable-planned-maintenance --planned-maintenance-day Friday --planned-maintenance-start-hour 10
必需参数
Azure Spring Apps 实例的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
参数“az spring update --app-insights”已弃用,将在将来的版本中删除。 请改用“az spring app-insights update --app-insights”。
同一资源组中现有 Application Insights 的名称。 或不同资源组中现有 Application Insights 的资源 ID。
参数“az spring update --app-insights-key”已弃用,将在将来的版本中删除。 请改用“az spring app-insights update --app-insights-key”。
现有 Application Insights 的连接字符串(建议)或检测密钥。
(仅限企业层)生成代理池的大小。 请参阅 https://aka.ms/azure-spring-cloud-build-service-docs 了解大小信息。
参数“az spring update --disable-app-insights”已弃用,将在将来的版本中删除。 请改用“az spring app-insights update --disable”。
禁用 Application Insights(如果未禁用)且未使用 --app-insights-key 或 --app-insights 指定的现有 Application Insights,则会在同一资源组中创建新的 Application Insights 实例。
如果为 true,请为日志流式处理、远程调试分配公共终结点,在可从虚拟网络访问的 vnet 注入实例中连接应用。
选项“--enable-log-stream-public-endpoint”已弃用,将在将来的版本中删除。 请改用“--enable-dataplane-public-endpoint”。
如果为 true,请为 vnet 注入实例中的日志流分配公共终结点,该实例可从虚拟网络访问。
如果已设置,请为实例启用计划内维护。
如果为 true,请将专用网络访问设置为 vnet 注入实例中的后端存储。
入口读取超时值(以秒为单位)。 最小值为 1,最大值为 1800。
不要等待长时间运行的操作完成。
计划内维护的一周中的一天。
计划内维护时段的开始时间(UTC)。 必须介于 0 和 23 之间。
SKU 的名称。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。