az sf managed-service

參考

管理在 Azure Service Fabric 受控叢集上執行的服務。僅支援 ARM 部署的服務。

命令

名稱	Description	類型	狀態
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。

接受的值: 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 安全檢查。使用的實際數位是 max（MinInstanceCount， ceil（ MinInstancePercentage/100.0 * InstanceCount）。請注意，如果 InstanceCount 設定為 -1，在 MinInstancePercentage 計算期間，-1 會先轉換成允許根據服務放置條件約束放置實例的節點數目。允許的值為 0 到 100。

--min-instance-count

指定在升級或停用節點等作業期間必須符合 EnsureAvailability 安全檢查的實例數目下限。使用的實際數位是 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

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 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

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 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

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 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

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 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

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 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

範例

必要參數

選擇性參數

其他資源