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

ターゲットが 5 ノードの新しいステートフル サービス "testService2" を作成します。

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

移動の既定のコストを指定します。 コストが高いほど、クラスターリソースマネージャーがクラスターのバランスを取ろうとするときにレプリカを移動する可能性が低くなります。

指定可能な値: 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 レプリカをメイン保持する期間の定義を指定します。これは ISO 8601 形式の "hh:mm:ss" で表されます。

--low-key

パーティション 'Count' 間で分割するパーティション キー範囲の下限を指定します。これは UniformInt64 パーティション 構成でのみ使用されます。

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

アップグレードや非アクティブ化ノードなどの操作中に、EnsureAvailability safety チェックを満たすために必要な InstanceCount の最小割合を指定します。 使用される実際の数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstancePercentage の計算中に、-1 は最初に、サービスの配置の制約に従ってインスタンスを配置できるノードの数に変換されます。 使用できる値は 0 ~ 100 です。

--min-instance-count

アップグレードや非アクティブ化ノードなどの操作中に EnsureAvailability safety チェックを満たす必要があるインスタンスの最小数を指定します。 使用される実際の数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstanceCount 計算中に -1 は、サービスの配置制約に従ってインスタンスを配置できるノードの数に最初に変換されることに注意してください。

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

ステートフル サービスの最小レプリカ セット サイズを指定します。

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

ビルドがスタックしていることを報告する前に、レプリカが 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

レプリカがダウンしてから新しいレプリカが作成されるまでの期間を、ISO 8601 形式の "hh:mm:ss" で指定します。

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

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

ステートフル サービスのターゲット レプリカ セットサイズを指定します。

グローバル パラメーター

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

移動の既定のコストを指定します。 コストが高いほど、クラスターリソースマネージャーがクラスターのバランスを取ろうとするときにレプリカを移動する可能性が低くなります。

指定可能な値: High, Low, Medium, Zero

--instance-count

ステートレス サービスのインスタンス数を指定します。 -1 が使用されている場合は、すべてのノードで実行されることを意味します。

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

削除する前に StandBy レプリカをメイン保持する期間の定義を指定します。これは ISO 8601 形式の "hh:mm:ss" で表されます。

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

アップグレードや非アクティブ化ノードなどの操作中に、EnsureAvailability safety チェックを満たすために必要な InstanceCount の最小割合を指定します。 使用される実際の数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstancePercentage の計算中に、-1 は最初に、サービスの配置の制約に従ってインスタンスを配置できるノードの数に変換されます。 使用できる値は 0 ~ 100 です。

--min-instance-count

アップグレードや非アクティブ化ノードなどの操作中に EnsureAvailability safety チェックを満たす必要があるインスタンスの最小数を指定します。 使用される実際の数値は max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) です。 InstanceCount が -1 に設定されている場合、MinInstanceCount 計算中に -1 は、サービスの配置制約に従ってインスタンスを配置できるノードの数に最初に変換されることに注意してください。

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

ステートフル サービスの最小レプリカ セット サイズを指定します。

--placement-constraints

配置の制約を文字列として指定します。 配置の制約はノード プロパティ上のブール式で、サービスの要件に基づいて特定のノードにサービスを制限することができます。 たとえば、NodeType が青色のノードにサービスを配置するには、"NodeColor == blue)" を指定します。

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

ビルドがスタックしていることを報告する前に、レプリカが 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

レプリカがダウンしてから新しいレプリカが作成されるまでの期間を、ISO 8601 形式の "hh:mm:ss" で指定します。

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

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

ステートフル サービスのターゲット レプリカ セットサイズを指定します。

グローバル パラメーター

--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 を使います。