무인 프로젝트 추천자

무인 프로젝트 추천자는 조직의 프로젝트에서 사용 활동을 분석하고 무인 프로젝트를 탐색, 확보 또는 삭제하는 데 도움이 되는 권장사항을 제공합니다.

개요

빠르게 변화하는 조직에서는 전체 프로젝트를 포함한 클라우드 리소스가 종종 잊혀지는 경우가 많습니다. 이러한 미사용 리소스는 식별하기 어렵고 불필요한 낭비와 보안 위험을 야기할 수 있습니다.

미사용 프로젝트 추천자는 조직의 모든 프로젝트에서 사용 활동을 분석하고 미사용 프로젝트를 탐색, 회수, 종료할 수 있는 다음 기능을 제공합니다.

• 모든 프로젝트의 사용량 통계(네트워킹, API, 프로젝트 소유자, 서비스 활동 등)
• 사용 활동이 적은 프로젝트를 종료하기 위한 권장사항
• 사용 활동이 많지만 활성 소유자가 없는 프로젝트에 새 소유자를 할당하기 위한 권장사항

미사용 프로젝트를 종료하거나 회수하면 조직에 다음과 같은 영향 및 이점이 발생할 수 있습니다.

• 보안 위험 감소(SECURITY)
• 불필요한 지출 감소(COST)
• 워크로드와 관련된 탄소 발자국 감소(SUSTAINABILITY)

참고: Google Cloud 조직에 할당된 프로젝트에만 프로젝트 무인 추천자는 사용할 수 있습니다.

작동 방식

미사용 프로젝트 추천자는 지난 30일 동안의 프로젝트 사용량을 분석합니다. 다음 표에는 사용 활동 비율이 높은지 낮은지에 따라 미사용 프로젝트 추천자가 생성할 수 있는 권장사항 및 통계가 나와 있습니다.

프로젝트 사용량/유형	통계 하위유형	권장사항	권장사항 하위유형
다음에 해당하는 프로젝트: 지난 30일 동안 사용량이 낮음	PROJECT_ACTIVITY	프로젝트를 검토하거나 삭제합니다.	CLEANUP_PROJECT
다음에 해당하는 프로젝트: 지난 30일 동안 사용량이 높음 사용자 소유자가 할당되었지만 프로젝트에서 활성 상태가 아님.	PROJECT_ACTIVITY	새 소유자를 할당하여 프로젝트를 회수합니다.	RECLAIM_PROJECT
Apps Script가 아닌 다른 모든 프로젝트	PROJECT_ACTIVITY	-	-

참고 무인 프로젝트 추천자는 Apps Script에 대한 통계 또는 권장사항을 생성하지 않습니다. 해당 프로젝트는 연결된 스크립트를 삭제하면 자동으로 삭제되기 때문입니다.

권장사항 및 통계는 클라우드 조직 계층 구조의 여러 수준에서 제공됩니다. 이러한 권장사항 및 통계에 액세스하려면 해당 수준에서 IAM 역할 binding이 필요합니다.

• 프로젝트 수준: 프로젝트 소유자는 액세스 권한이 있는 프로젝트에 대한 통계와 권장사항을 검색하고 조치를 취할 수 있습니다.
• 조직 수준: 조직 관리자는 클라우드 조직 내 프로젝트에 대한 통계와 권장사항을 검색하고 조치를 취할 수 있습니다.
• 결제 계정 수준: 결제 관리자는 특정 결제 계정과 연결된 프로젝트에 대한 통계와 권장사항을 검색하고 조치를 취할 수 있습니다.

참고: 조직 또는 결제 계정당 통계 및 권장사항 수는 현재 10,000개로 제한됩니다. 조직 또는 결제 계정에 10,000개 이상의 프로젝트가 있고 전체 권장사항 및 통계 집합을 검토하려면 프로젝트 수준의 통계 및 권장사항에 의존하거나 통계 및 권장사항의 BigQuery 내보내기를 사용하는 것이 좋습니다.

프로젝트의 사용 활동 순위 지정

제공된 권장사항에 따라 프로젝트의 사용 활동이 낮거나 높게 순위를 지정할 수 있습니다. 프로젝트의 사용 활동 순위는 프로젝트 사용률 통계에 포함된 콘텐츠를 기준으로 계산됩니다.

사용 활동이 저조한 것으로 확인된 프로젝트에는 다음 조건이 적용됩니다.

사용량 분류	조건
프로젝트가 50개를 초과하는 조직	프로젝트 사용률 통계에 포함된 모든 콘텐츠의 사용 활동 수준을 기준으로 프로젝트 순위가 결정됩니다. 프로젝트가 조직의 다른 모든 프로젝트와 비교하여 사용 활동의 10% 이내인 경우 자동으로 무인 프로젝트로 분류됩니다.
프로젝트가 50개 미만인 조직	프로젝트에서 사용한 API 호출의 일일 평균(consumedApiDailyCount)이 100회 미만입니다. Cloud Logging이 프로젝트에서 사용되는 유일한 서비스입니다. 다른 모든 프로젝트 사용률 통계의 값이 0입니다.

참고: 30일이 지난 프로젝트에만 권장사항이 제공됩니다.

권장사항 우선순위 및 영향

미사용 프로젝트 권장사항에는 이를 적용할 때의 이점에 대한 우선순위를 지정하고 이를 예상하는 데 도움이 되는 다음 필드가 포함됩니다.

• priority - P1에서 P4 사이의 우선순위 값으로, P1이 가장 높은 우선순위입니다.
• primaryImpact - SECURITY. 미사용 프로젝트의 우선순위가 높은 보안 권장사항 수입니다.
• additionalImpact(s) - COST 및 SUSTAINABILITY. 프로젝트가 삭제된 경우 실현될 비용($) 및 지속 가능성 탄소 배출량(kgCO₂e) 감소

권장사항 우선순위

미사용 프로젝트 권장사항의 우선순위는 P1에서 P4까지이며, P1이 가장 높은 우선순위입니다.

추천자는 각 미사용 프로젝트의 보안 권장사항을 검토하여 시작합니다. 여기에서 미사용 프로젝트 권장사항의 우선순위를 프로젝트 내에서 찾은 가장 높은 우선순위 권장사항과 동일하게 설정합니다. 예를 들어 미사용 프로젝트에 10개의 보안 권장사항, 8개의 P2 권장사항, 2개의 P1 권장사항이 있는 경우 미사용 프로젝트 권장사항에는 P1의 우선순위 값이 할당됩니다.

미사용 프로젝트에서 가장 자주 발생하는 보안 권장사항은 IAM 추천자에서 가져옵니다. 우선순위가 P1인 미사용 프로젝트 권장사항은 미사용 프로젝트에 공개적으로 액세스 가능한 클라우드 스토리지 버킷이 있음을 의미합니다(IAM 추천자가 우선순위를 설정하는 방법에 대해 자세히 알아보기).

보안에 미치는 영향

primaryImpact - SECURITY 필드는 미사용 프로젝트에서 우선순위가 높은(P2 이상) 보안 권장사항 수와 동일한 securityProjection을 제공합니다. 예를 들어 프로젝트에 광범위한 편집자 역할을 더 세분화된 역할로 대체하는 권장사항이 있는 경우 해당 권장사항은 P2 우선순위를 가지며 priorityRecommendationCount에서 계산됩니다.

비용 영향

additionalImpact - COST 필드는 미사용 프로젝트가 삭제된 경우에 대한 예상 비용 절감액인 costProjection을 제공합니다. 이는 지난 30일 동안 미사용 프로젝트에서 실행된 리소스로 인해 발생한 비용을 기준으로 합니다.

참고: 비용 예상치의 커스텀 가격을 보려면 연결된 Cloud Billing 계정이 지난 30일 동안 변경되지 않고 사용자에게 결제 권한이 있어야 합니다.

지속 가능성 영향

additionalImpact - SUSTAINABILITY 필드는 지난 30일 동안 미사용 프로젝트에서 실행되는 리소스에 의해 발생한 탄소 배출의 추정치인 sustainabilityProjection를 제공합니다. 추정치는 이산화탄소 킬로그램(kgCO₂e)으로 측정됩니다.

프로젝트 사용률 통계 콘텐츠

프로젝트의 사용률 통계 콘텐츠는 프로젝트의 사용 활동 순위를 지정하고 CLEANUP_PROJECT 또는 RECLAIM_PROJECT 권장사항을 생성하는 데 사용되는 필드 값입니다.

경고: 프로젝트 사용률 통계는 프로젝트가 프로젝트 미사용 여부에 관계없이 모든 프로젝트에 대해 생성됩니다. 이러한 통계는 매일 생성됩니다. 단일 통계는 미사용으로 간주되는 프로젝트에 대해 신뢰할 수 있는 지표가 아닙니다. 일일 통계를 바탕으로 프로젝트를 삭제하지 마세요.

다음 표에는 PROJECT_ACTIVITY 통계의 일부로 추천자가 표시하는 다양한 필드가 나와 있습니다.

필드	설명
사용량 수준
usagePercentile	동일한 조직의 다른 프로젝트와 비교한 이 프로젝트의 사용량 수준 백분위수입니다. 백분위수가 -1이면 값이 계산되지 않습니다. 조직에 프로젝트가 50개 미만 있으면 값이 계산되지 않습니다.
API 활동
activeServiceAccountDailyCount	이 프로젝트에 인증 활동이 있는 서비스 계정의 일일 평균입니다.
apiClientDailyCount	이 프로젝트에서 생성된 API 호출의 개별 클라이언트의 일일 평균입니다.
consumedApiDailyCount	이 프로젝트에서 사용한 API 호출의 일일 평균입니다.
datastoreApiDailyCount	이 프로젝트에서 사용한 Datastore API 일일 평균입니다.
네트워킹 활동
vpcEgressDailyBytes	이 프로젝트에서 전송된 VPC 이그레스 바이트의 일일 평균입니다.
vpcIngressDailyBytes	이 프로젝트로 전송된 VPC 인그레스 바이트의 일일 평균
결제 사용량
hasBillingAccount	관찰이 끝날 때 프로젝트에 결제 계정이 있는지 확인합니다.
serviceWithBillableUsage	지난 30일 동안 사용된 청구 가능한 서비스의 이름입니다.
클라우드 서비스 사용량
activeAppengineInstanceDailyCount: system/instance_count	이 프로젝트에 있는 활성 App Engine 인스턴스 수의 일일 평균입니다.
activeCloudsqlInstanceDailyCount	이 프로젝트의 활성 Cloud SQL 인스턴스 수에 대한 일일 평균입니다.
activeGceInstanceDailyCount	이 프로젝트에 있는 활성 Compute Engine 인스턴스의 일일 평균입니다.
bigqueryInflightJobDailyCount	이 프로젝트에서 진행 중인 BigQuery 작업의 일일 평균입니다.
bigqueryInflightQueryDailyCount	이 프로젝트에서 진행 중인 BigQuery 쿼리 수의 일일 평균입니다.
bigqueryStorageDailyBytes	이 프로젝트에서 진행 중인 BigQuery 스토리지의 일일 평균입니다.
bigqueryTableDailyCount	이 프로젝트의 BigQuery 테이블 수의 일일 평균입니다.
gcsObjectDailyCount	이 프로젝트의 Cloud Storage 객체 수의 일일 평균입니다.
gcsRequestDailyCount	이 프로젝트의 Cloud Storage API 수의 일일 평균입니다.
gcsStorageDailyBytes	이 프로젝트의 Cloud Storage가 사용하는 스토리지 바이트의 일일 평균입니다.
사용자 활동
numActiveUserOwners	관찰 기간이 끝날 때 활성 사용자 유형 프로젝트 소유자 수입니다. 활성은 사용자 계정이 사용 중지되지 않았으며 관찰 기간 동안 이 프로젝트에서 일부 활동이 확인되었음을 의미합니다.
owners	프로젝트 소유자 및 활동 목록
기타 필드
hasActiveOauthTokens	지난 180일 동안 사용된 활성 OAuth 토큰이 프로젝트에 있는지 확인합니다.
carbonFootprintDailyKgCO2	최근 30일 동안의 사용 가능한 데이터를 기반으로 계산된 이 프로젝트로 인한 탄소 배출량의 일일 평균입니다.
costProjection	프로젝트가 삭제된 경우 지정된 기간 동안 예상되는 비용 절감액입니다. 결제 계정 권한에 따라 커스텀 가격 또는 정가가 표시됩니다. 지난 30일간의 사용 가능한 데이터를 기반으로 한 추정치이며 청구서를 구성하지 않습니다.
severity	severity는 프로젝트에서 찾은 가장 높은 심각도 보안 통계의 해당 값으로 설정됩니다. 예를 들어 IAM 추천자에서 통계의 심각도를 설정하는 방식을 기준으로 미사용 프로젝트 통계의 CRITICAL 심각도는 미사용 프로젝트에 공개적으로 액세스할 수 있는 클라우드 스토리지 버킷이 있음을 의미할 수 있습니다.

프로젝트 삭제를 위한 권장사항

지난 30일 동안 사용량이 적으며 또한 지난 180일 동안 사용된 OAuth 토큰이 없으면 프로젝트를 삭제하는 것이 좋습니다.

경고: 프로젝트와 관련된 사용률 통계를 신중하게 검토하세요. 프로젝트를 삭제하면 되돌릴 수 없는 데이터 손실이 발생할 수 있습니다. 자세한 내용은 프로젝트 종료(삭제)를 참조하세요.

주의: 테넌트 프로젝트에 대한 권장사항이 제공됩니다. 이 프로젝트를 삭제하면 해당 프로젝트에 캡처되지 않은 추가 프로젝트 사용률 필드로 인해 데이터 손실이 발생할 수 있습니다.

프로젝트에 새 소유자를 할당하기 위한 권장사항

프로젝트가 아래 나열된 모든 조건을 충족하는 경우 새 소유자를 프로젝트에 할당하는 것이 좋습니다.

• 할당된 모든 소유자는 지난 90일 동안 프로젝트에서 비활성 상태이거나 회사와 관계가 없습니다.
• 프로젝트의 사용 활동이 높습니다.

참고: 프로젝트에 할당된 사용자 소유자가 없는 경우 RECLAIM_PROJECT 권장사항이 제공되지 않은 의도된 동작으로 간주됩니다.

가격 책정

Active Assist 가격 책정에 대한 자세한 내용은 추천자 가격 책정을 참조하세요.

시작하기 전에

통계와 권장사항을 보려면 먼저 다음을 수행해야 합니다.

• 추천자 API를 사용 설정해야 합니다. 단일 결제 프로젝트에서만 API를 사용 설정하면 됩니다. 그런 후 동일한 결제 프로젝트를 사용하고 gcloud/API의 --billing-project 기능을 사용해서 다른 프로젝트, 전체 조직 또는 결제 계정에 대한 권장사항 및 통계를 검토할 수 있습니다.
• 다음의 필수 역할 중 하나가 할당되었는지 확인합니다.

설명	역할
추천 보기	recommender.projectUtilViewer
권장사항 보기 및 업데이트	recommender.projectUtilAdmin
투명성 및 제어 센터 관련 통계와 권장사항 선택 해제	dataprocessing.admin

이러한 역할은 통계 및 권장사항에 액세스할 수 있는 권한 집합을 제공합니다. 역할에 대한 자세한 내용은 역할 이해 및 IAM 권한 부여를 참조하세요.

조직 수준에서 이러한 역할을 부여하면 조직 수준 API를 사용하여 개별적 또는 집합적으로(조직의 모든 미사용 프로젝트) 조직의 프로젝트에 대한 권장사항 및 통찰력에 액세스할 수 있습니다.

결제 계정 수준에서 이러한 역할을 부여하면 지정된 결제 계정을 사용하는 프로젝트에 대한 권장사항 및 통계에 액세스할 수 있습니다.

선택 해제 방법에 대한 자세한 내용은 통계 및 권장사항 선택 해제를 참조하세요.

추천자 ID

다음은 미사용 프로젝트 추천자 ID 및 통계 유형입니다.

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

필수 IAM 권한

권장사항 및 통계 목록에 액세스하려면 다음 권한이 필요합니다.

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

권장사항 및 통계를 업데이트하려면(예: 권장사항 닫기) 다음 권한이 필요합니다.

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

무인 프로젝트 권장사항 보기

이 섹션에서는 gcloud를 사용하여 무인 통계와 권장사항을 확인하고 curl을 사용하여 추천자 API에 요청을 보내는 방법을 설명합니다.

gcloud

gcloud를 사용하여 권장사항 및 통계를 보려면 아래 단계를 따르세요. 자세한 내용은 API 사용 - 통계 및 API 사용 - 권장사항을 참조하세요.

권장사항

1. Recommender API를 사용 설정한 프로젝트에 대한 무인 프로젝트 권장사항을 나열하려면 다음 명령어를 실행하세요.

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

   다음을 바꿉니다.

   • PROJECT_ID: 프로젝트 ID입니다.

2. 이전 단계에서처럼 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 다른 프로젝트에서 무인 프로젝트 권장사항을 나열하려면 다음 명령어를 실행합니다.

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

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API를 통해 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 PROJECT_ID와 동일함).
   • PROJECT_ID: 미사용 프로젝트 권장사항을 보려는 다른 프로젝트의 ID입니다.
   참고: 명령어가 권장사항을 반환하지 않으면 프로젝트가 무인 상태가 아니거나 30일 이상 진행되지 않았음을 의미합니다.

3. 이전 단계에서와 같이 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 전체 조직에 대한 미사용 프로젝트 권장사항을 나열하려면 다음 명령어를 실행합니다.

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

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API로 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 것과 동일한 PROJECT_ID).
   • ORGANIZATION_ID: 미사용 프로젝트 권장사항을 보려는 조직의 ID입니다.

4. 이전 단계에서와 같이 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 특정 결제 계정을 사용하는 미사용 프로젝트 권장사항을 나열하려면 다음 명령어를 실행합니다.

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

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API로 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 것과 동일한 PROJECT_ID).
   • BILLING_ACCOUNT_ID: Google Cloud Billing 계정의 ID입니다.

참고: --format=yaml 플래그를 끝에 추가하여 list 명령어에서 권장사항의 세부정보를 펼칠 수 있습니다.

통계

1. 특정 프로젝트의 사용량 통계를 나열하려면 다음 명령어를 실행합니다.

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

   다음을 바꿉니다.

   • PROJECT_ID: 프로젝트 ID입니다.

2. 이전 단계에서처럼 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 다른 프로젝트의 사용량 통계를 나열하려면 다음 명령어를 실행합니다.

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

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API를 통해 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 PROJECT_ID와 동일함).
   • PROJECT_ID: 무인 추천자 통계를 보려는 다른 프로젝트의 ID입니다.

3. 이전 단계에서와 같이 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 전체 조직에 대한 사용량 통계를 나열하려면 다음 명령어를 실행합니다.

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

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API로 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 것과 동일한 PROJECT_ID).
   • ORGANIZATION_ID: 사용량 통계를 보려는 조직의 ID입니다.

4. 이전 단계에서와 같이 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 특정 결제 계정을 사용하는 사용량 통계를 나열하려면 다음 명령어를 실행합니다.

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

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API로 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 것과 동일한 PROJECT_ID).
   • BILLING_ACCOUNT_ID: Google Cloud Billing 계정의 ID입니다.

참고: --format=yaml 플래그를 끝에 추가하여 list 명령어에서 통계 세부정보를 펼칠 수 있습니다.

API

권장사항 및 통계를 보려면 curl을 사용하여 추천자 API에 요청을 보내면 됩니다. 명령줄에서 요청을 승인하려면 OAuth 액세스 토큰을 사용합니다. OAuth 액세스 토큰은 API에 대한 임시 액세스 권한을 부여하는 문자열입니다.

참고:Google Cloud API 호출을 위한 인증 기본 요건에 대해 잘 모른다면 인증 개요를 참조하세요.

권장사항

1. Recommender API를 사용 설정한 프로젝트에 대한 무인 프로젝트 권장사항을 나열하려면 다음 명령어를 실행하세요.

   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"
   

   다음을 바꿉니다.

   • PROJECT_ID`: 프로젝트 ID
   참고: API 호출이 권장사항을 반환하지 않으면 프로젝트가 무인 상태가 아니거나 30일 이상 진행되지 않았음을 의미합니다.

2. 이전 단계에서처럼 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 다른 프로젝트에서 무인 프로젝트 권장사항을 나열하려면 다음 명령어를 실행합니다.

   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"
   

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API를 통해 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 PROJECT_ID와 동일함).
   • PROJECT_ID: 미사용 프로젝트 권장사항을 보려는 다른 프로젝트의 ID입니다.

3. 이전 단계에서와 같이 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 전체 조직에 대한 미사용 프로젝트 권장사항을 나열하려면 다음 명령어를 실행합니다.

   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"
   

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API를 통해 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 PROJECT_ID와 동일함).
   • ORGANIZATION_ID: 미사용 프로젝트 권장사항을 보려는 조직의 ID입니다.

4. 이전 단계에서와 같이 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 특정 결제 계정을 사용하는 미사용 프로젝트 권장사항을 나열하려면 다음 명령어를 실행합니다.

   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"
   

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API를 통해 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 PROJECT_ID와 동일함).
   • BILLING_ACCOUNT_ID: Google Cloud Billing 계정의 ID입니다.

통계

1. 특정 프로젝트의 사용량 통계를 나열하려면 다음 명령어를 실행합니다.

   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"
   

   다음을 바꿉니다.

   • PROJECT_ID`: 프로젝트 ID

2. 이전 단계에서처럼 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 다른 프로젝트의 사용량 통계를 나열하려면 다음 명령어를 실행합니다.

   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"
   

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API를 통해 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 PROJECT_ID와 동일함).
   • PROJECT_ID: 무인 추천자 통계를 보려는 다른 프로젝트의 ID입니다.

3. 이전 단계에서와 같이 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 전체 조직에 대한 사용량 통계를 나열하려면 다음 명령어를 실행합니다.

   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"
   

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API를 통해 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 PROJECT_ID와 동일함).
   • ORGANIZATION_ID: 미사용 프로젝트 권장사항을 보려는 조직의 ID입니다.

4. 이전 단계에서와 같이 Recommender API를 사용 설정한 프로젝트를 사용하는 동안 특정 결제 계정을 사용하는 사용량 통계를 나열하려면 다음 명령어를 실행합니다.

   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"
   

   다음을 바꿉니다.

   • BILLING_PROJECT_ID: Recommender API를 통해 사용 설정한 프로젝트의 ID입니다(이전 단계에서 제공된 PROJECT_ID와 동일함).
   • BILLING_ACCOUNT_ID: Google Cloud Billing 계정의 ID입니다.

권장사항 매개변수 구성

이 섹션에서는 gcloud 및 curl을 사용하여 이 추천자를 보고 구성하는 방법을 설명합니다.

다음 표에는 구성할 수 있는 다양한 매개변수가 나열되어 있습니다.

매개변수	설명	필요한 값
minimum_observation_period	최소 관찰 기간은 권장사항이 생성되기 전에 분석할 프로젝트 활동 일수를 정의합니다. 이 값은 현재 조직 수준에서만 설정할 수 있습니다.	'P30D'[[DEFAULT], 'P60D', 'P90D', 'P180D', 'P270D', 'P365D'

gcloud

gcloud를 사용하여 추천자 구성을 보고 업데이트하려면 아래 단계를 따르세요.

구성 보기

1. 특정 조직의 미사용 프로젝트 추천자 구성을 보려면 Recommender API가 사용 설정된 해당 조직에 속한 프로젝트에서 다음 명령어를 실행하세요.

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

   다음을 바꿉니다.

   • ORGANIZATION_ID: 조직 ID입니다.

2. 결과 예:

   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'
   

   ETAG 값을 살펴보세요.

   • ETAG: 이 값은 recommender-config update에 사용됩니다.

구성 업데이트

1. 특정 조직의 미사용 프로젝트 추천자 구성을 업데이트하려면 Recommender API를 사용 설정한 해당 조직에 속한 프로젝트를 선택하고 config.gcloud 파일을 만듭니다.

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

   다음을 바꿉니다.

   • DURATION: 'P30D', 'P60D', 'P90D', 'P180D', 'P270D', 'P365D' 중 하나의 값입니다.

2. 다음 명령어를 실행합니다.

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

   다음을 바꿉니다.

   • ORGANIZATION_ID: 조직 ID입니다.
   • ETAG: recommender-config describe에서 반환된 etag 값입니다.

API

추천자 구성을 보고 업데이트하려면 curl을 사용하여 Recommender API에 요청을 보내면 됩니다. 명령줄에서 요청을 승인하려면 OAuth 액세스 토큰을 사용합니다. OAuth 액세스 토큰은 API에 대한 임시 액세스 권한을 부여하는 문자열입니다.

참고:Google Cloud API 호출을 위한 인증 기본 요건에 대해 잘 모른다면 인증 개요를 참조하세요.

구성 보기

1. 특정 조직의 미사용 프로젝트 추천자 구성을 보려면 Recommender API가 사용 설정된 해당 조직에 속한 프로젝트에서 다음 명령어를 실행하세요.

   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
   

   다음을 바꿉니다.

   • PROJECT_ID: 프로젝트 ID입니다.
   • ORGANIZATION_ID: 조직 ID입니다.

2. 명령어 결과

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

   ETAG 값을 살펴보세요.

   • ETAG: 이 값은 curl PATCH에 사용됩니다.

구성 업데이트

1. 특정 조직의 미사용 프로젝트 추천자 구성을 업데이트하려면 Recommender API를 사용 설정한 해당 조직에 속한 프로젝트를 선택하고 request.json 파일을 만듭니다.

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

   다음을 바꿉니다.

   • DURATION: 'P30D', 'P60D', 'P90D', 'P180D', 'P270D', 'P365D' 중 하나의 값입니다.
   • ETAG: CURL get에서 반환된 etag 값입니다.

2. 다음 명령줄을 실행합니다.

   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
   

   다음을 바꿉니다.

   • PROJECT_ID: 프로젝트 ID입니다.
   • ORGANIZATION_ID: 조직 ID입니다.

다음 단계

• 프로젝트 종료(삭제)
• 조직의 프로젝트 삭제
• 탄소 배출량 보고 방법
• 대화형 튜토리얼(Cloud Shell에서 열기)