Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Image Commands

Contents

addimage

addimage                     Create a new machine image.

                             The root_source_tarball parameter must point to a
                             tar file containing the contents of the desired
                             root directory. The tar file must be stored in
                             Google Cloud Storage.

                             Usage: gcutil [--global_flags] addimage
                             [--command_flags] <image-name>
                             <root-source-tarball>

                             Flags for addimage:

gcutil_lib.image_cmds:
  --description: An optional image description.
    (default: '')

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

deleteimage

deleteimage                  Delete one or more machine images.

                             Specify multiple images as multiple arguments. The
                             images will be deleted in parallel.

                             Usage: gcutil [--global_flags] deleteimage
                             [--command_flags] <image-name-1> ... <image-name-n>

                             Flags for deleteimage:

gcutil_lib.command_base:
  -f,--[no]force: Override the "Delete image" prompt
    (default: 'false')

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

deprecateimage

deprecateimage               Sets the deprecation status for an image.

                             Usage: gcutil [--global_flags] deprecateimage
                             [--command_flags] <image-name>

                             Flags for deprecateimage:

gcutil_lib.gcutil_flags:
  --state: <ACTIVE|DEPRECATED|OBSOLETE|DELETED>: [Required] Sets the deprecation
    state for this image. Valid values are 'ACTIVE','DEPRECATED', 'OBSOLETE',
    and 'DELETED'. 'DEPRECATED' resources can still be used in requests, but a
    warning is returned. 'OBSOLETE'and 'DELETED' resources cannot be used to
    create new resources but existing resources can still use the image.
    'ACTIVE' means that the resource is no longer deprecated. Note that an image
    with a 'DELETED' deprecation state won't automatically be deleted. You must
    still make a request to delete the image to remove it from the image list.
    (default: 'ACTIVE')

gcutil_lib.image_cmds:
  --deleted_on: Specifies a valid RFC 3339 full-date or date-time on which the
    state of this resource became or will become DELETED. For example:
    2020-01-02T00:00:00Z for midnight on January 2nd, 2020.
  --deprecated_on: Specifies a valid RFC 3339 full-date or date-time on which
    the state of this resource became or will become DEPRECATED. For example:
    '2020-01-02T00:00:00Z' for midnight on January 2nd, 2020.
  --obsolete_on: Specifies a valid RFC 3339 full-date or date-time on which the
    state of this resource became or will become OBSOLETE. For example:
    '2020-01-02T00:00:00Z' for midnight on January 2nd, 2020.
  --replacement: [Required] Specifies a Compute Engine image as a replacement
    for this image. Users of the deprecated image will be advised to switch to
    this replacement.For example, '--replacement=my-custom-image' or
    '--replacement=projects/google/global/images/<image-name>'.

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

getimage

getimage                     Get a machine image.

                             Usage: gcutil [--global_flags] getimage
                             [--command_flags] <image-name>

listimages

listimages                   List the images for a project.

                             Usage: gcutil [--global_flags] listimages
                             [--command_flags]

                             Flags for listimages:

gcutil_lib.command_base:
  --columns: A comma-separated list of the desired columns to display. If 'all'
    is specified, then all possible columns will be included. Valid columns are
    <all|name|description|kernel|deprecation|status>.
    (a comma separated list)
  --[no]fetch_all_pages: Deprecated flag.
    (default: 'true')
  --filter: Filter expression for filtering listed resources. See gcutil
    documentation for syntax of the filter expression here:
    http://developers.google.com/compute/docs/gcutil/tips#filtering
  --max_results: Maximum number of items to list [Default is to fetch all].
    (a positive integer)

gcutil_lib.gcutil_flags:
  --sort_by: <name|-name|deprecation|-deprecation|status|-status>: Sort output
    results by the given field name. Field names starting with a "-" will lead
    to a descending order.

gcutil_lib.image_cmds:
  --[no]old_images: List all versions of images
    (default: 'false')
  --[no]standard_images: Include images in all well-known image projects.
    (default: 'true')

gflags:
  --flagfile: Insert flag definitions from the given file into the command line.
    (default: '')
  --undefok: comma-separated list of flag names that it is okay to specify on
    the command line even if the program does not define a flag with that name.
    IMPORTANT: flags in this list that have arguments MUST use the --flag=value
    format.
    (default: '')

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.