Configurar recomendações de reserva ociosa

Esta página descreve como visualizar e modificar a configuração de suas recomendações de reserva ociosa e sob demanda. Talvez você queira modificar a configuração para aumentar o número de recomendações recebidas ou para obter menos recomendações para excluir reservas que você planeja usar.

Antes de começar

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

      Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Configure suas recomendações

Para configurar suas recomendações de reserva ociosa, faça o seguinte:

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

Obtenha a configuração atual

Você pode obter a configuração atual para recomendações de reserva inativa para seu projeto usando a Google Cloud CLI ou REST.

Conclua esta tarefa usando um dos métodos a seguir.

gcloud

Para obter os parâmetros de configuração atuais, use o 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 você deseja 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 retorna 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"
}

DESCANSAR

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

Na linha de comando, 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 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 suas recomendações de reserva inativa, modifique o valor idle_reservation_lookback_period e carregue a nova configuração para o seu projeto.

Você pode definir o período de observação para um valor de 7 dias até 30 dias, usando uma string começando com P , depois um número inteiro para o número de dias ( 7 no mínimo e 30 no 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, utilize "P30D" .

Depois de fazer upload da nova configuração, levará aproximadamente 48 horas para que ela entre em vigor. Até esse momento, todas as recomendações geradas utilizam 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 você deseja obter a configuração atual
  • CONFIG_FILE_PATH : o caminho para o arquivo JSON com a configuração atual
  • ETAG : o valor etag da configuração atual
  • BILLING_ACCOUNT_ID : o ID da conta de faturamento

Em seu 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"
}

DESCANSAR

Para atualizar a configuração, faça uma solicitação 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 você deseja modificar a configuração do recomendador.
  • ZONE : a zona que contém seu projeto.

Salve o corpo da solicitação em um arquivo, por exemplo config.json . Você poderá então referenciar o arquivo ao atualizar a configuração do recomendador para seu projeto, usando um comando semelhante a este: 

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"
}

O que vem a seguir