Backup service

A backup service will be created if the etcd cluster has backup enabled. The backup service saves backup for the etcd cluster based on the requirement of the backup spec.

It also exposes an HTTP API for requesting a new backup and retrieving existing backups.


GET /v1/backupnow

The backup service requests a backup from the etcd cluster immediately when it receives the GET request.

GET /v1/backup

The backup service returns the most recent backup in the body of the HTTP response when it receives the GET request.

Request Parameters

  • etcdVersion (optional): backup service checks the compatibility between the latest backup and the etcd server with passed in etcdVersion. For example, if we want to get a backup for etcd server 3.1.0, we should set etcdVersion to 3.1.0. Backup service will check the if its latest backup can be used to restore a 3.1.0 etcd cluster.

Response Headers

  • X-etcd-Version: the etcd cluster version tht the backup was made from
  • X-Revision: the etcd store revision when the backup was made

GET /v1/status

The backup service returns the service status in JSON format. The JSON payload is defined in pkg backapi.ServiceStatus.