무인 프로젝트 추천자

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

개요

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

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

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

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

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

작동 방식

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

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

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

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

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

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

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

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

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

프로젝트의 사용률 통계 콘텐츠는 프로젝트의 사용 활동 순위를 지정하고 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일 동안의 사용 가능한 데이터를 기반으로 계산된 이 프로젝트로 인한 탄소 배출량의 일일 평균입니다.

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

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

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

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

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

가격 책정

이 추천자는 표준 추천자 가격 책정 등급에 해당됩니다. 가격 책정 등급에 대한 자세한 내용은 추천자 가격 책정을 참조하세요.

시작하기 전에

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

  • 추천자 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입니다.
  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 Platform 결제 계정 ID입니다.

통계

  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 Platform 결제 계정 ID입니다.

API

권장사항 및 통계를 보려면 curl을 사용하여 추천자 API에 요청을 보내면 됩니다. 명령줄에서 요청을 승인하려면 OAuth 액세스 토큰을 사용합니다. OAuth 액세스 토큰은 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
  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 Platform 결제 계정 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 Platform 결제 계정 ID입니다.

권장사항 매개변수 구성

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

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

매개변수 설명 필요한 값
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에 대한 임시 액세스 권한을 부여하는 문자열입니다.

구성 보기

  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입니다.

다음 단계