Python ArcGIS ContentManager.replace_service用法及代碼示例

本文簡要介紹 python 語言中 arcgis.gis.ContentManager.replace_service 的用法。

用法:

replace_service(replace_item, new_item, replaced_service_name=None, replace_metadata=False)

返回：

指示成功 (True) 或失敗 (False) 的布爾值

replace_service 操作允許您將生產矢量切片圖層替換為臨時圖層。此操作允許您對暫存切片圖層執行質量控製，然後以最短的停機時間用暫存切片替換生產切片圖層。此操作可以選擇保留生產切片圖層的備份。

注意：

此函數僅適用於基於包的托管矢量切片圖層、托管切片圖層和托管場景圖層。如果您要克隆服務，請改用clone_items 方法。

replace_service 方法的用法流程如下：

1. 將暫存服務發布到與生產服務相同的係統。兩種服務同時處於活動狀態。與一小部分用戶共享暫存服務，並對暫存服務進行 QA。

2. 製作項目的項目屬性(例如：縮略圖、項目信息、元數據)將被保留。如果您需要更新它們，請使用 Item.update() 方法。

3. 調用replace_service 操作。在托管服務器上運行的服務被替換(例如，它的緩存)。

注意：

用戶有責任確保兩種服務在函數上對使用它們的客戶端是等效的。例如，在替換托管要素服務時，請確保使用其客戶端應用程序的預期圖層和字段構建新服務。

例如，如果您想保留被替換的生產服務，以保留服務演變的檔案，您可以通過省略 “Replaced Service Name” 的值來做到這一點。如果沒有提供被替換的服務名稱，則被替換的生產服務將在執行替換服務時帶有時間戳。您可以為被替換的服務提供任何名稱，隻要它不存在於您的門戶內容中。

Parameter	Description
replace_item	必填項或項的 ID 作為字符串。要更換的服務
new_item	必填項或項的 ID 作為字符串。更換服務。
replaced_service_name	可選字符串。替換服務的名稱。
replace_metadata	可選布爾值。當設置為 True 時，當前服務的項目信息 {“thumbnail”, “tag”, “description”, “summary”} 將更新為替換服務的項目信息。積分、使用條款和由詳細信息創建的內容不會被替換。此選項默認設置為False。

例子：

# Usage Example
>>> gis.content.replace_service(replace_item="9311d21a9a2047d19c0faaebd6f2cca6",
                                new_item = "420554d21a9a2047d19c0faaebd6f2cca4")