Compute Engine では、イメージに使用中止ステータスを設定することで、所有するカスタム イメージの使用を中止できます。使用中止ステータスごとに異なるレスポンスがサーバーから生成され、移行ユーザーがサポートされないイメージの使用を管理可能な方法で中止するのに役立ちます。イメージの使用を中止するには、Google Cloud コンソール、Google Cloud CLI、または Compute Engine API メソッドを使用します。
使用中止状態
次の非推奨の状態がサポートされています。
ACTIVE
: イメージがアクティブで、通常のイメージとして使用できます。イメージ ファミリーは、任意のファミリー内の最新のアクティブ イメージを指します。DEPRECATED
: イメージは使用中止として指定されていますが、引き続き VM の作成に使用できます。このイメージへの新しいリンクは許可されます。イメージ ファミリーは、このイメージがファミリー内で最新のイメージであっても、このイメージをポイントしなくなります。Google Cloud CLI を使用して、非推奨のイメージを含む VM を作成すると、リクエストは成功しますが、警告が表示されます。
OBSOLETE
: イメージは廃止イメージに指定され、今後使用できません。リクエストでこのイメージを使用しようとすると、エラー メッセージが返されます。このイメージへの既存のリンクは依然として許可されます。DELETED
: このイメージは削除されています。削除されたイメージを使用しようとすると、エラー メッセージが返されます。
非推奨状態を ACTIVE
に変更すると、非推奨状態を元に戻す(イメージを再びアクティブにする)ことができます。
始める前に
- Images ドキュメントを確認します。
-
まだ設定していない場合は、認証を設定します。認証とは、サービスと API にアクセスするために ID を確認するプロセスです。 Google Cloud ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
-
カスタム イメージの使用を中止する
Google Cloud コンソールで、[イメージ] ページに移動します。
廃止するイメージの
(アクション)をクリックします。[廃止] を選択します。
状態で [サポート終了] または [廃止] を選択します。状態の詳細については、使用中止状態をご覧ください。
省略可: 代替イメージを指定します。
[イメージの使用を中止] をクリックします。
gcloud compute images deprecate
コマンドを使用して、イメージの使用中止ステータスを設定します。
gcloud compute images deprecateIMAGE_NAME \ --stateSTATE \ --replacementREPLACEMENT
次のように置き換えます。
IMAGE_NAME
: 使用中止にするイメージの名前。STATE
: 使用中止状態。REPLACEMENT
: 使用中止のイメージと置き換えるイメージ。
images().deprecate
メソッドに POST
リクエストを送信します。使用中止にするイメージの名前を指定します。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /global/images/RESOURCE_ID /deprecate { "state": "STATE ", "replacement": "REPLACEMENT " }
次のように置き換えます。
PROJECT_ID
: イメージが属するプロジェクト。RESOURCE_ID
: 使用中止にするイメージの名前。STATE
: このリソースの使用中止状態。REPLACEMENT
: 使用中止にするイメージと置き換えるイメージ。