Snapshot Policy: Defined Hours Backups (Keep 1 Month)
=====================================================

Introduction
------------

This snapshot policy is configured for manual snapshot execution at defined times on Saturdays and Sundays only. Unlike recurring schedules, this setup uses the ``manual_incremental_backup`` field to specify the exact times when snapshots are taken.

**Manual Backup Times:**
Snapshots are created at 02:00, 06:00, 20:00, and 22:15 UTC.

**Active Days:**
Only on weekends (Saturday and Sunday).

**Retention Period:**
Snapshots are kept for 1 month before being automatically deleted.

Scheduler Configuration
------------------------

The ``start_time`` and ``end_time`` fields restrict when snapshots are allowed to occur. Manual snapshots will only run within this defined window.

Snapshot Retention (1-Year Estimate)
------------------------------------

- Snapshots occur 4 times per day, only on weekends.
- 2 weekend days per week = 8 snapshots per week.
- Over 1 month (approximately 4 weeks):
  → **4 snapshots × 2 days × 4 weeks = 32 snapshots retained at any time.**
- After one year, the number of retained snapshots remains **32**, as the retention policy only keeps the last month's snapshots.

API Summary
-----------

**Endpoint:**

::

  POST /api/2.0/backupschedulers/

**JSON Payload**::

  {
    "type": "snapshot",
    "name": "Defined hours backups",
    "enable_backup_policy_notifications": true,
    "enable_retention_policy_notifications": false,
    "is_enabled": true,
    "is_default": false,
    "manual_incremental_backup": "02:00,06:00,20:00,22:15",
    "retention_policy": {
      "name": "Keep 1 Day",
      "rules": [
        {
          "period": "months",
          "quantity": 1
        }
      ]
    },
    "incremental_backup": {
      "day_of_month": "",
      "month": "",
      "hour": "",
      "minute": "",
      "day_of_week": ["sat", "sun"],
      "start_time": { "hour": 7, "minute": 0 },
      "end_time": { "hour": 6, "minute": 45 },
      "repeat": { "hour": "", "minute": "" }
    },
    "user_timezone": "Etc/UTC"
  }