Python ArcGIS Item.delete用法及代码示例

本文简要介绍 python 语言中 arcgis.gis.Item.delete 的用法。

用法:

delete(force=False, dry_run=False)

返回：

指示成功 (True) 或失败 (False) 的布尔值。使用dry_run 时，将返回包含项目详细信息的字典。

delete 方法删除项目。如果无法删除该项目，则会引发 RuntimeException。要知道您是否可以安全地删除项目，请使用可选参数‘dry_run’ 以便在不实际删除项目的情况下测试操作。

Parameter	Description
force	可选的布尔值。在ArcGIS Enterprise 10.6.1 及更高版本中可用。强制删除仅适用于在联合到 ArcGIS Enterprise 的服务器在正确取消联合之前意外删除时孤立的项目。在其他项目上调用时，它没有效果。
dry_run	可选的布尔值。在ArcGIS Enterprise 10.6.1 及更高版本中可用。如果为True，则检查该项目是否可以安全删除，并返回包含详细信息的字典。如果依赖项阻止删除，则提供此类 Item 对象的列表。

示例 1：

# USAGE EXAMPLE: Successful deletion of an item

item1 = gis.content.get('itemId12345')
item1.delete()

>> True

示例 2：

# USAGE EXAMPLE: Failed deletion of an item

item1 = gis.content.get('itemId12345')
item1.delete()

>> RuntimeError: Unable to delete item. This service item has a related Service item
>> (Error Code: 400)

示例 3：

# USAGE EXAMPLE: Dry run to check deletion of an item

item1 = gis.content.get('itemId12345abcde')
item1.delete(dry_run=True)

>> {'can_delete': False,
>> 'details': {'code': 400,
>> 'message': 'Unable to delete item. This service item has a related Service item',
>> 'offending_items': [<Item title:"Chicago_accidents_WFS" type:WFS owner:sharing1>]}}

注意：

在 dry run 期间，如果您收到违规项目列表，请先尝试删除它们，然后再删除当前项目。您可以依次对这些项目调用 dry_run 以确保可以安全地删除它们。