Configurar recomendações de reserva subutilizada

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.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Cloud de Confiance by S3NS . Para executar código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. Instale a CLI do Google Cloud e faça login na gcloud CLI com sua identidade federada. Depois de fazer login, inicialize a CLI do Google Cloud executando o seguinte comando: 

      gcloud init
    2. Set a default region and zone.

    REST

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

      Instale a CLI do Google Cloud e faça login na gcloud CLI com sua identidade federada. Depois de fazer login, inicialize a CLI do Google Cloud executando o seguinte comando: 

      gcloud init

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Cloud de Confiance .

Configurar suas recomendações

Para configurar as recomendações de reserva subutilizada, faça o seguinte:

  1. Obtenha a configuração atual para conferir o arquivo JSON dela.
  2. Edite o arquivo de configuração no formato JSON.
  3. 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 a tarefa usando um dos métodos abaixo.

gcloud

Para acessar os parâmetros de configuração atuais, use o comando 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:

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

REST

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:

  • 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 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 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 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".

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 a tarefa usando um dos métodos abaixo.

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:

  • ZONE: a zona com a configuração atual que você quer obter
  • CONFIG_FILE_PATH: o caminho para o arquivo JSON com a configuração atual
  • ETAG: o valor de etag da configuração atual
  • BILLING_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 o 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:

  • 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