VK Cloud logo
Обновлена 15 апреля 2024 г. в 08:50

Примеры использования API

Далее приведены некоторые примеры использования API Karboii VK Cloud.

В запросах будут использоваться:

  • эндпоинт:

    https://mcs.mail.ru/infra/karboii/v1
  • токен:

    gBkZhRqVNHSuSAJBI6duyXXXX
  • виртуальная машина:

    +-----------------------------+-----------------------------------------------------------+| Field                       | Value                                                     |+-----------------------------+-----------------------------------------------------------+| id                          | 8f1ba150-XXXX-4ae4-9693-d18844b30d19                      || name                        | Example_CentOS_STD2-2-4                             || project_id                  | b5b7ffd4ef0547e5b222f44555dfXXXX                          || status                      | ACTIVE                                                    |+-----------------------------+-----------------------------------------------------------+

Получить список созданных планов резервного копирования

Пример запроса:

curl -X GET \-H "Accept: application/json" \-H "X-Auth-Token: gBkZhRqVNHSuSAJBI6duyXXXX" \https://mcs.mail.ru/infra/karboii/v1/${OS_PROJECT_ID}/plans

Создать новый план резервного копирования для ВМ

1. Получить prodiver_id

Пример запроса:

curl -X GET \    -H "Accept: application/json" \    -H "X-Auth-Token: gBkZhRqVNHSuSAJBI6duyXXXX" \    https://mcs.mail.ru/infra/karboii/v1/${OS_PROJECT_ID}/providers

2. Создать план резервного копирования

Будет использоваться prodiver_id = 37997f75-0637-XXXX-bf7e-49ff2ff11fa5, поскольку создается план для виртуальной машины (а не инстанса БД).

Пример запроса:

curl -X POST \    -H "Accept: application/json" \    -H "Content-type: application/json" \    -H "X-Auth-Token: gBkZhRqVNHSuSAJBI6duyXXXX" \    -d '{      "plan": {        "name": "example-plan",        "resources": [          {            "id": "8f1ba150-XXXX-4ae4-9693-d18844b30d19",            "type": "OS::Nova::Server",            "name": "Example_CentOS_STD2-2-4"          }        ],        "provider_id": "37997f75-0637-XXXX-bf7e-49ff2ff11fa5",        "full_day": null,        "retention_type": "max_backups"      }    }' \        https://mcs.mail.ru/infra/karboii/v1/${OS_PROJECT_ID}/plans

3. Создать триггер

Пример запроса:

curl -s -X POST \    -H "Accept: application/json" \    -H "Content-type: application/json" \    -H "X-Auth-Token: gBkZhRqVNHSuSAJBI6duyXXXX" \    -d '{      "trigger_info": {        "name": "example-plan",        "plan_id": "17f09168-62c3-419b-XXXX-8889aac8fb0f",        "properties": {          "pattern": "3 3 * * 2",          "max_backups": 20,          "next_time": 0        }      }    }' \    https://mcs.mail.ru/infra/karboii/v1/${OS_PROJECT_ID}/triggers