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: '')