- tocdepth
2
Включение/выключение VM с помощью API
С помощью API вы также можете управлять виртуальными машинами, например, включать и выключать их.
Запрос XML-представления VM
Request
Отправьте GET-запрос на URL VM.
Подсказка
Один из способов узнать URL VM — запросить список VM.
curl -k --header "Accept: application/*;version={VERSION}" --header "Authorization: Bearer {TOKEN}" --request GET "https://{SITE}/api/vApp/vm-{VM-ID}"
curl -k --header "Accept: application/*;version=35.0" --header "Authorization: Bearer eyJhbG..." --request GET "https://vcd01-01.cloud.ru/api/vApp/vm-27bee2..."
GET https://vcd01-01.cloud.ru/api/vApp/vm-27bee2...
Headers:
- KEY: Accept
- VALUE: application/*;version=35.0
Authorization:
- Type: Bearer Token
- Token: eyJhbG...
Response
Сервер вернет действия, которые можно совершить с VM, в том числе включение/выключение.
Они располагаются в XML-элементах Vm
— Link
в атрибуте href
.
В зависимости от того, включена или выключена в данный момент VM, в ответе на запрос будет одна из ссылок:
<Vm>
<Link
rel="power:powerOff"
href="https://{SITE}/api/vApp/vm-{VM-ID}/power/action/powerOn"/>
...
</Vm>
<Vm>
<Link
rel="power:powerOn"
href="https://{SITE}/api/vApp/vm-{VM-ID}/power/action/powerOff"/>
...
</Vm>
Включение/выключение VM
Request
Чтобы запустить включение/выключение VM, отправьте POST-запрос на нужный URL.
curl -k --header "Accept: application/*;version={VERSION}" --header "Authorization: Bearer {TOKEN}" --request POST https://{SITE}/api/vApp/vm-{VM-ID}/power/action/powerOn
curl -k --header "Accept: application/*;version=35.0" --header "Authorization: Bearer eyJhbG..." --request POST https://vcd01-01.cloud.ru/api/vApp/vm-94cb9d.../power/action/powerOn
POST https://vcd01-01.cloud.ru/api/vApp/vm-94cb9d.../power/action/powerOn
Headers
- KEY: Accept
- VALUE: application/*;version=35.0
Authorization
- Type: Bearer Token
- Token: eyJhbG...
Response
<Task
operation="Starting vm-94cb9d..."
startTime="2021-03-02T14:51:36.051+03:00">
<!-- Other params -->
</Task>
См.также
Полное описание конечных точек, методов и параметров запросов можно посмотреть по ссылке https://{SITE}/docs/
.
Была ли статья полезной?
Запустили Evolution free tier
для Dev & Test
Получить
для Dev & Test