Product SiteDocumentation Site

⁠44.3. Пример создания контейнера с использованием API

Используемые обозначения:
  • APINODE — узел PVE, API которого используется для аутентификации;
  • TARGETNODE — узел PVE, на котором создаётся контейнер;
  • cookie — файл, содержащий cookie аутентификации;
  • csrftoken — файл, содержащий CSRF-токен.
Пример создания контейнера с использованием API:
  1. Для удобства задайте переменные окружения:
    $ export APINODE=pve01
    $ export TARGETNODE=pve03
    
  2. Получите билет аутентификации и CSRF-токен:
    $ response=$(curl --silent --show-error --fail --insecure \
      --data-urlencode 'username=root@pam' \
      --data-urlencode "password@$HOME/.pve-pass-file" \
      "https://$APINODE:8006/api2/json/access/ticket")
    
    В примере предполагается, что пароль сохранён в файле $HOME/.pve-pass-file.
  3. Сохраните cookie и CSRF-токен в отдельные файлы:
    $ printf 'PVEAuthCookie=%s' \
      "$(printf '%s' "$response" | jq -er '.data.ticket')" > cookie
    
    $ printf 'CSRFPreventionToken: %s' \
      "$(printf '%s' "$response" | jq -er '.data.CSRFPreventionToken')" > csrftoken
    
    $ chmod 600 cookie csrftoken
    
  4. Получите сведения о состоянии целевого узла:
    $ curl --silent --show-error --fail --insecure \
      --cookie "$(<cookie)" \
      "https://$APINODE:8006/api2/json/nodes/$TARGETNODE/status" | jq .
    
  5. Создайте LXC-контейнер:
    $ curl --silent --show-error --fail --insecure \
      --cookie "$(<cookie)" \
      --header "$(<csrftoken)" \
      --request POST \
      --data-urlencode 'net0=name=eth0,bridge=vmbr0' \
      --data-urlencode 'ostemplate=nfs-storage:vztmpl/alt-p11-rootfs-systemd-x86_64.tar.xz' \
      --data-urlencode storage="local" \
      --data-urlencode 'vmid=601' \
      "https://$APINODE:8006/api2/json/nodes/$TARGETNODE/lxc" | jq .
    
    Пример ответа:
    {
      "data": "UPID:pve03:00005470:00083F6D:66A76C80:vzcreate:601:root@pam:"
    }
    
    Ответ содержит идентификатор задачи (UPID), запущенной для создания контейнера.

    Примечание

    Для нового контейнера необходимо указать свободный идентификатор VMID в пределах допустимого диапазона.