Esta página descreve como exibir e modificar a configuração de servidores inativos, as recomendações de reserva sob demanda. 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 identificar reservas sob demanda ociosas e fazer ação, consulte Visualizar e aplicar recomendações de reserva inativas.
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 Google Cloud .
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:
-
Install the Google Cloud CLI, then initialize it by running the following command:
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 gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
-
Configurar suas recomendações
Para configurar as recomendações de reserva inativa, 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 inativas para seu projeto usando a CLI do Google Cloud ou REST.
Permissões exigidas para a tarefa
Para executar esta tarefa, é necessário ter permissões:
recommender.computeIdleResourceRecommendations.get
no projeto.
Conclua esta tarefa usando um dos métodos a seguir.
Para acessar os parâmetros de configuração atuais, use o
comando gcloud recommender recommender-config describe
e use google.compute.IdleResourceRecommender
como o
ID do recomendador:
gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \ --location=ZONE --billing-account=BILLING_ACCOUNT_ID
Substitua ZONE
pela zona que você quer usar.
a configuração atual.
Por exemplo:
gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \ --location=us-central1-c --billing-account=my-billing-account-id
O comando retorna a configuração do recomendador, incluindo o subcampo params.idle_reservation_lookback_period
modificável.
{ "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" }
Para recuperar a configuração atual, use o método
recommenders.getConfig
e especifique google.compute.IdleResourceRecommender
como o
ID do recomendador:
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/ZONE /recommenders/google.compute.IdleResourceRecommender/config
Substitua ZONE
pela 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.IdleResourceRecommender/config
O comando retorna a configuração do recomendador, incluindo o subcampo
que você pode modificar: 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" }
Atualizar a configuração de um projeto
Para atualizar a configuração das recomendações de reserva inativas, modifique o valor
de idle_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
e 30
máximo), seguido por D
, 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"
.
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.
Permissões exigidas para a tarefa
Para executar esta tarefa, é necessário ter permissões:
recommender.computeIdleResourceRecommenderConfig.get
no projeto para conferir a configuração.recommender.computeIdleResourceRecommenderConfig.update
no projeto para modificar a configuração.
Para atualizar os parâmetros de configuração, use o
comando gcloud recommender recommender-config update
e use google.compute.IdleResourceRecommender
como o
ID do recomendador:
gcloud recommender recommender-config update google.compute.IdleResourceRecommender\ --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, use o seguinte arquivo de configuração:
{ "params": { "idle_reservation_lookback_period": "P21D" } }
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.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "idle_reservation_lookback_period": "P21D" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2024-06-03T05:00:05Z" }
Para atualizar a configuração, faça uma solicitação PATCH
para o
recommenders.updateConfig
e especifique google.compute.IdleResourceRecommender
como o
ID do recomendador:
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\"" }
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.IdleResourceRecommender/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.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "idle_reservation_lookback_period": "P21D" } }, "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.