アイドル状態の予約に関する推奨事項を構成する

このページでは、アイドル状態のオンデマンド予約の推奨事項の構成を表示し、変更する方法について説明します。構成を変更して、受け取る推奨事項の数を増やすか、推奨事項の数を減らして、使用する予定の予約を削除します。

始める前に

  • まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

推奨事項を構成する

アイドル状態の予約に関する推奨事項を構成するには、次の操作を行います。

  1. 構成の JSON ファイルを取得するために、現在の構成を取得します。
  2. JSON 形式の構成ファイルを編集します。
  3. 新しい構成ファイルをアップロードして、変更を適用します。

現在の構成を取得する

プロジェクトのアイドル状態の予約の推奨事項に関する現在の構成は、Google Cloud CLI または REST を使用して取得できます。

gcloud

現在の構成パラメータを取得するには、gcloud recommender recommender-config describe コマンドを使用し、Recommender ID として google.compute.IdleResourceRecommender を指定します。

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=ZONE

ZONE は、現在の構成を取得するゾーンに置き換えます。

例:

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=us-central1-c

このコマンドから返される Recommender 構成に、変更可能なサブフィールド params.idle_reservation_lookback_period が含まれています。

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P7D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

REST

現在の構成を取得するには、recommenders.getConfig メソッドを使用し、Recommender ID として google.compute.IdleResourceRecommender を指定します。

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config

ZONE は、プロジェクトを含むゾーンに置き換えます。

コマンドラインから次のコマンドを実行して、プロジェクトの Recommender 構成を取得します。

PROJECT_ID=PROJECT_ID
ZONE=ZONE
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: ${PROJECT_ID}" \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config

このコマンドから返される Recommender 構成に、変更可能なサブフィールド params.idle_reservation_lookback_period が含まれています。

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P7D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

プロジェクトに対する構成を更新する

アイドル状態の予約の推奨事項の構成を更新するには、idle_reservation_lookback_period の値を変更し、プロジェクトに対する新しい構成をアップロードします。

観察期間として 7 日から 30 日までの値を設定できます。値を設定するには、P で始まる文字列、日数を表す整数（最小 7、最大 30）、D を使用します。次に例を示します。

  • 観察期間が 7 日の場合は、"P7D" を使用します。
  • 観察期間が 30 日の場合は、"P30D" を使用します。

新しい構成をアップロードした後、変更が適用されるまでに約 48 時間かかります。それまでは、以前の構成に従って推奨事項が生成されます。

gcloud

構成パラメータを更新するには、gcloud recommender recommender-config update コマンドを使用し、Recommender ID として google.compute.IdleResourceRecommender を指定します。

gcloud recommender recommender-config update google.compute.IdleResourceRecommender\
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG

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

  • ZONE: 現在の構成を取得する対象のゾーン
  • CONFIG_FILE_PATH: 現在の構成を含む JSON ファイルのパス
  • ETAG: 現在の構成の ETag 値

構成ファイル内で、構成パラメータを更新した recommenderGenerationConfig オブジェクトのみを指定します。たとえば、21 日の観察期間を指定するには、構成ファイル内で次の設定を使用します。

{
  "params": {
    "idle_reservation_lookback_period": "P21D"
  }
}

コマンドが成功すると、パラメータが変更された新しい構成を示す、次のようなレスポンス本文が返されます。

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

REST

構成を更新するには、recommenders.updateConfig メソッドに PATCH リクエストを送信し、Recommender ID として google.compute.IdleResourceRecommender を指定します。

PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

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

  • PROJECT_ID: Recommender の構成を変更する対象のプロジェクトの ID。
  • ZONE: プロジェクトを含むゾーン。

リクエスト本文をファイル（config.json など）に保存します。これにより、プロジェクトに対する Recommender の構成を更新するときに、次のようなコマンドを使用してファイルを参照できます。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "x-goog-user-project: ${PROJECT_ID}" \
-d @config.json \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config

POST コマンドは、パラメータが変更された新しい構成を示す、次のようなレスポンス本文を返します。

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

次のステップ