Configure recomendações de reservas inativas

Esta página descreve como ver e modificar a configuração das suas recomendações de reservas inativas e a pedido. Pode querer modificar a configuração para aumentar o número de recomendações que recebe ou para receber menos recomendações para eliminar reservas que planeia usar.

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-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

    1. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Configure as suas recomendações

Para configurar as recomendações de reservas inativas, faça o seguinte:

  1. Obtenha a configuração atual para receber o ficheiro JSON da configuração.
  2. Edite o ficheiro de configuração no formato JSON.
  3. Carregue o novo ficheiro de configuração para aplicar as alterações.

Obter a configuração atual

Pode obter a configuração atual para recomendações de reservas inativas para o seu projeto através da Google Cloud CLI ou da API REST.

Conclua esta tarefa através de um dos seguintes métodos.

gcloud

Para obter 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 para a qual quer obter 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 devolve a configuração do recomendador, incluindo o subcampo modificável 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

Para obter 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 seu projeto.

Na linha de comandos, execute o seguinte comando para obter a configuração do recomendador para 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 devolve a configuração do recomendador, incluindo o subcampo que 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"
}

Atualize a configuração de um projeto

Para atualizar a configuração das recomendações de reservas inativas, modifique o valor de idle_reservation_lookback_period e carregue a nova configuração para o seu projeto.

Pode definir o período de observação para um valor de 7 a 30 dias, usando uma string que comece com P, seguida de um número inteiro para o número de dias (mínimo de 7 e máximo de 30), seguido de 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 carregar a nova configuração, esta demora aproximadamente 48 horas a entrar em vigor. Até lá, as recomendações geradas usam a configuração anterior.

gcloud

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 o seguinte:

  • ZONE: a zona para a qual quer obter a configuração atual
  • CONFIG_FILE_PATH: o caminho para o ficheiro JSON com a configuração atual
  • ETAG: o valor etag da configuração atual
  • BILLING_ACCOUNT_ID: o ID da conta de faturação

No ficheiro 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 ficheiro de configuração:

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

Se o comando for bem-sucedido, devolve um corpo da resposta semelhante ao seguinte, que mostra a nova configuração com os parâmetros que 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"
}

REST

Para atualizar a configuração, faça um pedido PATCH ao método 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 o seguinte:

  • PROJECT_ID: o ID do projeto para o qual quer modificar a configuração do recomendador.
  • ZONE: a zona que contém o seu projeto.

Guarde o corpo do pedido num ficheiro, por exemplo, config.json. Em seguida, pode fazer referência ao ficheiro quando atualizar a configuração do recomendador para o seu 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 devolve um corpo de resposta semelhante ao seguinte, mostrando a nova configuração com os parâmetros que 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"
}

O que se segue?