VK Cloud logo

API пайдалану мысалдары

Төменде VK Cloud платформасындағы API Karboii пайдалану бойынша кейбір мысалдар келтірілген.

Келтірілген мысалдарды орындау үшін:

  1. Екі факторлы аутентификация ссылка және API арқылы қолжетімділік белсендірілгеніне көз жеткізіңіз.
  2. X-Subject-Token қатынау токенін алыңыз.
  3. Karboii сервисі үшін эндпоинтті ссылка.

Сұрау мысалдарында мыналар қолданылады:

  • эндпоинт:

    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: <ЗНАЧЕНИЕ_ТОКЕНА>" https://mcs.mail.ru/infra/karboii/v1/${OS_PROJECT_ID}/plans

ВМ үшін жаңа резервтік көшіру жоспарын жасау

Резервтік көшіру жоспарын жасау үшін:

  1. Резервтік көшіруді қамтамасыз ететін сервистің (provider_id) идентификаторын алыңыз.
  2. Резервтік көшіру жоспарының негізгі баптаулары берілетін plan объектісін жасаңыз.
  3. Резервтік көшіру іске қосылу кестесін беретін триггерді жасаңыз.

1. Провайдер идентификаторын алу

Сұрау мысалы:

curl -X GET     -H "Accept: application/json"     -H "X-Auth-Token: <ЗНАЧЕНИЕ_ТОКЕНА>"     https://mcs.mail.ru/infra/karboii/v1/${OS_PROJECT_ID}/providers

2. Резервтік көшіру жоспарын жасау

provider_id = 37997f75-0637-XXXX-bf7e-49ff2ff11fa5 пайдаланылады, себебі жоспар БД инстансы үшін емес, виртуалды машина үшін жасалады.

Сұрау мысалы:

curl -X POST     -H "Accept: application/json"     -H "Content-type: application/json"     -H "X-Auth-Token: <ЗНАЧЕНИЕ_ТОКЕНА>"     -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: <ЗНАЧЕНИЕ_ТОКЕНА>"     -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