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
-
Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。
gcloud init外部 ID プロバイダ(IdP)を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
- Set a default region and zone.
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。
gcloud init外部 ID プロバイダ(IdP)を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
カスタム イメージの使用を中止する
コンソール
Google Cloud コンソールで [イメージ] ページに移動します。
廃止するイメージの (アクション)をクリックします。
[廃止] を選択します。
状態で [サポート終了] または [廃止] を選択します。状態の詳細については、使用中止状態をご覧ください。
省略可: 代替イメージを指定します。
[イメージの使用を中止] をクリックします。
gcloud
gcloud compute images deprecateコマンドを使用して、イメージの使用中止ステータスを設定します。gcloud compute images deprecate IMAGE_NAME \ --state STATE \ --replacement REPLACEMENT次のように置き換えます。
IMAGE_NAME: 使用中止にするイメージの名前。STATE: 使用中止状態。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" }次のように置き換えます。
PROJECT_ID: イメージが属するプロジェクト。RESOURCE_ID: 使用中止にするイメージの名前。STATE: このリソースの使用中止状態。REPLACEMENT: 使用中止にするイメージと置き換えるイメージ。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-10-19 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["わかりにくい","hardToUnderstand","thumb-down"],["情報またはサンプルコードが不正確","incorrectInformationOrSampleCode","thumb-down"],["必要な情報 / サンプルがない","missingTheInformationSamplesINeed","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-10-19 UTC。"],[],[]] -