共用方式為


Microsoft.ServiceFabric managedclusters/applications/services 2022-02-01-preview

Bicep 資源定義

managedclusters/applications/services 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.ServiceFabric/managedclusters/applications/services 資源,請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.ServiceFabric/managedclusters/applications/services@2022-02-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    correlationScheme: [
      {
        scheme: 'string'
        serviceName: 'string'
      }
    ]
    defaultMoveCost: 'string'
    partitionDescription: {
      partitionScheme: 'string'
      // For remaining properties, see Partition objects
    }
    placementConstraints: 'string'
    scalingPolicies: [
      {
        scalingMechanism: {
          kind: 'string'
          // For remaining properties, see ScalingMechanism objects
        }
        scalingTrigger: {
          kind: 'string'
          // For remaining properties, see ScalingTrigger objects
        }
      }
    ]
    serviceLoadMetrics: [
      {
        defaultLoad: int
        name: 'string'
        primaryDefaultLoad: int
        secondaryDefaultLoad: int
        weight: 'string'
      }
    ]
    servicePackageActivationMode: 'string'
    servicePlacementPolicies: [
      {
        type: 'string'
        // For remaining properties, see ServicePlacementPolicy objects
      }
    ]
    serviceTypeName: 'string'
    serviceKind: 'string'
    // For remaining properties, see ServiceResourceProperties objects
  }
  tags: {
    {customized property}: 'string'
  }
}

數據分割物件

設定 partitionScheme 屬性,以指定對象的類型。

針對 具名,請使用:

{
  names: [
    'string'
  ]
  partitionScheme: 'Named'
}

針對 Singleton,請使用:

{
  partitionScheme: 'Singleton'
}

針對 UniformInt64Range,請使用:

{
  count: int
  highKey: int
  lowKey: int
  partitionScheme: 'UniformInt64Range'
}

ServiceResourceProperties 物件

設定 serviceKind 屬性,以指定物件的類型。

針對 具狀態,請使用:

{
  hasPersistedState: bool
  minReplicaSetSize: int
  quorumLossWaitDuration: 'string'
  replicaRestartWaitDuration: 'string'
  serviceKind: 'Stateful'
  servicePlacementTimeLimit: 'string'
  standByReplicaKeepDuration: 'string'
  targetReplicaSetSize: int
}

針對 無狀態,請使用:

{
  instanceCount: int
  minInstanceCount: int
  minInstancePercentage: int
  serviceKind: 'Stateless'
}

ServicePlacementPolicy 物件

設定 類型 屬性,以指定物件的類型。

針對 InvalidDomain,請使用:

{
  domainName: 'string'
  type: 'InvalidDomain'
}

針對 NonPartiallyPlaceService,請使用:

{
  type: 'NonPartiallyPlaceService'
}

針對 PreferredPrimaryDomain,請使用:

{
  domainName: 'string'
  type: 'PreferredPrimaryDomain'
}

針對 requiredDomain,請使用:

{
  domainName: 'string'
  type: 'RequiredDomain'
}

針對 RequiredDomainDistribution,請使用:

{
  domainName: 'string'
  type: 'RequiredDomainDistribution'
}

ScalingTrigger 物件

設定 種類 屬性,以指定對象的類型。

針對 AveragePartitionLoadTrigger,請使用:

{
  kind: 'AveragePartitionLoadTrigger'
  lowerLoadThreshold: int
  metricName: 'string'
  scaleInterval: 'string'
  upperLoadThreshold: int
}

針對 AverageServiceLoadTrigger,請使用:

{
  kind: 'AverageServiceLoadTrigger'
  lowerLoadThreshold: int
  metricName: 'string'
  scaleInterval: 'string'
  upperLoadThreshold: int
  useOnlyPrimaryLoad: bool
}

縮放機械物件

設定 種類 屬性,以指定對象的類型。

針對 AddRemoveIncrementalNamedPartition,請使用:

{
  kind: 'AddRemoveIncrementalNamedPartition'
  maxPartitionCount: int
  minPartitionCount: int
  scaleIncrement: int
}

針對 ScalePartitionInstanceCount,請使用:

{
  kind: 'ScalePartitionInstanceCount'
  maxInstanceCount: int
  minInstanceCount: int
  scaleIncrement: int
}

屬性值

AddRemoveIncrementalNamedPartitionScalingMechanism

名字 描述 價值
指定與此調整原則相關聯的機制。 'AddRemoveIncrementalNamedPartition' (必要)
maxPartitionCount 服務的具名分割區數目上限。 int (必要)
minPartitionCount 服務的具名分割區數目下限。 int (必要)
scaleIncrement 調整作業期間要新增或移除的實例數目。 int (必要)

AveragePartitionLoadScalingTrigger

名字 描述 價值
指定與此調整原則相關聯的觸發程式。 'AveragePartitionLoadTrigger' (必要)
lowerLoadThreshold 應執行相應縮小作業之負載的下限。 int (必要)
metricName 應追蹤使用量的計量名稱。 字串 (必要)
scaleInterval 決定是否要調整的秒數。 此屬性應以 ISO 8601 格式 「hh:mm:ss」 表示。 字串 (必要)
upperLoadThreshold 應該執行相應放大作業的負載上限。 int (必要)

AverageServiceLoadScalingTrigger

名字 描述 價值
指定與此調整原則相關聯的觸發程式。 'AverageServiceLoadTrigger' (必要)
lowerLoadThreshold 應執行相應縮小作業之負載的下限。 int (必要)
metricName 應追蹤使用量的計量名稱。 字串 (必要)
scaleInterval 決定是否要調整的秒數。 此屬性應以 ISO 8601 格式 「hh:mm:ss」 表示。 字串 (必要)
upperLoadThreshold 應該執行相應放大作業的負載上限。 int (必要)
useOnlyPrimaryLoad 旗標會決定是否只考慮要調整主要複本的負載。 如果設定為 true,則觸發程式只會考慮具狀態服務的主要復本負載。 如果設定為 false,觸發程式會考慮載入所有複本。 無狀態服務無法將此參數設定為 true。 布林 (必要)

Microsoft.ServiceFabric/managedclusters/applications/services

名字 描述 價值
位置 資源位置取決於父資源。 字串
名字 資源名稱 字串 (必要)
父母 在 Bicep 中,您可以指定子資源的父資源。 只有在父資源外部宣告子資源時,才需要新增這個屬性。

如需詳細資訊,請參閱 父資源外部的子資源
類型的資源符號名稱:managedclusters/applications
性能 服務資源屬性。 ServiceResourceProperties
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤

NamedPartitionScheme

名字 描述 價值
名字 分割區名稱的陣列。 string[] (必要)
partitionScheme 指定如何分割服務。 'Named' (必要)

分區

名字 描述 價值
partitionScheme 針對 type NamedPartitionScheme,設定為 'Named'。 將 設定為 type SingletonPartitionScheme的 'Singleton'。 針對 UniformInt64RangePartitionScheme類型,設定為 'UniformInt64Range'。 'Named'
'Singleton'
'UniformInt64Range' (必要)

PartitionInstanceCountScaleMechanism

名字 描述 價值
指定與此調整原則相關聯的機制。 'ScalePartitionInstanceCount' (必要)
maxInstanceCount 分割區的實例數目上限。 int (必要)
minInstanceCount 分割區的實例數目下限。 int (必要)
scaleIncrement 調整作業期間要新增或移除的實例數目。 int (必要)

ProxyResourceTags

名字 描述 價值

ScalingMechanism

名字 描述 價值
針對 type AddRemoveIncrementalNamedPartition' 設定為 'AddRemoveIncrementalNamedPartitionScalingMechanism。 針對 partitionInstanceCountScaleMechanism類型 ,設定為 'ScalePartitionInstanceCount'。 'AddRemoveIncrementalNamedPartition'
'ScalePartitionInstanceCount' (必要)

ScalingPolicy

名字 描述 價值
scalingMechanism 指定與此調整原則相關聯的機制 縮放機械 (必要)
scalingTrigger 指定與此調整原則相關聯的觸發程式。 ScalingTrigger (必要)

ScalingTrigger

名字 描述 價值
針對 type AveragePartitionLoadScalingTrigger,設定為 'AveragePartitionLoadTrigger'。 將 類型設定為 'AverageServiceLoadTrigger',AverageServiceLoadScalingTrigger 'AveragePartitionLoadTrigger'
'AverageServiceLoadTrigger' (必要)

ServiceCorrelation

名字 描述 價值
方案 ServiceCorrelationScheme,描述此服務與透過 ServiceName 指定的服務之間的關聯性。 'AlignedAffinity'
'NonAlignedAffinity' (必要)
serviceName 建立相互關聯性之服務的 Arm 資源標識碼。 字串 (必要)

ServiceLoadMetric

名字 描述 價值
defaultLoad 僅適用於無狀態服務。 此服務為此計量所建立的預設負載量,以數位表示。 int
名字 計量的名稱。 如果服務選擇在運行時間報告負載,載入計量名稱應該完全符合 Name 中指定的名稱。 請注意,計量名稱區分大小寫。 字串 (必要)
primaryDefaultLoad 僅適用於具狀態服務。 當此服務是主要複本時,此服務針對此計量所建立的預設負載量,以數位表示。 int
secondaryDefaultLoad 僅適用於具狀態服務。 當此服務是次要複本時,此服務針對此計量所建立的預設負載量,以數位表示。 int
重量 相較於為此服務設定的其他計量,服務負載計量相對權數為數位。 'High'
'Low'
'Medium'
'Zero'

ServicePlacementInvalidDomainPolicy

名字 描述 價值
domainName 不應該用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'InvalidDomain' (必要)

ServicePlacementNonPartiallyPlaceServicePolicy

名字 描述 價值
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'NonPartiallyPlaceService' (必要)

ServicePlacementPolicy

名字 描述 價值
類型 針對 type ServicePlacementInvalidDomainPolicy,設定為 'InvalidDomain'。 針對 type ServicePlacementNonPartiallyPlaceServicePolicy,設定為 'NonPartiallyPlaceServiceService'。 針對 type ServicePlacementPreferPrimaryDomainPolicy,設定為 'PreferredPrimaryDomain'。 針對 servicePlacementRequiredDomainPolicy 類型 設定為 'RequiredDomain',。 針對 type ServicePlacementRequireDomainDistributionPolicy,設定為 'RequiredDomainDistribution'。 'InvalidDomain'
'NonPartiallyPlaceService'
'PreferredPrimaryDomain'
'RequiredDomain'
'RequiredDomainDistribution' (必要)

ServicePlacementPreferPrimaryDomainPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'PreferredPrimaryDomain' (必要)

ServicePlacementRequiredDomainPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'RequiredDomain' (必要)

ServicePlacementRequireDomainDistributionPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'RequiredDomainDistribution' (必要)

ServiceResourceProperties

名字 描述 價值
correlationScheme 描述服務與其他服務相互關聯的清單。 ServiceCorrelation[]
defaultMoveCost 指定服務的移動成本。 'High'
'Low'
'Medium'
'Zero'
partitionDescription 描述如何分割服務。 分割區 (必要)
placementConstraints 放置條件約束做為字串。 放置條件約束是節點屬性上的布爾表達式,允許根據服務需求將服務限制為特定節點。 例如,若要將服務放在 NodeType 為藍色的節點上,請指定下列專案:“NodeColor == blue)”。 字串
scalingPolicies 調整此服務的原則。 ScalingPolicy[]
serviceKind 針對 statefulServiceProperties 類型 設定為 'Stateful'。 將 類型設為 'Stateless' StatelessServiceProperties '具狀態'
'無狀態' (必要)
serviceLoadMetrics 服務負載計量會指定為 ServiceLoadMetric 物件的陣列。 ServiceLoadMetric[]
servicePackageActivationMode 服務套件的啟用模式 'ExclusiveProcess'
'SharedProcess'
servicePlacementPolicies 描述服務與其他服務相互關聯的清單。 ServicePlacementPolicy[]
serviceTypeName 服務類型的名稱 字串 (必要)

SingletonPartitionScheme

名字 描述 價值
partitionScheme 指定如何分割服務。 'Singleton' (必要)

StatefulServiceProperties

名字 描述 價值
hasPersistedState 旗標,指出這是否為永續性服務,它會將狀態儲存在本機磁碟上。 如果是,則此屬性的值為 true,如果不是 false,則為 false。 bool
minReplicaSetSize 復本集大小下限為數位。 int

約束:
最小值 = 1
quorumLossWaitDuration 允許分割區處於仲裁遺失狀態的最大持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
replicaRestartWaitDuration 復本關閉和建立新復本時之間的持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
serviceKind 服務種類(無狀態或具狀態)。 '具狀態' (必要)
servicePlacementTimeLimit 復本在報告建置停滯之前可以保留 InBuild 的持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
standByReplicaKeepDuration 在移除之前,應該維護 StandBy 複本長度的定義,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
targetReplicaSetSize 目標副本集大小為數位。 int

約束:
最小值 = 1

StatelessServiceProperties

名字 描述 價值
instanceCount 實例計數。 int

約束:
最小值 = -1 (必要)
minInstanceCount MinInstanceCount 是必須在升級或停用節點等作業期間符合 EnsureAvailability 安全檢查的最小實例數目。 使用的實際數位是 max(MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) 。 請注意,如果 InstanceCount 設定為 -1,在 MinInstanceCount 計算期間,-1 會先轉換成允許根據服務放置條件約束放置實例的節點數目。 int
minInstancePercentage MinInstancePercentage 是 InstanceCount 的最小百分比,必須符合升級或停用節點等作業期間的 EnsureAvailability 安全檢查。 使用的實際數位是 max(MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) 。 請注意,如果 InstanceCount 設定為 -1,在 MinInstancePercentage 計算期間,-1 會先轉換成允許根據服務放置條件約束的實例數目。 int
serviceKind 服務種類(無狀態或具狀態)。 '無狀態' (必要)

UniformInt64RangePartitionScheme

名字 描述 價值
計數 數據分割的數目。 int (必要)
highKey 分割區索引鍵範圍的上限
應該在分割區 『Count』 之間分割
int (必要)
lowKey 分割區索引鍵範圍的下限
應該在分割區 『Count』 之間分割
int (必要)
partitionScheme 指定如何分割服務。 'UniformInt64Range' (必要)

ARM 樣本資源定義

managedclusters/applications/services 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.ServiceFabric/managedclusters/applications/services 資源,請將下列 JSON 新增至範本。

{
  "type": "Microsoft.ServiceFabric/managedclusters/applications/services",
  "apiVersion": "2022-02-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "correlationScheme": [
      {
        "scheme": "string",
        "serviceName": "string"
      }
    ],
    "defaultMoveCost": "string",
    "partitionDescription": {
      "partitionScheme": "string"
      // For remaining properties, see Partition objects
    },
    "placementConstraints": "string",
    "scalingPolicies": [
      {
        "scalingMechanism": {
          "kind": "string"
          // For remaining properties, see ScalingMechanism objects
        },
        "scalingTrigger": {
          "kind": "string"
          // For remaining properties, see ScalingTrigger objects
        }
      }
    ],
    "serviceLoadMetrics": [
      {
        "defaultLoad": "int",
        "name": "string",
        "primaryDefaultLoad": "int",
        "secondaryDefaultLoad": "int",
        "weight": "string"
      }
    ],
    "servicePackageActivationMode": "string",
    "servicePlacementPolicies": [ {
      "type": "string"
      // For remaining properties, see ServicePlacementPolicy objects
    } ],
    "serviceTypeName": "string",
    "serviceKind": "string"
    // For remaining properties, see ServiceResourceProperties objects
  },
  "tags": {
    "{customized property}": "string"
  }
}

數據分割物件

設定 partitionScheme 屬性,以指定對象的類型。

針對 具名,請使用:

{
  "names": [ "string" ],
  "partitionScheme": "Named"
}

針對 Singleton,請使用:

{
  "partitionScheme": "Singleton"
}

針對 UniformInt64Range,請使用:

{
  "count": "int",
  "highKey": "int",
  "lowKey": "int",
  "partitionScheme": "UniformInt64Range"
}

ServiceResourceProperties 物件

設定 serviceKind 屬性,以指定物件的類型。

針對 具狀態,請使用:

{
  "hasPersistedState": "bool",
  "minReplicaSetSize": "int",
  "quorumLossWaitDuration": "string",
  "replicaRestartWaitDuration": "string",
  "serviceKind": "Stateful",
  "servicePlacementTimeLimit": "string",
  "standByReplicaKeepDuration": "string",
  "targetReplicaSetSize": "int"
}

針對 無狀態,請使用:

{
  "instanceCount": "int",
  "minInstanceCount": "int",
  "minInstancePercentage": "int",
  "serviceKind": "Stateless"
}

ServicePlacementPolicy 物件

設定 類型 屬性,以指定物件的類型。

針對 InvalidDomain,請使用:

{
  "domainName": "string",
  "type": "InvalidDomain"
}

針對 NonPartiallyPlaceService,請使用:

{
  "type": "NonPartiallyPlaceService"
}

針對 PreferredPrimaryDomain,請使用:

{
  "domainName": "string",
  "type": "PreferredPrimaryDomain"
}

針對 requiredDomain,請使用:

{
  "domainName": "string",
  "type": "RequiredDomain"
}

針對 RequiredDomainDistribution,請使用:

{
  "domainName": "string",
  "type": "RequiredDomainDistribution"
}

ScalingTrigger 物件

設定 種類 屬性,以指定對象的類型。

針對 AveragePartitionLoadTrigger,請使用:

{
  "kind": "AveragePartitionLoadTrigger",
  "lowerLoadThreshold": "int",
  "metricName": "string",
  "scaleInterval": "string",
  "upperLoadThreshold": "int"
}

針對 AverageServiceLoadTrigger,請使用:

{
  "kind": "AverageServiceLoadTrigger",
  "lowerLoadThreshold": "int",
  "metricName": "string",
  "scaleInterval": "string",
  "upperLoadThreshold": "int",
  "useOnlyPrimaryLoad": "bool"
}

縮放機械物件

設定 種類 屬性,以指定對象的類型。

針對 AddRemoveIncrementalNamedPartition,請使用:

{
  "kind": "AddRemoveIncrementalNamedPartition",
  "maxPartitionCount": "int",
  "minPartitionCount": "int",
  "scaleIncrement": "int"
}

針對 ScalePartitionInstanceCount,請使用:

{
  "kind": "ScalePartitionInstanceCount",
  "maxInstanceCount": "int",
  "minInstanceCount": "int",
  "scaleIncrement": "int"
}

屬性值

AddRemoveIncrementalNamedPartitionScalingMechanism

名字 描述 價值
指定與此調整原則相關聯的機制。 'AddRemoveIncrementalNamedPartition' (必要)
maxPartitionCount 服務的具名分割區數目上限。 int (必要)
minPartitionCount 服務的具名分割區數目下限。 int (必要)
scaleIncrement 調整作業期間要新增或移除的實例數目。 int (必要)

AveragePartitionLoadScalingTrigger

名字 描述 價值
指定與此調整原則相關聯的觸發程式。 'AveragePartitionLoadTrigger' (必要)
lowerLoadThreshold 應執行相應縮小作業之負載的下限。 int (必要)
metricName 應追蹤使用量的計量名稱。 字串 (必要)
scaleInterval 決定是否要調整的秒數。 此屬性應以 ISO 8601 格式 「hh:mm:ss」 表示。 字串 (必要)
upperLoadThreshold 應該執行相應放大作業的負載上限。 int (必要)

AverageServiceLoadScalingTrigger

名字 描述 價值
指定與此調整原則相關聯的觸發程式。 'AverageServiceLoadTrigger' (必要)
lowerLoadThreshold 應執行相應縮小作業之負載的下限。 int (必要)
metricName 應追蹤使用量的計量名稱。 字串 (必要)
scaleInterval 決定是否要調整的秒數。 此屬性應以 ISO 8601 格式 「hh:mm:ss」 表示。 字串 (必要)
upperLoadThreshold 應該執行相應放大作業的負載上限。 int (必要)
useOnlyPrimaryLoad 旗標會決定是否只考慮要調整主要複本的負載。 如果設定為 true,則觸發程式只會考慮具狀態服務的主要復本負載。 如果設定為 false,觸發程式會考慮載入所有複本。 無狀態服務無法將此參數設定為 true。 布林 (必要)

Microsoft.ServiceFabric/managedclusters/applications/services

名字 描述 價值
apiVersion API 版本 '2022-02-01-preview'
位置 資源位置取決於父資源。 字串
名字 資源名稱 字串 (必要)
性能 服務資源屬性。 ServiceResourceProperties
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
類型 資源類型 'Microsoft.ServiceFabric/managedclusters/applications/services'

NamedPartitionScheme

名字 描述 價值
名字 分割區名稱的陣列。 string[] (必要)
partitionScheme 指定如何分割服務。 'Named' (必要)

分區

名字 描述 價值
partitionScheme 針對 type NamedPartitionScheme,設定為 'Named'。 將 設定為 type SingletonPartitionScheme的 'Singleton'。 針對 UniformInt64RangePartitionScheme類型,設定為 'UniformInt64Range'。 'Named'
'Singleton'
'UniformInt64Range' (必要)

PartitionInstanceCountScaleMechanism

名字 描述 價值
指定與此調整原則相關聯的機制。 'ScalePartitionInstanceCount' (必要)
maxInstanceCount 分割區的實例數目上限。 int (必要)
minInstanceCount 分割區的實例數目下限。 int (必要)
scaleIncrement 調整作業期間要新增或移除的實例數目。 int (必要)

ProxyResourceTags

名字 描述 價值

ScalingMechanism

名字 描述 價值
針對 type AddRemoveIncrementalNamedPartition' 設定為 'AddRemoveIncrementalNamedPartitionScalingMechanism。 針對 partitionInstanceCountScaleMechanism類型 ,設定為 'ScalePartitionInstanceCount'。 'AddRemoveIncrementalNamedPartition'
'ScalePartitionInstanceCount' (必要)

ScalingPolicy

名字 描述 價值
scalingMechanism 指定與此調整原則相關聯的機制 縮放機械 (必要)
scalingTrigger 指定與此調整原則相關聯的觸發程式。 ScalingTrigger (必要)

ScalingTrigger

名字 描述 價值
針對 type AveragePartitionLoadScalingTrigger,設定為 'AveragePartitionLoadTrigger'。 將 類型設定為 'AverageServiceLoadTrigger',AverageServiceLoadScalingTrigger 'AveragePartitionLoadTrigger'
'AverageServiceLoadTrigger' (必要)

ServiceCorrelation

名字 描述 價值
方案 ServiceCorrelationScheme,描述此服務與透過 ServiceName 指定的服務之間的關聯性。 'AlignedAffinity'
'NonAlignedAffinity' (必要)
serviceName 建立相互關聯性之服務的 Arm 資源標識碼。 字串 (必要)

ServiceLoadMetric

名字 描述 價值
defaultLoad 僅適用於無狀態服務。 此服務為此計量所建立的預設負載量,以數位表示。 int
名字 計量的名稱。 如果服務選擇在運行時間報告負載,載入計量名稱應該完全符合 Name 中指定的名稱。 請注意,計量名稱區分大小寫。 字串 (必要)
primaryDefaultLoad 僅適用於具狀態服務。 當此服務是主要複本時,此服務針對此計量所建立的預設負載量,以數位表示。 int
secondaryDefaultLoad 僅適用於具狀態服務。 當此服務是次要複本時,此服務針對此計量所建立的預設負載量,以數位表示。 int
重量 相較於為此服務設定的其他計量,服務負載計量相對權數為數位。 'High'
'Low'
'Medium'
'Zero'

ServicePlacementInvalidDomainPolicy

名字 描述 價值
domainName 不應該用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'InvalidDomain' (必要)

ServicePlacementNonPartiallyPlaceServicePolicy

名字 描述 價值
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'NonPartiallyPlaceService' (必要)

ServicePlacementPolicy

名字 描述 價值
類型 針對 type ServicePlacementInvalidDomainPolicy,設定為 'InvalidDomain'。 針對 type ServicePlacementNonPartiallyPlaceServicePolicy,設定為 'NonPartiallyPlaceServiceService'。 針對 type ServicePlacementPreferPrimaryDomainPolicy,設定為 'PreferredPrimaryDomain'。 針對 servicePlacementRequiredDomainPolicy 類型 設定為 'RequiredDomain',。 針對 type ServicePlacementRequireDomainDistributionPolicy,設定為 'RequiredDomainDistribution'。 'InvalidDomain'
'NonPartiallyPlaceService'
'PreferredPrimaryDomain'
'RequiredDomain'
'RequiredDomainDistribution' (必要)

ServicePlacementPreferPrimaryDomainPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'PreferredPrimaryDomain' (必要)

ServicePlacementRequiredDomainPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'RequiredDomain' (必要)

ServicePlacementRequireDomainDistributionPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'RequiredDomainDistribution' (必要)

ServiceResourceProperties

名字 描述 價值
correlationScheme 描述服務與其他服務相互關聯的清單。 ServiceCorrelation[]
defaultMoveCost 指定服務的移動成本。 'High'
'Low'
'Medium'
'Zero'
partitionDescription 描述如何分割服務。 分割區 (必要)
placementConstraints 放置條件約束做為字串。 放置條件約束是節點屬性上的布爾表達式,允許根據服務需求將服務限制為特定節點。 例如,若要將服務放在 NodeType 為藍色的節點上,請指定下列專案:“NodeColor == blue)”。 字串
scalingPolicies 調整此服務的原則。 ScalingPolicy[]
serviceKind 針對 statefulServiceProperties 類型 設定為 'Stateful'。 將 類型設為 'Stateless' StatelessServiceProperties '具狀態'
'無狀態' (必要)
serviceLoadMetrics 服務負載計量會指定為 ServiceLoadMetric 物件的陣列。 ServiceLoadMetric[]
servicePackageActivationMode 服務套件的啟用模式 'ExclusiveProcess'
'SharedProcess'
servicePlacementPolicies 描述服務與其他服務相互關聯的清單。 ServicePlacementPolicy[]
serviceTypeName 服務類型的名稱 字串 (必要)

SingletonPartitionScheme

名字 描述 價值
partitionScheme 指定如何分割服務。 'Singleton' (必要)

StatefulServiceProperties

名字 描述 價值
hasPersistedState 旗標,指出這是否為永續性服務,它會將狀態儲存在本機磁碟上。 如果是,則此屬性的值為 true,如果不是 false,則為 false。 bool
minReplicaSetSize 復本集大小下限為數位。 int

約束:
最小值 = 1
quorumLossWaitDuration 允許分割區處於仲裁遺失狀態的最大持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
replicaRestartWaitDuration 復本關閉和建立新復本時之間的持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
serviceKind 服務種類(無狀態或具狀態)。 '具狀態' (必要)
servicePlacementTimeLimit 復本在報告建置停滯之前可以保留 InBuild 的持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
standByReplicaKeepDuration 在移除之前,應該維護 StandBy 複本長度的定義,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
targetReplicaSetSize 目標副本集大小為數位。 int

約束:
最小值 = 1

StatelessServiceProperties

名字 描述 價值
instanceCount 實例計數。 int

約束:
最小值 = -1 (必要)
minInstanceCount MinInstanceCount 是必須在升級或停用節點等作業期間符合 EnsureAvailability 安全檢查的最小實例數目。 使用的實際數位是 max(MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) 。 請注意,如果 InstanceCount 設定為 -1,在 MinInstanceCount 計算期間,-1 會先轉換成允許根據服務放置條件約束放置實例的節點數目。 int
minInstancePercentage MinInstancePercentage 是 InstanceCount 的最小百分比,必須符合升級或停用節點等作業期間的 EnsureAvailability 安全檢查。 使用的實際數位是 max(MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) 。 請注意,如果 InstanceCount 設定為 -1,在 MinInstancePercentage 計算期間,-1 會先轉換成允許根據服務放置條件約束的實例數目。 int
serviceKind 服務種類(無狀態或具狀態)。 '無狀態' (必要)

UniformInt64RangePartitionScheme

名字 描述 價值
計數 數據分割的數目。 int (必要)
highKey 分割區索引鍵範圍的上限
應該在分割區 『Count』 之間分割
int (必要)
lowKey 分割區索引鍵範圍的下限
應該在分割區 『Count』 之間分割
int (必要)
partitionScheme 指定如何分割服務。 'UniformInt64Range' (必要)

Terraform (AzAPI 提供者) 資源定義

managedclusters/applications/services 資源類型可以使用目標作業來部署:

  • 資源群組

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.ServiceFabric/managedclusters/applications/services 資源,請將下列 Terraform 新增至您的範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedclusters/applications/services@2022-02-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      correlationScheme = [
        {
          scheme = "string"
          serviceName = "string"
        }
      ]
      defaultMoveCost = "string"
      partitionDescription = {
        partitionScheme = "string"
        // For remaining properties, see Partition objects
      }
      placementConstraints = "string"
      scalingPolicies = [
        {
          scalingMechanism = {
            kind = "string"
            // For remaining properties, see ScalingMechanism objects
          }
          scalingTrigger = {
            kind = "string"
            // For remaining properties, see ScalingTrigger objects
          }
        }
      ]
      serviceLoadMetrics = [
        {
          defaultLoad = int
          name = "string"
          primaryDefaultLoad = int
          secondaryDefaultLoad = int
          weight = "string"
        }
      ]
      servicePackageActivationMode = "string"
      servicePlacementPolicies = [
        {
          type = "string"
          // For remaining properties, see ServicePlacementPolicy objects
        }
      ]
      serviceTypeName = "string"
      serviceKind = "string"
      // For remaining properties, see ServiceResourceProperties objects
    }
  })
}

數據分割物件

設定 partitionScheme 屬性,以指定對象的類型。

針對 具名,請使用:

{
  names = [
    "string"
  ]
  partitionScheme = "Named"
}

針對 Singleton,請使用:

{
  partitionScheme = "Singleton"
}

針對 UniformInt64Range,請使用:

{
  count = int
  highKey = int
  lowKey = int
  partitionScheme = "UniformInt64Range"
}

ServiceResourceProperties 物件

設定 serviceKind 屬性,以指定物件的類型。

針對 具狀態,請使用:

{
  hasPersistedState = bool
  minReplicaSetSize = int
  quorumLossWaitDuration = "string"
  replicaRestartWaitDuration = "string"
  serviceKind = "Stateful"
  servicePlacementTimeLimit = "string"
  standByReplicaKeepDuration = "string"
  targetReplicaSetSize = int
}

針對 無狀態,請使用:

{
  instanceCount = int
  minInstanceCount = int
  minInstancePercentage = int
  serviceKind = "Stateless"
}

ServicePlacementPolicy 物件

設定 類型 屬性,以指定物件的類型。

針對 InvalidDomain,請使用:

{
  domainName = "string"
  type = "InvalidDomain"
}

針對 NonPartiallyPlaceService,請使用:

{
  type = "NonPartiallyPlaceService"
}

針對 PreferredPrimaryDomain,請使用:

{
  domainName = "string"
  type = "PreferredPrimaryDomain"
}

針對 requiredDomain,請使用:

{
  domainName = "string"
  type = "RequiredDomain"
}

針對 RequiredDomainDistribution,請使用:

{
  domainName = "string"
  type = "RequiredDomainDistribution"
}

ScalingTrigger 物件

設定 種類 屬性,以指定對象的類型。

針對 AveragePartitionLoadTrigger,請使用:

{
  kind = "AveragePartitionLoadTrigger"
  lowerLoadThreshold = int
  metricName = "string"
  scaleInterval = "string"
  upperLoadThreshold = int
}

針對 AverageServiceLoadTrigger,請使用:

{
  kind = "AverageServiceLoadTrigger"
  lowerLoadThreshold = int
  metricName = "string"
  scaleInterval = "string"
  upperLoadThreshold = int
  useOnlyPrimaryLoad = bool
}

縮放機械物件

設定 種類 屬性,以指定對象的類型。

針對 AddRemoveIncrementalNamedPartition,請使用:

{
  kind = "AddRemoveIncrementalNamedPartition"
  maxPartitionCount = int
  minPartitionCount = int
  scaleIncrement = int
}

針對 ScalePartitionInstanceCount,請使用:

{
  kind = "ScalePartitionInstanceCount"
  maxInstanceCount = int
  minInstanceCount = int
  scaleIncrement = int
}

屬性值

AddRemoveIncrementalNamedPartitionScalingMechanism

名字 描述 價值
指定與此調整原則相關聯的機制。 'AddRemoveIncrementalNamedPartition' (必要)
maxPartitionCount 服務的具名分割區數目上限。 int (必要)
minPartitionCount 服務的具名分割區數目下限。 int (必要)
scaleIncrement 調整作業期間要新增或移除的實例數目。 int (必要)

AveragePartitionLoadScalingTrigger

名字 描述 價值
指定與此調整原則相關聯的觸發程式。 'AveragePartitionLoadTrigger' (必要)
lowerLoadThreshold 應執行相應縮小作業之負載的下限。 int (必要)
metricName 應追蹤使用量的計量名稱。 字串 (必要)
scaleInterval 決定是否要調整的秒數。 此屬性應以 ISO 8601 格式 「hh:mm:ss」 表示。 字串 (必要)
upperLoadThreshold 應該執行相應放大作業的負載上限。 int (必要)

AverageServiceLoadScalingTrigger

名字 描述 價值
指定與此調整原則相關聯的觸發程式。 'AverageServiceLoadTrigger' (必要)
lowerLoadThreshold 應執行相應縮小作業之負載的下限。 int (必要)
metricName 應追蹤使用量的計量名稱。 字串 (必要)
scaleInterval 決定是否要調整的秒數。 此屬性應以 ISO 8601 格式 「hh:mm:ss」 表示。 字串 (必要)
upperLoadThreshold 應該執行相應放大作業的負載上限。 int (必要)
useOnlyPrimaryLoad 旗標會決定是否只考慮要調整主要複本的負載。 如果設定為 true,則觸發程式只會考慮具狀態服務的主要復本負載。 如果設定為 false,觸發程式會考慮載入所有複本。 無狀態服務無法將此參數設定為 true。 布林 (必要)

Microsoft.ServiceFabric/managedclusters/applications/services

名字 描述 價值
位置 資源位置取決於父資源。 字串
名字 資源名稱 字串 (必要)
parent_id 此資源為父系之資源的標識碼。 類型的資源標識碼:managedclusters/applications
性能 服務資源屬性。 ServiceResourceProperties
標籤 資源標籤 標記名稱和值的字典。
類型 資源類型 “Microsoft.ServiceFabric/managedclusters/applications/services@2022-02-01-preview”

NamedPartitionScheme

名字 描述 價值
名字 分割區名稱的陣列。 string[] (必要)
partitionScheme 指定如何分割服務。 'Named' (必要)

分區

名字 描述 價值
partitionScheme 針對 type NamedPartitionScheme,設定為 'Named'。 將 設定為 type SingletonPartitionScheme的 'Singleton'。 針對 UniformInt64RangePartitionScheme類型,設定為 'UniformInt64Range'。 'Named'
'Singleton'
'UniformInt64Range' (必要)

PartitionInstanceCountScaleMechanism

名字 描述 價值
指定與此調整原則相關聯的機制。 'ScalePartitionInstanceCount' (必要)
maxInstanceCount 分割區的實例數目上限。 int (必要)
minInstanceCount 分割區的實例數目下限。 int (必要)
scaleIncrement 調整作業期間要新增或移除的實例數目。 int (必要)

ProxyResourceTags

名字 描述 價值

ScalingMechanism

名字 描述 價值
針對 type AddRemoveIncrementalNamedPartition' 設定為 'AddRemoveIncrementalNamedPartitionScalingMechanism。 針對 partitionInstanceCountScaleMechanism類型 ,設定為 'ScalePartitionInstanceCount'。 'AddRemoveIncrementalNamedPartition'
'ScalePartitionInstanceCount' (必要)

ScalingPolicy

名字 描述 價值
scalingMechanism 指定與此調整原則相關聯的機制 縮放機械 (必要)
scalingTrigger 指定與此調整原則相關聯的觸發程式。 ScalingTrigger (必要)

ScalingTrigger

名字 描述 價值
針對 type AveragePartitionLoadScalingTrigger,設定為 'AveragePartitionLoadTrigger'。 將 類型設定為 'AverageServiceLoadTrigger',AverageServiceLoadScalingTrigger 'AveragePartitionLoadTrigger'
'AverageServiceLoadTrigger' (必要)

ServiceCorrelation

名字 描述 價值
方案 ServiceCorrelationScheme,描述此服務與透過 ServiceName 指定的服務之間的關聯性。 'AlignedAffinity'
'NonAlignedAffinity' (必要)
serviceName 建立相互關聯性之服務的 Arm 資源標識碼。 字串 (必要)

ServiceLoadMetric

名字 描述 價值
defaultLoad 僅適用於無狀態服務。 此服務為此計量所建立的預設負載量,以數位表示。 int
名字 計量的名稱。 如果服務選擇在運行時間報告負載,載入計量名稱應該完全符合 Name 中指定的名稱。 請注意,計量名稱區分大小寫。 字串 (必要)
primaryDefaultLoad 僅適用於具狀態服務。 當此服務是主要複本時,此服務針對此計量所建立的預設負載量,以數位表示。 int
secondaryDefaultLoad 僅適用於具狀態服務。 當此服務是次要複本時,此服務針對此計量所建立的預設負載量,以數位表示。 int
重量 相較於為此服務設定的其他計量,服務負載計量相對權數為數位。 'High'
'Low'
'Medium'
'Zero'

ServicePlacementInvalidDomainPolicy

名字 描述 價值
domainName 不應該用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'InvalidDomain' (必要)

ServicePlacementNonPartiallyPlaceServicePolicy

名字 描述 價值
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'NonPartiallyPlaceService' (必要)

ServicePlacementPolicy

名字 描述 價值
類型 針對 type ServicePlacementInvalidDomainPolicy,設定為 'InvalidDomain'。 針對 type ServicePlacementNonPartiallyPlaceServicePolicy,設定為 'NonPartiallyPlaceServiceService'。 針對 type ServicePlacementPreferPrimaryDomainPolicy,設定為 'PreferredPrimaryDomain'。 針對 servicePlacementRequiredDomainPolicy 類型 設定為 'RequiredDomain',。 針對 type ServicePlacementRequireDomainDistributionPolicy,設定為 'RequiredDomainDistribution'。 'InvalidDomain'
'NonPartiallyPlaceService'
'PreferredPrimaryDomain'
'RequiredDomain'
'RequiredDomainDistribution' (必要)

ServicePlacementPreferPrimaryDomainPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'PreferredPrimaryDomain' (必要)

ServicePlacementRequiredDomainPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'RequiredDomain' (必要)

ServicePlacementRequireDomainDistributionPolicy

名字 描述 價值
domainName 應該根據此原則用於放置的功能變數名稱。 字串 (必要)
類型 Service Fabric 服務的放置原則類型。 以下是可能的值。 'RequiredDomainDistribution' (必要)

ServiceResourceProperties

名字 描述 價值
correlationScheme 描述服務與其他服務相互關聯的清單。 ServiceCorrelation[]
defaultMoveCost 指定服務的移動成本。 'High'
'Low'
'Medium'
'Zero'
partitionDescription 描述如何分割服務。 分割區 (必要)
placementConstraints 放置條件約束做為字串。 放置條件約束是節點屬性上的布爾表達式,允許根據服務需求將服務限制為特定節點。 例如,若要將服務放在 NodeType 為藍色的節點上,請指定下列專案:“NodeColor == blue)”。 字串
scalingPolicies 調整此服務的原則。 ScalingPolicy[]
serviceKind 針對 statefulServiceProperties 類型 設定為 'Stateful'。 將 類型設為 'Stateless' StatelessServiceProperties '具狀態'
'無狀態' (必要)
serviceLoadMetrics 服務負載計量會指定為 ServiceLoadMetric 物件的陣列。 ServiceLoadMetric[]
servicePackageActivationMode 服務套件的啟用模式 'ExclusiveProcess'
'SharedProcess'
servicePlacementPolicies 描述服務與其他服務相互關聯的清單。 ServicePlacementPolicy[]
serviceTypeName 服務類型的名稱 字串 (必要)

SingletonPartitionScheme

名字 描述 價值
partitionScheme 指定如何分割服務。 'Singleton' (必要)

StatefulServiceProperties

名字 描述 價值
hasPersistedState 旗標,指出這是否為永續性服務,它會將狀態儲存在本機磁碟上。 如果是,則此屬性的值為 true,如果不是 false,則為 false。 bool
minReplicaSetSize 復本集大小下限為數位。 int

約束:
最小值 = 1
quorumLossWaitDuration 允許分割區處於仲裁遺失狀態的最大持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
replicaRestartWaitDuration 復本關閉和建立新復本時之間的持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
serviceKind 服務種類(無狀態或具狀態)。 '具狀態' (必要)
servicePlacementTimeLimit 復本在報告建置停滯之前可以保留 InBuild 的持續時間,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
standByReplicaKeepDuration 在移除之前,應該維護 StandBy 複本長度的定義,以 ISO 8601 格式 「hh:mm:ss」 表示。 字串
targetReplicaSetSize 目標副本集大小為數位。 int

約束:
最小值 = 1

StatelessServiceProperties

名字 描述 價值
instanceCount 實例計數。 int

約束:
最小值 = -1 (必要)
minInstanceCount MinInstanceCount 是必須在升級或停用節點等作業期間符合 EnsureAvailability 安全檢查的最小實例數目。 使用的實際數位是 max(MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) 。 請注意,如果 InstanceCount 設定為 -1,在 MinInstanceCount 計算期間,-1 會先轉換成允許根據服務放置條件約束放置實例的節點數目。 int
minInstancePercentage MinInstancePercentage 是 InstanceCount 的最小百分比,必須符合升級或停用節點等作業期間的 EnsureAvailability 安全檢查。 使用的實際數位是 max(MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) 。 請注意,如果 InstanceCount 設定為 -1,在 MinInstancePercentage 計算期間,-1 會先轉換成允許根據服務放置條件約束的實例數目。 int
serviceKind 服務種類(無狀態或具狀態)。 '無狀態' (必要)

UniformInt64RangePartitionScheme

名字 描述 價值
計數 數據分割的數目。 int (必要)
highKey 分割區索引鍵範圍的上限
應該在分割區 『Count』 之間分割
int (必要)
lowKey 分割區索引鍵範圍的下限
應該在分割區 『Count』 之間分割
int (必要)
partitionScheme 指定如何分割服務。 'UniformInt64Range' (必要)