Esta página descreve como exibir e modificar a configuração de servidores subutilizados, as recomendações de reserva imediata. Talvez você queira modificar de configuração para aumentar o número de recomendações recebidas ou para receber menos recomendações e excluir as reservas que você planeja usar.
- Para mais informações sobre os parâmetros que podem ser usados para personalizar as recomendações, consulte Escolher os parâmetros de configuração corretos.
- Para mais informações sobre como agir quando você recebe recomendações sobre reservas inativas ou subutilizadas, consulte Visualizar e aplicar recomendações de reserva inativas ou Visualizar e aplicar recomendações de reserva subutilizadas.
Antes de começar
-
Configure a autenticação, caso ainda não tenha feito isso.
A autenticação é
o processo de verificação da sua identidade para acesso a serviços e APIs do Trusted Cloud by S3NS .
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
gcloud
-
Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
- Set a default region and zone.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted Cloud .
Configurar suas recomendações
Para configurar as recomendações de reserva subutilizada, faça o seguinte:
- Obtenha a configuração atual para conferir o arquivo JSON dela.
- Edite o arquivo de configuração no formato JSON.
- Faça o upload do novo arquivo de configuração para aplicar as alterações.
Obter a configuração atual
É possível acessar a configuração atual das recomendações de reserva subutilizadas para seu projeto usando a CLI do Google Cloud ou REST.
Conclua esta tarefa usando um dos métodos a seguir.
gcloud
Para acessar os parâmetros de configuração atuais, use o comando
gcloud recommender recommender-config describe
e usegoogle.compute.RightSizeResourceRecommender
como o ID do recomendador:gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \ --location=ZONE --billing-account=BILLING_ACCOUNT_ID
Substitua:
ZONE
com a zona que contém reservas para listar as recomendações.BILLING_ACCOUNT_ID
: o código da sua conta de faturamento.
Exemplo:
gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \ --location=us-central1-c --billing-account=my-billing-account-id
O comando retorna a configuração do recomendador, incluindo os subcampos modificáveis
params.under_utilized_reservation_lookback_period
eparams.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
Para recuperar a configuração atual, use o método
recommenders.getConfig
e especifiquegoogle.compute.RightSizeResourceRecommender
como o ID do recomendador:GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config
Substitua:
PROJECT_ID
: o ID do projeto que tem a configuração do recomendador que você quer modificar.ZONE
: a zona que contém o projeto.
Na linha de comando, execute o seguinte comando para consultar a configuração do recomendador de um projeto:
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
O comando retorna a configuração do recomendador, incluindo os subcampos que você pode modificar:
params.under_utilized_reservation_lookback_period
eparams.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" }
Atualizar a configuração de um projeto
Para atualizar a configuração das recomendações de reserva subutilizadas, modifique o valor de
under_utilized_reservation_lookback_period
e faça o upload da nova configuração do projeto.Você pode definir o período de observação com um valor de 7 a 30 dias, usando uma string que começa com
P
, depois um número inteiro para o número de dias (7
mínimo e30
máximo), seguido porD
, por exemplo:- Para um período de observação de 7 dias, use
"P7D"
. - Para um período de observação de 30 dias, use
"P30D"
.
Da mesma forma, defina o limite de uso que aciona uma recomendação de reserva subutilizada modificando o valor de
under_utilized_reservation_utilization_threshold
e faça o upload da nova configuração do projeto, por exemplo:- Para um limite de 80%,
"0.8"
.
Depois de fazer upload da nova configuração, leva aproximadamente 48 horas para que ela entre em vigor. Até lá, todas as recomendações geradas usarão a configuração anterior.
Conclua esta tarefa usando um dos métodos a seguir.
gcloud
Para atualizar os parâmetros de configuração, use o comando
gcloud recommender recommender-config update
e usegoogle.compute.RightSizeResourceRecommender
como o ID do recomendador:gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\ --location=ZONE \ --config-file=CONFIG_FILE_PATH \ --etag=ETAG \ --billing-account=BILLING_ACCOUNT_ID
Substitua:
ZONE
: a zona com a configuração atual que você quer obterCONFIG_FILE_PATH
: o caminho para o arquivo JSON com a configuração atualETAG
: o valor de etag da configuração atualBILLING_ACCOUNT_ID
: o ID da conta de faturamento
No arquivo de configuração, especifique apenas o objeto
recommenderGenerationConfig
com os parâmetros de configuração atualizados. Por exemplo, para especificar um período de observação de 21 dias e o limite de reserva subutilizada em 80%, use o seguinte arquivo de configuração:{ "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }
Se o comando for bem-sucedido, ele retornará um corpo de resposta semelhante ao seguinte, mostrando a nova configuração com os parâmetros que você acabou de modificar.
{ "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
Para atualizar a configuração, faça uma solicitação
PATCH
para orecommenders.updateConfig
e especifiquegoogle.compute.RightSizeResourceRecommender
como o ID do recomendador: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\"" }
Substitua:
PROJECT_ID
: o ID do projeto que tem a configuração do recomendador que você quer modificar.ZONE
: a zona que contém o projeto.
Salve o corpo da solicitação em um arquivo, por exemplo,
config.json
. Em seguida, você pode referenciar o arquivo ao atualizar a configuração do recomendador para o projeto, usando um comando semelhante ao seguinte: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
O comando
POST
retorna um corpo de resposta semelhante ao seguinte, mostrando a nova configuração com os parâmetros que você acabou de modificar.{ "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" }
A seguir
- Saiba como visualizar e aplicar recomendações de reservas inativas.
- Saiba como visualizar e aplicar recomendações de reservas subutilizadas.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-19 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[[["\u003cp\u003eThis page explains how to configure underutilized reservation recommendations, which are Pre-GA products available "as is" with potentially limited support.\u003c/p\u003e\n"],["\u003cp\u003eYou can modify the configuration to adjust the number of recommendations received by altering parameters like the lookback period (7-30 days) and utilization threshold.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration changes require getting the current configuration in JSON format, editing it, and then uploading the updated file using either the Google Cloud CLI or REST API.\u003c/p\u003e\n"],["\u003cp\u003eTo update the configuration you must have \u003ccode\u003erecommender.computeRightSizeResourceRecommender.get\u003c/code\u003e to view, and \u003ccode\u003erecommender.computeRightSizeResourceRecommender.update\u003c/code\u003e permissions to modify.\u003c/p\u003e\n"],["\u003cp\u003eAfter uploading a new configuration, it will take approximately 48 hours for the changes to become effective and to be used to generate any new recommendations.\u003c/p\u003e\n"]]],[],null,[]] -