NFS-хранилища - сетевые папки для бэкапов: подключаются к серверу как диск по NFSv4, доступ - по IP-адресам, которые вы указываете в хранилище, ежедневные снимки защищают копии от удаления и шифровальщика. Основы - ключ, формат ответа, ошибки - в статье «Начало работы».

Запросы

Метод Путь Права Что делает
GET /nfs-capacity read Цена за ГБ, границы объёма, сколько можно взять сейчас
GET /nfs-shares read Мои хранилища: объём, занято, адреса, снимки, адрес для подключения
POST /user-service-nfs write + деньги Заказать хранилище: {name, size_gb}
PUT /user-service-nfs write + деньги Изменить объём: {id, size_gb}
POST /nfs-confirm-code write Код на почту для удаления, возврата к снимку, сокращения снимков: {id, action}
DELETE /user-service-nfs?id=&code= write Удалить хранилище; данные хранятся 7 дней
POST /nfs-share-restore write + деньги Восстановить удалённое хранилище: {id}
GET /nfs-address-check?ip= read Адрес из облака Fatmetal или через интернет
PUT /nfs-share-addresses write Адреса доступа: {id, addresses:[{ip, comment}]}
PUT /nfs-share-policy write Хранение снимков: {id, daily, weekly, monthly, code?}
POST /nfs-share-snapshot write Снимок сейчас: {id}
POST /nfs-share-rollback write Вернуть хранилище к снимку: {id, snapshot, code}
POST /nfs-share-undo-rollback write Вернуть состояние до отката: {id, previous}

Заказ, изменение объёма и восстановление требуют у ключа права «Может тратить деньги».

Порядок

  1. GET /nfs-capacity - цена и доступный объём (от 1 до 20 ТБ, шаг 512 ГБ).
  2. POST /user-service-nfs {"name":"backups","size_gb":2048} - хранилище; в ответе id.
  3. PUT /nfs-share-addresses - адреса серверов, которые пишут копии, и адрес, с которого забираете их к себе. До 5 адресов, подсеть не шире /30.
  4. GET /nfs-shares - host и path для подключения: sudo mount -t nfs4 <host>:<path> /mnt/backups.

Снимки

Ежедневные (до 14), еженедельные (до 4), ежемесячные (до 6), делаются ночью. Снимки занимают место в объёме хранилища и доступны только на чтение - в папке .zfs/snapshot хранилища. Если хранение сокращается, лишние снимки удаляются через 7 дней; запрос с сокращением требует code из /nfs-confirm-code (action: "policy").

Удаление и возврат - обратимы 7 дней

  • DELETE /user-service-nfs - доступ закрывается сразу, оплата прекращается, данные и снимки хранятся 7 дней; POST /nfs-share-restore возвращает хранилище. Удалить хранилище можно через 30 дней после создания - с момента delete_from из GET /nfs-shares; раньше удаление и код на него (/nfs-confirm-code, action: "delete") отвечают 400.
  • POST /nfs-share-rollback - хранилище становится таким, как в снимке; прежнее состояние хранится 7 дней (previous в GET /nfs-shares), POST /nfs-share-undo-rollback возвращает его. Клиенту после возврата хранилище нужно переподключить.

Ограничения

  • NFS не шифрует трафик: с адресов вне облака Fatmetal данные идут через интернет - шифруйте бэкапы (restic, borg, Veeam с шифрованием).
  • Отдача на адреса вне облака больше двух объёмов хранилища за сутки ограничивается.
  • Нужно больше объёма, адресов или снимков - напишите в поддержку.