역할 추천 생성 구성

IAM 추천자 구성을 변경하여 역할 추천 생성 방식을 맞춤설정할 수 있습니다. 이 페이지에서는 구성을 수정하여 프로젝트에 대해 추천이 생성되는 속도를 변경하는 방법을 설명합니다.

IAM 추천자는 다양한 리소스에 대해 역할 추천을 생성하지만 프로젝트에 대한 역할 추천이 생성되는 방식만 수정할 수 있습니다.

시작하기 전에

Enable the Recommender API.
Enable the API
IAM 추천자가 역할 추천을 생성하는 방법 이해
Google Cloud CLI 설치

필요한 역할

IAM 역할 권장사항을 구성하는 데 필요한 권한을 얻으려면 관리자에게 IAM 추천자를 구성하려는 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

구성 세부정보 보기: IAM 추천자 뷰어(roles/recommender.iamViewer)
구성 수정: IAM 추천자 관리자(roles/recommender.iamAdmin)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 IAM 역할 권장사항을 구성하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

IAM 역할 권장사항을 구성하려면 다음 권한이 필요합니다.

구성 세부정보 보기: recommender.iamPolicyRecommenderConfig.get
구성 수정하기: recommender.iamPolicyRecommenderConfig.update

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

현재 구성 보기

현재 구성을 보고 IAM 추천자가 역할 추천을 생성하기 전에 기다리는 권한 사용 데이터의 일수를 확인합니다.

gcloud CLI 또는 REST API를 사용하여 구성을 볼 수 있습니다.

gcloud

프로젝트의 IAM 추천자 구성을 가져오려면 gcloud beta recommender recommender-config describe 명령어를 사용합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다.

gcloud beta recommender recommender-config describe 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud beta recommender recommender-config describe \
google.iam.policy.Recommender \
--project="PROJECT_ID" \
--location="global"

Windows(PowerShell)

gcloud beta recommender recommender-config describe `
google.iam.policy.Recommender `
--project="PROJECT_ID" `
--location="global"

Windows(cmd.exe)

gcloud beta recommender recommender-config describe ^
google.iam.policy.Recommender ^
--project="PROJECT_ID" ^
--location="global"

응답에는 프로젝트의 IAM 추천자 구성이 포함됩니다. 예를 들어 다음과 같을 수 있습니다.

etag: '"d3e779ee3f34f276"'
name: projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/config
recommenderGenerationConfig:
  params:
    minimum_observation_period: P90D
revisionId: DEFAULT
updateTime: '2022-10-02T22:57:33Z'

REST

프로젝트의 IAM 추천자 구성을 가져오려면 Recommender API의 projects.locations.recommenders.getConfig 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_NUMBER: Google Cloud 프로젝트의 숫자 ID
PROJECT_ID: Google Cloud 프로젝트 ID. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다.

HTTP 메서드 및 URL:

GET https://recommender.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://recommender.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://recommender.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config" | Select-Object -Expand Content

응답에는 프로젝트의 IAM 추천자 구성이 포함됩니다. 예를 들어 다음과 같을 수 있습니다.

{
  "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "minimum_observation_period": "P90D"
    }
  },
  "etag": "\"d3e779ee3f34f276\"",
  "updateTime": "2022-10-02T22:57:33Z",
  "revisionId": "DEFAULT"
}

구성 세부정보 이해

구성의 내용은 해당 구성의 추천자에 따라 달라집니다. IAM 추천자 구성에는 다음과 같은 구성요소가 있습니다(순서는 다름).

name: 구성의 식별자로, projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config 형식입니다.
recommenderGenerationConfig: IAM 추천자가 추천을 생성할 때 사용하는 매개변수입니다. 이 필드에는 다음 매개변수가 포함됩니다.
- minimum_observation_period: IAM 추천자가 역할 추천 생성을 시작하는 데 필요한 권한 사용 데이터의 일수입니다.
etag: 동시 실행 업데이트를 방지하는 데 사용되는 구성의 현재 상태에 대한 식별자입니다. 구성이 변경될 때마다 새 ETag 값이 할당됩니다.
updateTime: 구성이 업데이트된 가장 최근 시간의 타임스탬프(UTC 형식)(RFC 3339).
revisionId: 출력 전용. 구성의 현재 버전에 대한 식별자입니다. 이 값은 구성이 수정될 때마다 업데이트됩니다.

구성 수정

구성을 수정하여 프로젝트에 대해 추천이 생성되는 속도를 변경합니다.

gcloud

프로젝트의 IAM 추천자 구성을 수정하려면 gcloud beta recommender recommender-config update 명령어를 사용합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

OBSERVATION_PERIOD: 설정하려는 최소 관찰 기간입니다. P30D(30일), P60D(60일), P90D(90일) 중 하나를 사용합니다.
ETAG: 구성의 현재 etag로, 현재 구성을 가져오고 응답의 etag 필드 값을 복사하여 확인할 수 있습니다.
PROJECT_ID: Google Cloud 프로젝트 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다.

다음 콘텐츠를 request.json 파일에 저장합니다.

{
  "params": {
    "minimum_observation_period": "OBSERVATION_PERIOD"
  }
}

gcloud beta recommender recommender-config update 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud beta recommender recommender-config update \
google.iam.policy.Recommender \
--etag="ETAG" \
--project="PROJECT_ID" \
--location="global" \
--config-file="request.json"

Windows(PowerShell)

gcloud beta recommender recommender-config update `
google.iam.policy.Recommender `
--etag="ETAG" `
--project="PROJECT_ID" `
--location="global" `
--config-file="request.json"

Windows(cmd.exe)

gcloud beta recommender recommender-config update ^
google.iam.policy.Recommender ^
--etag="ETAG" ^
--project="PROJECT_ID" ^
--location="global" ^
--config-file="request.json"

응답에는 업데이트된 구성이 포함됩니다. 예를 들어 다음과 같을 수 있습니다.

etag: '"2549af0942332910"'
name: projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/config
recommenderGenerationConfig:
  params:
    minimum_observation_period: P60D
revisionId: 288c60eb
updateTime: '2022-10-05T21:42:21.069170Z'

REST

프로젝트의 IAM 추천자 구성을 수정하려면 Recommender API의 projects.locations.recommenders.updateConfig 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_NUMBER: Google Cloud 프로젝트의 숫자 ID
OBSERVATION_PERIOD: 설정하려는 최소 관찰 기간입니다. P30D(30일), P60D(60일), P90D(90일) 중 하나를 사용합니다.
ETAG: 구성의 현재 etag로, 현재 구성을 가져오고 응답의 etag 필드 값을 복사하여 확인할 수 있습니다. 백슬래시를 사용하여 따옴표를 이스케이프 처리합니다(예: "\"df7308cca9719dcc\"").
PROJECT_ID: Google Cloud 프로젝트 ID. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다.

HTTP 메서드 및 URL:

PATCH https://recommender.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config

JSON 요청 본문:

{
  "name": "projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "minimum_observation_period": "OBSERVATION_PERIOD"
    }
  },
  "etag": "ETAG"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth 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/projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recommender.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config" | Select-Object -Expand Content

API 탐색기(브라우저)

요청 본문을 복사하고 메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 요청 본문을 이 도구에 붙여넣고 다른 필수 필드를 입력한 후 실행을 클릭합니다.

응답에는 업데이트된 구성이 포함됩니다. 예를 들어 다음과 같을 수 있습니다.

{
  "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "minimum_observation_period": "P60D"
    }
  },
  "etag": "\"2549af0942332910\"",
  "updateTime": "2022-10-05T21:26:52.127512Z",
  "revisionId": "b5fc0053"
}

역할 추천 생성 구성

시작하기 전에

필요한 역할

필수 권한

현재 구성 보기

gcloud

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

구성 세부정보 이해

구성 수정

gcloud

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

API 탐색기(브라우저)

다음 단계