啟動叢集組態升級

發行項
08/05/2023

開始升級 Service Fabric 獨立叢集的設定。

驗證所提供的設定升級參數，如果參數有效，便開始升級叢集設定。

要求

方法	要求 URI
POST	`/$/StartClusterConfigurationUpgrade?api-version=6.0&timeout={timeout}`

參數

名稱	類型	必要	Location
`api-version`	字串	是	查詢
`timeout`	整數 (int64)	No	查詢
`ClusterConfigurationUpgradeDescription`	ClusterConfigurationUpgradeDescription	是	body

`api-version`

類型：字串
必要：是
預設：6.0

API 的版本。這是必要參數，其值必須是 '6.0'。

Service Fabric REST API 版本是以 API 引進或變更的執行時間版本為基礎。 Service Fabric 執行時間支援多個版本的 API。這是 API 的最新支援版本。如果傳遞較低的 API 版本，傳回的回應可能會與本規格中所述的回應不同。

此外，執行時間也接受高於最新支援版本的任何版本，最高為目前版本的執行時間。因此，如果最新的 API 版本是 6.0，但如果執行時間是 6.1，為了更容易撰寫用戶端，執行時間將會接受該 API 6.1 版。不過，API 的行為會根據記載的 6.0 版本。

`timeout`

類型：整數 (int64)
必要：否
預設：60
InclusiveMaximum： 4294967295
InclusiveMinimum： 1

用來執行作業的伺服器逾時 (以秒為單位)。此逾時指定了用戶端願意等候要求作業完成的持續時間。這個參數的預設值是 60 秒。

`ClusterConfigurationUpgradeDescription`

類型： ClusterConfigurationUpgradeDescription
必要：是

獨立叢集組態升級的參數。

回應

HTTP 狀態碼	描述	回應結構描述
202 (已接受)	成功的回應表示叢集組態升級已啟動。使用 GetClusterConfigurationUpgradeStatus 作業來取得升級的狀態。
所有其他狀態碼	詳細的錯誤回應。	FabricError

範例

開始升級 Service Fabric 獨立叢集的設定

此範例示範如何開始升級 Service Fabric 獨立叢集的組態。

要求

POST http://localhost:19080/$/StartClusterConfigurationUpgrade?api-version=6.0

主體

{
  "ClusterConfig": "<PutYourClusterConfigHere>",
  "ApplicationHealthPolicies": {
    "ApplicationHealthPolicyMap": [
      {
        "Key": "fabric:/samples/CalculatorApp",
        "Value": {
          "ConsiderWarningAsError": true,
          "MaxPercentUnhealthyDeployedApplications": "10",
          "DefaultServiceTypeHealthPolicy": {
            "MaxPercentUnhealthyPartitionsPerService": "0",
            "MaxPercentUnhealthyReplicasPerPartition": "0",
            "MaxPercentUnhealthyServices": "0"
          },
          "ServiceTypeHealthPolicyMap": [
            {
              "Key": "Svc1Type",
              "Value": {
                "MaxPercentUnhealthyPartitionsPerService": "0",
                "MaxPercentUnhealthyReplicasPerPartition": "0",
                "MaxPercentUnhealthyServices": "10"
              }
            }
          ]
        }
      }
    ]
  }
}

202 回應

主體

回應主體是空的。

共用方式為