このページでは、アイドル状態のオンデマンド予約の推奨事項の構成を表示し、変更する方法について説明します。構成を変更して、受け取る推奨事項の数を増やすか、推奨事項の数を減らして、使用する予定の予約を削除します。
- 推奨事項のカスタマイズに使用できるパラメータの詳細については、適切な構成パラメータの選択をご覧ください。
- アイドル状態のオンデマンド予約を特定して対処する方法の詳細については、アイドル状態の予約に関する推奨事項の表示と適用をご覧ください。
始める前に
-
まだ設定していない場合は、認証を設定します。認証とは、 Trusted Cloud by S3NS サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
Select the tab for how you plan to use the samples on this page:
gcloud
-
After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- 構成の JSON ファイルを取得するために、現在の構成を取得します。
- JSON 形式の構成ファイルを編集します。
- 新しい構成ファイルをアップロードして、変更を適用します。
- 観察期間が 7 日の場合は、
"P7D"
を使用します。 - 観察期間が 30 日の場合は、
"P30D"
を使用します。 ZONE
: 現在の構成を取得する対象のゾーンCONFIG_FILE_PATH
: 現在の構成を含む JSON ファイルのパスETAG
: 現在の構成の ETag 値BILLING_ACCOUNT_ID
: 請求先アカウントの IDPROJECT_ID
: Recommender の構成を変更する対象のプロジェクトの ID。ZONE
: プロジェクトを含むゾーン。- アイドル状態の予約の推奨事項の表示と適用の方法を確認する。
- 十分に活用されていない予約の推奨事項を表示して適用する方法を確認する。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:
gcloud init
詳細については、 Trusted Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
推奨事項を構成する
アイドル状態の予約に関する推奨事項を構成するには、次の操作を行います。
現在の構成を取得する
プロジェクトのアイドル状態の予約の推奨事項に関する現在の構成は、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 --billing-account=BILLING_ACCOUNT_ID
ZONE
は、現在の構成を取得するゾーンに置き換えます。例:
gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \ --location=us-central1-c --billing-account=my-billing-account-id
このコマンドから返される 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
を使用します。次に例を示します。新しい構成をアップロードした後、変更が適用されるまでに約 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 \ --billing-account=BILLING_ACCOUNT_ID
次のように置き換えます。
構成ファイル内で、構成パラメータを更新した
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\"" }
次のように置き換えます。
リクエスト本文をファイル(
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" }
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-21 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-07-21 UTC。"],[[["\u003cp\u003eThis document explains how to view and modify the configuration for idle, on-demand reservation recommendations, which is a pre-GA offering subject to specific terms and limited support.\u003c/p\u003e\n"],["\u003cp\u003eYou can adjust the number of idle reservation recommendations you receive by modifying the configuration parameters, with detailed instructions provided on selecting the right parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe configuration process involves obtaining the current configuration, editing the JSON file to change the \u003ccode\u003eidle_reservation_lookback_period\u003c/code\u003e parameter within the 7 to 30 day range, and then uploading the new configuration.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is required, and this can be done via the gcloud CLI or the REST API, with specific instructions for each method included in this document.\u003c/p\u003e\n"],["\u003cp\u003eAfter updating the configuration, it takes about 48 hours for the changes to take effect on generated recommendations, and the \u003ccode\u003eetag\u003c/code\u003e value changes each time you update the configuration.\u003c/p\u003e\n"]]],[],null,[]] -