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

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:

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:

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:

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:

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:

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.