# VBoxManage cloud image

VBoxManage-cloudimage

1

VBoxManage-cloudimage

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

&product-name;

          VBoxManage cloud
            --provider=имя
            --profile=имя
            image
            create
            --display-name=имя
            --bucket-name=имя
            --object-name=имя
            --instance-id=уникальный id

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

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

          VBoxManage cloud
          --provider=имя
          --profile=имя
          image
          import
          --id=уникальный id
          --bucket-name=имя
          --object-name=имя

          VBoxManage cloud
          --provider=имя
          --profile=имя
          image
          export
          --id=уникальный id
          --display-name=имя
          --bucket-name=имя
          --object-name=имя

## Описание

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

Подкоманды `cloudimage` реализуют стандартные операции над облачными образами, как то create/delete/show/import/export. Следующие общие параметры должны находиться между "cloud" и последующими подкомандами:

--provider=`имя`

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

--profile=`имя`

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

### cloud image create

Создает новый образ в облаке. Существует два стандартных способа создать образ в облаке: 1. Создать образ из объекта в облачном хранилище; 2. Создать образ из существующего облачного экземпляра. Для первого способа требуются параметры: bucket-name - имя облачной корзины где находится объект; object-name - имя объекта в корзине; display-name - имя для нового образа в облаке. Для второго способа требуются параметры: instance-id - Id экземпляра в облаке; display-name - имя для нового образа в облаке.

`--display-name`

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

`--bucket-name`

- Имя облачной корзины где размещен объект.

`--object-name`

- Имя объекта в корзине.

`--instance-id`

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

### cloud image info

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

`--id`

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

### cloud image delete

Удаляет образ с указанным id из облака.

`--id`

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

### cloud image import

Импортирует образ с указанным id из облака на локальный хост. Результатом является объект в локальной папке "temp" локального хоста. Возможный подход может состоят из двух основных этапов: 1. Создать объект из образа в облачном хранилище; 2. Загрузить объект на локальный хост. Поэтому, следующие параметры могут потребоваться: bucket-name - имя облачной корзины где будет создан объект; object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использовано показанное имя образа. Если первый этап не нужен, требуется только параметр "id".

`--id`

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

`--bucket-name`

- Имя облачной корзины, где будет создан объект.

`--object-name`

- Имя созданного объекта в корзине. У загруженного объекта будет такое же имя.

### cloud image export

Экспортирует существующий образ VBox с указанным uuid из локального хоста в облако. Результатом является новый образ в облаке. Возможный подход может состоят из двух основных этапов: 1. Загрузить образ VBox в облачное хранилище; 2. Создать образ из загруженного объекта. Поэтому, следующие параметры могут потребоваться: bucket-name - имя облачной корзины куда будет загружен объект; object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использован id образа; display-name - имя для нового образа в облаке. Если первый этап не нужен, требуются только параметры "id" и "display-name".

`--id`

- Уникальный идентификатор образа в VirtualBox.

`--display-name`

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

`--bucket-name`

- Имя облачной корзины куда будет загружен образ (объект).

`--object-name`

- Имя объекта в корзине.