참고: 이 문서 모음은 Gemini Enterprise의 Standard, Plus, Frontline 버전을 위한 것입니다. Business 에디션 문서는 Gemini Enterprise - Business 에디션 고객센터를 참고하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Gemini Enterprise 구독 및 라이선스 할당

이 페이지에서는 Gemini Enterprise를 구독하는 방법과 사용자 라이선스를 관리하는 방법을 설명합니다.

액세스 설정에는 일반적으로 다음 단계가 포함됩니다.

조달: 결제 계정의 제품 버전 구독을 구매합니다.
배포: 구독의 라이선스를 특정 프로젝트와 위치에 할당합니다.
할당: 배포된 라이선스를 개별 사용자에게 할당합니다.

라이선스 정보

Gemini Enterprise 앱에 로그인하려면 사용자에게 라이선스가 있어야 합니다. 라이선스는 사용자에게 수동 또는 자동으로 할당할 수 있습니다.

수동으로 할당된 라이선스: 이메일 주소를 사용하여 사용자를 추가할 수 있습니다.
자동 할당 라이선스: 사용자가 Gemini Enterprise 또는 Gemini Notebook Enterprise 인터페이스에 처음 액세스할 때 Gemini Enterprise에서 사용자에게 라이선스를 자동으로 할당하도록 구독을 구성할 수 있습니다.

구독 정보

라이선스를 받으려면 먼저 Gemini Enterprise 버전을 구독해야 합니다. 구독은 결제 계정에 따라 다릅니다. 사용 가능한 버전에 대한 자세한 내용은 Gemini Enterprise 버전 비교하기를 참고하세요.

Gemini Enterprise의 경우 월간 구독 또는 연간 구독을 구매할 수 있습니다. 이러한 구독은 자동으로 갱신되도록 설정할 수 있습니다.

Google Cloud 콘솔을 사용하여 Gemini Enterprise Standard, Gemini Enterprise Plus, Gemini Enterprise 사용한 만큼만 지불 버전의 구독을 구매할 수 있습니다.

구독 시트 수량 한도

Google Cloud 콘솔을 통해 직접 사용자 수 기반 요금제를 구매하거나 수정하는 경우 Cloud Billing 계정 유형에 따라 자동 사용자 수 한도가 적용됩니다.

셀프 서비스 (또는 온라인) 및 재판매 결제 계정: Google Cloud 콘솔을 사용하여 구독을 관리하는 경우 계정당 최대 25개 시트로 제한됩니다.
인보이스 (또는 오프라인) 계정 결제 계정: 계정당 최대 1,000개의 라이선스로 제한됩니다.

조직에 더 많은 시트가 필요하거나 기존 구독에 라이선스를 추가하려고 할 때 최대 시트 한도 오류가 발생하는 경우 Google Cloud 영업 담당자 또는 계정 관리자에게 문의하여 오프라인 주문을 통해 라이선스를 추가로 구매하거나 허용 목록 예외를 요청하세요.

정기 결제 상태 정보

정기 결제는 다음 상태 중 하나일 수 있습니다.

주	설명
시작되지 않음	구독을 구매했지만 아직 활성화되지 않았습니다. 이 구독의 라이선스를 프로젝트에 배포할 수 있지만 이러한 라이선스가 할당된 사용자는 구독이 활성화될 때까지 Gemini Enterprise에 액세스할 수 없습니다. 자세한 내용은 라이선스 배포를 참고하세요.
활성	구독이 활성 상태이며 이 구독의 라이선스가 있는 사용자가 Gemini Enterprise에 액세스할 수 있습니다.
비활성화 중	구독이 비활성화 상태이며 라이선스가 조기 종료되도록 예약되어 있습니다. 이 구독의 라이선스가 있는 사용자는 1주간의 유예 기간 동안 Gemini Enterprise에 계속 액세스할 수 있습니다. 이 주가 지나면 라이선스가 만료 상태로 전환됩니다. 자세한 내용은 조기 종료 처리를 참고하세요.
만료됨	이 구독의 라이선스를 보유한 사용자는 구독 기간이 종료되거나 조기 종료 후 라이선스가 비활성화 상태에서 만료 상태로 전환되면 Gemini Enterprise에 액세스할 수 없게 됩니다.

시작하기 전에

이 페이지의 절차를 시작하기 전에 다음 기본 요건을 충족하는지 확인하세요.

Gemini Enterprise 설정에 설명된 모든 작업을 완료합니다. 여기에는 다음이 포함됩니다.
- 프로젝트의 결제 계정 설정
- Gemini Enterprise 사용 라이선스를 부여할 사용자에게 Gemini Enterprise 사용자 역할을 부여합니다.
Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 자세한 내용은 Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인을 참고하세요.

참고: Gemini Enterprise 종량제 구독은 인보이스 계정에서만 사용할 수 있습니다. 자세한 내용은 Cloud Billing 계정 유형을 참고하세요.

필요한 IAM 역할과 권한이 있는지 확인합니다.

Gemini Enterprise 관리자 역할

조직의 결제를 관리하는 경우 Gemini Enterprise 구독 및 조달 주문을 관리하려면 다음 역할이 있어야 합니다.

결제 계정 관리자(roles/billing.admin)
서비스 사용량 소비자(roles/serviceusage.serviceUsageConsumer)

또는 세부적인 IAM 제어를 위해 결제 계정 관리자 역할 대신 다음 권한이 있는 커스텀 역할을 사용할 수 있습니다.

서비스	권한
검색 엔진	`discoveryengine.billingAccountLicenseConfigs.distribute` `discoveryengine.billingAccountLicenseConfigs.get` `discoveryengine.billingAccountLicenseConfigs.list` `discoveryengine.billingAccountLicenseConfigs.retract` `discoveryengine.licenseConfigs.create` `discoveryengine.licenseConfigs.get` `discoveryengine.licenseConfigs.list` `discoveryengine.licenseConfigs.update` `discoveryengine.projects.get` `discoveryengine.projects.provision` `discoveryengine.projects.reportConsentChange` `discoveryengine.userStores.batchUpdateUserLicenses` `discoveryengine.userStores.listUserLicenses`
소비자 조달	`consumerprocurement.orders.get` `consumerprocurement.licensePools.assign` `consumerprocurement.licensePools.unassign` `consumerprocurement.licensePools.enumerateLicensedUsers`
Resource Manager	`resourcemanager.projects.get` `resourcemanager.projects.list`
서비스 사용량	`serviceusage.services.get` `serviceusage.services.list`

라이선스를 받으려면 결제 계정으로 Gemini Enterprise 버전 구독을 구매하세요. 구독을 통해 해당 결제 계정에 연결된 모든 프로젝트에서 사용할 수 있고, 프로젝트에 배포하고, 사용자에게 할당할 수 있는 라이선스 풀이 제공됩니다.

Standard 및 Plus

Gemini Enterprise Standard 또는 Plus 버전을 구독하려면 다음 단계를 따르세요.

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

Gemini Enterprise
구독 관리 > 구독 만들기를 클릭합니다.
Gemini Enterprise Standard 또는 Gemini Enterprise Plus 버전의 경우 구독을 클릭합니다.
결제 세부정보를 구성합니다.
1. 드롭다운에서 결제 계정을 선택합니다.
2. 구독 이름을 입력합니다.
3. 버전에 필요한 라이선스 수를 입력합니다.
구독 기간을 선택합니다.
구독을 자동으로 갱신하려면 구독 자동 갱신을 선택합니다.
배포 세부정보를 구성합니다.
1. 프로젝트 선택 드롭다운에서 프로젝트를 선택합니다.
2. 구독의 위치 유형을 선택합니다. 미국 또는 EU 멀티 리전에서 데이터를 찾아야 하는 규정 준수 또는 규제 사유가 없다면 최대 가용성과 낮은 지연 시간을 위해 글로벌 멀티 리전을 선택하는 것이 좋습니다.
만들기 > 확인을 클릭합니다.

사용한 만큼만 지불

사용한 만큼만 지불 구독의 경우 초과 사용량에 나열된 요금으로 사용한 만큼 매월 지불합니다. 결제 계정에 연결된 모든 프로젝트에서 구독을 사용할 수 있습니다.

Gemini Enterprise 사용한 만큼만 지불 에디션을 구독하려면 다음 단계를 따르세요.

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

Gemini Enterprise
구독 관리 > 구독 만들기를 클릭합니다.
Gemini Enterprise 사용한 만큼만 지불 버전에서 구독을 클릭합니다.
결제 세부정보를 구성합니다.
1. 구독 이름을 입력합니다.
2. 버전에 필요한 라이선스 수를 입력합니다.
배포 세부정보를 구성합니다.
1. 프로젝트 선택 드롭다운에서 프로젝트를 선택합니다.
2. 구독의 위치 유형을 선택합니다. 미국 또는 EU 멀티 리전에서 데이터를 찾아야 하는 규정 준수 또는 규제 사유가 없다면 최대 가용성과 낮은 지연 시간을 위해 글로벌 멀티 리전을 선택하는 것이 좋습니다.
만들기 > 확인을 클릭합니다.

구독 관리

이 섹션에서는 Gemini Enterprise 구독을 확인, 업데이트, 배포, 회수하는 방법을 설명합니다.

구독 세부정보 보기

Gemini Enterprise 구독 세부정보를 보려면 다음 단계를 따르세요.

콘솔

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

Gemini Enterprise
구독 관리를 클릭합니다.
드롭다운에서 결제 계정을 선택합니다.
Gemini 구독 표에서 구독 이름을 클릭합니다.

REST

구독 세부정보를 가져오려면 다음 명령어를 실행합니다.

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

다음을 바꿉니다.

PROJECT_NUMBER: 서비스 사용량 소비자 역할이 있는 프로젝트 번호
BILLING_ACCOUNT_ID: Google Cloud 결제 계정의 ID입니다.

샘플 출력

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

구독 설정 업데이트

구독을 만든 후 라이선스 수 또는 자동 갱신 설정과 같은 설정을 업데이트할 수 있습니다.

라이선스를 추가하는 방법은 구독을 처음 구매한 방법에 따라 다릅니다.

Google Cloud 콘솔을 통해 구독을 구매한 경우 이 섹션의 단계에 따라 Google Cloud 콘솔 내에서 직접 라이선스를 추가하세요.
오프라인 주문 양식을 사용하여 구매한 경우 새 라이선스 수로 주문 양식을 업데이트해야 합니다. Google 계정 관리자에게 문의하여 주문 양식을 업데이트하세요.

참고: Google Cloud 콘솔에서 구독 시트 수를 업데이트할 때 결제 계정 유형에 따라 최대 시트 한도가 적용됩니다(셀프 서비스 (또는 온라인) 및 리셀러 결제 계정의 경우 최대 25시트, 인보이스 (또는 오프라인) 결제 계정의 경우 최대 1,000시트). 자세한 내용은 구독 사용자 수 한도를 참고하세요.

기존 구독이 이러한 기준점을 초과하는 경우 (예: 영업팀 주도의 오프라인 주문을 통해 처음 프로비저닝된 경우) Google Cloud 콘솔을 통해 직접 라이선스를 추가하려고 하면 시트 한도 오류가 발생할 수 있습니다. Google Cloud 영업 담당자 또는 계정 관리자에게 문의하여 라이선스 수를 조정하거나 허용 목록 예외를 요청하세요.

Google Cloud 콘솔을 통해 구매한 경우 다음 단계에 따라 라이선스 수를 업데이트하세요.

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

Gemini Enterprise
구독 관리를 클릭합니다.
Gemini 구독 표에서 업데이트하려는 구독을 클릭합니다.
구독 세부정보 옆에 있는 수정을 클릭합니다.
라이선스 수를 업데이트하거나 자동 갱신을 사용 설정 또는 사용 중지합니다.
제출을 클릭합니다.

구독 취소하기

Gemini Enterprise 구독을 취소하려면 자동 갱신을 사용 중지해야 합니다. 구독 기간이 종료될 때까지 구독은 활성 상태로 유지되며 해당 날짜까지 요금이 청구될 수 있습니다. 정기 결제에 관해 자세히 알아보려면 정기 결제 세부정보 보기를 참고하세요.

구독을 취소하려면 다음 단계를 따르세요.

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

Gemini Enterprise
구독 관리를 클릭합니다.
Gemini 구독 표에서 구독 이름을 클릭하여 구독 세부정보 페이지를 엽니다.
수정을 클릭합니다.
구독 수정 패널에서 구독 자동 갱신 체크박스를 선택 해제합니다.
제출을 클릭합니다.

라이선스 배포

구독 라이선스를 프로젝트에 배포하지 않은 경우(오프라인으로 구독을 구매하거나 이전에 라이선스 배포가 실패한 경우 발생할 수 있음) 다음 단계를 따르세요.

콘솔

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

Gemini Enterprise
구독 관리를 클릭합니다.
드롭다운에서 결제 계정을 선택합니다.
Gemini 구독 표에서 구독 이름을 클릭합니다.
페이지 상단에서 라이선스 배포를 클릭합니다. 기존 라이선스 배포 및 남은 좌석 수와 총 좌석 수의 통계가 표시된 목록이 나타납니다.
프로젝트에 라이선스를 배포하려면 다음 단계를 따르세요.
1. 프로젝트 선택기를 클릭하여 프로젝트를 선택합니다. 선택기는 자동 완성을 지원합니다.
2. 참고: 선택한 프로젝트에 Discovery Engine API를 사용 설정하지 않은 경우 사용 설정하라는 대화상자가 표시됩니다.
3. 위치를 선택합니다.
4. 할당할 라이선스 수를 입력합니다.
5. 여러 프로젝트 또는 위치에 라이선스를 배포하려면 이 단계를 반복합니다.
제출을 클릭합니다.
확인 대화상자에서 변경사항 요약을 검토하고 확인을 클릭합니다.

REST

프로젝트 또는 여러 프로젝트에 라이선스를 배포하려면 다음 명령어를 실행합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

다음을 바꿉니다.

PROJECT_NUMBER: 서비스 사용량 소비자 역할이 있는 프로젝트 번호
ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
- 미국 멀티 리전의 경우 us
- EU 멀티 리전의 경우 eu
- 전역 위치의 경우 global
자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).
TARGET_PROJECT_NUMBER: 라이선스를 배포할 프로젝트 번호입니다.
LICENSE_COUNT: 배포할 라이선스 수입니다.
BILLING_ACCOUNT_ID: Google Cloud 결제 계정의 ID입니다.
BILLING_ACCOUNT_LICENSE_CONFIG_ID: 구독 세부정보에서 결제 계정 라이선스 구성 ID를 찾습니다.
선택사항 LICENSE_CONFIG_ID: 기존 프로젝트 수준 라이선스 구성의 ID입니다. 구독 세부정보를 볼 때 licenseConfigDistributions 필드에서 이 ID를 확인할 수 있습니다.

참고: 이 API 요청에서 LICENSE_CONFIG_ID를 생략하면 지정된 프로젝트 번호와 위치에 새 라이선스 구성이 생성됩니다. 기존 라이선스 구성을 업데이트하려면 LICENSE_CONFIG_ID를 포함해야 합니다.

구독에서 할당되지 않은 라이선스 복구

이 섹션에서는 프로젝트에서 할당되지 않은 라이선스를 회수하여 결제 계정에서 다른 프로젝트에 재분배할 수 있도록 하는 방법을 설명합니다.

콘솔

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

Gemini Enterprise
구독 관리를 클릭합니다.
드롭다운에서 결제 계정을 선택합니다.
Gemini 구독 표에서 구독 이름을 클릭합니다.
페이지 상단에서 라이선스 배포를 클릭합니다 (이 버튼을 클릭하면 모든 할당의 관리 양식이 열림).
할당 목록에서 라이선스를 회수할 프로젝트 및 위치의 행을 찾습니다.
다음 작업 중 하나를 선택합니다.
- 라이선스 수를 줄이려면 라이선스 입력란의 수를 줄입니다.
- 라이선스를 완전히 회수하려면 행 위로 포인터를 이동하여 삭제 버튼을 표시한 다음 삭제를 클릭합니다.
제출을 클릭합니다.
확인 대화상자에서 변경사항 요약 (회수된 라이선스 목록이 표시됨)을 검토하고 확인을 클릭합니다.

REST

재배포를 위해 구독 라이선스를 결제 계정으로 다시 이전하려면 다음 명령어를 실행합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

다음을 바꿉니다.

PROJECT_NUMBER: 서비스 사용량 소비자 역할이 있는 프로젝트 번호
ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
- 미국 멀티 리전의 경우 us
- EU 멀티 리전의 경우 eu
- 전역 위치의 경우 global
자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).
TARGET_PROJECT_NUMBER: 라이선스를 회수할 프로젝트 번호입니다.
LICENSE_COUNT: 회수할 라이선스 수입니다.
BILLING_ACCOUNT_ID: Google Cloud 결제 계정의 ID입니다.
BILLING_ACCOUNT_LICENSE_CONFIG_ID: 구독 세부정보에서 결제 계정 라이선스 구성 ID를 찾습니다.
LICENSE_CONFIG_ID: 기존 프로젝트 수준 라이선스 구성의 라이선스 구성 ID입니다.

조기 종료 처리

다른 정기 결제 유형 간에 이전하거나 결제 계정에 문제가 있는 경우 정기 결제가 계획보다 일찍 종료될 수 있습니다.

원활한 전환과 서비스 중단을 방지하기 위해 영향을 받는 라이선스가 완전히 만료되기 전에 비활성화 상태가 되는 1주일 (7일)의 유예 기간이 제공됩니다. 이 유예 기간 동안 새 구독으로 전환하는 동안에도 서비스를 계속 사용할 수 있습니다.

사용자의 액세스 권한을 유지하려면 라이선스를 활성 상태의 새 구독으로 자동 또는 수동으로 이전하세요.

다음 이미지는Google Cloud 콘솔에서 라이선스를 비활성화하는 예를 보여줍니다.

Google Cloud 콘솔에서 라이선스를 비활성화하는 예

사용자 라이선스 관리

이 섹션에서는 라이선스를 확인하고, 사용자 데이터를 내보내고, 개별 사용자의 라이선스를 할당, 이전, 삭제하는 방법을 설명합니다.

라이선스 보기

라이선스와 라이선스에 할당된 사용자를 확인하려면 다음 단계를 따르세요.

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

Gemini Enterprise
사용자 관리를 클릭합니다.
기존 라이선스의 멀티 리전을 선택합니다.

사용자 데이터 내보내기

Google Cloud 콘솔의 사용자 테이블은 정렬 또는 필터링을 지원하지 않습니다. 사용자 데이터를 정렬, 필터링 또는 분석해야 하는 경우 최대 1,000,000개의 사용자 레코드를 쉼표로 구분된 값 (CSV) 파일로 내보낼 수 있습니다.

내보낸 CSV 파일에는 다음 열이 포함됩니다.

열 이름	설명
`user_principal`	사용자의 이메일 주소입니다.
`license_config`	사용자에게 할당된 구독의 전체 Google Cloud 리소스 이름입니다 (예: `projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID`). 라이선스 구성 ID는 사용자에게 할당된 Gemini Enterprise 버전 (예: Standard 또는 Plus)에 해당합니다.
`assignment_time`	관리자가 라이선스를 할당한 시간의 타임스탬프 (UTC)입니다.
`last_login_time`	사용자가 마지막으로 로그인한 시간의 타임스탬프 (UTC)입니다.
`license_assignment_state`	라이선스 할당 상태입니다. 사용할 수 있는 값은 다음과 같습니다. `ASSIGNED`: 사용자에게 라이선스가 할당되었습니다. `NO_LICENSE`: 관리자가 라이선스를 할당하지 않았거나 기존 라이선스를 삭제했기 때문에 사용자에게 라이선스가 없습니다. `BLOCKED`: 정책 또는 관리자가 사용자의 라이선스 수신을 차단합니다.

사용자 데이터를 CSV 파일로 내보내려면 다음 단계를 따르세요.

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

사용자 관리
기존 라이선스의 멀티 리전을 선택합니다.
사용자 섹션에서 모든 사용자 내보내기를 클릭합니다.

사용자 테이블의 크기에 따라 내보내기 프로세스를 완료하는 데 최대 2.5분이 걸릴 수 있습니다. 이 기간 동안 콘솔에는 로드 상태가 표시됩니다. 내보내기가 완료되면 브라우저에서 CSV 파일을 기본 다운로드 위치로 다운로드합니다.

내보내기 문제 해결

다음 표에는 사용자 데이터를 내보낼 때 발생하는 일반적인 문제와 해결 방법이 나와 있습니다.

문제	해결 방법
모든 사용자 내보내기 버튼이 숨겨져 있음	선택한 멀티 리전에 라이선스가 할당된 사용자가 있는지 확인합니다. 할당된 사용자가 없으면 모든 사용자 내보내기 버튼이 표시되지 않습니다.
내보내기 요청이 한도 초과 오류로 실패함	사용자 목록이 내보내기 한도인 1,000,000명을 초과하면 Google Cloud 콘솔에서 내보내기 요청을 거부하고 한도 초과 오류 메시지를 표시합니다.
내보내기 요청이 권한 거부 오류와 함께 실패함	계정에 필요한 `discoveryengine.userStores.listUserLicenses` 권한이 포함된 Gemini Enterprise 관리자 역할이 있는지 확인합니다.

사용자에게 라이선스 할당

이 섹션에서는 새 사용자에게 라이선스를 자동으로 또는 수동으로 할당하는 방법을 설명합니다. 언제든지 신규 사용자에게 라이선스를 할당할 수 있으며, 라이선스가 할당되면 사용자는 즉시 Gemini Enterprise에 액세스할 수 있습니다.

사용자를 추가하고 라이선스를 자동으로 할당하기

사용자가 Gemini Enterprise 앱에 로그인할 때 라이선스를 자동으로 할당하려면 다음 단계를 따르세요.

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

Gemini Enterprise
사용자 관리를 클릭합니다.
기존 라이선스의 멀티 리전을 선택합니다.
라이선스 자동 할당을 선택한 다음 구독을 선택합니다.

수동으로 할당된 라이선스가 없는 사용자가 로그인할 때마다 Gemini Enterprise는 이 구독에서 라이선스를 자동으로 할당합니다. 구독에 라이선스가 남아 있지 않으면 Gemini Enterprise에 액세스 권한이 없다는 메시지가 사용자에게 표시됩니다.

정기 결제에 관한 자세한 내용은 정기 결제 정보 섹션을 참고하세요.

사용자를 추가하고 라이선스를 수동으로 할당하기

특정 사용자에게 Gemini Enterprise 액세스 권한을 부여하려면 활성 구독에서 라이선스를 수동으로 할당하면 됩니다.

콘솔

사용자에게 라이선스를 수동으로 할당하려면 다음 단계를 따르세요.

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

Gemini Enterprise
사용자 관리를 클릭합니다.
기존 라이선스의 멀티 리전을 선택합니다.
사용자 추가를 클릭합니다.
사용자 추가 페이지에서 다음 단계를 따르세요.
1. 사용자의 이메일 주소를 입력합니다. Gemini Enterprise 앱에 로그인할 때 사용할 이메일 주소를 사용해야 합니다.
2. 해당 사용자에게 할당할 구독을 선택합니다.
3. 제출을 클릭합니다.

REST

사용자에게 라이선스를 수동으로 할당하려면 다음 명령어를 실행합니다.

핵심 용어: Gemini Enterprise에서 앱이라는 용어는 API라는 맥락에서 엔진이라는 용어와 서로 바꿔서 사용할 수 있습니다. Gemini Enterprise 엔진은 app_type 필드가 APP_TYPE_INTRANET으로 설정된 일반 검색 엔진입니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":false
  }'

다음을 바꿉니다.

PROJECT_ID: 프로젝트의 ID입니다.
ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
- 미국 멀티 리전의 경우 us
- EU 멀티 리전의 경우 eu
- 전역 위치의 경우 global
자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).
USER_EMAIL: 라이선스에 추가할 사용자의 이메일 주소입니다.
PROJECT_NUMBER: Google Cloud 프로젝트 수
SUBSCRIPTION_ID: Gemini Enterprise 구독의 ID입니다.

만료된 구독의 라이선스 이전

구독이 만료된 경우 사용자는 Gemini Enterprise에 로그인할 수 없습니다. 로그인 액세스 권한을 사용자에게 다시 부여하는 방법에는 두 가지가 있습니다.

라이선스가 만료된 기존 사용자를 기본 구독으로 자동 이전
기존 사용자를 새 구독으로 수동 이전

사용자를 활성 구독으로 자동 이전

사용자를 활성 구독으로 자동 이전하려면 다음 단계를 따르세요.

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

Gemini Enterprise 라이선스
기존 라이선스의 멀티 리전을 선택합니다.
구독이 활성 상태인지 확인하세요. 구독이 없으면 구독하세요.
라이선스 자동 할당을 선택하고 활성 구독을 선택합니다.
만료된 라이선스 자동 업데이트를 선택합니다.

라이선스가 만료된 사용자가 다음에 로그인하면 Gemini Enterprise에서 선택한 구독의 라이선스를 자동으로 부여합니다.

사용자를 활성 구독으로 수동 이전

사용자를 활성 상태의 구독으로 수동 이전하려면 다음 단계를 따르세요.

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

Gemini Enterprise 라이선스
기존 라이선스의 멀티 리전을 선택합니다.
구독이 활성 상태인지 확인하세요. 구독이 없으면 구독하세요.
사용자를 선택하고 다른 라이선스 할당을 클릭합니다.
사용자 수정 창에서 구독을 선택하고 제출을 클릭합니다.

라이선스 나열

라이선스와 라이선스에 할당된 사용자를 나열하려면 다음 명령어를 실행합니다.

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

다음을 바꿉니다.

PROJECT_ID: 프로젝트의 ID입니다.
ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
- 미국 멀티 리전의 경우 us
- EU 멀티 리전의 경우 eu
- 전역 위치의 경우 global
자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).

라이선스에서 사용자 삭제

언제든지 사용자에게서 라이선스를 삭제할 수 있습니다. 라이선스가 삭제되면 사용자는 즉시 Gemini Enterprise에 액세스할 수 없게 됩니다. 라이선스에서 사용자를 삭제하려면 다음 단계를 따르세요.

콘솔

Google Cloud 콘솔을 사용하여 라이선스에서 사용자를 삭제하려면 다음 단계를 따르세요.

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

Gemini Enterprise 라이선스
기존 라이선스의 멀티 리전을 선택합니다.
사용자 표에서 사용자를 선택합니다.
라이선스에서 사용자를 삭제하려면 다음 중 하나를 선택하세요.
- 선택한 사용자에게서만 라이선스를 삭제하려면 라이선스 할당 해제를 클릭합니다.
- 라이선스를 삭제하고 선택한 사용자를 프로젝트에서 삭제하려면 라이선스 할당 해제 및 삭제를 클릭합니다.
확인을 클릭합니다.

REST

라이선스에서 사용자를 삭제하려면 다음 명령어를 실행합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

다음을 바꿉니다.

PROJECT_ID: 프로젝트의 ID입니다.
ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
- 미국 멀티 리전의 경우 us
- EU 멀티 리전의 경우 eu
- 전역 위치의 경우 global
자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).
USER_EMAIL: 라이선스에서 삭제할 사용자의 이메일 주소입니다.

다음 단계

Gemini Enterprise 라이선스 관련 자주 묻는 질문(FAQ)에 대해 자세히 알아보세요.
IAM 역할 및 권한에 대해 알아봅니다.

Gemini Enterprise 구독 및 라이선스 할당 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

라이선스 정보

구독 정보

구독 시트 수량 한도

정기 결제 상태 정보

시작하기 전에

구독하기

Standard 및 Plus

사용한 만큼만 지불

구독 관리

구독 세부정보 보기

콘솔

REST

구독 설정 업데이트

구독 취소하기

라이선스 배포

콘솔

REST

구독에서 할당되지 않은 라이선스 복구

콘솔

REST

조기 종료 처리

사용자 라이선스 관리

라이선스 보기

사용자 데이터 내보내기

내보내기 문제 해결

사용자에게 라이선스 할당

사용자를 추가하고 라이선스를 자동으로 할당하기

사용자를 추가하고 라이선스를 수동으로 할당하기

콘솔

REST

만료된 구독의 라이선스 이전

사용자를 활성 구독으로 자동 이전

사용자를 활성 구독으로 수동 이전

라이선스 나열

라이선스에서 사용자 삭제

콘솔

REST

다음 단계

Gemini Enterprise 구독 및 라이선스 할당