Onedata API Reference

REST API references for Onezone, Oneprovider, and Onepanel.

Onezone REST API Oneprovider REST API Onepanel REST API

Rerun ended transfer

POST /transfers/{tid}/rerun

Reruns ended transfer by creating a new, identical transfer.

This operation requires:

  • space_schedule_replication when rerunning replication
  • space_schedule_eviction when rerunning eviction
  • space_schedule_replication and space_schedule_eviction when rerunning migration

Additionally, rerunning transfers using views requires space_query_views privilege.

Example cURL requests

Rerun finished transfer

curl -X POST -H "X-Auth-Token: $TOKEN" \
"https://$HOST/api/v3/oneprovider/transfers/$TRANSFER_ID/rerun"

Path parameters

Parameter Type & Description
tid required
string

Transfer Id.

Request Examples

Shell
oneprovider-rest-cli rerunTransfer tid=$TRANSFER_ID

Responses

application/json
201

The rerun request has been accepted and the result is the transfer Id, which can be used for monitoring the new transfer status. Also URI of the new transfer in form https://$HOST/api/v3/oneprovider/transfers/{tid} is returned in the response Location header.

PropertyType & Description
transferId
string

New transfer Id.

400

Invalid request.

PropertyType & Description
error
string

Identifier representing internal error code.

error_description
string

Detailed error message.

Example

application/json
{
  "error": "invalid_token",
  "error_description": "Provided token could not be validated."
}
403

Forbidden request.

PropertyType & Description
error
string

Identifier representing internal error code.

error_description
string

Detailed error message.

Example

application/json
{
  "error": "invalid_token",
  "error_description": "Provided token could not be validated."
}
404

Transfer with provided Id was not found.

PropertyType & Description
error
string

Identifier representing internal error code.

error_description
string

Detailed error message.

Example

application/json
{
  "error": "invalid_token",
  "error_description": "Provided token could not be validated."
}
500

Internal server error.

PropertyType & Description
error
string

Identifier representing internal error code.

error_description
string

Detailed error message.

Example

application/json
{
  "error": "invalid_token",
  "error_description": "Provided token could not be validated."
}