Microsoft.ServiceFabric managedclusters/applications/services 2021-01-01-preview

  • [アーティクル]

Bicep リソース定義

managedclusters/applications/services リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.ServiceFabric/managedclusters/applications/services リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.ServiceFabric/managedclusters/applications/services@2021-01-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  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
  }
}

ServiceResourceProperties オブジェクト

serviceKind プロパティを設定して、オブジェクトの種類を指定します。

Stateful の場合は、次の値を使用します。

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

ステートレスの場合は、次の値を使用します。

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

パーティション オブジェクト

partitionScheme プロパティを設定して、オブジェクトの種類を指定します。

[名前付き] には、次の値を使用します。

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

Singleton の場合は、次の値を使用します。

  partitionScheme: 'Singleton'

UniformInt64Range の場合は、次の値を使用します。

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

ScalingMechanism オブジェクト

kind プロパティを設定して、オブジェクトの種類を指定します。

AddRemoveIncrementalNamedPartition の場合は、次の値を使用します。

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

ScalePartitionInstanceCount の場合は、次の値を使用します。

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

ScalingTrigger オブジェクト

kind プロパティを設定して、オブジェクトの種類を指定します。

AveragePartitionLoadTrigger の場合は、次の値を使用します。

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

AverageServiceLoadTrigger の場合は、次の値を使用します。

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

ServicePlacementPolicy オブジェクト

オブジェクトの 型 を指定するには、type プロパティを設定します。

InvalidDomain の場合は、次の値を使用します。

  type: 'InvalidDomain'
  domainName: 'string'

NonPartiallyPlaceService の場合は、次の値を使用します。

  type: 'NonPartiallyPlaceService'

PreferredPrimaryDomain の場合は、次を使用します。

  type: 'PreferredPrimaryDomain'
  domainName: 'string'

RequiredDomain の場合は、次の値を使用します。

  type: 'RequiredDomain'
  domainName: 'string'

RequiredDomainDistribution の場合は、次を使用します。

  type: 'RequiredDomainDistribution'
  domainName: 'string'

プロパティ値

managedclusters/applications/services

名前 説明 値
name リソース名

Bicep で子リソースの名前と型を設定する方法を参照してください。		 string (必須)
location リソースの場所は、親リソースによって異なります。 string
tags Azure リソース タグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
parent Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「 親リソースの外部の子リソース」を参照してください。		 種類のリソースのシンボル名: アプリケーション
properties サービス リソースのプロパティ。 ServiceResourceProperties

ServiceResourceProperties

名前 説明 値
correlationScheme サービスと他のサービスの相関関係を説明するリスト。 ServiceCorrelation[]
defaultMoveCost サービスの移動コストを指定します。 'High'
'Low'
'Medium'
'Zero'
partitionDescription サービスのパーティション分割方法について説明します。 パーティション (必須)
placementConstraints 文字列としての配置の制約。 配置の制約はノード プロパティ上のブール式で、サービスの要件に基づいて特定のノードにサービスを制限することができます。 たとえば、NodeType が青色のノードにサービスを配置するには、"NodeColor == blue)" を指定します。 string
scalingPolicies このサービスのスケーリング ポリシー。 ScalingPolicy[]
serviceLoadMetrics サービス読み込みメトリックは、ServiceLoadMetric オブジェクトの配列として指定されます。 ServiceLoadMetric[]
servicePackageActivationMode サービス パッケージのアクティブ化モード 'ExclusiveProcess'
'SharedProcess'
servicePlacementPolicies サービスと他のサービスの相関関係を説明するリスト。 ServicePlacementPolicy[]
serviceTypeName サービスの種類の名前 string (必須)
serviceKind オブジェクトの種類を設定する ステートフル
ステートレス (必須)

ServiceCorrelation

名前 説明 値
scheme ServiceCorrelationScheme。このサービスと ServiceName を介して指定されたサービスの間の関係を記述します。 'AlignedAffinity'
'NonAlignedAffinity' (必須)
serviceName 関連付け関係が確立されているサービスの Arm リソース ID。 string (必須)

Partition

名前 説明 値
partitionScheme オブジェクトの種類を設定する Named
Singleton
UniformInt64Range (必須)

NamedPartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 'Named' (必須)
names パーティションの名前の配列。 string[] (必須)

SingletonPartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 'Singleton' (必須)

UniformInt64RangePartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 'UniformInt64Range' (必須)
count パーティションの数。 int (必須)
highKey パーティション キー範囲の上限
パーティション 'Count' 間で分割する必要があります		 int (必須)
lowKey パーティション キー範囲の下限
パーティション 'Count' 間で分割する必要があります		 int (必須)

ScalingPolicy

名前 説明 値
scalingMechanism このスケーリング ポリシーに関連付けられているメカニズムを指定します ScalingMechanism (必須)
scalingTrigger このスケーリング ポリシーに関連付けられているトリガーを指定します。 ScalingTrigger (必須)

ScalingMechanism

名前 説明 値
kind オブジェクトの種類を設定する AddRemoveIncrementalNamedPartition
ScalePartitionInstanceCount (必須)

AddRemoveIncrementalNamedPartitionScalingMechanism

名前 説明 値
kind このスケーリング ポリシーに関連付けられているメカニズムを指定します。 'AddRemoveIncrementalNamedPartition' (必須)
maxPartitionCount サービスの名前付きパーティションの最大数。 int (必須)
minPartitionCount サービスの名前付きパーティションの最小数。 int (必須)
scaleIncrement スケーリング操作中に追加または削除するインスタンスの数。 int (必須)

PartitionInstanceCountScaleMechanism

名前 説明 値
kind このスケーリング ポリシーに関連付けられているメカニズムを指定します。 'ScalePartitionInstanceCount' (必須)
maxInstanceCount パーティションのインスタンスの最大数。 int (必須)
minInstanceCount パーティションのインスタンスの最小数。 int (必須)
scaleIncrement スケーリング操作中に追加または削除するインスタンスの数。 int (必須)

ScalingTrigger

名前 説明 値
kind オブジェクトの種類を設定する AveragePartitionLoadTrigger
AverageServiceLoadTrigger (必須)

AveragePartitionLoadScalingTrigger

名前 説明 値
kind このスケーリング ポリシーに関連付けられているトリガーを指定します。 'AveragePartitionLoadTrigger' (必須)
lowerLoadThreshold スケールイン操作を実行する必要がある負荷の下限。 int (必須)
metricName 使用状況を追跡するメトリックの名前。 string (必須)
scaleInterval スケーリングするかどうかを決定する期間 (秒単位)。 このプロパティは、ISO 8601 形式の "hh:mm:ss" で指定する必要があります。 string (必須)
upperLoadThreshold スケールアウト操作を実行する必要がある負荷の上限。 int (必須)

AverageServiceLoadScalingTrigger

名前 説明 値
kind このスケーリング ポリシーに関連付けられているトリガーを指定します。 'AverageServiceLoadTrigger' (必須)
lowerLoadThreshold スケールイン操作を実行する必要がある負荷の下限。 int (必須)
metricName 使用状況を追跡するメトリックの名前。 string (必須)
scaleInterval スケーリングするかどうかを決定する期間 (秒単位)。 このプロパティは、ISO 8601 形式の "hh:mm:ss" で指定する必要があります。 string (必須)
upperLoadThreshold スケールアウト操作を実行する必要がある負荷の上限。 int (必須)
useOnlyPrimaryLoad フラグは、スケーリングのためにプライマリ レプリカの負荷のみを考慮するかどうかを決定します。 true に設定すると、トリガーはステートフル サービスのプライマリ レプリカの負荷のみを考慮します。 false に設定すると、トリガーはすべてのレプリカの読み込みを考慮します。 ステートレス サービスの場合、このパラメーターを true に設定することはできません。 bool (必須)

ServiceLoadMetric

名前 説明 値
defaultLoad ステートレス サービスにのみ使用されます。 このメトリックに対してこのサービスによって作成される既定の負荷量 (数値)。 INT
name メトリックの名前。 実行時にサービスが負荷を報告することを選択した場合、読み込みメトリック名は[名前] で指定された名前と正確に一致する必要があります。 メトリック名は大文字と小文字が区別されることに注意してください。 string (必須)
primaryDefaultLoad ステートフル サービスにのみ使用されます。 サービスがプライマリ レプリカである場合、このサービスがメトリックのために作成する既定の負荷量で、数値で表されます。 INT
secondaryDefaultLoad ステートフル サービスにのみ使用されます。 サービスがセカンダリ レプリカである場合、このサービスがメトリックのために作成する既定の負荷量で、数値で表されます。 INT
weight サービスの負荷メトリックの相対的な重みで、このサービス用に構成されたその他のメトリックと比較し、数値で表します。 'High'
'Low'
'Medium'
'Zero'

ServicePlacementPolicy

名前 説明 値
type オブジェクトの種類を設定する InvalidDomain
NonPartiallyPlaceService
PreferredPrimaryDomain
RequiredDomain
RequiredDomainDistribution (必須)

ServicePlacementInvalidDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'InvalidDomain' (必須)
domainName 配置に使用しないドメインの名前。 string (必須)

ServicePlacementNonPartiallyPlaceServicePolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'NonPartiallyPlaceService' (必須)

ServicePlacementPreferPrimaryDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'PreferredPrimaryDomain' (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

ServicePlacementRequiredDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'RequiredDomain' (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

ServicePlacementRequireDomainDistributionPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'RequiredDomainDistribution' (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

StatefulServiceProperties

名前 説明 値
serviceKind サービスの種類 (ステートレスまたはステートフル)。 'Stateful' (必須)
hasPersistedState これがローカル ディスクに状態を格納する永続的なサービスであるかどうかを示すフラグ。 このプロパティの値が true の場合、false でない場合は true になります。 [bool]
minReplicaSetSize レプリカ セットの最小サイズ (数)。 INT

制約:
最小値 = 1
quorumLossWaitDuration ISO 8601 形式の "hh:mm:ss" で表されるクォーラム損失の状態でパーティションが許可される最大期間。 string
replicaRestartWaitDuration レプリカがダウンしてから新しいレプリカが作成されるまでの期間は、ISO 8601 形式 "hh:mm:ss" で表されます。 string
servicePlacementTimeLimit ビルドがスタックしていることを報告する前にレプリカが InBuild に留まる期間は、ISO 8601 形式の "hh:mm:ss" で表されます。 string
standByReplicaKeepDuration 削除される前に StandBy レプリカを保持する必要がある期間に関する定義は、ISO 8601 形式の "hh:mm:ss" で表されます。 string
targetReplicaSetSize ターゲット レプリカ セットのサイズ (数)。 INT

制約:
最小値 = 1

StatelessServiceProperties

名前 説明 値
serviceKind サービスの種類 (ステートレスまたはステートフル)。 'Stateless' (必須)
instanceCount インスタンス数。 int (必須)
minInstanceCount MinInstanceCount は、アップグレードや非アクティブ化ノードなどの操作中に EnsureAvailability safety チェックを満たす必要があるインスタンスの最小数です。 実際に使用される数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstanceCount 計算中に -1 は、サービスの配置制約に従ってインスタンスを配置できるノードの数に最初に変換されます。 INT
minInstancePercentage MinInstancePercentage は、アップグレードや非アクティブ化ノードなどの操作中に EnsureAvailability safety チェックを満たすために必要な InstanceCount の最小割合です。 実際に使用される数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstancePercentage の計算中に、-1 は最初に、サービスの配置制約に従ってインスタンスを配置できるノードの数に変換されます。 INT

ARM テンプレート リソース定義

managedclusters/applications/services リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.ServiceFabric/managedclusters/applications/services リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.ServiceFabric/managedclusters/applications/services",
  "apiVersion": "2021-01-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "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
  }
}

ServiceResourceProperties オブジェクト

serviceKind プロパティを設定して、オブジェクトの種類を指定します。

Stateful の場合は、次の値を使用します。

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

ステートレスの場合は、次の値を使用します。

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

パーティション オブジェクト

partitionScheme プロパティを設定して、オブジェクトの種類を指定します。

[名前付き] には、次の値を使用します。

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

Singleton の場合は、次の値を使用します。

  "partitionScheme": "Singleton"

UniformInt64Range の場合は、次の値を使用します。

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

ScalingMechanism オブジェクト

kind プロパティを設定して、オブジェクトの種類を指定します。

AddRemoveIncrementalNamedPartition の場合は、次の値を使用します。

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

ScalePartitionInstanceCount の場合は、次の値を使用します。

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

ScalingTrigger オブジェクト

kind プロパティを設定して、オブジェクトの種類を指定します。

AveragePartitionLoadTrigger の場合は、次の値を使用します。

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

AverageServiceLoadTrigger の場合は、次の値を使用します。

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

ServicePlacementPolicy オブジェクト

type プロパティを設定して、オブジェクトの種類を指定します。

InvalidDomain の場合は、次の値を使用します。

  "type": "InvalidDomain",
  "domainName": "string"

NonPartiallyPlaceService の場合は、次の値を使用します。

  "type": "NonPartiallyPlaceService"

PreferredPrimaryDomain の場合は、次を使用します。

  "type": "PreferredPrimaryDomain",
  "domainName": "string"

RequiredDomain の場合は、次の値を使用します。

  "type": "RequiredDomain",
  "domainName": "string"

RequiredDomainDistribution の場合は、次の値を使用します。

  "type": "RequiredDomainDistribution",
  "domainName": "string"

プロパティ値

managedclusters/applications/services

名前 説明 値
type リソースの種類 'Microsoft.ServiceFabric/managedclusters/applications/services'
apiVersion リソース API のバージョン '2021-01-01-preview'
name リソース名

JSON ARM テンプレートで子リソースの名前と型を設定する方法を参照してください。		 string (必須)
location リソースの場所は、親リソースによって異なります。 string
tags Azure リソース タグ。 タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください
properties サービス リソースのプロパティ。 ServiceResourceProperties

ServiceResourceProperties

名前 説明 値
correlationScheme サービスと他のサービスの相関関係を説明するリスト。 ServiceCorrelation[]
defaultMoveCost サービスの移動コストを指定します。 'High'
'Low'
'Medium'
'Zero'
partitionDescription サービスのパーティション分割方法について説明します。 パーティション (必須)
placementConstraints 文字列としての配置の制約。 配置の制約はノード プロパティ上のブール式で、サービスの要件に基づいて特定のノードにサービスを制限することができます。 たとえば、NodeType が青色のノードにサービスを配置するには、"NodeColor == blue)" を指定します。 string
scalingPolicies このサービスのスケーリング ポリシー。 ScalingPolicy[]
serviceLoadMetrics サービス読み込みメトリックは、ServiceLoadMetric オブジェクトの配列として指定されます。 ServiceLoadMetric[]
servicePackageActivationMode サービス パッケージのアクティブ化モード 'ExclusiveProcess'
'SharedProcess'
servicePlacementPolicies サービスと他のサービスの相関関係を説明するリスト。 ServicePlacementPolicy[]
serviceTypeName サービスの種類の名前 string (必須)
serviceKind オブジェクトの種類を設定する ステートフル
ステートレス (必須)

ServiceCorrelation

名前 説明 値
scheme ServiceCorrelationScheme。このサービスと ServiceName を介して指定されたサービスの間の関係を記述します。 'AlignedAffinity'
'NonAlignedAffinity' (必須)
serviceName 関連付け関係が確立されているサービスの Arm リソース ID。 string (必須)

Partition

名前 説明 値
partitionScheme オブジェクトの種類を設定する Named
Singleton
UniformInt64Range (必須)

NamedPartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 'Named' (必須)
names パーティションの名前の配列。 string[] (必須)

SingletonPartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 'Singleton' (必須)

UniformInt64RangePartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 'UniformInt64Range' (必須)
count パーティションの数。 int (必須)
highKey パーティション キー範囲の上限。
パーティション 'Count' 間で分割する必要があります		 int (必須)
lowKey パーティション キー範囲の下限
パーティション 'Count' 間で分割する必要があります		 int (必須)

ScalingPolicy

名前 説明 値
scalingMechanism このスケーリング ポリシーに関連付けられているメカニズムを指定します ScalingMechanism (必須)
scalingTrigger このスケーリング ポリシーに関連付けられているトリガーを指定します。 ScalingTrigger (必須)

ScalingMechanism

名前 説明 値
kind オブジェクトの種類を設定する AddRemoveIncrementalNamedPartition
ScalePartitionInstanceCount (必須)

AddRemoveIncrementalNamedPartitionScalingMechanism

名前 説明 値
kind このスケーリング ポリシーに関連付けられているメカニズムを指定します。 'AddRemoveIncrementalNamedPartition' (必須)
maxPartitionCount サービスの名前付きパーティションの最大数。 int (必須)
minPartitionCount サービスの名前付きパーティションの最小数。 int (必須)
scaleIncrement スケーリング操作中に追加または削除するインスタンスの数。 int (必須)

PartitionInstanceCountScaleMechanism

名前 説明 値
kind このスケーリング ポリシーに関連付けられているメカニズムを指定します。 'ScalePartitionInstanceCount' (必須)
maxInstanceCount パーティションのインスタンスの最大数。 int (必須)
minInstanceCount パーティションのインスタンスの最小数。 int (必須)
scaleIncrement スケーリング操作中に追加または削除するインスタンスの数。 int (必須)

ScalingTrigger

名前 説明 値
kind オブジェクトの種類を設定する AveragePartitionLoadTrigger
AverageServiceLoadTrigger (必須)

AveragePartitionLoadScalingTrigger

名前 説明 値
kind このスケーリング ポリシーに関連付けられているトリガーを指定します。 'AveragePartitionLoadTrigger' (必須)
lowerLoadThreshold スケールイン操作を実行する必要がある負荷の下限。 int (必須)
metricName 使用状況を追跡する必要があるメトリックの名前。 string (必須)
scaleInterval スケーリングするかどうかを決定する期間 (秒単位)。 このプロパティは、ISO 8601 形式の "hh:mm:ss" である必要があります。 string (必須)
upperLoadThreshold スケールアウト操作を実行する必要がある負荷の上限。 int (必須)

AverageServiceLoadScalingTrigger

名前 説明 値
kind このスケーリング ポリシーに関連付けられているトリガーを指定します。 'AverageServiceLoadTrigger' (必須)
lowerLoadThreshold スケールイン操作を実行する必要がある負荷の下限。 int (必須)
metricName 使用状況を追跡する必要があるメトリックの名前。 string (必須)
scaleInterval スケーリングするかどうかを決定する期間 (秒単位)。 このプロパティは、ISO 8601 形式の "hh:mm:ss" である必要があります。 string (必須)
upperLoadThreshold スケールアウト操作を実行する必要がある負荷の上限。 int (必須)
useOnlyPrimaryLoad フラグは、プライマリ レプリカの負荷のみをスケーリングのために考慮する必要があるかどうかを決定します。 true に設定すると、トリガーはステートフル サービスのプライマリ レプリカの負荷のみを考慮します。 false に設定すると、トリガーはすべてのレプリカの読み込みを考慮します。 ステートレス サービスの場合、このパラメーターを true に設定することはできません。 bool (必須)

ServiceLoadMetric

名前 説明 値
defaultLoad ステートレス サービスにのみ使用されます。 このメトリックに対してこのサービスによって作成される既定の負荷量 (数値)。 INT
name メトリックの名前。 実行時にサービスが読み込みをレポートすることを選択した場合、読み込みメトリック名は[名前] で指定された名前と正確に一致する必要があります。 メトリック名は大文字と小文字が区別されることに注意してください。 string (必須)
primaryDefaultLoad ステートフル サービスにのみ使用されます。 サービスがプライマリ レプリカである場合、このサービスがメトリックのために作成する既定の負荷量で、数値で表されます。 INT
secondaryDefaultLoad ステートフル サービスにのみ使用されます。 サービスがセカンダリ レプリカである場合、このサービスがメトリックのために作成する既定の負荷量で、数値で表されます。 INT
weight サービスの負荷メトリックの相対的な重みで、このサービス用に構成されたその他のメトリックと比較し、数値で表します。 'High'
'Low'
'Medium'
'Zero'

ServicePlacementPolicy

名前 説明 値
type オブジェクトの種類を設定する InvalidDomain
NonPartiallyPlaceService
PreferredPrimaryDomain
RequiredDomain
RequiredDomainDistribution (必須)

ServicePlacementInvalidDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'InvalidDomain' (必須)
domainName 配置に使用しないドメインの名前。 string (必須)

ServicePlacementNonPartiallyPlaceServicePolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'NonPartiallyPlaceService' (必須)

ServicePlacementPreferPrimaryDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'PreferredPrimaryDomain' (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

ServicePlacementRequiredDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'RequiredDomain' (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

ServicePlacementRequireDomainDistributionPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 'RequiredDomainDistribution' (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

StatefulServiceProperties

名前 説明 値
serviceKind サービスの種類 (ステートレスまたはステートフル)。 'Stateful' (必須)
hasPersistedState これがローカル ディスクに状態を格納する永続的なサービスであるかどうかを示すフラグ。 が の場合、このプロパティの値は true になります。そうでない場合は false です。 [bool]
minReplicaSetSize レプリカ セットの最小サイズ (数)。 INT

制約:
最小値 = 1
quorumLossWaitDuration ISO 8601 形式の "hh:mm:ss" で表されるクォーラム損失の状態でパーティションを許可される最大期間。 string
replicaRestartWaitDuration レプリカがダウンしてから新しいレプリカが作成されるまでの期間は、ISO 8601 形式の "hh:mm:ss" で表されます。 string
servicePlacementTimeLimit ビルドがスタックしていることを報告する前にレプリカが InBuild を維持できる期間は、ISO 8601 形式の "hh:mm:ss" で表されます。 string
standByReplicaKeepDuration 削除される前に StandBy レプリカを保持する必要がある期間に関する定義。ISO 8601 形式の "hh:mm:ss" で表されます。 string
targetReplicaSetSize ターゲット レプリカ セットのサイズ (数)。 INT

制約:
最小値 = 1

StatelessServiceProperties

名前 説明 値
serviceKind サービスの種類 (ステートレスまたはステートフル)。 'Stateless' (必須)
instanceCount インスタンス数。 int (必須)
minInstanceCount MinInstanceCount は、アップグレードや非アクティブ化ノードなどの操作中に EnsureAvailability safety チェックを満たす必要があるインスタンスの最小数です。 実際に使用される数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstanceCount 計算中に -1 は、サービスの配置制約に従ってインスタンスを配置できるノードの数に最初に変換されます。 INT
minInstancePercentage MinInstancePercentage は、アップグレードや非アクティブ化ノードなどの操作中に EnsureAvailability safety チェックを満たすために必要な InstanceCount の最小割合です。 実際に使用される数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstancePercentage の計算中に、-1 は最初に、サービスの配置制約に従ってインスタンスを配置できるノードの数に変換されます。 INT

Terraform (AzAPI プロバイダー) リソース定義

managedclusters/applications/services リソースの種類は、次を対象とする操作でデプロイできます。

  • リソース グループ

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.ServiceFabric/managedclusters/applications/services リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedclusters/applications/services@2021-01-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  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
    }
  })
}

ServiceResourceProperties オブジェクト

serviceKind プロパティを設定して、オブジェクトの種類を指定します。

Stateful の場合は、次の値を使用します。

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

ステートレスの場合は、次の値を使用します。

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

パーティション オブジェクト

partitionScheme プロパティを設定して、オブジェクトの種類を指定します。

[名前付き] には、次の値を使用します。

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

Singleton の場合は、次の値を使用します。

  partitionScheme = "Singleton"

UniformInt64Range の場合は、次の値を使用します。

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

ScalingMechanism オブジェクト

kind プロパティを設定して、オブジェクトの種類を指定します。

AddRemoveIncrementalNamedPartition の場合は、次の値を使用します。

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

ScalePartitionInstanceCount の場合は、次の値を使用します。

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

ScalingTrigger オブジェクト

kind プロパティを設定して、オブジェクトの種類を指定します。

AveragePartitionLoadTrigger の場合は、次の値を使用します。

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

AverageServiceLoadTrigger の場合は、次の値を使用します。

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

ServicePlacementPolicy オブジェクト

type プロパティを設定して、オブジェクトの種類を指定します。

InvalidDomain の場合は、次の値を使用します。

  type = "InvalidDomain"
  domainName = "string"

NonPartiallyPlaceService の場合は、次の値を使用します。

  type = "NonPartiallyPlaceService"

PreferredPrimaryDomain の場合は、次を使用します。

  type = "PreferredPrimaryDomain"
  domainName = "string"

RequiredDomain の場合は、次の値を使用します。

  type = "RequiredDomain"
  domainName = "string"

RequiredDomainDistribution の場合は、次の値を使用します。

  type = "RequiredDomainDistribution"
  domainName = "string"

プロパティ値

managedclusters/applications/services

名前 説明 値
type リソースの種類 "Microsoft.ServiceFabric/managedclusters/applications/services@2021-01-01-preview"
name リソース名 string (必須)
location リソースの場所は、親リソースによって異なります。 string
parent_id このリソースの親であるリソースの ID。 種類のリソースの ID: アプリケーション
tags Azure リソース タグ。 タグ名と値のディクショナリ。
properties サービス リソースのプロパティ。 ServiceResourceProperties

ServiceResourceProperties

名前 説明 値
correlationScheme サービスと他のサービスの相関関係を説明するリスト。 ServiceCorrelation[]
defaultMoveCost サービスの移動コストを指定します。 "High"
"Low"
"Medium"
"Zero"
partitionDescription サービスのパーティション分割方法について説明します。 パーティション (必須)
placementConstraints 文字列としての配置の制約。 配置の制約はノード プロパティ上のブール式で、サービスの要件に基づいて特定のノードにサービスを制限することができます。 たとえば、NodeType が青色のノードにサービスを配置するには、"NodeColor == blue)" を指定します。 string
scalingPolicies このサービスのスケーリング ポリシー。 ScalingPolicy[]
serviceLoadMetrics サービス読み込みメトリックは、ServiceLoadMetric オブジェクトの配列として指定されます。 ServiceLoadMetric[]
servicePackageActivationMode サービス パッケージのアクティブ化モード "ExclusiveProcess"
"SharedProcess"
servicePlacementPolicies サービスと他のサービスの相関関係を説明するリスト。 ServicePlacementPolicy[]
serviceTypeName サービスの種類の名前 string (必須)
serviceKind オブジェクトの種類を設定する ステートフル
ステートレス (必須)

ServiceCorrelation

名前 説明 値
scheme ServiceCorrelationScheme。このサービスと ServiceName を介して指定されたサービスの間の関係を記述します。 "AlignedAffinity"
"NonAlignedAffinity" (必須)
serviceName 関連付け関係が確立されているサービスの Arm リソース ID。 string (必須)

Partition

名前 説明 値
partitionScheme オブジェクトの種類を設定する Named
Singleton
UniformInt64Range (必須)

NamedPartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 "Named" (必須)
names パーティションの名前の配列。 string[] (必須)

SingletonPartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 "Singleton" (必須)

UniformInt64RangePartitionScheme

名前 説明 値
partitionScheme サービスのパーティション分割方法を指定します。 "UniformInt64Range" (必須)
count パーティションの数。 int (必須)
highKey パーティション キー範囲の上限
パーティション 'Count' 間で分割する必要があります		 int (必須)
lowKey パーティション キー範囲の下限
パーティション 'Count' 間で分割する必要があります		 int (必須)

ScalingPolicy

名前 説明 値
scalingMechanism このスケーリング ポリシーに関連付けられているメカニズムを指定します ScalingMechanism (必須)
scalingTrigger このスケーリング ポリシーに関連付けられているトリガーを指定します。 ScalingTrigger (必須)

ScalingMechanism

名前 説明 値
kind オブジェクトの種類を設定する AddRemoveIncrementalNamedPartition
ScalePartitionInstanceCount (必須)

AddRemoveIncrementalNamedPartitionScalingMechanism

名前 説明 値
kind このスケーリング ポリシーに関連付けられているメカニズムを指定します。 "AddRemoveIncrementalNamedPartition" (必須)
maxPartitionCount サービスの名前付きパーティションの最大数。 int (必須)
minPartitionCount サービスの名前付きパーティションの最小数。 int (必須)
scaleIncrement スケーリング操作中に追加または削除するインスタンスの数。 int (必須)

PartitionInstanceCountScaleMechanism

名前 説明 値
kind このスケーリング ポリシーに関連付けられているメカニズムを指定します。 "ScalePartitionInstanceCount" (必須)
maxInstanceCount パーティションのインスタンスの最大数。 int (必須)
minInstanceCount パーティションのインスタンスの最小数。 int (必須)
scaleIncrement スケーリング操作中に追加または削除するインスタンスの数。 int (必須)

ScalingTrigger

名前 説明 値
kind オブジェクトの種類を設定する AveragePartitionLoadTrigger
AverageServiceLoadTrigger (必須)

AveragePartitionLoadScalingTrigger

名前 説明 値
kind このスケーリング ポリシーに関連付けられているトリガーを指定します。 "AveragePartitionLoadTrigger" (必須)
lowerLoadThreshold スケールイン操作を実行する必要がある負荷の下限。 int (必須)
metricName 使用状況を追跡する必要があるメトリックの名前。 string (必須)
scaleInterval スケーリングするかどうかを決定する期間 (秒単位)。 このプロパティは、ISO 8601 形式の "hh:mm:ss" である必要があります。 string (必須)
upperLoadThreshold スケールアウト操作を実行する必要がある負荷の上限。 int (必須)

AverageServiceLoadScalingTrigger

名前 説明 値
kind このスケーリング ポリシーに関連付けられているトリガーを指定します。 "AverageServiceLoadTrigger" (必須)
lowerLoadThreshold スケールイン操作を実行する必要がある負荷の下限。 int (必須)
metricName 使用状況を追跡する必要があるメトリックの名前。 string (必須)
scaleInterval スケーリングするかどうかを決定する期間 (秒単位)。 このプロパティは、ISO 8601 形式の "hh:mm:ss" である必要があります。 string (必須)
upperLoadThreshold スケールアウト操作を実行する必要がある負荷の上限。 int (必須)
useOnlyPrimaryLoad フラグは、プライマリ レプリカの負荷のみをスケーリングのために考慮する必要があるかどうかを決定します。 true に設定すると、トリガーはステートフル サービスのプライマリ レプリカの負荷のみを考慮します。 false に設定すると、トリガーはすべてのレプリカの読み込みを考慮します。 ステートレス サービスの場合、このパラメーターを true に設定することはできません。 bool (必須)

ServiceLoadMetric

名前 説明 値
defaultLoad ステートレス サービスにのみ使用されます。 このメトリックに対してこのサービスによって作成される既定の負荷量 (数値)。 INT
name メトリックの名前。 実行時にサービスが読み込みをレポートすることを選択した場合、読み込みメトリック名は[名前] で指定された名前と正確に一致する必要があります。 メトリック名は大文字と小文字が区別されることに注意してください。 string (必須)
primaryDefaultLoad ステートフル サービスにのみ使用されます。 サービスがプライマリ レプリカである場合、このサービスがメトリックのために作成する既定の負荷量で、数値で表されます。 INT
secondaryDefaultLoad ステートフル サービスにのみ使用されます。 サービスがセカンダリ レプリカである場合、このサービスがメトリックのために作成する既定の負荷量で、数値で表されます。 INT
weight サービスの負荷メトリックの相対的な重みで、このサービス用に構成されたその他のメトリックと比較し、数値で表します。 "High"
"Low"
"Medium"
"Zero"

ServicePlacementPolicy

名前 説明 値
type オブジェクトの種類を設定する InvalidDomain
NonPartiallyPlaceService
PreferredPrimaryDomain
RequiredDomain
RequiredDomainDistribution (必須)

ServicePlacementInvalidDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 "InvalidDomain" (必須)
domainName 配置に使用しないドメインの名前。 string (必須)

ServicePlacementNonPartiallyPlaceServicePolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 "NonPartiallyPlaceService" (必須)

ServicePlacementPreferPrimaryDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 "PreferredPrimaryDomain" (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

ServicePlacementRequiredDomainPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 "RequiredDomain" (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

ServicePlacementRequireDomainDistributionPolicy

名前 説明 値
type Service Fabric サービスの配置ポリシーの種類。 使用できる値を次に示します。 "RequiredDomainDistribution" (必須)
domainName このポリシーに従って配置に使用するドメインの名前。 string (必須)

StatefulServiceProperties

名前 説明 値
serviceKind サービスの種類 (ステートレスまたはステートフル)。 "Stateful" (必須)
hasPersistedState これがローカル ディスクに状態を格納する永続的なサービスであるかどうかを示すフラグ。 このプロパティの値が true の場合、false でない場合は true になります。 [bool]
minReplicaSetSize レプリカ セットの最小サイズ (数)。 INT

制約:
最小値 = 1
quorumLossWaitDuration ISO 8601 形式の "hh:mm:ss" で表されるクォーラム損失の状態でパーティションが許可される最大期間。 string
replicaRestartWaitDuration レプリカがダウンしてから新しいレプリカが作成されるまでの期間は、ISO 8601 形式 "hh:mm:ss" で表されます。 string
servicePlacementTimeLimit ビルドがスタックしていることを報告する前にレプリカが InBuild に留まる期間は、ISO 8601 形式の "hh:mm:ss" で表されます。 string
standByReplicaKeepDuration 削除される前に StandBy レプリカを保持する必要がある期間に関する定義は、ISO 8601 形式の "hh:mm:ss" で表されます。 string
targetReplicaSetSize ターゲット レプリカ セットのサイズ (数)。 INT

制約:
最小値 = 1

StatelessServiceProperties

名前 説明 値
serviceKind サービスの種類 (ステートレスまたはステートフル)。 "ステートレス" (必須)
instanceCount インスタンス数。 int (必須)
minInstanceCount MinInstanceCount は、アップグレードや非アクティブ化ノードなどの操作中に EnsureAvailability safety チェックを満たす必要があるインスタンスの最小数です。 使用される実際の数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstanceCount 計算中に -1 は、サービスの配置制約に従ってインスタンスを配置できるノードの数に最初に変換されます。 INT
minInstancePercentage MinInstancePercentage は、アップグレードや非アクティブ化ノードなどの操作中に、EnsureAvailability safety チェックを満たす必要がある InstanceCount の最小割合です。 使用される実際の数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstancePercentage の計算中に、-1 は最初に、サービスの配置制約に従ってインスタンスを配置できるノードの数に変換されます。 int