az sf managed-service

リファレンス

Azure Service Fabric マネージドクラスターで実行されているサービスを管理します。 ARM デプロイ済みサービスのみをサポートします。

コマンド

名前	説明	型	Status
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

--min-instance-count

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

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

--placement-constraints

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

コマンド

az sf managed-service create

例

必須のパラメーター

省略可能のパラメーター

az sf managed-service delete

例

必須のパラメーター

az sf managed-service list

例

必須のパラメーター

az sf managed-service show

例

必須のパラメーター

az sf managed-service update

例

必須のパラメーター

省略可能のパラメーター

フィードバック

その他のリソース