hosting

PUT `/v1/sites/{siteId}/offsite`

Send this site's backups to a destination.

Аутентификация

Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение hosting.backup.manage; ключ без него отклоняется с кодом 403, а не 404.

Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

curl -X PUT https://api.zinndigital.com/v1/sites/{siteId}/offsite \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "destination_id": <string>, "retention_days": <integer<7, 30, 90, 180, 365>> }'

Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли

Подробнее

Requires the add-on for this site and an account in good standing. Switching on copies the newest restorable backup (and any archives it depends on) at once, then every later backup. Changing destination drops copies still waiting for the old one; stored copies stay. Requires hosting.backup.manage.

Параметры

Имя	Тип	Обязательно	Что это
`siteId (path)`	`Uuid`	Да	Site ID (UUIDv7).

Тело запроса

Имя	Тип	Обязательно	Что это
`destination_id`	`string`	Да	—
`retention_days`	`integer<7, 30, 90, 180, 365>`	Да	—
`enabled`	`boolean`	Нет	—

Ответ

Имя	Тип	Обязательно	Что это
`site_id`	`string`	Да	—
`entitled`	`boolean`	Да	—
`extra_code`	`string`	Да	—
`retention_choices`	`integer[]`	Да	—
`policy`	`object`	Да	—
`copies`	`OffsiteCopy[]`	Да	—

Ошибки, которые может возвращать этот эндпоинт

401 · 403 · 404 · 422

PUT /v1/sites/{siteId}/offsite