# Beépített mentések képességei

> A mainwp-backups kategória 32 képessége: mentési állapot olvasása, előnézet és megerősítés, feladatok, pillanatképek, visszaállítás, tárolók és beállítások.

A MainWP vezérlőpult 32 képességet regisztrál a `mainwp-backups` kategóriában. Ezekkel a beépített mentéseket kezelheted az Abilities API-n vagy a MainWP MCP-szerveren át: olvashatod az állapotot, előnézetet kérhetsz, mentési feladatokat és tárolókat kezelhetsz, és figyelheted a mentéseket és a visszaállításokat.

## Követelmények

- Beépített mentéseket támogató MainWP vezérlőpult és a hozzá tartozó MainWP Child-kiadás
- WordPress 6.9 vagy újabb a vezérlőpulton
- Hitelesített felhasználó, akinek van hozzáférése a kért webhelyekhez és a szükséges mentési jogosultsága
- Bekapcsolt beépített mentések a mentés készítéséhez és a visszaállításokhoz

A közvetlen API-kéréseket WordPress-alkalmazásjelszóval hitelesítsd. A MainWP REST API-kulcsai az Abilities API-kéréseket nem hitelesítik.

## A sémák felderítése

Kérdezd le a kategóriát, hogy megkapd az egyes képességek bemeneti és kimeneti sémáját és a futtatási útmutatót:

```bash
curl -u 'FELHASZNALONEV:ALKALMAZASJELSZO' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities?category=mainwp-backups&per_page=50'
```

Egy képesség leírását a hívás előtt is lekérheted:

```bash
curl -u 'FELHASZNALONEV:ALKALMAZASJELSZO' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/run-site-backup-v1'
```

A telepített vezérlőpult-verzió által visszaadott sémát használd. A bemenetek elutasítják az ismeretlen mezőket. A tárolók hitelesítő adatait, a titkosítási kulcsokat és a helyreállítási jelmondatokat ezek a képességek nem adják ki.

## Mentési állapot olvasása

Az olvasó képességek GET metódust használnak. A bemenetet, ha kell, JSON-szövegként add át az `input` lekérdezési paraméterben:

```bash
curl -G -u 'FELHASZNALONEV:ALKALMAZASJELSZO' \
  --data-urlencode 'input={"site_id_or_domain":1}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/get-site-backup-progress-v1/run'
```

| Képesség | Mire jó |
|---|---|
| `mainwp/get-backup-status-v1` | A mentések állapota az elérhető webhelyeken |
| `mainwp/list-backup-history-v1` | A mentési előzmények listája |
| `mainwp/list-backup-destinations-v1` | A beállított tárolók listája |
| `mainwp/get-backup-destination-v1` | Egy tároló adatai a hitelesítő adatok nélkül |
| `mainwp/get-backup-settings-v1` | A mentési beállítások a helyreállítási titkok nélkül |
| `mainwp/list-backup-tasks-v1` | Az ütemezett mentési feladatok listája |
| `mainwp/get-backup-task-v1` | Egy feladat beállításai |
| `mainwp/get-backup-task-run-v1` | Egy ütemezett feladat futásának lekérdezése |
| `mainwp/get-site-backup-progress-v1` | Egy webhely mentésének előrehaladása |
| `mainwp/list-backup-snapshots-v1` | A tárolt pillanatképek listája |
| `mainwp/get-backup-snapshot-v1` | Egy pillanatkép részletei |
| `mainwp/list-restore-jobs-v1` | A visszaállítási feladatok listája |
| `mainwp/get-restore-job-v1` | Egy visszaállítási feladat lekérdezése és eredményének vizsgálata |

## Változtatások előnézete és megerősítése

Az író képességek POST metódust használnak, és vagy `dry_run: true` (előnézet), vagy `confirm: true` (végrehajtás) értéket kérnek. Előbb kérj előnézetet, nézd át az érintett webhelyeket, tárolókat, a megőrzés miatti törléseket és a figyelmeztetéseket, majd erősítsd meg ugyanazt a kijelölést. A két jelzőt ne állítsd egyszerre `true`-ra.

Például egy teljes, igény szerinti mentés előnézete:

```bash
curl -X POST -u 'FELHASZNALONEV:ALKALMAZASJELSZO' \
  -H 'Content-Type: application/json' \
  -d '{"input":{"site_id_or_domain":1,"dry_run":true}}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/run-site-backup-v1/run'
```

Az előnézet átnézése után a végrehajtás:

```bash
curl -X POST -u 'FELHASZNALONEV:ALKALMAZASJELSZO' \
  -H 'Content-Type: application/json' \
  -d '{"input":{"site_id_or_domain":1,"confirm":true}}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/run-site-backup-v1/run'
```

A mentés a háttérben folytatódik. Kövesd a visszaadott lekérdezési útmutatót, amíg a mentés be nem fejeződik vagy hibával le nem áll: az indító válasz nem jelenti azt, hogy a mentés elkészült. Ha az eredmény `not_started`, semmilyen munka nem került sorba, próbáld újra később. Az `already_running` eredmény egy már futó mentéshez kapcsol, ilyenkor azt kérdezd le, és ne indíts újat.

| Képesség | Mire jó |
|---|---|
| `mainwp/run-site-backup-v1` | Teljes, igény szerinti mentés indítása egy webhelyen |
| `mainwp/run-backup-task-v1` | Ütemezett feladat azonnali futtatása |
| `mainwp/cancel-site-backup-v1` | Egy webhely mentésének megszakítása |
| `mainwp/reset-backup-task-run-v1` | Egy nyitott feladatfutás visszaállítása |
| `mainwp/cleanup-site-backups-v1` | Egy webhely mentéseinek takarítása |
| `mainwp/delete-backup-snapshot-v1` | Pillanatkép törlése |
| `mainwp/create-backup-task-v1` | Ütemezett mentési feladat létrehozása |
| `mainwp/update-backup-task-v1` | Feladat módosítása |
| `mainwp/delete-backup-task-v1` | Feladat törlése, a pillanatképek megtartásának lehetőségével |
| `mainwp/pause-backup-task-v1` | Feladat szüneteltetése, a nyitott futás léptetésének leállításával |
| `mainwp/resume-backup-task-v1` | Szüneteltetett feladat folytatása |
| `mainwp/restore-site-snapshot-v1` | Pillanatkép visszaállítása a webhelyére |
| `mainwp/cancel-restore-v1` | A visszaállítás megszakítása, vagy a visszaállítás utáni kapcsolatellenőrzések leállítása |
| `mainwp/rollback-restore-v1` | Egy korábbi visszaállítás biztonsági mentésének visszaállítása |
| `mainwp/test-backup-destination-v1` | Egy tárolt tároló kapcsolatának kipróbálása |
| `mainwp/set-default-backup-destination-v1` | Az alapértelmezett tároló kiválasztása |
| `mainwp/update-backup-destination-v1` | Egy tároló nevének, alapértelmezett jelzőjének vagy legkisebb megőrzésének módosítása |
| `mainwp/delete-backup-destination-v1` | Tároló eltávolítása a vezérlőpultról; a tárolt objektumok megmaradnak |
| `mainwp/update-backup-settings-v1` | A támogatott mentési beállítások módosítása |

A tárolók hitelesítő adatait, a szervereket, a vödröket és az útvonalakat a **Biztonsági mentések → Storage** oldalon szerkesztheted (`/wp-admin/admin.php?page=ManageBackupsStorage`). A titkosítást és a helyreállítási jelmondatot a jobb felső felhasználói menü → **MainWP beállításai** → **Biztonsági mentés beállításai** oldalon adhatod meg. A beépített mentések felületi használatát a Beépített biztonsági mentések fejezet írja le.

## Jogosultságok és a visszaállítás eredménye

A képességek érvényesítik a felhasználó webhelyhozzáférését, a feladatok tulajdonlását és a műveleti jogosultságokat. A tárolók módosításához olyan fiók kell, amely minden webhelyhez hozzáfér. A globális mentési beállítások olvasásához és módosításához a megfelelő vezérlőpult-beállítási jogosultságok kellenek.

Visszaállítás megerősítése előtt nézd át az előnézet figyelmeztetéseit a felülírásról és a WooCommerce-ről. A visszaállítás elindítása után kérdezd le a `mainwp/get-restore-job-v1` képességet, és vizsgáld az `outcome`, a `partial_state_risk` és a `verification` mezőt. A megszakítási kérés még függőben lehet: addig kérdezz le, amíg a webhely meg nem erősíti a leállást. A visszagörgetéshez (`rollback-restore-v1`) szükség van az eredeti visszaállításból származó, elérhető biztonsági mentésre.