Resync Replication Rule
Replicate a bucket's existing objects for a rule that opted into existing-object replication.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/buckets/:bucketName/replication/rules/:ruleId/resync | POST | No |
Triggers a walk of every current object under the rule's prefix, enqueueing a replication task for each - the explicit "do it now" trigger for a rule with replicateExisting enabled. See Existing-object replication.
Only works for a rule that is both enabled and has replicateExisting: true.
The walk runs in the background, not inline in this request - a bucket with hundreds of thousands of objects can take a while to enumerate. This endpoint validates the rule/target and returns
202 Accepted immediately; it does not report how many objects were found. Track progress via List Replication Tasks instead.Path Parameters
bucketName
string required
The name of the bucket.
ruleId
string required
The rule's id (from Get Replication Rules).
Response
202 Accepted, empty body.
Errors
| Status | Reason |
|---|---|
400 | Missing bucket name, invalid rule id, the rule is disabled, replicateExisting is not set, or the rule's target is missing/disabled |
404 | Bucket not found (or not owned by you), or rule not found |