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

az sf managed-service

管理在 Azure Service Fabric 托管群集上运行的服务。 仅支持 ARM 部署的服务。

命令

名称	说明	类型	状态
az sf managed-service correlation-scheme	管理在 Azure Service Fabric 托管群集上运行的服务的相关方案。 仅支持 ARM 部署的服务。	核心	GA
az sf managed-service correlation-scheme create	在 Azure Service Fabric 托管群集上创建新的托管服务关联方案。	核心	GA
az sf managed-service correlation-scheme delete	删除托管服务关联方案。	核心	GA
az sf managed-service correlation-scheme update	更新托管服务关联方案。	核心	GA
az sf managed-service create	在 Azure Service Fabric 托管群集上创建新的托管服务。	核心	GA
az sf managed-service delete	删除托管服务。	核心	GA
az sf managed-service list	列出给定托管应用程序的托管服务。	核心	GA
az sf managed-service load-metrics	管理在 Azure Service Fabric 托管群集上运行的服务负载指标。 仅支持 ARM 部署的服务。	核心	GA
az sf managed-service load-metrics create	在 Azure Service Fabric 托管群集上创建新的托管服务负载指标。	核心	GA
az sf managed-service load-metrics delete	删除托管服务。	核心	GA
az sf managed-service load-metrics update	更新托管服务。	核心	GA
az sf managed-service show	获取服务。	核心	GA
az sf managed-service update	更新托管服务。	核心	GA

az sf managed-service create

在 Azure Service Fabric 托管群集上创建新的托管服务。

az sf managed-service create --application
                             --cluster-name
                             --name
                             --resource-group
                             --service-type
                             --state {Stateful, Stateless}
                             [--activation-mode]
                             [--default-move-cost {High, Low, Medium, Zero}]
                             [--has-persisted-state {false, true}]
                             [--high-key]
                             [--instance-count]
                             [--keep-duration]
                             [--low-key]
                             [--min-inst-pct]
                             [--min-instance-count]
                             [--min-replica]
                             [--partition-count]
                             [--partition-names]
                             [--partition-scheme {Named, Singleton, UniformInt64Range}]
                             [--placement-constraints]
                             [--plcmt-time-limit]
                             [--quorum-loss-wait]
                             [--replica-restart-wait]
                             [--tags]
                             [--target-replica]

示例

使用实例计数 -1（在所有节点上）创建新的无状态托管服务“testService1”。

az sf managed-service create -g testRG -c testCluster --application-name testApp --state stateless --service-name testService \
  --service-type testStateless --instance-count -1 --partition-scheme singleton

创建一个新的有状态服务“testService2”，其目标为 5 个节点。

az sf managed-service create -g testRG -c testCluster --application-name testApp --state stateful --service-name testService2 --has-persisted-state \
  --service-type testStatefulType --min-replica-set-size 3 --target-replica-set-size 5 --partition-scheme uniformint64range --partition-count 1 --low-key 0 --high-key 25

必需参数

--application --application-name

指定服务的名称。

--cluster-name -c

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

--name --service-name

指定服务的名称。

--resource-group -g

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

--service-type --type

指定应用程序的服务类型名称，它应存在于应用程序清单中。

--state

指定服务是无状态还是有状态。

接受的值: Stateful, Stateless

可选参数

--activation-mode --package-activation-mode --service-package-activation-mode

指定服务包的激活模式。

--default-move-cost

指定移动的默认成本。 成本越高，群集资源管理器在尝试平衡群集时将移动副本 (replica)的可能性更低。

接受的值: High, Low, Medium, Zero

--has-persisted-state

确定这是一项持久服务，用于将状态存储在本地磁盘上。 如果是，则此属性的值为 true，否则为 false。

接受的值: false, true

--high-key

指定应在分区“Count”之间拆分的分区键范围的上限。这仅适用于 UniformInt64 分区方案。

--instance-count

指定无状态服务的实例计数。 如果使用 -1，则表示它将在所有节点上运行。

--keep-duration --stand-by-keep-duration --stand-by-replica-keep-duration

指定在删除之前应保留 StandBy 副本 (replica) 数的定义，以 ISO 8601 格式“hh：mm：ss”表示。

--low-key

指定应在分区“Count”之间拆分的分区键范围的下限。这仅适用于 UniformInt64 分区方案。

--min-inst-pct --min-instance-percentage

指定在升级或停用节点等操作期间必须满足 EnsureAvailability 安全检查的 InstanceCount 的最小百分比。 使用的实际数字是 max（MinInstanceCount，ceil（MinInstancePercentage/100.0 * InstanceCount） 。 请注意，如果在 MinInstancePercentage 计算期间将 InstanceCount 设置为 -1，则 -1 将首先转换为允许根据服务上的放置约束放置实例的节点数。 允许的值为 0 到 100。

--min-instance-count

指定在升级或停用节点等操作期间必须满足 EnsureAvailability 安全检查的最小实例数。 使用的实际数字是 max（MinInstanceCount，ceil（MinInstancePercentage/100.0 * InstanceCount） 。 请注意，如果 InstanceCount 设置为 -1，则 MinInstanceCount 计算 -1 期间首先转换为允许根据服务放置约束放置实例的节点数。

--min-replica --min-replica-set-size

指定有状态服务的最小副本 (replica)设置大小。

--partition-count

指定分区数。 这仅适用于 UniformInt64 分区方案。

--partition-names

指定分区名称的数组。 这仅适用于命名分区方案。

--partition-scheme

指定要使用的分区方案。 单独分区通常在服务不需要任何其他路由时使用。 UniformInt64 表示每个分区拥有一系列 int64 键。 命名通常适用于可在边界集中存储的数据的服务。 用作命名分区键的数据字段的一些常见示例是区域、邮政编码、客户组或其他业务边界。

接受的值: Named, Singleton, UniformInt64Range

默认值: singleton

--placement-constraints

将放置约束指定为字符串。 放置约束是节点属性中的布尔表达式，用于根据服务要求将服务限制到特定的节点。 例如，若要在 NodeType 为蓝色的节点上放置服务，请指定以下内容：“NodeColor == blue”。。

--plcmt-time-limit --service-placement-time-limit

指定在报告生成停滞之前，副本 (replica)可以保留 InBuild 的持续时间，以 ISO 8601 格式“hh：mm：ss”表示。

--quorum-loss-wait --quorum-loss-wait-duration

指定允许分区处于仲裁丢失状态的最大持续时间，以 ISO 8601 格式“hh：mm：ss”表示。

--replica-restart-wait --replica-restart-wait-duration

指定副本 (replica)关闭和创建新副本 (replica)之间的持续时间，以 ISO 8601 格式“hh：mm：ss”表示。

--tags

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

--target-replica --target-replica-set-size

指定有状态服务的目标副本 (replica)设置大小。

全局参数

--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 managed-service delete

删除托管服务。

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

示例

删除托管服务。

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

必需参数

--application --application-name

指定服务的名称。

--cluster-name -c

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

--name --service-name

指定服务的名称。

--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 managed-service list

列出给定托管应用程序的托管服务。

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

示例

列出托管服务。

az sf managed-service list -g testRG -c testCluster --application-name testApp

必需参数

--application --application-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 managed-service show

获取服务。

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

示例

显示 Azure Service Fabric 托管群集上托管服务的属性。

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

必需参数

--application --application-name

指定服务的名称。

--cluster-name -c

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

--name --service-name

指定服务的名称。

--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 managed-service update

更新托管服务。

az sf managed-service update --application
                             --cluster-name
                             --name
                             --resource-group
                             [--default-move-cost {High, Low, Medium, Zero}]
                             [--instance-count]
                             [--keep-duration]
                             [--min-inst-pct]
                             [--min-instance-count]
                             [--min-replica]
                             [--placement-constraints]
                             [--plcmt-time-limit]
                             [--quorum-loss-wait]
                             [--replica-restart-wait]
                             [--tags]
                             [--target-replica]

示例

更新托管无状态服务。

az sf managed-service update -g testRG -c testCluster --application-name testApp --service-name testService --min-instance-count 2 \
  --min-instance-percentage 20

更新托管有状态服务。

az sf managed-service update -g testRG -c testCluster --application-name testApp --service-name testService2 --service-placement-time-limit '00:11:00' \
  --stand-by-replica-keep-duration '00:11:00' --replica-restart-wait-duration '00:11:00' --quorum-loss-wait-duration '00:11:00'

必需参数

--application --application-name

指定服务的名称。

--cluster-name -c

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

--name --service-name

指定服务的名称。

--resource-group -g

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

可选参数

--default-move-cost

指定移动的默认成本。 成本越高，群集资源管理器在尝试平衡群集时将移动副本 (replica)的可能性更低。

接受的值: High, Low, Medium, Zero

--instance-count

指定无状态服务的实例计数。 如果使用 -1，则表示它将在所有节点上运行。

--keep-duration --stand-by-keep-duration --stand-by-replica-keep-duration

指定在删除之前应保留 StandBy 副本 (replica) 数的定义，以 ISO 8601 格式“hh：mm：ss”表示。

--min-inst-pct --min-instance-percentage

指定在升级或停用节点等操作期间必须满足 EnsureAvailability 安全检查的 InstanceCount 的最小百分比。 使用的实际数字是 max（MinInstanceCount，ceil（MinInstancePercentage/100.0 * InstanceCount） 。 请注意，如果在 MinInstancePercentage 计算期间将 InstanceCount 设置为 -1，则 -1 将首先转换为允许根据服务上的放置约束放置实例的节点数。 允许的值为 0 到 100。

--min-instance-count

指定在升级或停用节点等操作期间必须满足 EnsureAvailability 安全检查的最小实例数。 使用的实际数字是 max（MinInstanceCount，ceil（MinInstancePercentage/100.0 * InstanceCount） 。 请注意，如果 InstanceCount 设置为 -1，则 MinInstanceCount 计算 -1 期间首先转换为允许根据服务放置约束放置实例的节点数。

--min-replica --min-replica-set-size

指定有状态服务的最小副本 (replica)设置大小。

--placement-constraints

将放置约束指定为字符串。 放置约束是节点属性中的布尔表达式，用于根据服务要求将服务限制到特定的节点。 例如，若要在 NodeType 为蓝色的节点上放置服务，请指定以下内容：“NodeColor == blue”。。

--plcmt-time-limit --service-placement-time-limit

指定在报告生成停滞之前，副本 (replica)可以保留 InBuild 的持续时间，以 ISO 8601 格式“hh：mm：ss”表示。

--quorum-loss-wait --quorum-loss-wait-duration

指定允许分区处于仲裁丢失状态的最大持续时间，以 ISO 8601 格式“hh：mm：ss”表示。

--replica-restart-wait --replica-restart-wait-duration

指定副本 (replica)关闭和创建新副本 (replica)之间的持续时间，以 ISO 8601 格式“hh：mm：ss”表示。

--tags

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

--target-replica --target-replica-set-size

指定有状态服务的目标副本 (replica)设置大小。

全局参数

--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 获取完整的调试日志。