API - Резервтік көшірмемен өзара әрекеттесу

Бұл құжатта Zomro қызметінің API көмегімен instance үшін резервтік көшірмелерді жасау, қарау және жою процесі сипатталған. Берілген сұрау мысалдары сізге API арқылы резервтік көшірмелерді басқару үшін қажетті негізгі операцияларды тез түсінуге көмектеседі.

Резервтік көшірме жасау

Резервтік көшірме жасау үшін келесі сұрауды орындаңыз:

URL:

https://api.zomro.com/

Әдіс: POST

Сұрау денесі (Form-data):

Параметр	Мән мысалы	Міндетті параметр	Мән сипаттамасы
func	instances.fleio_bckps.edit	Иә	Резервтік көшірме жасау функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
sok	ok	Иә	Операцияны растау
plid	5203773	Иә	Резервтік көшірме жасау үшін instance ID
name	MyBackup	Иә	Резервтік көшірме атауы

Қызмет үшін резервтік көшірме жасау мысалы

Мысал ретінде, қызметті қолданамыз:

URL:

https://api.zomro.com/

Әдіс: POST

Сұрау денесі (Form-data):

Параметр	Мән
func	instances.fleio_bckps.edit
auth	21fc199...c43f71
out	json
sok	ok
plid	5203773
name	MyBackup

Міне, консольдан орындауға болатын сұрау мысалы:

curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio_bckps.edit"' \
--form 'auth="d3ec30e337e01078a1d185cc"' \
--form 'out="json"' \
--form 'sok="ok"' \
--form 'plid="5203773"' \
--form 'name="MyBackup"'

Сұрауды орындағаннан кейін, резервтік көшірме жасау процесінде екенін көреміз. Резервтік көшірме Saving мәніне ие екенін көреміз:

Резервтік көшірме жасау аяқталғаннан кейін, резервтік көшірме статусы Saving-ден Active-ке өзгереді:

Қызмет статусы Active екенін көреміз.

API көмегімен резервтік көшірмелер тізімін қалай алуға болады

Сондай-ақ, API көмегімен резервтік көшірмелер тізімін алуға болады. Ол үшін келесі сұрау форматын орындаймыз:

URL:

https://api.zomro.com/

Әдіс: POST

Сұрау денесі (Form-data):

Параметр	Мән мысалы	Міндетті параметр	Мән сипаттамасы
func	instances.fleio_bckps	Иә	Барлық резервтік көшірмелерді алу функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
plid	5203773	Иә	Резервтік көшірмелерін алу жоспарланған instance ID

Мысал ретінде, 5203773 қызметі үшін резервтік көшірмелерді алуға тырысамыз. Алдыңғы қадамда 1 резервтік көшірме жасадық. Оны алуға тырысамыз.

Келесі сұрауды консольда орындап көрейік:

curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio_bckps"' \
--form 'auth="8409b4eea786e3cad35eacf7"' \
--form 'out="json"' \
--form 'elid="5203773"'

Келесі нәтижені аламыз:

{
    "doc": {
        ...
        "elem": [
            {
                "architecture": {
                    "$": "x86_64"
                },
                "backup_type": {
                    "$": "manual"
                },
                "createdate": {
                    "$": "2024-07-23"
                },
                "disk_format": {
                    "$": "qcow2"
                },
                "fleio_id": {
                    "$": "b26c0f34-48b2-4cb2-b4eb-388eac959df6"
                },
                "fleio_status": {
                    "$": "Active"
                },
                "hypervisor_type": {
                    "$": "any_hypervisor"
                },
                "id": {
                    "$": "5203980"
                },
                "image_size": {
                    "$": "3"
                },
                "item_real_status": {
                    "$": "2"
                },
                "min_disk": {
                    "$": "20"
                },
                "min_ram": {
                    "$": "0"
                },
                "name": {
                    "$": "MyBackup"
                },
                "os_distro": {
                    "$": "Ubuntu"
                },
                "os_version": {
                    "$": "22.04 x64"
                },
                "protected": {
                    "$": "off"
                },
                "region": {
                    "$": "Netherlands-2"
                },
                "visibility": {
                    "$": "private"
                }
            }
        ],
    }
}

Бізді келесі деректер қызықтырады:

doc.elem.[]

Бұл жауаптан келесі деректерді аламыз:

Өріс атауы	Сипаттама
architecture	Виртуалды машинаның архитектурасы
backup_type	Резервтік көшірме қалай жасалған: Қолмен немесе кесте бойынша
createdate	Резервтік көшірме жасау уақыты
disk_format	Резервтік көшірме файлының түрі
fleio_id	fleio жүйесіндегі бірегей UUID
fleio_status	Резервтік көшірме статусы. Active мәні резервтік көшірме жасалғанын білдіреді
hypervisor_type	Виртуалды машина үшін гипервизор түрі
id	bill manager шегіндегі резервтік көшірме ID
image_size	Резервтік көшірменің нақты өлшемі. Резервтік көшірме жасау аяқталғаннан кейін анықталады
item_real_status	billmanager шегіндегі қызмет статусы
min_disk	Бұл резервтік көшірмені қалпына келтіру үшін серверде қажет минималды диск өлшемі
min_ram	Бұл резервтік көшірмені қалпына келтіру үшін серверде қажет минималды ОЗУ өлшемі
name	Резервтік көшірме атауы
os_distro	Операциялық жүйе атауы
os_version	Операциялық жүйе нұсқасы
protected	Резервтік көшірмені жоюға рұқсат етілгенін хабарлайды. "off" мәні кезінде резервтік көшірмені жоюға болады. "on" мәні кезінде резервтік көшірмені жою мүмкін емес.
region	Резервтік көшірме орналасқан дата орталығының атауы
visibility	Резервтік көшірмеге қол жеткізу статусы. Жалғыз қол жетімді мән "Private"

Резервтік көшірмені қалай жоюға болады

Резервтік көшірмені жою үшін келесі сұрауды орындаймыз:

URL:

https://api.zomro.com/

Әдіс: POST

Сұрау денесі (Form-data):

Параметр	Мән мысалы	Міндетті параметр	Мән сипаттамасы
func	image.delete	Иә	Резервтік көшірмені жою функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
plid	5203773	Иә	Резервтік көшірмелерін алу жоспарланған instance ID
elname	5203980	Иә	Жою қажет резервтік көшірме ID
elid	5203980	Иә	Жою қажет резервтік көшірме ID
sok	ok	Иә	Операцияны орындауды растау

Келесі сұрауды консольда орындап көрейік:

curl --location 'https://api.zomro.com/' \
--form 'func="image.delete"' \
--form 'auth="72307c8cfc94e631d835438f"' \
--form 'out="json"' \
--form 'sok="ok"' \
--form 'plid="5203773"' \
--form 'elname="5203980"' \
--form 'elid="5203980"'

Сұрауды орындағаннан кейін, нәтижені "instances.fleio_bckps" функциясы арқылы немесе веб-интерфейс арқылы тексеруге болады:

Көріп отырғанымыздай, резервтік көшірме сәтті жойылды.

Сондай-ақ, API көмегімен Cloud VPS өнімдерімен өзара әрекеттесу үшін пайдалы болуы мүмкін мақалаларды оқуды ұсынамыз: