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 以確保可以安全地刪除它們。