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")