Description: Returns the status of scheduled cron-based replication jobs defined in Artifactory. Supported by local, local-cached, and remote repositories. The status is returned on two levels, per replication job and per repository containing the replication jobs, as explained below.
Notes: Requires Artifactory Pro
Security: Requires a user with 'read' permission (can be anonymous)
Since: 2.4.2
Usage: GET artifactory/api/replication/{repoKey}
Produces: application/json (application/vnd.org.jfrog.artifactory.replication.ReplicationStatus+json)
GET artifactory/api/replication/remote-libs
{
"status": {status},
"lastCompleted": {time},
"targets":
[
{ "url" : targetUrl, "repoKey": {repoKy}, "status" : {status}, "lastCompleted" : {time} },
...
{ "url" : targetUrl, "repoKey": {repoKy}, "status" : {status}, "lastCompleted" : {time}}
],
"repositories":
{
{repoKy} : { "status" : {status}, "lastCompleted" : {time} },
...
{repoKy} : { "status" : {status}, "lastCompleted" : {time} }
}
}
where:
{status}= never_run|incomplete(running or interrupted)|error|warn|ok|inconsistent
{time}= time in ISO8601 format (yyyy-MM-dd'T'HH:mm:ss.SSSZ), or null if never completedSample Usage:
GET /api/replication/remote-libs
{
"status" : "ok",
"lastCompleted" : 2015-12-27T15:08:49.050+02:00",
"targets":
[
{ "url": "http://remote_host/remote-libs1", "repoKey": "remote-libs1", "status" : {status}, "lastCompleted" : "2015-12-27T15:07:49.050+02:00" },
...
{ "url" : "http://remote_host/remote-libs2", "repoKey": "remote-libs2", "status" : {status}, "lastCompleted" : "2015-12-27T15:07:49.050+02:00" }
],
"repositories":
{
"remote-libs1" : { "status" : "ok", "lastCompleted" : "2015-12-27T15:07:49.050+02:00" },
...
"remote-libs2" : { "status" : "ok", "lastCompleted" : "2015-12-27T15:07:49.050+02:00" }
}
}Return Values for status
The status parameter will have one of the following return values:
Value | Description |
|---|---|
The following status return values can be returned for a single replication job: | |
| The replication never ran. |
| The replication ran but never finished. |
| The replication has not no start-time but does have an end-time. |
The following status return values can be returned for a single replication job and also for the repository cointaining the replication jobs: | |
| Some replications completed with errors. |
| Replications completed with warnings. |
| Replications completed with errors. |
| All replications completed successfully. |