このページでは、十分に活用されていないオンデマンド予約の推奨事項の構成を表示し、変更する方法について説明します。構成を変更して、受け取る推奨事項の数を増やすか、推奨事項の数を減らして、使用する予定の予約を削除します。
- 推奨事項のカスタマイズに使用できるパラメータの詳細については、適切な構成パラメータの選択をご覧ください。
- アイドル状態または十分に活用されていない予約に関する推奨事項が表示された場合の対処方法については、アイドル状態の予約に関する推奨事項を表示して適用するまたは十分に活用されていない予約に関する推奨事項を表示して適用するをご覧ください。
始める前に
-
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
Select the tab for how you plan to use the samples on this page:
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- 構成の JSON ファイルを取得するために、現在の構成を取得します。
- JSON 形式の構成ファイルを編集します。
- 新しい構成ファイルをアップロードして、変更を適用します。
ZONE
は、推奨事項を一覧取得する予約を含むゾーンに置き換えます。BILLING_ACCOUNT_ID
は、請求先アカウントの ID に置き換えます。PROJECT_ID
: Recommender の構成を変更する対象のプロジェクトの ID。ZONE
: プロジェクトを含むゾーン。- 観察期間が 7 日の場合は、
"P7D"
を使用します。 - 観察期間が 30 日の場合は、
"P30D"
を使用します。 - しきい値が 80% の場合は
"0.8"
です。 ZONE
: 現在の構成を取得する対象のゾーンCONFIG_FILE_PATH
: 現在の構成を含む JSON ファイルのパスETAG
: 現在の構成の ETag 値BILLING_ACCOUNT_ID
: 請求先アカウントの IDPROJECT_ID
: Recommender の構成を変更する対象のプロジェクトの ID。ZONE
: プロジェクトを含むゾーン。- アイドル状態の予約の推奨事項の表示と適用の方法を確認する。
- 十分に活用されていない予約の推奨事項を表示して適用する方法を確認する。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
推奨事項を構成する
十分に活用されていない予約の推奨事項を構成する手順は次のとおりです。
現在の構成を取得する
プロジェクトで十分に活用されていない予約の推奨事項に関する現在の構成は、Google Cloud CLI または REST を使用して取得できます。
次のいずれかの方法でこのタスクを完了します。
gcloud
現在の構成パラメータを取得するには、
gcloud recommender recommender-config describe
コマンドを使用し、Recommender ID としてgoogle.compute.RightSizeResourceRecommender
を指定します。gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \ --location=ZONE --billing-account=BILLING_ACCOUNT_ID
次のように置き換えます。
例:
gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \ --location=us-central1-c --billing-account=my-billing-account-id
このコマンドから返される Recommender 構成に、変更可能なサブフィールド
params.under_utilized_reservation_lookback_period
とparams.under_utilized_reservation_utilization_threshold
が含まれています。{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P7D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2024-06-03T04:41:15.330351Z" }
REST
現在の構成を取得するには、
recommenders.getConfig
メソッドを使用し、Recommender ID としてgoogle.compute.RightSizeResourceRecommender
を指定します。GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config
次のように置き換えます。
コマンドラインから次のコマンドを実行して、プロジェクトの 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.RightSizeResourceRecommender/config
このコマンドから返される Recommender 構成に、変更可能なサブフィールド
params.under_utilized_reservation_lookback_period
とparams.under_utilized_reservation_utilization_threshold
が含まれています。{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P7D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2024-06-03T04:41:15.330351Z" }
プロジェクトに対する構成を更新する
十分に活用されていない予約の推奨事項の構成を更新するには、
under_utilized_reservation_lookback_period
の値を変更し、プロジェクトに対する新しい構成をアップロードします。観察期間として 7 日から 30 日までの値を設定できます。値を設定するには、
P
で始まる文字列、日数を表す整数(最小7
、最大30
)、D
を使用します。次に例を示します。同様に、
under_utilized_reservation_utilization_threshold
の値を変更して、予約の使用率が低い場合にトリガーされる使用量のしきい値を設定し、プロジェクトの新しい構成をアップロードします。次に例を示します。新しい構成をアップロードした後、変更が適用されるまでに約 48 時間かかります。それまでは、以前の構成に従って推奨事項が生成されます。
次のいずれかの方法でこのタスクを完了します。
gcloud
構成パラメータを更新するには、
gcloud recommender recommender-config update
コマンドを使用し、Recommender ID としてgoogle.compute.RightSizeResourceRecommender
を指定します。gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\ --location=ZONE \ --config-file=CONFIG_FILE_PATH \ --etag=ETAG \ --billing-account=BILLING_ACCOUNT_ID
次のように置き換えます。
構成ファイル内で、構成パラメータを更新した
recommenderGenerationConfig
オブジェクトのみを指定します。たとえば、観察期間を 21 日、予約の未使用率しきい値を 80% に指定するには、次の構成ファイルを使用します。{ "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }
コマンドが成功すると、パラメータが変更された新しい構成を示す、次のようなレスポンス本文が返されます。
{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2024-06-03T05:00:05Z" }
REST
構成を更新するには、
recommenders.updateConfig
メソッドにPATCH
リクエストを送信し、Recommender ID としてgoogle.compute.RightSizeResourceRecommender
を指定します。PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config { "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "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.RightSizeResourceRecommender/config
POST
コマンドは、パラメータが変更された新しい構成を示す、次のようなレスポンス本文を返します。{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2024-06-03T05:00:05Z" }
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-12-23 UTC。
-