Revision 6395cebb doc/rapi.rst
b/doc/rapi.rst | ||
---|---|---|
369 | 369 |
|
370 | 370 |
Returns: a job ID that can be used later for polling. |
371 | 371 |
|
372 |
Body parameters: |
|
373 |
|
|
374 |
``__version__`` (int, required) |
|
375 |
Must be ``1`` (older Ganeti versions used a different format for |
|
376 |
instance creation requests, version ``0``, but that format is not |
|
377 |
documented). |
|
378 |
``name`` (string, required) |
|
379 |
Instance name |
|
380 |
``disk_template`` (string, required) |
|
381 |
Disk template for instance |
|
382 |
``disks`` (list, required) |
|
383 |
List of disk definitions. Example: ``[{"size": 100}, {"size": 5}]``. |
|
384 |
Each disk definition must contain a ``size`` value and can contain an |
|
385 |
optional ``mode`` value denoting the disk access mode (``ro`` or |
|
386 |
``rw``). |
|
387 |
``nics`` (list, required) |
|
388 |
List of NIC (network interface) definitions. Example: ``[{}, {}, |
|
389 |
{"ip": "1.2.3.4"}]``. Each NIC definition can contain the optional |
|
390 |
values ``ip``, ``mode``, ``link`` and ``bridge``. |
|
391 |
``os`` (string) |
|
392 |
Instance operating system. |
|
393 |
``force_variant`` (bool) |
|
394 |
Whether to force an unknown variant. |
|
395 |
``pnode`` (string) |
|
396 |
Primary node. |
|
397 |
``snode`` (string) |
|
398 |
Secondary node. |
|
399 |
``src_node`` (string) |
|
400 |
Source node for import. |
|
401 |
``src_path`` (string) |
|
402 |
Source directory for import. |
|
403 |
``start`` (bool) |
|
404 |
Whether to start instance after creation. |
|
405 |
``ip_check`` (bool) |
|
406 |
Whether to ensure instance's IP address is inactive. |
|
407 |
``name_check`` (bool) |
|
408 |
Whether to ensure instance's name is resolvable. |
|
409 |
``file_storage_dir`` (string) |
|
410 |
File storage directory. |
|
411 |
``file_driver`` (string) |
|
412 |
File storage driver. |
|
413 |
``iallocator`` (string) |
|
414 |
Instance allocator name. |
|
415 |
``hypervisor`` (string) |
|
416 |
Hypervisor name. |
|
417 |
``hvparams`` (dict) |
|
418 |
Hypervisor parameters, hypervisor-dependent. |
|
419 |
``beparams`` |
|
420 |
Backend parameters. |
|
421 |
|
|
422 |
|
|
372 | 423 |
``/2/instances/[instance_name]`` |
373 | 424 |
++++++++++++++++++++++++++++++++ |
374 | 425 |
|
Also available in: Unified diff