# VBoxManage cloud instance

VBoxManage-cloudinstance

1

VBoxManage-cloudinstance

Управление облачными экземплярами

&product-name;

          VBoxManage cloud
          --provider=имя
          --profile=имя
          instance
          create
          --domain-name=имя

              --image-id=id
              --boot-volume-id=id

          --display-name=имя
          --shape=тип
          --subnet=id
          --boot-disk-size=размер в ГБ
          --publicip=true/false
          --privateip=IP адрес
          --public-ssh-key=ключевая строка
          --launch-mode=NATIVE/EMULATED/PARAVIRTUALIZED

          VBoxManage cloud
          --provider=имя
          --profile=имя
          instance
          info
          --id=уникальный id

          VBoxManage cloud
          --provider=имя
          --profile=имя
          instance
          terminate
          --id=уникальный id

          VBoxManage cloud
          --provider=имя
          --profile=имя
          instance
          start
          --id=уникальный id

          VBoxManage cloud
          --provider=имя
          --profile=имя
          instance
          pause
          --id=уникальный id

## Описание

### Общие параметры

Подкоманды `cloudinstance` реализуют стандартные операции над облачными экземплярами, как то start/pause/show/terminate. Следующие общие параметры должны быть помещены между "cloud" и последующими подкомандами:

--provider=`имя`

- Короткое имя облачного провайдера.

--profile=`имя`

- Имя облачного профиля.

### cloud instance create

Создает новый экземпляр в облаке. Существует два стандартных способа создать экземпляр в облаке: 1. Создать экземпляр из существующего пользовательского образа. 2. Создать экземпляр из существующего загрузочного тома. Этот загрузочный том не должен быть подключен к какому-либо экземпляру. Для первого способа требуются параметры: image-id, boot-disk-size. Для второго способа требуются параметры: boot-volume-id. Остальные параметры являются общими для обоих способов: display-name, launch-mode, subnet-id, publicIP, privateIP, shape, domain.

`--domain-name`

- Облачный домен, где создается экземпляр.

`--image-id`

- Уникальный идентификатор, полностью идентифицирующий пользовательский образ в облаке.

`--boot-volume-id`

- Уникальный идентификатор, полностью идентифицирующий загрузочный том в облаке.

`--display-name`

- Имя для нового экземпляра в облаке.

`--shape`

- Форма экземпляра, определяющая количество ЦПУ и размер RAM памяти.

`--subnet`

- Уникальный идентификатор, полностью идентифицирующий существующую подсеть в облаке для использования экземпляром.

`--boot-disk-size`

- Размер загрузочного образа в ГБ. По умолчанию 50 ГБ.

`--publicip`

- У экземпляра публичный IP или нет.

`--privateip`

- Приватный IP адрес для созданного экземпляра.

`--public-ssh-key`

- Публичный ключ SSH, используемый для подключения к экземпляру через SSH. Этот параметр может быть указан несколько раз если нужно указать несколько ключей, например: "--public-ssh-key=firstSSHKey --public-ssh-key=secondSSHKey".

`--launch-mode`

- Наиболее известные значения здесь могут быть EMULATED, NATIVE, PARAVIRTUALIZED.

### cloud instance info

Показывает информацию об облачном экземпляре с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.

### cloud instance termination

Удаляет облачный экземпляр с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.

### cloud instance start

Запускает облачный экземпляр с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.

### cloud instance pause

Приостанавливает облачный экземпляр с указанным id.

`--id`

- Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.