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