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

Services - Update

更新Service Fabric服务资源。
使用指定名称更新Service Fabric服务资源。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applications/{applicationName}/services/{serviceName}?api-version=2019-11-01-preview

URI 参数

Name In Required Type Description
applicationName
path True
  • string

应用程序资源的名称。

clusterName
path True
  • string

群集资源的名称。

resourceGroupName
path True
  • string

资源组的名称。

serviceName
path True
  • string

服务资源的名称,格式为 {applicationName}~{serviceName}。

subscriptionId
path True
  • string

客户订阅标识符。

api-version
query True
  • string

Service Fabric资源提供程序 API 的版本。 这是一个必需参数,并且该值必须为此规范的“2019-11-01-preview”。

请求正文

Name Required Type Description
properties.serviceKind True

服务类型 (无状态或有状态) 。

location
  • string

它将弃用在新 API 中,资源位置取决于父资源。

properties.correlationScheme

描述服务与其他服务关联的列表。

properties.defaultMoveCost

指定服务的移动成本。

properties.placementConstraints
  • string

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

properties.serviceLoadMetrics

服务负载指标作为 ServiceLoadMetricDescription 对象的数组提供。

properties.servicePlacementPolicies
  • ServicePlacementPolicyDescription[]

描述服务与其他服务关联的列表。

tags
  • object

Azure 资源标记。

响应

Name Type Description
202 Accepted

请求已接受,操作将以异步方式完成。

Other Status Codes

详细的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

Patch a service

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService?api-version=2019-11-01-preview

{
  "properties": {
    "serviceKind": "Stateless",
    "serviceLoadMetrics": [
      {
        "name": "metric1",
        "weight": "Low"
      }
    ]
  }
}

Sample Response

Retry-After: 10
Location: http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/4dde8d8b-b6b2-4c56-99c6-9b83932bb09a?api-version=2019-11-01-preview
{
  "type": "services",
  "location": "eastus",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService",
  "name": "myCluster",
  "tags": {},
  "etag": "W/\"636462502183671257\"",
  "properties": {
    "provisioningState": "Updating",
    "serviceKind": "Stateless",
    "serviceTypeName": "myServiceType",
    "partitionDescription": {
      "partitionScheme": "Singleton"
    },
    "serviceLoadMetrics": [
      {
        "name": "metric1",
        "weight": "Low"
      }
    ],
    "instanceCount": 1,
    "servicePackageActivationMode": "SharedProcess"
  }
}

定义

ArmServicePackageActivationMode

服务包的激活模式

ErrorModel

错误的结构。

ErrorModelError

错误详细信息。

MoveCost

指定服务的移动成本。

NamedPartitionSchemeDescription

描述服务的命名分区方案。

PartitionScheme

枚举服务可分区的方式。

ServiceCorrelationDescription

创建服务之间的特定关联。

ServiceCorrelationScheme

服务关联方案。

ServiceKind

服务类型 (无状态或有状态) 。

ServiceLoadMetricDescription

指定在运行时对服务进行负载均衡的指标。

ServiceLoadMetricWeight

确定相对于为此服务配置的其他指标的指标权重。 在运行时,如果两个指标最终冲突,则群集资源管理器优先选择权重较高的指标。

ServiceResource

服务资源。

ServiceResourceUpdate

用于修补操作的服务资源。

SingletonPartitionSchemeDescription

描述单一分区或非分区服务的分区方案。

UniformInt64RangePartitionSchemeDescription

描述一个分区方案,其中整数范围在多个分区中均匀分配。

ArmServicePackageActivationMode

服务包的激活模式

Name Type Description
ExclusiveProcess
  • string

指示应用程序包激活模式将使用独占进程。

SharedProcess
  • string

指示应用程序包激活模式将使用共享进程。

ErrorModel

错误的结构。

Name Type Description
error

错误详细信息。

ErrorModelError

错误详细信息。

Name Type Description
code
  • string

错误代码。

message
  • string

错误消息。

MoveCost

指定服务的移动成本。

Name Type Description
High
  • string

将服务的移动成本指定为“高”。 值为 3。

Low
  • string

将服务的移动成本指定为“低”。 值为 1。

Medium
  • string

将服务的移动成本指定为中等。 值为 2。

Zero
  • string

零移动成本。 此值为零。

NamedPartitionSchemeDescription

描述服务的命名分区方案。

Name Type Description
count
  • integer

分区数。

names
  • string[]

由“count”参数指定的大小数组,用于分区的名称。

partitionScheme string:
  • Named

指定如何对服务进行分区。

PartitionScheme

枚举服务可分区的方式。

Name Type Description
Invalid
  • string

指示分区类型无效。 所有Service Fabric枚举都具有无效的类型。 值为 0。

Named
  • string

指示分区基于字符串名称,并且是 NamedPartitionSchemeDescription 对象。 该值为 3

Singleton
  • string

指示分区基于字符串名称,并且是 SingletonPartitionSchemeDescription 对象,值为 1。

UniformInt64Range
  • string

指示分区基于 Int64 键范围,并且是 UniformInt64RangePartitionSchemeDescription 对象。 值为 2。

ServiceCorrelationDescription

创建服务之间的特定关联。

Name Type Description
scheme

ServiceCorrelationScheme,描述此服务与通过 ServiceName 指定的服务之间的关系。

serviceName
  • string

建立关联关系的服务的名称。

ServiceCorrelationScheme

服务关联方案。

Name Type Description
Affinity
  • string

指示此服务与另一个服务具有相关性关系。 为向后兼容提供,请考虑首选 Aligned 或 NonAlignedAffinity 选项。 值为 1。

AlignedAffinity
  • string

对齐的相关性可确保同一节点上并置关联服务的分区的初选。 这是默认值,与选择地缘方案相同。 值为 2。

Invalid
  • string

无效的关联方案。 不能使用。 值为 0。

NonAlignedAffinity
  • string

不一致的相关性保证每个服务的所有副本将放置在同一节点上。 与对齐相关性不同,这不能保证将并置特定角色的副本。 值为 3。

ServiceKind

服务类型 (无状态或有状态) 。

Name Type Description
Invalid
  • string

指示服务类型无效。 所有Service Fabric枚举都具有无效的类型。 值为 0。

Stateful
  • string

使用Service Fabric使其状态或状态的一部分高度可用且可靠。 值为 2。

Stateless
  • string

不使用Service Fabric使其状态高度可用或可靠。 值为 1。

ServiceLoadMetricDescription

指定在运行时对服务进行负载均衡的指标。

Name Type Description
defaultLoad
  • integer

仅用于无状态服务。 此服务为此指标创建的默认负载量(作为数字)。

name
  • string

指标的名称。 如果服务选择在运行时报告负载,则负载指标名称应与 Name 中指定的名称完全匹配。 请注意,度量值名称区分大小写。

primaryDefaultLoad
  • integer

仅用于有状态服务。 当此服务为主副本时为此度量值创建的默认负载量,以数字形式提供。

secondaryDefaultLoad
  • integer

仅用于有状态服务。 当此服务为辅助副本时为此度量值创建的默认负载量,以数字形式提供。

weight

服务负载度量值的相对权重(相对于为此服务配置的其他度量值),以数字形式提供。

ServiceLoadMetricWeight

确定相对于为此服务配置的其他指标的指标权重。 在运行时,如果两个指标最终冲突,则群集资源管理器优先选择权重较高的指标。

Name Type Description
High
  • string

将服务负载的指标权重指定为 High。 值为 3。

Low
  • string

将服务负载的指标权重指定为“低”。 值为 1。

Medium
  • string

将服务负载的指标权重指定为中等。 值为 2。

Zero
  • string

禁用此指标的资源均衡。 此值为零。

ServiceResource

服务资源。

Name Type Description
etag
  • string

Azure 资源 etag。

id
  • string

Azure 资源标识符。

location
  • string

它将弃用在新 API 中,资源位置取决于父资源。

name
  • string

Azure 资源名称。

properties.correlationScheme

描述服务与其他服务关联的列表。

properties.defaultMoveCost

指定服务的移动成本。

properties.partitionDescription PartitionSchemeDescription:

描述如何对服务进行分区。

properties.placementConstraints
  • string

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

properties.provisioningState
  • string

当前部署或预配状态,仅在响应中显示

properties.serviceDnsName
  • string

用于服务的 Dns 名称。 如果指定了这一点,则可以通过其 DNS 名称而不是服务名称访问该服务。

properties.serviceKind

服务类型 (无状态或有状态) 。

properties.serviceLoadMetrics

服务负载指标作为 ServiceLoadMetricDescription 对象的数组提供。

properties.servicePackageActivationMode

服务包的激活模式

properties.servicePlacementPolicies
  • ServicePlacementPolicyDescription[]

描述服务与其他服务关联的列表。

properties.serviceTypeName
  • string

服务类型的名称

tags
  • object

Azure 资源标记。

type
  • string

Azure 资源类型。

ServiceResourceUpdate

用于修补操作的服务资源。

Name Type Description
etag
  • string

Azure 资源 etag。

id
  • string

Azure 资源标识符。

location
  • string

它将弃用在新 API 中,资源位置取决于父资源。

name
  • string

Azure 资源名称。

properties.correlationScheme

描述服务与其他服务关联的列表。

properties.defaultMoveCost

指定服务的移动成本。

properties.placementConstraints
  • string

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

properties.serviceKind

服务类型 (无状态或有状态) 。

properties.serviceLoadMetrics

服务负载指标作为 ServiceLoadMetricDescription 对象的数组提供。

properties.servicePlacementPolicies
  • ServicePlacementPolicyDescription[]

描述服务与其他服务关联的列表。

tags
  • object

Azure 资源标记。

type
  • string

Azure 资源类型。

SingletonPartitionSchemeDescription

描述单一分区或非分区服务的分区方案。

Name Type Description
partitionScheme string:
  • Singleton

指定如何对服务进行分区。

UniformInt64RangePartitionSchemeDescription

描述一个分区方案,其中整数范围在多个分区中均匀分配。

Name Type Description
count
  • integer

分区数。

highKey
  • string

指示应在分区“count”之间拆分的分区键范围的上限的字符串

lowKey
  • string

指示应在分区“count”之间拆分的分区键范围的下限的字符串

partitionScheme string:
  • UniformInt64Range

指定如何对服务进行分区。