7.4. Image Service API v2 Commands

Positional arguments

<MODEL>

        Name of model to describe.

Optional arguments

--architecture <ARCHITECTURE>

      Operating system architecture as specified in
      http://docs.openstack.org/user-guide/common/cli-
      manage-images.html

--protected [True|False]

      If true, image will not be deletable.

--name <NAME>

        Descriptive name for the image

--instance-uuid <INSTANCE_UUID>

      Metadata which can be used to record which instance
      this image is associated with. (Informational only,
      does not create an instance snapshot.)

--min-disk <MIN_DISK>

      Amount of disk space (in GB) required to boot image.

--visibility <VISIBILITY>

      Scope of image accessibility Valid values: public,
      private

--kernel-id <KERNEL_ID>

      ID of image stored in Glance that should be used as
      the kernel when booting an AMI-style image.

--tags <TAGS> [<TAGS> ...]

      List of strings related to the image

--os-version <OS_VERSION>

      Operating system version as specified by the
      distributor

--disk-format <DISK_FORMAT>

      Format of the disk Valid values: None, ami, ari, aki,
      vhd, vmdk, raw, qcow2, vdi, iso

--os-distro <OS_DISTRO>

      Common name of operating system distribution as
      specified in http://docs.openstack.org/user-
      guide/common/cli-manage-images.html

--id <ID>

        An identifier for the image

--owner <OWNER>

        Owner of the image

--ramdisk-id <RAMDISK_ID>

      ID of image stored in Glance that should be used as
      the ramdisk when booting an AMI-style image.

--min-ram <MIN_RAM>

        Amount of ram (in MB) required to boot image.

--container-format <CONTAINER_FORMAT>

      Format of the container Valid values: None, ami, ari,
      aki, bare, ovf, ova, docker

--property <key=value>

      Arbitrary property to associate with image. May be
      used multiple times.

--file <FILE>

        Local file that contains disk image to be uploaded
      during creation. Alternatively, the image data can be
      passed to the client via stdin.

--progress

        Show upload progress bar.

Positional arguments

<IMAGE_ID>

        ID of image(s) to delete.

Positional arguments

<IMAGE_ID>

        ID of image to download.

Optional arguments

--file <FILE>

        Local file to save downloaded image data to. If this is not
      specified and there is no redirection the image data will not
      be saved.

--progress

        Show download progress bar.

Optional arguments

--limit <LIMIT>

        Maximum number of images to get.

--page-size <SIZE>

        Number of images to request in each paginated request.

--visibility <VISIBILITY>

      The visibility of the images to display.

--member-status <MEMBER_STATUS>

      The status of images to display.

--owner <OWNER>

        Display images owned by <OWNER>.

--property-filter <KEY=VALUE>

      Filter images by a user-defined image property.

--checksum <CHECKSUM>

      Displays images that match the checksum.

--tag <TAG>

        Filter images by a user-defined tag.

--sort-key {name,status,container_format,disk_format,size,id,created_at,updated_at}

      Sort image list by specified fields. May be used
      multiple times.

--sort-dir {asc,desc}

      Sort image list in specified directions.

--sort <key>[:<direction>]

      Comma-separated list of sort keys and directions in
      the form of <key>[:<asc|desc>]. Valid keys: name,
      status, container_format, disk_format, size, id,
      created_at, updated_at. OPTIONAL.

Positional arguments

<IMAGE_ID>

        ID of image to describe.

Optional arguments

--human-readable

        Print image size in a human-friendly format.

--max-column-width <integer>

      The max column width of the printed table.

Positional arguments

<IMAGE_ID>

        ID of the image from which to delete tag.

<TAG_VALUE>

        Value of the tag.

Positional arguments

<IMAGE_ID>

        Image to be updated with the given tag.

<TAG_VALUE>

        Value of the tag.

Positional arguments

<IMAGE_ID>

        ID of image to update.

Optional arguments

--architecture <ARCHITECTURE>

      Operating system architecture as specified in
      http://docs.openstack.org/user-guide/common/cli-
      manage-images.html

--protected [True|False]

      If true, image will not be deletable.

--name <NAME>

        Descriptive name for the image

--instance-uuid <INSTANCE_UUID>

      Metadata which can be used to record which instance
      this image is associated with. (Informational only,
      does not create an instance snapshot.)

--min-disk <MIN_DISK>

      Amount of disk space (in GB) required to boot image.

--visibility <VISIBILITY>

      Scope of image accessibility Valid values: public,
      private

--kernel-id <KERNEL_ID>

      ID of image stored in Glance that should be used as
      the kernel when booting an AMI-style image.

--os-version <OS_VERSION>

      Operating system version as specified by the
      distributor

--disk-format <DISK_FORMAT>

      Format of the disk Valid values: None, ami, ari, aki,
      vhd, vmdk, raw, qcow2, vdi, iso

--os-distro <OS_DISTRO>

      Common name of operating system distribution as
      specified in http://docs.openstack.org/user-
      guide/common/cli-manage-images.html

--owner <OWNER>

        Owner of the image

--ramdisk-id <RAMDISK_ID>

      ID of image stored in Glance that should be used as
      the ramdisk when booting an AMI-style image.

--min-ram <MIN_RAM>

        Amount of ram (in MB) required to boot image.

--container-format <CONTAINER_FORMAT>

      Format of the container Valid values: None, ami, ari,
      aki, bare, ovf, ova, docker

--property <key=value>

      Arbitrary property to associate with image. May be
      used multiple times.

--remove-property

        key
      Name of arbitrary property to remove from the image.

Positional arguments

<IMAGE_ID>

        ID of image to upload data to.

Optional arguments

--file <FILE>

        Local file that contains disk image to be uploaded.
      Alternatively, images can be passed to the client via
      stdin.

--size <IMAGE_SIZE>

        Size in bytes of image to be uploaded. Default is to
      get size from provided data object but this is
      supported in case where size cannot be inferred.

--progress

        Show upload progress bar.

Positional arguments

<IMAGE_ID>

        Image with which to create member.

<MEMBER_ID>

        Tenant to add as member.

Positional arguments

<IMAGE_ID>

        Image from which to remove member.

<MEMBER_ID>

        Tenant to remove as member.

Optional arguments

--image-id <IMAGE_ID>

      Image to display members of.

Positional arguments

<IMAGE_ID>

        Image from which to update member.

<MEMBER_ID>

        Tenant to update.

<MEMBER_STATUS>

        Updated status of member. Valid Values: accepted, rejected,
      pending