5.24. nova boot

Positional arguments

<name>

        Name for the new server.

Optional arguments

--flavor <flavor>

        Name or ID of flavor (see 'nova flavor-list').

--image <image>

        Name or ID of image (see 'glance image-list').

--image-with <key=value>

        Image metadata property (see 'glance image-
      show').

--boot-volume <volume_id>

        Volume ID to boot from.

--snapshot <snapshot_id>

        Snapshot ID to boot from (will create a
      volume).

--min-count <number>

        Boot at least <number> servers (limited by
      quota).

--max-count <number>

        Boot up to <number> servers (limited by
      quota).

--meta <key=value>

        Record arbitrary key/value metadata to
      /meta_data.json on the metadata server. Can be
      specified multiple times.

--file <dst-path=src-path>

        Store arbitrary files from <src-path> locally
      to <dst-path> on the new server. Limited by
      the injected_files quota value.

--key-name <key-name>

        Key name of keypair that should be created
      earlier with the command keypair-add.

--user-data <user-data>

        user data file to pass to be exposed by the
      metadata server.

--availability-zone <availability-zone>

      The availability zone for server placement.

--security-groups <security-groups>

      Comma separated list of security group names.

--block-device-mapping <dev-name=mapping>

      Block device mapping in the format <dev-
      name>=<id>:<type>:<size(GB)>:<delete-on-
      terminate>.

--block-device

        key1=value1[,key2=value2...]
      Block device mapping with the keys: id=UUID
      (image_id, snapshot_id or volume_id only if
      using source image, snapshot or volume)
      source=source type (image, snapshot, volume or
      blank), dest=destination type of the block
      device (volume or local), bus=device's bus
      (e.g. uml, lxc, virtio, ...; if omitted,
      hypervisor driver chooses a suitable default,
      honoured only if device type is supplied)
      type=device type (e.g. disk, cdrom, ...;
      defaults to 'disk') device=name of the device
      (e.g. vda, xda, ...; tag=device metadata tag
      (optional) if omitted, hypervisor driver
      chooses suitable device depending on selected
      bus; note the libvirt driver always uses
      default device names), size=size of the block
      device in MB(for swap) and in GB(for other
      formats) (if omitted, hypervisor driver
      calculates size), format=device will be
      formatted (e.g. swap, ntfs, ...; optional),
      bootindex=integer used for ordering the boot
      disks (for image backed instances it is equal
      to 0, for others need to be specified) and
      shutdown=shutdown behaviour (either preserve
      or remove, for local destination set to
      remove). (Supported by API versions '2.32' -
      '2.latest')

--swap <swap_size>

        Create and attach a local swap block device of
      <swap_size> MB.

--ephemeral

        size=<size>[,format=<format>]
      Create and attach a local ephemeral block
      device of <size> GB and format it to <format>.

--hint <key=value>

        Send arbitrary key/value pairs to the
      scheduler for custom use.

--nic <auto,none,net-id=net-uuid,net-name=network-name,port-id=port-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,tag=tag>

      Create a NIC on the server. Specify option
      multiple times to create multiple nics unless
      using the special 'auto' or 'none' values.
      auto: automatically allocate network resources
      if none are available. This cannot be
      specified with any other nic value and cannot
      be specified multiple times. none: do not
      attach a NIC at all. This cannot be specified
      with any other nic value and cannot be
      specified multiple times. net-id: attach NIC
      to network with a specific UUID. net-name:
      attach NIC to network with this name (either
      port-id or net-id or net-name must be
      provided), v4-fixed-ip: IPv4 fixed address for
      NIC (optional), v6-fixed-ip: IPv6 fixed
      address for NIC (optional), port-id: attach
      NIC to port with this UUID tag: interface
      metadata tag (optional) (either port-id or
      net-id must be provided). (Supported by API
      versions '2.37' - '2.latest')

--config-drive <value>

        Enable config drive.

--poll

        Report the new server boot progress until it
      completes.

--admin-pass <value>

        Admin password for the instance.

--access-ip-v4 <value>

        Alternative access IPv4 of the instance.

--access-ip-v6 <value>

        Alternative access IPv6 of the instance.

--description <description>

        Description for the server. (Supported by API
      versions '2.19' - '2.latest')