idea Unregister All Replicas in ArcGIS Online Ideas

Unregister All Replicas

GJW — Sat, 11 Jul 2020 19:13:12 GMT

ArcGIS Online will not allow you to overwrite an existing hosted feature service if replicas exist. ArcGIS Online also will not allow you to programatically compile a list of all of the existing replica IDs for a hosted feature service and then use that list to unregister them all. There needs to be a way to either programatically gather all of the replica IDs and unregister the replicas, or provide an "Unregister All" button on the feature service page so that users do not have to spend hours copying and pasting each individual replica ID into the one-at-a-time "Unregister Replica" tool.

Re: Unregister All Replicas

Anonymous User — Fri, 04 Sep 2020 04:54:02 GMT

There's a function in the ArcGIS API for Python to list all the replicas and unregister them. Just be aware that doing this will break any outstanding offline maps. After removing the replicas, when a user clicks 'Check for update', for their offline map in ArcGIS Explorer/Collector, they will get a sync failed error as the replica can no longer be found.

featureLayerName = "layername"
featureLayer = gis.content.search(query=featureLayerName + " owner:named_user", item_type='Feature Layer Collection', sort_field='relevance', sort_order='desc', max_items=1)
print(featureLayer)
featureDataset = FeatureLayerCollection.fromitem(featureLayer[0])
print(featureDataset.url)
outstandingReplicas = featureDataset.replicas.get_list()
if outstandingReplicas:
   for replica_dict in outstandingReplicas:
      featureDataset.replicas.unregister(replica_dict['replicaID'])
      print("Unregistered replica: {0}".format(replica_dict['replicaID']))
else:
   print("No replicas present")

Re: Unregister All Replicas

mejohnson22 — Sun, 25 Sep 2022 22:42:05 GMT

Hi @Anonymous User,

It looks like your solution above is what I am looking for. I have gone through the first four lines OK, but I am getting stuck and was hoping for some assistance.

I get stuck here at this point. I do have USERNAME updated in the actual script

featureLayer = gis.content.search(query= featureLayerName + "owner:USERNAME", item_type='Feature Server', sort_field='relevance', sort_order='desc', max_items=1)
print(featureLayer)

When stepping through, when I hit the print, I return

[]

Which may be the issue, because then when I continue

featureDataset = FeatureLayerCollection.fromitem(featureLayer[0])

I receive the error

Traceback (most recent call last):
File "<string>", line 1, in <module>
IndexError: list index out of range

I've been trying to troubleshoot for a good bit and though I might reach back out to the master for some potential guidance.

Thanks in advance

Mary

Re: Unregister All Replicas

Anonymous User — Mon, 26 Sep 2022 19:50:58 GMT

Hi @mejohnson22,

I haven't been able to check but suspect the problem is with the item type specified as it doesn't look to be valid - Items and item types—ArcGIS REST APIs | ArcGIS Developers

item_type='Feature Server'

I think it's not returning any results from the search, thus it's returning [] & 'list index out of range'.

As an aside - and it doesn't always work - you can enter * into the unRegisterReplica option for a feature service e.g. https://services3.arcgis.com/AkUq3zcWf7TVqyR9/ArcGIS/rest/services/SERVICE_NAME/FeatureServer/unRegisterReplica and that will try and remove all replicas.

Re: Unregister All Replicas

TylerMcGarrity — Thu, 23 Feb 2023 22:36:52 GMT

This worked for me. Thank you!

Re: Unregister All Replicas

LukeGilner1 — Wed, 27 Mar 2024 17:05:33 GMT

Hi @mejohnson22 & @TylerMcGarrity ,

Can you post the specific code for the 2nd option you mentioned to unRegisterReplica?

Re: Unregister All Replicas

TylerMcGarrity — Wed, 27 Mar 2024 17:19:57 GMT

Hello @LukeGilner1,

No specific code, you just enter an asterisk and click on Unregister Replica:

Re: Unregister All Replicas

LukeGilner1 — Wed, 27 Mar 2024 17:23:35 GMT

@TylerMcGarrity

Awesome! Thanks for the picture. Worked for me!

Re: Unregister All Replicas

mejohnson22 — Thu, 23 May 2024 22:55:51 GMT

@LukeGilner1 works great! Thank you!

Re: Unregister All Replicas

ShoNuff — Thu, 15 May 2025 14:24:48 GMT

@TylerMcGarrity Thanks for you tip on unregistering all replicas. It worked for me too.

Re: Unregister All Replicas

AndrewHankinson — Sat, 02 Aug 2025 05:04:38 GMT

@TylerMcGarrity , perfect just what I was looking for, thank you.

Re: Unregister All Replicas

LayerItOn — Thu, 18 Sep 2025 03:53:15 GMT

@TylerMcGarrity that was amazing, thank you so much!