Back to Redis

Index

content/operate/rs/references/rest-api/requests/migrations/_index.md

latest1.7 KB
Original Source
MethodPathDescription
GET/v1/migrations/<uid>Get database migration status

Get migration status {#get-migrations}

sh
GET /v1/migrations/<uid>

Gets the migration status of a database in the cluster when using Replica Of.

Required permissions

Permission nameRoles
[view_bdb_info]({{< relref "/operate/rs/references/rest-api/permissions#view_bdb_info" >}})admin
cluster_member
cluster_viewer
db_member
db_viewer
user_manager

Request {#get-request}

Example HTTP request

sh
GET /v1/migrations/1

Headers

KeyValueDescription
Hostcnm.cluster.fqdnDomain name
Acceptapplication/jsonAccepted media type

URL parameters

FieldTypeDescription
uidintegerThe database's unique ID

Response {#get-response}

Returns a JSON array with all data required by the migration orchestrator.

Example response body

json
{
  "migration": {
    "status": "string",
    "lag": 0,
    "rdb_size": 0,
    "rdb_transferred": 0,
    "run_id": "string",
    "flush_counter": 0,
    "source_shards": [
      {
        "replication_id": "string",
        "replication_offset": 0
      }
    ],
    "error": {
      "error_code": "string",
      "message": "string",
      "timestamp": "2019-08-24T14:15:22Z"
    }
  }
}

Status codes {#get-status-codes}

CodeDescription
200 OKNo error
404 Not FoundDatabase does not exist