GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GCLOUD_COMPUTE_IMAGES_DEPRECATE (1)

NAME

gcloud compute images deprecate - manage deprecation status of Google Compute Engine images

CONTENTS

SYNOPSIS


gcloud compute images deprecate NAME --state STATE [--delete-in DELETE_IN | --delete-on DELETE_ON] [--obsolete-in OBSOLETE_IN | --obsolete-on OBSOLETE_ON] [--replacement REPLACEMENT] [GLOBAL-FLAG ...]

DESCRIPTION

gcloud compute images deprecate is used to deprecate images.

POSITIONAL ARGUMENTS

NAME

The name of the image to set deprecation status of.

REQUIRED FLAGS

--state STATE

The deprecation state to set on the image. An image’s default state is ACTIVE, suggesting that the image is currently supported. Operations which create a new resource using a DEPRECATED image return successfully, but with a warning indicating that the image is deprecated and recommending its replacement. New uses of OBSOLETE or DELETED images result in an error. Note that setting the deprecation state to DELETED will not automatically delete the image. You must still make a request to delete the image to remove it from the image list.

OPTIONAL FLAGS

--delete-in DELETE_IN

Specifies the amount of time until the image’s status should be set to DELETED. For instance, specifying 30d will set the status to DELETED in 30 days from the current system time. Valid units for this flag are ‘‘s’’ for seconds, ‘‘m’’ for minutes, ‘‘h’’ for hours and ‘‘d’’ for days. If no unit is specified, seconds is assumed.

Note that the image will not be deleted automatically. The image will only be marked as deleted. An explicit request to delete the image must be made in order to remove it from the image list. This flag is mutually exclusive with --delete-on.

--delete-on DELETE_ON
Similar to --delete-in, but specifies an absolute time when the status should be set to DELETED. The date and time specified must be a valid RFC 3339 full-date or date-time. For times in UTC, this looks like YYYY-MM-DDTHH:MM:SSZ. For example: 2020-01-02T00:00:00Z for midnight on January 2, 2020 in UTC. This flag is mutually exclusive with --delete-in.

--obsolete-in OBSOLETE_IN
Specifies time (in the same format as --delete-in) until this image’s status should become OBSOLETE. Obsolete images will cause an error whenever an attempt is made to apply the image to a new disk. This flag is mutually exclusive with --obsolete-on.

--obsolete-on OBSOLETE_ON
Specifies time (in the same format as --delete-on) when this image’s status should become OBSOLETE. This flag is mutually exclusive with --obsolete-in.

--replacement REPLACEMENT
Specifies a Compute Engine image as a replacement for the image being phased out. Users of the deprecated image will be advised to switch to this replacement. For example, --replacement example-image or --replacement projects/google/global/images/example-image. This flag is required when setting the image state to anything other than ACTIVE or when --delete-in, --delete-on, --obsolete-in, or --obsolete-on is provided.

GLOBAL FLAGS

Run $ gcloud help for a description of flags available to all commands.

EXAMPLES

To deprecate an image called ’IMAGE’ immediately, mark it as obsolete in one day, and mark it as deleted in two days, use:

$ gcloud compute images deprecate IMAGE --state DEPRECATED \
--obsolete-in 1d --delete-in 2d

To un-deprecate an image called ’IMAGE’, use:

$ gcloud compute images deprecate IMAGE --state ACTIVE
Search for    or go to Top of page |  Section 1 |  Main Index


GCLOUD_COMPUTE_IMAGES_DEPRECATE (1) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.