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

az sf application

参考

管理在 Azure Service Fabric 群集上运行的应用程序。仅支持 ARM 部署的应用程序。

命令

名称	说明	类型	Status
az sf application certificate	管理应用程序的证书。	核心	GA
az sf application certificate add	将新证书添加到构成托管应用程序使用的群集的虚拟机规模集。	核心	GA
az sf application create	在 Azure Service Fabric 群集上创建新应用程序。	核心	GA
az sf application delete	删除应用程序。	核心	GA
az sf application list	列出给定群集的应用程序。	核心	GA
az sf application show	显示 Azure Service Fabric 群集上应用程序的属性。	核心	GA
az sf application update	更新 Azure Service Fabric 应用程序。这允许更新应用程序参数和/或升级将触发应用程序升级的应用程序类型版本。	核心	GA

az sf application create

在 Azure Service Fabric 群集上创建新应用程序。

az sf application create --application-name
                         --application-type-name
                         --application-type-version
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--max-nodes]
                         [--min-nodes]
                         [--package-url]

示例

使用参数创建应用程序“testApp”。应用程序类型“TestAppType”版本“v1”应已存在于群集中，应在应用程序清单中定义应用程序参数。

az sf application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0

使用提供的包 URL 创建应用程序“testApp”和应用类型版本。

az sf application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --package-url "https://sftestapp.blob.core.windows.net/sftestapp/testApp_1.0.sfpkg" \
    --application-parameters key0=value0

必需参数

--application-name --name

指定应用程序名称。

--application-type-name --type-name

指定应用程序类型名称。

--application-type-version --version

指定应用程序类型版本。

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--application-parameters --parameters

将应用程序参数指定为键/值对。这些参数必须存在于应用程序清单中。例如：--application-parameters param1=value1 param2=value2。

--max-nodes --maximum-nodes

指定要放置应用程序的最大节点数。此参数的值必须是非负整数。默认值为 0，指示应用程序可以放置在群集中任意数量的节点上。

--min-nodes --minimum-nodes

指定 Service Fabric 将为此应用程序保留容量的最小节点数，这并不意味着应用程序保证在所有这些节点上具有副本 (replica)。此参数的值必须是非负整数。默认值为零，这意味着没有为应用程序保留容量。

--package-url

指定应用程序包 sfpkg 文件的 URL。

全局参数

--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 sf application delete

删除应用程序。

az sf application delete --application-name
                         --cluster-name
                         --resource-group

示例

删除应用程序。

az sf application delete -g testRG -c testCluster --application-name testApp

必需参数

--application-name --name

指定应用程序名称。

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。可以使用 az configure --defaults group=<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 sf application list

列出给定群集的应用程序。

az sf application list --cluster-name
                       --resource-group

示例

列出给定群集的应用程序。

az sf application list -g testRG -c testCluster

必需参数

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。可以使用 az configure --defaults group=<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 sf application show

显示 Azure Service Fabric 群集上应用程序的属性。

az sf application show --application-name
                       --cluster-name
                       --resource-group

示例

获取应用程序。

az sf application show -g testRG -c testCluster --application-name testApp

必需参数

--application-name --name

指定应用程序名称。

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。可以使用 az configure --defaults group=<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 sf application update

更新 Azure Service Fabric 应用程序。这允许更新应用程序参数和/或升级将触发应用程序升级的应用程序类型版本。

az sf application update --application-name
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--application-type-version]
                         [--consider-warning-as-error {false, true}]
                         [--failure-action {Manual, Rollback}]
                         [--force-restart {false, true}]
                         [--hc-retry-timeout]
                         [--hc-stable-duration]
                         [--hc-wait-duration]
                         [--max-nodes]
                         [--max-porcent-unhealthy-apps]
                         [--max-porcent-unhealthy-partitions]
                         [--max-porcent-unhealthy-replicas]
                         [--max-porcent-unhealthy-services]
                         [--min-nodes]
                         [--rep-check-timeout]
                         [--service-type-health-policy-map]
                         [--ud-timeout]
                         [--upgrade-timeout]

示例

将应用程序参数和将策略值和应用类型版本升级到 v2。

az sf application update -g testRG -c testCluster --application-name testApp --application-type-version v2 \
  --application-parameters key0=value0 --health-check-stable-duration 0 --health-check-wait-duration 0 --health-check-retry-timeout 0 \
    --upgrade-domain-timeout 5000 --upgrade-timeout 7000 --failure-action Rollback --upgrade-replica-set-check-timeout 300 --force-restart

更新应用程序最小节点和最大节点数。

az sf application update -g testRG -c testCluster --application-name testApp --minimum-nodes 1 --maximum-nodes 3

必需参数

--application-name --name

指定应用程序名称。

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--application-parameters --parameters

将应用程序参数指定为键/值对。这些参数必须存在于应用程序清单中。例如：--application-parameters param1=value1 param2=value2。

--application-type-version --version

指定应用程序类型版本。

--consider-warning-as-error --warning-as-error

指示在运行状况评估期间是否将警告运行状况事件视为错误事件。

接受的值: false, true

默认值: False

--failure-action

指定监视升级失败时要执行的操作。此参数的可接受值为 Rollback 或 Manual。

接受的值: Manual, Rollback

--force-restart

指示即使升级是仅配置更改，服务主机也会重启。

接受的值: false, true

默认值: False

--hc-retry-timeout --health-check-retry-timeout

指定持续时间（以秒为单位），如果以前的运行状况检查失败，Service Fabric 会重试运行状况检查。

--hc-stable-duration --health-check-stable-duration

指定 Service Fabric 等待的持续时间（以秒为单位）以验证应用程序在移动到下一个升级域或完成升级之前是否稳定。此等待持续时间可防止在执行运行状况检查后立即检测到运行状况更改。

--hc-wait-duration --health-check-wait-duration

指定 Service Fabric 在升级域完成升级后在执行初始运行状况检查之前等待的持续时间（以秒为单位）。

--max-nodes --maximum-nodes

指定要放置应用程序的最大节点数。此参数的值必须是非负整数。默认值为 0，指示应用程序可以放置在群集中任意数量的节点上。

--max-porcent-unhealthy-apps --max-unhealthy-apps

指定在群集中的节点上部署的应用程序实例的最大百分比，这些实例在群集的应用程序运行状况状态出错之前处于运行状况状态。允许的值为 0 到 100。

--max-porcent-unhealthy-partitions --max-unhealthy-parts

指定运行状况策略允许的默认服务类型用于监视升级的每个服务的最大未保留分区百分比。允许的值为 0 到 100。

--max-porcent-unhealthy-replicas --max-unhealthy-reps

指定默认服务类型用于监视升级的默认服务类型的运行状况策略所允许的每个服务的最大不保留副本 (replica)百分比。允许的值为 0 到 100。

--max-porcent-unhealthy-services --max-unhealthy-servs

指定运行状况策略允许用于监视升级的默认服务类型允许的最大未维护服务百分比。允许的值为 0 到 100。

--min-nodes --minimum-nodes

--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

指定 Service Fabric 等待服务重新配置为安全状态（如果尚未处于安全状态）之前的最长时间（以秒为单位）。

--service-type-health-policy-map --service-type-policy

指定用于不同服务类型的运行状况策略的映射，格式如下：{“ServiceTypeName”：“MaxPercentUnhealthyPartitionsPerService，MaxPercentUnhealthyReplicasPerPartition，MaxPercentUnhealthyServices”}。例如：@{ “ServiceTypeName01” = “5,10,5”;“ServiceTypeName02” = “5,5,5” }。

--ud-timeout --upgrade-domain-timeout

指定 Service Fabric 升级单个升级域所需的时间（以秒为单位）。在此时间段后，升级失败。

--upgrade-timeout

指定 Service Fabric 对整个升级所需的时间（以秒为单位）。在此时间段后，升级失败。

全局参数

--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 sf application

命令

az sf application create

示例

必需参数

可选参数

az sf application delete

示例

必需参数

az sf application list

示例

必需参数

az sf application show

示例

必需参数

az sf application update

示例

必需参数

可选参数

其他资源