Recomendador de projetos sem supervisão

O recomendador de projetos não supervisionados analisa a atividade de utilização em projetos na sua organização e fornece recomendações que ajudam a descobrir, reclamar ou remover projetos não supervisionados.

Vista geral

Em organizações em rápida evolução, não é invulgar que os recursos da nuvem, incluindo projetos inteiros, sejam ocasionalmente esquecidos. Estes recursos não supervisionados podem ser difíceis de identificar e tendem a resultar em desperdício desnecessário e riscos de segurança.

O recomendador de projetos não supervisionados analisa a atividade de utilização em todos os projetos da sua organização e oferece-lhe as seguintes funcionalidades para ajudar a descobrir, reaver e encerrar projetos não supervisionados:

• Estatísticas de utilização para cada projeto (rede, API, proprietário do projeto, atividade do serviço e muito mais).
• Recomendações para desativar projetos com atividade de utilização baixa.
• Recomendações para atribuir um novo proprietário a projetos com atividade de utilização elevada, mas sem proprietário ativo.

O encerramento ou a recuperação de projetos não supervisionados pode ter o seguinte impacto e vantagens para a sua organização:

• Redução nos riscos de segurança (SECURITY)
• Redução dos gastos desnecessários (COST)
• Redução da pegada de carbono associada às suas cargas de trabalho (SUSTAINABILITY)

Nota: o recomendador de projetos não supervisionados só pode ser usado para projetos atribuídos a organizações.

Google Cloud

Como funciona

O recomendador de projetos não supervisionados analisa a utilização de projetos nos últimos 30 dias. A tabela seguinte apresenta as recomendações e as estatísticas que o recomendador de projetos não supervisionados pode gerar com base no facto de a atividade de utilização ser baixa ou elevada .

Utilização/tipo de projeto	Subtipo de estatísticas	Recomendação	Subtipo de recomendação
Projetos com: Utilização baixa nos últimos 30 dias	PROJECT_ACTIVITY	Reveja ou elimine o projeto.	CLEANUP_PROJECT
Projetos com: Utilização elevada nos últimos 30 dias Proprietários do utilizador atribuídos, mas nenhum deles está ativo no projeto.	PROJECT_ACTIVITY	Reivindique o projeto atribuindo um novo proprietário.	RECLAIM_PROJECT
Todos os outros projetos que não sejam do Apps Script.	PROJECT_ACTIVITY	-	-

Nota: o recomendador de projetos não supervisionados não gera estatísticas nem recomendações para projetos do Apps Script, uma vez que estes projetos são eliminados automaticamente quando os scripts associados são eliminados.

As recomendações e as estatísticas estão disponíveis em diferentes níveis da hierarquia da organização do Google Cloud. O acesso a essas recomendações e estatísticas requer uma associação de funções da IAM ao nível correspondente:

• Ao nível do projeto: os proprietários do projeto podem descobrir e tomar medidas com base nas estatísticas e nas recomendações para os projetos aos quais têm acesso.
• Ao nível da organização: os administradores da organização podem descobrir e tomar medidas com base em estatísticas e recomendações para projetos numa organização na nuvem.
• Ao nível da conta de faturação: os administradores de faturação podem descobrir e agir com base em estatísticas e recomendações para projetos associados a uma determinada conta de faturação.

Nota: atualmente,o número de estatísticas e recomendações por organização ou conta de faturação está limitado a 10 000. Se a sua organização ou conta de faturação incluir mais de 10 000 projetos e quiser rever o conjunto completo de recomendações e estatísticas, recomendamos que confie nas estatísticas e recomendações ao nível do projeto ou use a exportação do BigQuery de estatísticas e recomendações.

Classificar a atividade de utilização de um projeto

Um projeto pode ser classificado como tendo uma atividade de utilização baixa ou elevada, com base nas recomendações fornecidas. A classificação da atividade de utilização de um projeto é calculada com base no conteúdo incluído nas estatísticas de utilização do projeto.

Para projetos identificados como tendo uma atividade de utilização baixa, aplicam-se as seguintes condições:

Classificação da utilização	Condição
Organizações com mais de 50 projetos	Um projeto é classificado com base no nível de atividade de utilização em todo o conteúdo incluído nas estatísticas de utilização do projeto. Um projeto é classificado como não supervisionado se estiver dentro de 10% da atividade de utilização em comparação com todos os outros projetos nessa organização.
Organizações com menos de 50 projetos	A média diária de chamadas API consumidas por um projeto (consumedApiDailyCount) é inferior a 100. O Cloud Logging é o único serviço usado por um projeto. Todas as outras estatísticas de utilização do projeto têm um valor igual a zero.

Nota: as recomendações são fornecidas apenas para projetos com mais de 30 dias.

Prioridade e impactos das recomendações

As recomendações de projetos não supervisionados contêm os seguintes campos que ajudam a prioritizar e estimar as vantagens da respetiva aplicação:

• priority - Um valor de prioridade entre P1 e P4, sendo P1 a prioridade mais elevada.
• primaryImpact – SECURITY. A contagem de recomendações de segurança de alta prioridade num projeto não supervisionado.
• additionalImpact(s) – COST e SUSTAINABILITY. O custo (em $) e a redução das emissões de sustentabilidade (em kgCO₂e) que seriam alcançados se o projeto fosse removido.

Prioridade da recomendação

A prioridade da recomendação de projeto não assistido varia de P1 a P4, sendo P1 a prioridade mais elevada.

O recomendador começa por rever as recomendações de segurança em cada projeto não supervisionado. A partir daí, define a prioridade da recomendação do projeto não supervisionado igual à da recomendação de prioridade mais elevada encontrada no projeto. Por exemplo, se um projeto não monitorizado tiver 10 recomendações de segurança, oito recomendações P2 e duas recomendações P1, a recomendação do projeto não monitorizado seria atribuída a um valor de prioridade de P1.

As recomendações de segurança mais frequentes encontradas em projetos não supervisionados são do IAM Recommender. Uma recomendação de projeto não monitorizado com uma prioridade de P1 significa provavelmente que existe um contentor de armazenamento na nuvem acessível publicamente no projeto não monitorizado (saiba mais sobre como o IAM Recommender define as prioridades).

Impacto na segurança

O campo primaryImpact - SECURITY oferece um valor igual à quantidade de recomendações de segurança de alta prioridade (P2 e superior) no projeto não supervisionado.securityProjection Por exemplo, quando um projeto tem uma recomendação para substituir a função ampla de editor por uma função mais detalhada, essa recomendação tem uma prioridade de P2 e é contabilizada no priorityRecommendationCount.

Impacto no custo

O campo additionalImpact - COST oferece um costProjection que é uma estimativa da poupança de custos se o projeto não supervisionado fosse removido. Isto baseia-se nos custos incorridos com os recursos em execução no projeto não supervisionado nos últimos 30 dias.

Nota: para ver os preços personalizados nas projeções de custos, a conta de faturação da nuvem associada não pode ter sido alterada nos últimos 30 dias, e o utilizador tem de ter autorizações de faturação.

Impacto na sustentabilidade

O campo additionalImpact - SUSTAINABILITY oferece um sustainabilityProjection que é uma estimativa das emissões de carbono contribuídas pelos recursos em execução no projeto não supervisionado nos últimos 30 dias. A estimativa é medida em quilogramas de equivalente de dióxido de carbono (kgCO₂e).

Conteúdos de uma estatística de utilização de projetos

O conteúdo das estatísticas de utilização de um projeto são valores de campos usados para classificar a atividade de utilização do projeto e gerar recomendações CLEANUP_PROJECT e/ou RECLAIM_PROJECT.

Aviso: as estatísticas de utilização de projetos são geradas para todos os projetos, independentemente de o projeto ser não supervisionado ou não. Estas estatísticas são geradas diariamente. Uma única estatística não é um indicador fiável para que um projeto seja considerado sem supervisão. Evite remover projetos com base nas estatísticas de um único dia.

A tabela seguinte lista os vários campos que o motor de recomendações apresenta como parte da estatística PROJECT_ACTIVITY:

Campo	Descrição
Nível de utilização
usagePercentile	Percentil do nível de utilização deste projeto em comparação com outros projetos na mesma organização. Se o percentil for -1, significa que o valor não é calculado. O valor não é calculado quando as organizações têm menos de 50 projetos.
Atividade da API
activeServiceAccountDailyCount	Média diária de contas de serviço com atividade de autenticação neste projeto.
apiClientDailyCount	Média diária de clientes distintos de chamadas API produzidas por este projeto.
consumedApiDailyCount	Média diária de chamadas de API consumidas por este projeto.
datastoreApiDailyCount	Média diária de chamadas da API Datastore consumidas por este projeto
Atividade de rede
vpcEgressDailyBytes	Média diária de bytes de saída da VPC deste projeto.
vpcIngressDailyBytes	Média diária de bytes de entrada da VPC neste projeto
Utilização da faturação
hasBillingAccount	Verifica se o projeto tem uma conta de faturação no final da observação
serviceWithBillableUsage	Nomes dos serviços faturáveis usados nos últimos 30 dias.
Utilização de serviços na nuvem
activeAppengineInstanceDailyCount: system/instance_count	Média diária do número de instâncias do App Engine ativas neste projeto
activeCloudsqlInstanceDailyCount	Média diária do número de instâncias do Cloud SQL ativas neste projeto.
activeGceInstanceDailyCount	Média diária do número de instâncias do Compute Engine ativas neste projeto.
bigqueryInflightJobDailyCount	Média diária de tarefas do BigQuery em curso neste projeto.
bigqueryInflightQueryDailyCount	Média diária da contagem de consultas do BigQuery em curso neste projeto.
bigqueryStorageDailyBytes	Média diária do armazenamento do BigQuery em curso neste projeto.
bigqueryTableDailyCount	Média diária da quantidade de tabelas do BigQuery neste projeto.
gcsObjectDailyCount	Média diária do número de objetos do Cloud Storage neste projeto.
gcsRequestDailyCount	Média diária do número de APIs Cloud Storage neste projeto.
gcsStorageDailyBytes	Média diária de bytes de armazenamento usados pelo Cloud Storage neste projeto.
Atividade do utilizador
numActiveUserOwners	O número de proprietários de projetos do tipo de utilizador ativo no final do período de observação. Ativo significa que a conta de utilizador não está desativada e que foi identificada alguma atividade neste projeto durante o período de observação.
owners	Lista de proprietários de projetos e respetivas atividades
Outros campos
hasActiveOauthTokens	Verifica se o projeto tem tokens OAuth ativos usados nos últimos 180 dias.
carbonFootprintDailyKgCO2	Média diária das emissões de carbono contribuídas por este projeto com base nos últimos 30 dias de dados disponíveis.
costProjection	Poupanças de custos previstas para a duração especificada se o projeto fosse removido. É apresentado um preço personalizado ou de tabela com base nas autorizações da conta de faturação. É uma estimativa baseada nos últimos 30 dias de dados disponíveis e não constitui uma fatura.
severity	O severity está definido para o valor correspondente da estatística de segurança de gravidade mais elevada encontrada no projeto. Por exemplo, com base na forma como o IAM Recommender define as gravidades para as respetivas estatísticas, uma gravidade CRITICAL na estatística do projeto não supervisionado significa provavelmente que existe um contentor de armazenamento na nuvem acessível publicamente no projeto não supervisionado.

Recomendações para eliminar um projeto

Recomendamos a eliminação de um projeto quando tem uma utilização baixa nos últimos 30 dias e não tem tokens OAuth usados nos últimos 180 dias.

Aviso: examine cuidadosamente as estatísticas de utilização associadas a um projeto. A eliminação de um projeto pode resultar na perda irreversível de dados. Para mais informações, consulte o artigo Encerrar (eliminar) projetos.

Aviso: as recomendações são fornecidas para projetos de inquilinos. A eliminação deste projeto pode levar à perda de dados devido a campos de utilização adicionais do projeto que não são capturados para estes projetos.

Recomendações para atribuir um novo proprietário a um projeto

Recomendamos que atribua um novo proprietário a um projeto quando este cumprir todas as condições indicadas abaixo:

• Todos os proprietários atribuídos estão inativos no projeto nos últimos 90 dias ou já não trabalham na empresa.
• O projeto tem uma atividade de utilização elevada.

Nota: se um projeto não tiver um proprietário do utilizador atribuído, é considerado um comportamento pretendido em que a recomendação RECLAIM_PROJECT não é fornecida.

Preços

Para mais detalhes sobre os preços do Active Assist, consulte os preços do recomendador.

Antes de começar

Antes de poder ver as estatísticas e as recomendações, tem de fazer o seguinte:

• Tem de ativar a API Recommender. Só tem de ativar a API num único projeto de faturação. Em seguida, pode usar este mesmo projeto de faturação para examinar as recomendações e as estatísticas de outros projetos, de toda a organização ou da conta de faturação, através da funcionalidade de gcloud/API.--billing-project
• Certifique-se de que tem uma destas funções obrigatórias atribuídas:

Descrição	Funções
Ver recomendações	recommender.projectUtilViewer
Veja e atualize recomendações	recommender.projectUtilAdmin
Desativar estatísticas e recomendações no Centro de transparência e controlo	dataprocessing.admin

Estas funções fornecem um conjunto de autorizações que lhe permitem aceder às estatísticas e recomendações. Para mais informações sobre as funções, consulte os artigos Compreender as funções e Conceder autorizações de IAM.

A concessão destas funções ao nível da organização permite-lhe aceder às recomendações e às estatísticas dos projetos na organização individualmente ou em conjunto (todos os projetos não supervisionados na organização) através da API ao nível da organização.

A concessão destas funções ao nível da conta de faturação permite-lhe aceder às recomendações e às estatísticas dos projetos que usam a conta de faturação especificada.

Para mais informações sobre a desativação, consulte o artigo Desative as estatísticas e as recomendações.

ID do motor de recomendações

Seguem-se o ID do recomendador de projetos não supervisionados e o tipo de estatísticas:

• google.resourcemanager.projectUtilization.Recommender
• google.resourcemanager.projectUtilization.Insight

Autorizações de IAM necessárias

Para aceder à lista de recomendações e estatísticas, são necessárias as seguintes autorizações:

• recommender.resourcemanagerProjectUtilizationRecommendations.get
• recommender.resourcemanagerProjectUtilizationRecommendations.list
• recommender.resourcemanagerProjectUtilizationInsights.get
• recommender.resourcemanagerProjectUtilizationInsights.list

Para atualizar recomendações e estatísticas (por exemplo, para ignorar uma recomendação), são necessárias as seguintes autorizações:

• recommender.resourcemanagerProjectUtilizationRecommendations.update
• recommender.resourcemanagerProjectUtilizationInsights.update

Ver recomendações de projetos sem supervisão

Esta secção descreve como verificar estatísticas e recomendações não supervisionadas com a gcloud e com a curl para enviar pedidos para a API Recommender.

gcloud

Para ver recomendações e estatísticas com o gcloud, siga os passos abaixo. Para mais informações, consulte os artigos Usar a API – Estatísticas e Usar a API – Recomendações.

Recomendações

1. Para apresentar recomendações de projetos sem supervisão para o projeto onde ativou a API Recommender, execute o seguinte comando:

     gcloud recommender recommendations list \
     --project=PROJECT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do projeto.

2. Para listar recomendações de projetos não supervisionados num projeto diferente enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --project=PROJECT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (seria o mesmo PROJECT_ID indicado no passo anterior).
   • PROJECT_ID: o ID de um projeto diferente para o qual quer ver as recomendações de projetos não supervisionados.
   Nota: se o comando não devolver nenhuma recomendação, significa que o projeto não é autónomo ou existe há 30 dias ou mais.

3. Para apresentar uma lista de recomendações de projetos não supervisionados para toda a organização, enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --organization=ORGANIZATION_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (este seria o mesmo PROJECT_ID indicado no passo anterior).
   • ORGANIZATION_ID: o ID da organização para a qual quer ver as recomendações de projetos não monitorizados.

4. Para listar recomendações de projetos não supervisionados que estão a usar uma conta de faturação específica, enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --billing-account=BILLING_ACCOUNT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (este seria o mesmo PROJECT_ID indicado no passo anterior).
   • BILLING_ACCOUNT_ID: o ID da sua Google Cloud conta de faturação.

Nota: pode expandir os detalhes das recomendações a partir do comando list anexando uma flag --format=yaml no final.

Estatísticas

1. Para apresentar uma lista de estatísticas de utilização de um determinado projeto, execute o seguinte comando:

     gcloud recommender insights list \
     --project=PROJECT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do projeto.

2. Para listar as estatísticas de utilização de um projeto diferente, enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --project=PROJECT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (seria o mesmo PROJECT_ID indicado no passo anterior).
   • PROJECT_ID: o ID de um projeto diferente para o qual quer ver as estatísticas do motor de recomendações autónomo.

3. Para apresentar uma lista de estatísticas de utilização para toda a organização, enquanto usa um projeto onde ativou a API Recommender (como no passo anterior), execute o seguinte comando:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --organization=ORGANIZATION_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (este seria o mesmo PROJECT_ID indicado no passo anterior).
   • ORGANIZATION_ID: o ID da organização para a qual quer ver as estatísticas de utilização.

4. Para listar as estatísticas de utilização que estão a usar uma conta de faturação específica, enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --billing-account=BILLING_ACCOUNT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (este seria o mesmo PROJECT_ID indicado no passo anterior).
   • BILLING_ACCOUNT_ID: o ID da sua Google Cloud conta de faturação.

Nota: pode expandir os detalhes das estatísticas do comando list anexando uma flag --format=yaml no final.

API

Para ver recomendações e estatísticas, pode usar curl para enviar um pedido às APIs Recommender. Para autorizar pedidos a partir da linha de comandos, usa chaves de acesso de OAuth. Uma chave de acesso OAuth é uma string que concede acesso temporário a uma API.

Nota: se ainda não estiver familiarizado com os pré-requisitos de autenticação para chamar APIs, consulte a vista geral da autenticação.

Google Cloud

Recomendações

1. Para apresentar recomendações de projetos sem supervisão para o projeto onde ativou a API Recommender, execute o seguinte comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Substitua o seguinte:

   • PROJECT_ID`: o ID do projeto.
   Nota: se a chamada da API não devolver nenhuma recomendação, significa que o projeto não é autónomo ou existe há, pelo menos, 30 dias.

2. Para listar recomendações de projetos não supervisionados num projeto diferente enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (seria o mesmo PROJECT_ID indicado no passo anterior).
   • PROJECT_ID: o ID de um projeto diferente para o qual quer ver as recomendações de projetos não supervisionados.

3. Para apresentar uma lista de recomendações de projetos não supervisionados para toda a organização, enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (seria o mesmo PROJECT_ID indicado no passo anterior).
   • ORGANIZATION_ID: o ID da organização para a qual quer ver as recomendações de projetos não monitorizados.

4. Para listar recomendações de projetos não supervisionados que estão a usar uma conta de faturação específica, enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (seria o mesmo PROJECT_ID indicado no passo anterior).
   • BILLING_ACCOUNT_ID: o ID da sua Google Cloud conta de faturação.

Estatísticas

1. Para apresentar uma lista de estatísticas de utilização de um determinado projeto, execute o seguinte comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global\
   /insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Substitua o seguinte:

   • PROJECT_ID`: o ID do projeto.

2. Para listar as estatísticas de utilização de um projeto diferente, enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "x-goog-user-project: BILLING_PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID//locations/global\
   /insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (seria o mesmo PROJECT_ID indicado no passo anterior).
   • PROJECT_ID: o ID de um projeto diferente para o qual quer ver as estatísticas do motor de recomendações autónomo.

3. Para apresentar uma lista de estatísticas de utilização para toda a organização, enquanto usa um projeto onde ativou a API Recommender (como no passo anterior), execute o seguinte comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/\
   insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (seria o mesmo PROJECT_ID indicado no passo anterior).
   • ORGANIZATION_ID: o ID da organização para a qual quer ver as recomendações de projetos não monitorizados.

4. Para listar as estatísticas de utilização que estão a usar uma conta de faturação específica, enquanto usa um projeto no qual ativou a API Recommender (como no passo anterior), execute o seguinte comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/locations/global/\
   insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Substitua o seguinte:

   • BILLING_PROJECT_ID: o ID do projeto que ativou com a API Recommender (seria o mesmo PROJECT_ID indicado no passo anterior).
   • BILLING_ACCOUNT_ID: o ID da sua Google Cloud conta de faturação.

Configurar parâmetros de recomendações

Esta secção descreve como ver e configurar esta recomendação através de gcloud e curl.

A tabela seguinte apresenta vários parâmetros que podem ser configurados:

Parâmetro	Descrição	Valores esperados
minimum_observation_period	O período de observação mínimo define o número de dias de atividade do projeto a analisar antes de ser gerada uma recomendação. Atualmente, a definição deste valor só é suportada ao nível da organização.	"P30D"[DEFAULT], "P60D", "P90D", "P180D", "P270D", "P365D"

gcloud

Para ver e atualizar as configurações do motor de recomendações através da gcloud, siga os passos abaixo.

Visualizar configurações

1. Para ver as configurações do Recomendador de projetos sem supervisão para uma determinada organização, execute o seguinte comando a partir de um projeto pertencente a essa organização que tenha a API Recommender ativada:

   gcloud beta recommender recommender-config describe \
   google.resourcemanager.projectUtilization.Recommender \
   --organization=ORGANIZATION_ID \
   --location=global
   

   Substitua o seguinte:

   • ORGANIZATION_ID: o ID da organização.

2. Exemplo de resultado:

   etag: ETAG
   name: organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   recommenderGenerationConfig:
     params:
       minimum_observation_period: P30D
   revisionId: DEFAULT
   updateTime: '2022-04-19T00:57:55Z'
   

   Anote o valor ETAG:

   • ETAG: este valor vai ser usado em recommender-config update.

A atualizar as configurações

1. Para atualizar as configurações do Unattended Project Recommender para uma determinada organização, escolha um projeto pertencente a essa organização no qual ativou a API Recommender e crie um ficheiro config.gcloud:

   
   {
    "params": {
       "minimum_observation_period": DURATION
     }
   }
   

   Substitua o seguinte:

   • DURATION: um valor de "P30D", "P60D", "P90D", "P180D", "P270D" ou "P365D"

2. Execute o seguinte comando:

   gcloud beta recommender recommender-config update \
   google.resourcemanager.projectUtilization.Recommender \
   --organization=ORGANIZATION_ID \
   --location=global \
   --config-file=config.gcloud \
   --etag=ETAG
   

   Substitua o seguinte:

   • ORGANIZATION_ID: o ID da organização.
   • ETAG: o valor etag devolvido por recommender-config describe.

API

Para ver e atualizar as configurações do Recomendador, pode usar curl para enviar um pedido às APIs Recommender. Para autorizar pedidos a partir da linha de comandos, usa chaves de acesso de OAuth. Uma chave de acesso OAuth é uma string que concede acesso temporário a uma API.

Nota: se ainda não estiver familiarizado com os pré-requisitos de autenticação para chamar APIs, consulte a vista geral da autenticação.

Google Cloud

Visualizar configurações

1. Para ver as configurações do Recomendador de projetos sem supervisão para uma determinada organização, execute o seguinte comando a partir de um projeto pertencente a essa organização que tenha a API Recommender ativada:

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "x-goog-user-project: PROJECT_ID" \
   https://recommender.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do projeto.
   • ORGANIZATION_ID: o ID da organização.

2. Exemplo de resultado:

   
   {
     "name": "organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config",
     "recommenderGenerationConfig": {
       "params": {
         "minimum_observation_period": "P60D"
       }
     },
     "etag": ETAG,
     "updateTime": "2022-04-21T18:51:17.407255Z",
     "revisionId": "75c3b0d7"
   }
   
   

   Anote o valor ETAG:

   • ETAG: este valor vai ser usado em curl PATCH.

A atualizar as configurações

1. Para atualizar as configurações do Unattended Project Recommender para uma determinada organização, escolha um projeto pertencente a essa organização no qual ativou a API Recommender e crie um ficheiro request.json:

   
   {
     "name": "organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config",
     "recommenderGenerationConfig": {
       "params": {
         "minimum_observation_period": DURATION
       }
     },
   "etag": ETAG,
   }
   

   Substitua o seguinte:

   • DURATION: um valor de "P30D", "P60D", "P90D", "P180D", "P270D" ou "P365D"
   • ETAG: o valor etag devolvido por CURL get.

2. Execute a seguinte linha de comandos:

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "x-goog-user-project: PROJECT_ID" \
   -H "Content-Type: application/json; charset=utf-8" -d @request.json \
   https://recommender.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do projeto.
   • ORGANIZATION_ID: o ID da organização.

O que se segue?

• Encerrar (eliminar) projetos
• Eliminar projetos numa organização
• Metodologia de relatórios da pegada de carbono
• Tutorial interativo (abrir no Cloud Shell)