지원 중단된 IAM 권한

다음 Identity and Access Management (IAM) 권한은 2026년 4월 8일에 지원 중단되고 Gemini Cloud Assist에서 종료됩니다.

  • cloudaicompanion.instances.completeTask

이 변경사항에 대비하려면 다음 단계를 수행합니다.

  1. Gemini for Google Cloud API에 대한 액세스를 제어하는 커스텀 IAM 역할을 식별합니다.

    1. Google Cloud 콘솔에서 역할 페이지로 이동합니다.

      역할로 이동

    2. Google Cloud 콘솔 툴바의 목록에서 조직이나 프로젝트를 선택합니다.

    3. 역할 권한을 보려면 역할 체크박스 하나 이상을 선택합니다. 역할에 포함된 권한이 인접한 창에 표시됩니다.

      유형 열의 아이콘은 커스텀 역할 또는 사전 정의된 역할

      역할 유형 아이콘

      cloudaicompanion.instances.completeTask 권한이 포함된 역할을 모두 찾으려면 역할 목록 상단에 있는 필터 필드에 권한 이름 (cloudaicompanion.instances.completeTask)을 입력합니다.

  2. 새 권한을 추가합니다. 2026년 4월 8일 전에 다음 Google Cloud CLI 명령어를 사용하여 커스텀 역할에 geminicloudassist.agents.invoke 권한을 추가합니다.

      gcloud iam roles update ROLE_ID \
    --project="PROJECT_ID" \
    --add-permissions="geminicloudassist.agents.invoke"

    다음 값을 바꿉니다.

    • ROLE_ID: 업데이트하려는 맞춤 역할의 ID입니다.

    • PROJECT_ID: 맞춤 역할이 정의된 프로젝트의 ID입니다.

    맞춤 역할이 업데이트되면 해당 맞춤 역할이 부여된 모든 사용자, 그룹, 서비스 계정이 geminicloudassist.agents.invoke 권한을 자동으로 상속합니다.

  3. 이전 권한을 유지합니다. 2026년 4월 8일까지 커스텀 역할에서 다음 권한을 유지합니다.

    • cloudaicompanion.instances.completeTask

2026년 4월 8일 이후에는 Gemini Cloud Assist에서 이전 권한을 더 이상 사용하지 않습니다. BigQuery의 Gemini 또는 Gemini Code Assist와 같은 다른 Gemini 서비스를 사용하는 경우 맞춤 역할에서 이 권한을 유지해야 할 수 있습니다.

커스텀 역할을 업데이트하는 방법에 대한 자세한 내용은 커스텀 역할 만들기 및 관리를 참조하세요.