VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-cloudimage.xml@ 103131

Last change on this file since 103131 was 98103, checked in by vboxsync, 23 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 12.7 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage cloud image
4-->
5<!--
6 Copyright (C) 2018-2023 Oracle and/or its affiliates.
7
8 This file is part of VirtualBox base platform packages, as
9 available from https://www.virtualbox.org.
10
11 This program is free software; you can redistribute it and/or
12 modify it under the terms of the GNU General Public License
13 as published by the Free Software Foundation, in version 3 of the
14 License.
15
16 This program is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, see <https://www.gnu.org/licenses>.
23
24 SPDX-License-Identifier: GPL-3.0-only
25-->
26<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
27 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
28<!ENTITY % all.entities SYSTEM "all-entities.ent">
29%all.entities;
30]>
31<refentry id="vboxmanage-cloudimage" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage cloud image</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-cloudimage</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-cloudimage</refname>
44 <refpurpose>Управление облачными образами</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-cloudimage-create" sepchar=" "> <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
50 <command>VBoxManage cloud</command>
51 <arg choice="req">--provider=<replaceable>имя</replaceable></arg>
52 <arg choice="req">--profile=<replaceable>имя</replaceable></arg>
53 <arg choice="plain">image</arg>
54 <arg choice="plain">create</arg>
55 <arg choice="req">--display-name=<replaceable>имя</replaceable></arg>
56 <arg>--bucket-name=<replaceable>имя</replaceable></arg>
57 <arg>--object-name=<replaceable>имя</replaceable></arg>
58 <arg>--instance-id=<replaceable>уникальный id</replaceable></arg>
59 </cmdsynopsis>
60 <cmdsynopsis id="synopsis-vboxmanage-cloudimage-info" sepchar=" ">
61 <command>VBoxManage cloud</command>
62 <arg choice="req">--provider=<replaceable>имя</replaceable></arg>
63 <arg choice="req">--profile=<replaceable>имя</replaceable></arg>
64 <arg choice="plain">image</arg>
65 <arg choice="plain">info</arg>
66 <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg>
67 </cmdsynopsis>
68 <cmdsynopsis id="synopsis-vboxmanage-cloudimage-delete" sepchar=" ">
69 <command>VBoxManage cloud</command>
70 <arg choice="req">--provider=<replaceable>имя</replaceable></arg>
71 <arg choice="req">--profile=<replaceable>имя</replaceable></arg>
72 <arg choice="plain">image</arg>
73 <arg choice="plain">delete</arg>
74 <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg>
75 </cmdsynopsis>
76 <cmdsynopsis id="synopsis-vboxmanage-cloudimage-import" sepchar=" ">
77 <command>VBoxManage cloud</command>
78 <arg choice="req">--provider=<replaceable>имя</replaceable></arg>
79 <arg choice="req">--profile=<replaceable>имя</replaceable></arg>
80 <arg choice="plain">image</arg>
81 <arg choice="plain">import</arg>
82 <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg>
83 <arg>--bucket-name=<replaceable>имя</replaceable></arg>
84 <arg>--object-name=<replaceable>имя</replaceable></arg>
85 </cmdsynopsis>
86 <cmdsynopsis id="synopsis-vboxmanage-cloudimage-export" sepchar=" ">
87 <command>VBoxManage cloud</command>
88 <arg choice="req">--provider=<replaceable>имя</replaceable></arg>
89 <arg choice="req">--profile=<replaceable>имя</replaceable></arg>
90 <arg choice="plain">image</arg>
91 <arg choice="plain">export</arg>
92 <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg>
93 <arg choice="req">--display-name=<replaceable>имя</replaceable></arg>
94 <arg>--bucket-name=<replaceable>имя</replaceable></arg>
95 <arg>--object-name=<replaceable>имя</replaceable></arg>
96 </cmdsynopsis>
97 </refsynopsisdiv>
98
99 <refsect1>
100 <title>Описание</title>
101
102 <refsect2 id="vboxmanage-cloudimage-common-options">
103 <title>Общие параметры</title>
104 <remark role="help-scope" condition="GLOBAL"/>
105 <para>Подкоманды <command>cloudimage</command> реализуют стандартные операции над облачными образами, как то
106 create/delete/show/import/export. Следующие общие параметры должны находиться между "cloud" и последующими подкомандами:</para>
107 <variablelist>
108 <varlistentry>
109 <term>--provider=<replaceable>имя</replaceable></term>
110 <listitem><para>Короткое имя облачного провайдера.</para></listitem>
111 </varlistentry>
112 <varlistentry>
113 <term>--profile=<replaceable>имя</replaceable></term>
114 <listitem><para>Имя облачного профиля. </para></listitem>
115 </varlistentry>
116 </variablelist>
117 </refsect2>
118
119 <refsect2 id="vboxmanage-cloudimage-create">
120 <title>cloud image create</title>
121 <remark role="help-copy-synopsis"/>
122 <para>
123 Создает новый образ в облаке.
124 Существует два стандартных способа создать образ в облаке:
125 1. Создать образ из объекта в облачном хранилище;
126 2. Создать образ из существующего облачного экземпляра.
127 Для первого способа требуются параметры:
128 bucket-name - имя облачной корзины где находится объект;
129 object-name - имя объекта в корзине;
130 display-name - имя для нового образа в облаке.
131 Для второго способа требуются параметры:
132 instance-id - Id экземпляра в облаке;
133 display-name - имя для нового образа в облаке.
134 </para>
135 <variablelist>
136 <varlistentry>
137 <term><option>--display-name</option></term><listitem><para>Имя для нового образа в облаке.</para></listitem>
138 </varlistentry>
139 <varlistentry>
140 <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзины где размещен объект.</para></listitem>
141 </varlistentry>
142 <varlistentry>
143 <term><option>--object-name</option></term><listitem><para>Имя объекта в корзине.</para></listitem>
144 </varlistentry>
145 <varlistentry>
146 <term><option>--instance-id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem>
147 </varlistentry>
148 </variablelist>
149 </refsect2>
150
151 <refsect2 id="vboxmanage-cloudimage-info">
152 <title>cloud image info</title>
153 <remark role="help-copy-synopsis"/>
154 <para>
155 Показывает информацию об облачном образе с указанным id.
156 </para>
157 <variablelist>
158 <varlistentry>
159 <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem>
160 </varlistentry>
161 </variablelist>
162 </refsect2>
163
164 <refsect2 id="vboxmanage-cloudimage-delete">
165 <title>cloud image delete</title>
166 <remark role="help-copy-synopsis"/>
167 <para>
168 Удаляет образ с указанным id из облака.
169 </para>
170 <variablelist>
171 <varlistentry>
172 <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem>
173 </varlistentry>
174 </variablelist>
175 </refsect2>
176
177 <refsect2 id="vboxmanage-cloudimage-import">
178 <title>cloud image import</title>
179 <remark role="help-copy-synopsis"/>
180 <para>
181 Импортирует образ с указанным id из облака на локальный хост.
182 Результатом является объект в локальной папке "temp" локального хоста.
183 Возможный подход может состоят из двух основных этапов:
184 1. Создать объект из образа в облачном хранилище;
185 2. Загрузить объект на локальный хост.
186 Поэтому, следующие параметры могут потребоваться:
187 bucket-name - имя облачной корзины где будет создан объект;
188 object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использовано показанное имя образа.
189 Если первый этап не нужен, требуется только параметр "id".
190 </para>
191 <variablelist>
192 <varlistentry>
193 <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem>
194 </varlistentry>
195 <varlistentry>
196 <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзины, где будет создан объект.</para></listitem>
197 </varlistentry>
198 <varlistentry>
199 <term><option>--object-name</option></term>
200 <listitem>
201 <para>
202 Имя созданного объекта в корзине. У загруженного объекта будет такое же имя.
203 </para>
204 </listitem>
205 </varlistentry>
206 </variablelist>
207 </refsect2>
208
209 <refsect2 id="vboxmanage-cloudimage-export">
210 <title>cloud image export</title>
211 <remark role="help-copy-synopsis"/>
212 <para>
213 Экспортирует существующий образ VBox с указанным uuid из локального хоста в облако.
214 Результатом является новый образ в облаке.
215 Возможный подход может состоят из двух основных этапов:
216 1. Загрузить образ VBox в облачное хранилище;
217 2. Создать образ из загруженного объекта.
218 Поэтому, следующие параметры могут потребоваться:
219 bucket-name - имя облачной корзины куда будет загружен объект;
220 object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использован id образа;
221 display-name - имя для нового образа в облаке.
222 Если первый этап не нужен, требуются только параметры "id" и "display-name".
223 </para>
224 <variablelist>
225 <varlistentry>
226 <term><option>--id</option></term><listitem><para>Уникальный идентификатор образа в VirtualBox.</para></listitem>
227 </varlistentry>
228 <varlistentry>
229 <term><option>--display-name</option></term><listitem><para>Имя для нового образа в облаке.</para></listitem>
230 </varlistentry>
231 <varlistentry>
232 <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзины куда будет загружен образ (объект).</para></listitem>
233 </varlistentry>
234 <varlistentry>
235 <term><option>--object-name</option></term><listitem><para>Имя объекта в корзине.</para></listitem>
236 </varlistentry>
237 </variablelist>
238 </refsect2>
239 </refsect1>
240
241</refentry>
242
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette