通过

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

az sf managed-application

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

命令

名称 说明 类型 Status
az sf managed-application create

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

 Core GA
az sf managed-application delete

删除托管应用程序。

 Core GA
az sf managed-application list

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

 Core GA
az sf managed-application show

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

 Core GA
az sf managed-application update

更新 Azure Service Fabric 托管应用程序。

 Core GA

az sf managed-application create

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

az sf managed-application create --application-name --name
                                 --application-type-name --type-name
                                 --application-type-version --version
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters --parameters]
                                 [--package-url]
                                 [--tags]

示例

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

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

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

az sf managed-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。

--package-url

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

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az sf managed-application delete

删除托管应用程序。

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

示例

删除托管应用程序。

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

必需参数

--application-name --name

指定应用程序名称。

--cluster-name -c

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

--resource-group -g

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

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az sf managed-application list

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

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

示例

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

az sf managed-application list -g testRG -c testCluster

必需参数

--cluster-name -c

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

--resource-group -g

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

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az sf managed-application show

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

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

示例

获取托管应用程序。

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

必需参数

--application-name --name

指定应用程序名称。

--cluster-name -c

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

--resource-group -g

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

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az sf managed-application update

中断性变更

选项列表已更改，运行 help 命令以查看允许的选项

更新 Azure Service Fabric 托管应用程序。

这允许更新标记、应用程序参数、应用程序 UpgradePolicy 和/或升级应用程序类型版本，这将触发应用程序升级。

az sf managed-application update --application-name --name
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters --parameters]
                                 [--application-type-version --version]
                                 [--failure-action {Manual, Rollback}]
                                 [--force-restart {false, true}]
                                 [--hc-retry-timeout --health-check-retry-timeout]
                                 [--hc-stable-duration --health-check-stable-duration]
                                 [--hc-wait-duration --health-check-wait-duration]
                                 [--instance-close-delay-duration]
                                 [--max-unhealthy-apps]
                                 [--max-unhealthy-parts]
                                 [--max-unhealthy-reps]
                                 [--max-unhealthy-servs]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout --replica-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout --upgrade-domain-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]
                                 [--warning-as-error {false, true}]

示例

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

az sf managed-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 --replica-check-timeout 300 --force-restart

更新托管应用程序服务类型运行状况策略映射。

az sf managed-application update -g testRG -c testCluster --application-name testApp --service-type-health-policy-map  "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5"

必需参数

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

指定应用程序类型版本。

--failure-action

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

属性 值
参数组: Upgrade description Arguments
接受的值: Manual, Rollback
--force-restart

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

属性 值
参数组: Upgrade description Arguments
默认值: False
接受的值: false, true
--hc-retry-timeout --health-check-retry-timeout

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

属性 值
参数组: Upgrade description Arguments
--hc-stable-duration --health-check-stable-duration

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

属性 值
参数组: Upgrade description Arguments
--hc-wait-duration --health-check-wait-duration

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

属性 值
参数组: Upgrade description Arguments
--instance-close-delay-duration

指定持续时间（以秒为单位）以等待无状态实例关闭之前，以允许活动请求正常清空。 当实例在应用程序/群集升级期间关闭时，只有在服务说明中配置了非零延迟持续时间的实例时，这才有效。

属性 值
参数组: Upgrade description Arguments
--max-unhealthy-apps

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

属性 值
参数组: Upgrade description Arguments
--max-unhealthy-parts

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

属性 值
参数组: Upgrade description Arguments
--max-unhealthy-reps

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

属性 值
参数组: Upgrade description Arguments
--max-unhealthy-servs

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

属性 值
参数组: Upgrade description Arguments
--recreate-application

确定是否应在更新时重新创建应用程序。 如果 value=true，则不允许使用升级策略参数的其余部分。

属性 值
参数组: Upgrade description Arguments
默认值: False
接受的值: false, true
--rep-check-timeout --replica-check-timeout

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

属性 值
参数组: Upgrade description Arguments
--service-type-health-policy-map

按以下格式指定用于不同服务类型的运行状况策略映射作为键/值对：“ServiceTypeName”=“MaxPercentUnhealthyPartitionsPerService，MaxPercentUnhealthyReplicasPerPartition，MaxPercentUnhealthyServices”。 例如：--service-type-health-policy-map “ServiceTypeName01”=“5,10,5” “ServiceTypeName02”=“5,5,5”。

属性 值
参数组: Upgrade description Arguments
--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

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

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

属性 值
参数组: Upgrade description Arguments
--upgrade-mode

指定用于在滚动升级期间监视运行状况的模式。 值为 Monitored 和 UnmonitoredAuto。

属性 值
参数组: Upgrade description Arguments
接受的值: Monitored, UnmonitoredAuto
--upgrade-timeout

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

属性 值
参数组: Upgrade description Arguments
--warning-as-error

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

属性 值
参数组: Upgrade description Arguments
默认值: False
接受的值: false, true
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False