이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Gemini Code Assist 라이선스 관리

Gemini Code Assist를 사용하려면 조직의 각 사용자에게 라이선스가 필요합니다.

기본적으로 새 구독에서는 라이선스를 수동으로 할당해야 합니다. 특정 Google Cloud용 Gemini 제품을 설정한 후 라이선스를 수동으로 또는 자동으로 할당하도록 선택할 수 있습니다.

시작하기 전에

다음 섹션에 설명된 특정 라이선스 관리 태스크에 필요한 추가 권한을 결제 계정에 부여할 수 있도록 결제 계정 관리자(roles/billing.admin) 또는 소비자 조달 주문 관리자(roles/consumerprocurement.orderAdmin) IAM 역할을 보유하고 있는지 확인합니다.

Google Cloud 콘솔이 아닌 API를 사용하여 라이선스를 관리하려면 다음을 확인합니다.
- 결제 계정에 할당량 프로젝트를 설정합니다.
- 할당량 프로젝트에서 Cloud Commerce Consumer Procurement API를 사용 설정합니다.
- 모든 API 호출에 다음 헤더 키-값 쌍이 있는지 확인합니다.
  - Authorization: Google Cloud CLI의 Google Cloud 액세스 토큰
  - x-goog-user-project: 할당량 프로젝트의 프로젝트 ID

구독에서 Gemini Code Assist 라이선스 수 변경

Google Cloud 콘솔 또는 Google 계정 담당자나 공인 리셀러를 통해 직접 Google Cloud를 위한 Gemini 라이선스 수를 추가하거나 삭제할 수 있습니다.

구독에서 라이선스 수를 변경하려면 다음 단계를 수행합니다.

구독을 소유한 결제 계정에 다음 Identity and Access Management (IAM) 권한이 있는지 확인합니다.
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.orders.modify
- resourcemanager.projects.get
Google Cloud 콘솔에서 Gemini 관리자 페이지로 이동합니다.

Gemini 관리자로 이동
변경하려는 구독을 선택한 다음 구독 수정을 선택합니다.
원하는 라이선스 수를 입력합니다. 다음 정보가 표시됩니다.
- 구매 후 총 라이선스 수입니다.
- 구매 후 할당할 수 있는 라이선스 수입니다.
- 기간별 새 구독 가격입니다. 추가된 라이선스의 추가 금액은 현재 기간 중 남은 기간을 기준으로 일할 계산됩니다.
저장을 선택합니다.

Gemini Code Assist 라이선스 할당 보기

다음 옵션 중 하나를 선택합니다.

콘솔

정기 결제를 소유한 결제 계정에 다음 IAM 권한이 있는지 확인합니다.
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- resourcemanager.projects.get
Gemini 관리자 페이지로 이동합니다.

Gemini 관리자로 이동
변경하려는 구독을 선택한 다음 구독 수정을 선택합니다.

라이선스가 할당된 각 사용자의 다음 정보를 확인할 수 있습니다.
- 이름
- 이메일
- 계정 유형
- 할당된 라이선스
특정 사용자 집합을 찾으려면 다음과 같이 목록을 필터링하고 정렬하면 됩니다.
- 목록을 필터링하려면 필터 필드에 속성과 값을 입력합니다.
- 목록을 정렬하려면 정렬 기준으로 사용할 열의 제목을 선택합니다. 예를 들어 사용자 이름별로 알파벳순으로 정렬하려면 이름 열 제목을 선택합니다.

API

Gemini Code Assist 라이선스 할당을 보려면 billingAccounts.orders.licensePool.enumerateLicensedUsers 메서드를 사용합니다.

이 작업을 수행하려면 정기 결제를 소유한 결제 계정에 대한 consumerprocurement.licensePools.enumerateLicensedUsers 권한이 있어야 합니다.

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

다음을 바꿉니다.

BILLING_ACCOUNT_ID: 결제 계정 ID
ORDER_ID: IAM 정책

이 명령어가 성공하면 licensedUsers 출력을 다음 형식으로 반환합니다.

{
  "licensedUsers": [
      {
          "username": "dana@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "lee@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "taylor@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "bola@example.com",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

개별 사용자에게 Gemini Code Assist 라이선스 수동 할당

다음 옵션 중 하나를 선택합니다.

콘솔

정기 결제를 소유한 결제 계정에 다음 IAM 권한이 있는지 확인합니다.
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- consumerprocurement.licensePools.assign
- resourcemanager.projects.get
Gemini 관리자 페이지로 이동합니다.

Gemini 관리자로 이동
Gemini Code Assist 관리를 선택한 다음 구독 수정을 선택합니다.
이 Gemini Code Assist 구독의 경우 라이선스 할당을 라이선스 수동 할당으로 설정해야 합니다. Gemini Code Assist 구독이 라이선스 자동 할당으로 설정된 경우 개별 라이선스를 관리할 수 없습니다. 이 결제 계정을 라이선스 수동 할당으로 전환하면 변경 후 자동 라이선스 할당이 사용 중지되지만 기존 라이선스 할당은 영향을 받지 않습니다.
라이선스 할당을 선택합니다. 사용자 선택 대화상자가 표시됩니다. 특정 사용자를 검색하려면 이메일 주소를 입력한 다음 다음을 선택합니다.
라이선스 할당을 선택합니다.

API

Gemini Code Assist 라이선스를 할당하려면 billingAccounts.orders.licensePool.assign 메서드를 사용합니다.

이 작업을 수행하려면 정기 결제를 소유한 결제 계정에 다음 권한이 있어야 합니다.

billing.accounts.get
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.get
consumerprocurement.licensePools.unassign
consumerprocurement.orders.get

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

다음을 바꿉니다.

BILLING_ACCOUNT_ID: 결제 계정 ID
ORDER_ID: IAM 정책

명령어가 성공하면 빈 응답 본문을 다음 형식으로 반환합니다.

{}

할당을 확인하려면 할당 목록을 봅니다.

Gemini Code Assist 라이선스 자동 할당

라이선스 할당 페이지에서 Gemini Code Assist에 액세스해야 하는 조직의 모든 사용자에게 라이선스를 자동으로 할당할 수 있습니다. 자동 라이선스 할당은 구독별로 개별적으로 설정됩니다.

Gemini Code Assist의 라이선스를 자동으로 할당하도록 선택하면 해당 계정에서 개별 사용자 라이선스를 삭제하거나 추가할 수 없습니다. Gemini Code Assist 기능을 사용하지 않은 라이선스 할당 사용자는 관리자가 설정한 대로 지정된 일수 동안 비활성 상태가 되면 결제 기간이 끝날 때 자동으로 프로비저닝 해제됩니다.

Google Cloud 콘솔에서 Gemini 관리자 페이지로 이동합니다.

Gemini 관리자로 이동
Gemini Code Assist 관리를 선택한 다음 구독 관리를 선택합니다.
라이선스 관리를 선택한 다음 자동 라이선스 할당 사용 설정을 선택합니다. 자동 라이선스 사용 설정 대화상자가 나타납니다.

이 구독을 자동 라이선스 할당으로 전환하면 변경 후 수동 라이선스 할당이 사용 중지되지만 기존 라이선스 할당은 영향을 받지 않습니다.
할당 대상자가 비활성 상태인 경우 라이선스가 할당 해제되는 시간을 설정한 다음 변경사항 확인을 선택합니다. 자동 라이선스 할당이 사용 설정됨 대화상자가 표시됩니다.
닫기를 선택합니다.

할당할 수 있는 라이선스가 있는 한 신규 사용자는 이 결제 계정의 구독에 포함된 Gemini Code Assist에 처음 액세스할 때 라이선스를 자동으로 받습니다.

자동 라이선스 할당을 사용 중지하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Gemini 관리자 페이지로 이동합니다.

Gemini 관리자로 이동
Gemini Code Assist 관리를 선택한 다음 구독 관리를 선택합니다.
라이선스 관리를 선택한 다음 자동 라이선스 할당 관리를 선택합니다. 자동 라이선스 할당 관리 대화상자가 표시됩니다.
자동 라이선스 관리 사용 중지를 선택합니다.
변경사항 확인을 선택합니다.

Gemini Code Assist 라이선스 수동으로 할당 해제

다음 옵션 중 하나를 선택합니다.

콘솔

정기 결제를 소유한 결제 계정에 다음 IAM 권한이 있는지 확인합니다.
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- consumerprocurement.licensePools.unassign
- resourcemanager.projects.get
Gemini 관리자 페이지로 이동합니다.

Gemini 관리자로 이동
Gemini Code Assist 관리를 선택한 다음 구독 관리를 선택합니다.
라이선스 관리를 선택한 다음 자동 라이선스 할당 관리를 선택합니다. 자동 라이선스 할당 관리 대화상자가 표시됩니다.
라이선스를 할당 해제할 사용자를 선택한 다음 라이선스 할당 해제를 선택합니다.
확인을 선택합니다.

API

Gemini Code Assist 라이선스를 할당 해제하려면 billingAccounts.orders.licensePool.unassign 메서드를 사용합니다.

이 작업을 수행하려면 정기 결제를 소유한 결제 계정에 대한 consumerprocurement.licensePools.unassign 권한이 있어야 합니다.

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

다음을 바꿉니다.

BILLING_ACCOUNT_ID: 결제 계정 ID
ORDER_ID: IAM 정책

명령어가 성공하면 빈 응답 본문을 다음 형식으로 반환합니다.

{}

할당 해제를 확인하려면 할당 목록을 봅니다.

Gemini Code Assist 라이선스 이전

Gemini Code Assist 라이선스는 사용자 간에 직접 이전할 수 없습니다. 대신 사용자의 라이선스를 할당 해제한 후 새 사용자에게 라이선스를 할당합니다.

조직 간 라이선스 사용 방지

Gemini Code Assist 라이선스는 조직이나 프로젝트가 아닌 개별 사용자에게 할당되므로 개별 사용자가 여러 조직에서 Gemini Code Assist를 사용할 수 있습니다.

Gemini Code Assist 사용에서 생성된 로그는 라이선스 수혜자가 아닌 이를 사용한 프로젝트에 속합니다. 또한 Gemini Code Assist의 맞춤설정 또는 구성 (예: 코드 맞춤설정)은 라이선스 또는 구독 수준이 아닌 프로젝트에서 수행됩니다.

더 효과적으로 프로젝트에서 Gemini Code Assist를 조직 간에 사용하지 못하게 하려면 다음 중 하나를 수행하면 됩니다.

프로젝트에서 Google Cloud를 위한 Gemini API를 중지합니다.
권한을 사용하여 프로젝트에 대한 사용자 액세스를 거부합니다.

제한사항

Google Cloud를 위한 Gemini 라이선스 관리에서는 직원 ID 제휴를 지원하지 않습니다.