共用方式為

移除複本

  • 發行項

移除在節點上執行的服務複本。

此 API 會從 Service Fabric 叢集移除複本，來模擬 Service Fabric 複本失敗。 移除作業會關閉複本，將複本轉換成 None 角色，然後從叢集移除複本所有的狀態資訊。 此 API 會測試複本狀態移除路徑，並透過用戶端 API 模擬報告錯誤永久路徑。 警告：使用此 API 時，不會執行任何安全性檢查。 不正確使用此 API 可能會導致具狀態服務遺失資料。 此外，forceRemove 旗標會影響裝載於相同處理序中的所有其他複本。

要求

方法 要求 URI
POST /Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/Delete?api-version=6.0&ForceRemove={ForceRemove}&timeout={timeout}

參數

名稱 類型 必要 Location
nodeName 字串 是 路徑
partitionId 字串 (uuid) 是 路徑
replicaId 字串 是 路徑
api-version 字串 是 查詢
ForceRemove boolean No 查詢
timeout 整數 (int64) No 查詢

nodeName

類型：字串
必要：是

節點的名稱。

partitionId

類型：字串 (uuid)
必要：是

分割區的識別。

replicaId

類型：字串
必要：是

複本的識別碼。

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 版本。

ForceRemove

類型：布林值
必要：否

強制移除 Service Fabric 應用程式或服務，而不經過正常關機順序。 當因服務程式碼中有導致無法正常關閉複本的問題，而使得應用程式或服務的刪除逾時時，可使用此參數來強制刪除應用程式或服務。

timeout

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

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

回應

HTTP 狀態碼 描述 回應結構描述
200 (確定) 成功的作業會傳回 200 狀態碼。 成功的作業表示重新開機命令是由節點上的複本所接收，而且正在重新開機。
所有其他狀態碼 詳細的錯誤回應。
 FabricError