カスタム イメージの使用を中止する


Compute Engine では、イメージに使用中止ステータスを設定することで、所有するカスタム イメージの使用を中止できます。使用中止ステータスごとに異なるレスポンスがサーバーから生成され、移行ユーザーがサポートされないイメージの使用を管理可能な方法で中止するのに役立ちます。イメージの使用を中止するには、Google Cloud コンソール、Google Cloud CLI、または Compute Engine API メソッドを使用します。

使用中止状態

次の使用中止の状態がサポートされています。

  • ACTIVE: イメージがアクティブで、通常のイメージとして使用できます。イメージ ファミリーは、任意のファミリー内の最新のアクティブ イメージを指します。
  • DEPRECATED: イメージは使用中止として指定されていますが、引き続き VM の作成に使用できます。このイメージへの新しいリンクは許可されます。イメージ ファミリーは、このイメージがファミリー内で最新のイメージであっても、このイメージをポイントしなくなります。

    Google Cloud CLI を使用して、非推奨のイメージを含む VM を作成すると、リクエストは成功しますが、警告が表示されます。

  • OBSOLETE: イメージは廃止イメージに指定され、今後使用できません。リクエストでこのイメージを使用しようとすると、エラー メッセージが返されます。このイメージへの既存のリンクは依然として許可されます。

  • DELETED: このイメージは削除されています。削除されたイメージを使用しようとすると、エラー メッセージが返されます。

非推奨状態を ACTIVE に変更すると、非推奨状態を元に戻す(イメージを再びアクティブにする)ことができます。

始める前に

カスタム イメージの使用を中止する

コンソール

  1. Google Cloud Console で、[イメージ] ページに移動します。

    [イメージ] に移動

  2. 廃止するイメージの アクション)をクリックします。

  3. [廃止] を選択します。

  4. 状態で [サポート終了] または [廃止] を選択します。状態の詳細については、使用中止状態をご覧ください。

  5. 省略可: 代替イメージを指定します。

  6. [イメージの使用を中止] をクリックします。

gcloud

gcloud compute images deprecate コマンドを使用して、イメージの使用中止ステータスを設定します。

gcloud compute images deprecate IMAGE_NAME \
    --state STATE \
    --replacement REPLACEMENT

次のように置き換えます。

  • IMAGE_NAME: 使用中止にするイメージの名前。
  • STATE: 使用中止状態
  • REPLACEMENT: 使用中止のイメージと置き換えるイメージ。

API

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: 使用中止にするイメージと置き換えるイメージ。