- URL:
- https://<root>/<serviceName>/FeatureServer/replicas
- Methods:
GET
- Version Introduced:
- 10.0
Description
The replicas
resource lists all replicas that have been created on the feature service. This list includes the replica name and replica ID of each replica. For secured services, all replicas are listed when logged in as the admin user. Otherwise, only replicas created by the logged-in user are listed.
New at 10.8.1
New advanced
properties in sync
are provided for sync enabled feature services published from ArcGIS Pro that reference enterprise geodatabase data. These describe new parameters that can be passed to the replicas resource. These include replica
, return
, and return
. See details below in the Request Parameters table.
For sync enabled, branch versioned data, determined by the layer resource returning is
as true
, the replicas
resource will list, and allow, access to all replicas from all users if the connected user has the Version Management privilege assigned to them either through the default administrator role or through a custom role. Users with this privilege can also unregister any replica from any users.
Request parameters
Parameter | Details |
---|---|
| Can be set when the service resource's Example
|
| Can be set if the service resource's Values: |
| Can be set if the service resource's Values: |
| The response format. The default response format is Values: |
Example usage
URL listing the replicas, as well as the version name and last
values associated with each replica, in the USA feature service:
https://machine.domain.com/webadaptor/rest/services/USA/FeatureServer/replica?returnVersion=true&returnLastSyncDate=true&f=pjson
JSON Response syntax
[
{
"replicaName": "replicaName1",
"replicaID": "replicaID1"
},
{
"replicaName": "replicaName1",
"replicaID": "replicaID2"
}
]
JSON Response examples
The following response demonstrates the information returned when return
and return
are true
:
[
{
"replicaName": "Ags_Fs_1587781611176",
"replicaID": "A849811F-6FDF-4AEC-9DD0-3E3DF7142603",
"replicaVersion": "GDB.admin_counties_v_1587781587098",
"lastSyncDate": 1587781611254
},
{
"replicaName": "Ags_Fs_1587781611208",
"replicaID": "1FBA41AA-55B0-432A-B918-96024ECF2533",
"replicaVersion": "GDB.admin_counties_v_1587781587066",
"lastSyncDate": 1587781611286
}
]
The following response demonstrates what is returned when replica
is defined (for this example, it was defined as GB
) and return
is true
.
[
{
"replicaName": "Ags_Fs_1587781611176",
"replicaID": "A849811F-6FDF-4AEC-9DD0-3E3DF7142603",
"replicaVersion": "GDB.admin_counties_v_1587781587098"
}
]