Configurar recomendações de reservas subutilizadas

Esta página descreve como visualizar e modificar a configuração de suas recomendações de reserva sob demanda subutilizadas. 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 subutilizadas, 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 subutilizadas 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.RightSizeResourceRecommender como o ID do recomendador:

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=ZONE --billing-account=BILLING_ACCOUNT_ID

Substitua o seguinte:

  • ZONE com a zona que contém reservas para as quais listar recomendações.
  • BILLING_ACCOUNT_ID pelo ID da sua conta de faturamento.

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

DESCANSAR

Para recuperar a configuração atual, use o método recommenders.getConfig e especifique google.compute.RightSizeResourceRecommender como o ID do recomendador:

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

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.

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.RightSizeResourceRecommender/config

O comando retorna a configuração do recomendador, incluindo os subcampos que você pode modificar: params.under_utilized_reservation_lookback_period e 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"
}

Atualizar a configuração de um projeto

Para atualizar a configuração das suas recomendações de reserva subutilizadas, modifique o valor de under_utilized_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" .

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 carregue a nova configuração para seu projeto, por exemplo:

  • Para um limite de 80%, "0.8" .

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.

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 use google.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 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 e o limite de reserva subutilizada de 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"
}

DESCANSAR

Para atualizar a configuração, faça uma solicitação PATCH ao método recommenders.updateConfig e especifique google.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 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.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"
}

O que vem a seguir