移除節點狀態
通知 Service Fabric 某個節點上的永續性狀態已永久移除或遺失。
這意謂著無法復原該節點的永續性狀態。 通常如果已將硬碟抹除乾淨或硬碟損毀,就會發生這種情況。 節點必須停止運作,此作業才能成功。 此作業可讓 Service Fabric 知道該節點上的複本已不存在,而 Service Fabric 應該停止等候這些複本恢復運作。 如果節點上的狀態尚未移除,而節點能夠在其狀態保持不變的情況下恢復運作,則請勿執行此 Cmdlet。 從 Service Fabric 6.5 開始,為了將此 API 用於種子節點,請將種子節點變更為一般 (非種子) 節點,然後再叫用此 API 來移除節點狀態。 如果叢集在 Azure 上執行,則在種子節點關閉之後,Service Fabric 會嘗試自動將它變更為非種子節點。 若要這樣做,請確定主要節點類型中的非種子節點數目不小於向下種子節點的數目。 如有必要,請將更多節點新增至主要節點類型,以達成此目的。 針對獨立叢集,如果向下種子節點不會以完整狀態備份,請從叢集中移除節點 (參閱https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes)
要求
方法 | 要求 URI |
---|---|
POST | /Nodes/{nodeName}/$/RemoveNodeState?api-version=6.0&timeout={timeout} |
參數
名稱 | 類型 | 必要 | Location |
---|---|---|---|
nodeName |
字串 | 是 | 路徑 |
api-version |
字串 | 是 | 查詢 |
timeout |
整數 (int64) | No | 查詢 |
nodeName
類型:字串
必要:是
節點的名稱。
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 秒。
回應
HTTP 狀態碼 | 描述 | 回應結構描述 |
---|---|---|
200 (確定) | 成功的作業會傳回 200 狀態碼。 |
|
所有其他狀態碼 | 詳細的錯誤回應。 |
FabricError |