Unable to create a replica for a dimension feature layer – "Error creating replica"

Error Message

When attempting to take a dimension feature layer offline by creating a replica through the ArcGIS REST API, the operation may fail with an "Error creating replica" message. Other layers within the same feature service may successfully create replicas, making the issue appear isolated to the dimension layer.

Users may observe the following:

• Replica creation fails for a dimension feature layer
• Other layers within the same service can successfully create replicas
• An "Error creating replica" message is returned

Cause

This behavior may occur when the replicaOptions parameter is not set in the Create Replica request for dimension feature layers.

Solution or Workaround

When creating a replica for a dimension feature layer through the REST API, include the following parameter in the request:

replicaOptions = {"syncDataOptions": 2}

This option allows for the inclusion of layers that are not of either the feature layer or table types in the replica.