서비스 종속 항목 나열
계층적 서비스 활성화를 사용하면 Google Cloud 리소스 계층 구조를 통해 상속되는 서비스 사용 설정을 관리할 수 있습니다. 자세한 내용은 개요를 참고하세요.
많은 Google Cloud 서비스가 작동하려면 다른 서비스가 필요합니다. 계층적 서비스 활성화를 사용하여 서비스를 사용 설정하면 필수 종속 항목이 ConsumerPolicy에 자동으로 추가됩니다. 서비스 종속 항목 그룹에는 이러한 종속 서비스가 포함되어 있으며, 이를 나열하여 더 잘 이해하고 관리할 수 있습니다.
이 문서에서는 Google Cloud CLI를 사용하여 프로젝트, 폴더, 조직의 서비스 종속 항목을 나열하는 방법을 보여줍니다.
시작하기 전에
- Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
-
Google Cloud CLI를 설치합니다.
-
외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
-
gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.
gcloud init -
Google Cloud 프로젝트를 만들거나 선택합니다.
프로젝트를 선택하거나 만드는 데 필요한 역할
- 프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
-
프로젝트 만들기: 프로젝트를 만들려면
resourcemanager.projects.create권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기
-
Google Cloud 프로젝트를 만듭니다.
gcloud projects create PROJECT_ID
PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다. -
생성한 Google Cloud 프로젝트를 선택합니다.
gcloud config set project PROJECT_ID
PROJECT_ID을 Google Cloud 프로젝트 이름으로 바꿉니다.
-
이 가이드에 기존 프로젝트를 사용하는 경우 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다. 새 프로젝트를 만든 경우에는 이미 필요한 권한이 있습니다.
Service Usage API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 포함된 서비스 사용량 관리자 IAM 역할 (roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기gcloud services enable serviceusage.googleapis.com
-
Google Cloud CLI를 설치합니다.
-
외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
-
gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.
gcloud init -
Google Cloud 프로젝트를 만들거나 선택합니다.
프로젝트를 선택하거나 만드는 데 필요한 역할
- 프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
-
프로젝트 만들기: 프로젝트를 만들려면
resourcemanager.projects.create권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기
-
Google Cloud 프로젝트를 만듭니다.
gcloud projects create PROJECT_ID
PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다. -
생성한 Google Cloud 프로젝트를 선택합니다.
gcloud config set project PROJECT_ID
PROJECT_ID을 Google Cloud 프로젝트 이름으로 바꿉니다.
-
이 가이드에 기존 프로젝트를 사용하는 경우 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다. 새 프로젝트를 만든 경우에는 이미 필요한 권한이 있습니다.
Service Usage API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 포함된 서비스 사용량 관리자 IAM 역할 (roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기gcloud services enable serviceusage.googleapis.com
- 관리할 Google Cloud 리소스를 표시하지 않으면 이 문서의 명령어는 기본적으로 현재 프로젝트를 사용합니다. 예를 들어
gcloud beta services groups list-members bigquery.googleapis.com dependencies은 현재 프로젝트의 구성원을 나열합니다.다음과 같이 현재 프로젝트 ID를 가져올 수 있습니다.
gcloud config list --format='text(core.project)'
필요한 역할
서비스 종속 항목을 나열하는 데 필요한 권한을 얻으려면 관리자에게 타겟 리소스에 대한 서비스 사용량 뷰어 (roles/serviceusage.serviceUsageViewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 서비스 종속 항목을 나열하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
서비스 종속 항목을 나열하려면 다음 권한이 필요합니다.
-
종속 항목 그룹 구성원을 나열합니다.
serviceusage.groups.listMembers -
확장된 종속 항목 그룹 구성원을 나열합니다.
serviceusage.groups.listExpandedMembers
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
종속 항목 그룹 구성원 나열
gcloud beta services groups list-members 명령어를 사용하여 프로젝트, 폴더 또는 조직의 서비스 종속 항목 그룹의 직접 구성원을 나열할 수 있습니다.
프로젝트
gcloud beta services groups list-members SERVICE GROUP \
--project=PROJECT_ID
다음을 바꿉니다.
SERVICE: 구성원을 나열할 서비스의 이름입니다.GROUP: 구성원을 나열할 서비스 종속성 그룹의 이름입니다. 기본적으로 지원되는 그룹은dependencies입니다.PROJECT_ID: Google Cloud 프로젝트 ID 또는 플래그를 생략하여 현재 프로젝트를 기본값으로 설정합니다.
폴더
gcloud beta services groups list-members SERVICE GROUP \
--folder=FOLDER_ID
다음을 바꿉니다.
SERVICE: 구성원을 나열할 서비스의 이름입니다.GROUP: 구성원을 나열할 서비스 종속성 그룹의 이름입니다. 기본적으로 지원되는 그룹은dependencies입니다.FOLDER_ID: Google Cloud 폴더 ID
조직
gcloud beta services groups list-members SERVICE GROUP \
--organization=ORGANIZATION_ID
다음을 바꿉니다.
SERVICE: 구성원을 나열할 서비스의 이름입니다.GROUP: 구성원을 나열할 서비스 종속성 그룹의 이름입니다. 기본적으로 지원되는 그룹은dependencies입니다.ORGANIZATION_ID: Google Cloud 조직 리소스 ID입니다.
기타 플래그를 사용하여 나열된 회원을 필터링하고 제한할 수 있습니다.
확장된 종속 항목 그룹 구성원 나열
gcloud beta services groups list-expanded-members 명령어를 사용하여 프로젝트, 폴더 또는 조직의 서비스 종속 항목 그룹에 속한 확장된 구성원을 나열할 수 있습니다.
이 명령어는 중첩된 그룹의 종속 항목을 포함한 모든 종속 항목의 병합된 목록을 제공하기 위해 모든 종속 항목의 평면화된 목록을 반환합니다.
프로젝트
gcloud beta services groups list-expanded-members SERVICE GROUP \
--project=PROJECT_ID
다음을 바꿉니다.
SERVICE: 구성원을 나열할 서비스의 이름입니다.GROUP: 구성원을 나열할 서비스 종속성 그룹의 이름입니다. 기본적으로 지원되는 그룹은dependencies입니다.PROJECT_ID: Google Cloud 프로젝트 ID 또는 플래그를 생략하여 현재 프로젝트를 기본값으로 설정합니다.
폴더
gcloud beta services groups list-expanded-members SERVICE GROUP \
--folder=FOLDER_ID
다음을 바꿉니다.
SERVICE: 구성원을 나열할 서비스의 이름입니다.GROUP: 구성원을 나열할 서비스 종속성 그룹의 이름입니다. 기본적으로 지원되는 그룹은dependencies입니다.FOLDER_ID: Google Cloud 폴더 ID
조직
gcloud beta services groups list-expanded-members SERVICE GROUP \
--organization=ORGANIZATION_ID
다음을 바꿉니다.
SERVICE: 구성원을 나열할 서비스의 이름입니다.GROUP: 구성원을 나열할 서비스 종속성 그룹의 이름입니다. 기본적으로 지원되는 그룹은dependencies입니다.ORGANIZATION_ID: Google Cloud 조직 리소스 ID입니다.
기타 플래그를 사용하여 나열된 회원을 필터링하고 제한할 수 있습니다.
예시
직접 종속 항목 그룹 구성원 나열
- 현재 프로젝트의 BigQuery 서비스 직접 종속 항목을 나열합니다.
gcloud beta services groups list-members bigquery.googleapis.com dependencies
출력:
NAME: services/analyticshub.googleapis.com REASON: BigQuery depends on this group to allow users to exchange data and analytics assets. NAME: services/bigquery.googleapis.com REASON: The service representing BigQuery which owns this dependency group and depends on the other members of this group. NAME: services/bigqueryconnection.googleapis.com REASON: BigQuery depends on this group to allow users to manage connections to external data sources. NAME: services/bigquerydatapolicy.googleapis.com REASON: BigQuery depends on this group to allow users to manage their data policies. ...
- 해당 서비스 종속 항목 그룹 없이 API 키 서비스의 종속 항목을 나열하려고 시도합니다.
gcloud beta services groups list-members apikeys.googleapis.com dependencies --project=test-project
출력:
Listed 0 items.
확장된 종속 항목 그룹 구성원 나열
- 현재 프로젝트의 BigQuery 서비스 확장 종속 항목을 나열합니다.
gcloud beta services groups list-expanded-members bigquery.googleapis.com dependencies
출력:
services/analyticshub.googleapis.com services/bigquery.googleapis.com services/bigqueryconnection.googleapis.com services/bigquerydatapolicy.googleapis.com services/bigquerydatatransfer.googleapis.com services/bigquerymigration.googleapis.com services/bigqueryreservation.googleapis.com services/bigquerystorage.googleapis.com services/cloudresourcemanager.googleapis.com services/dataform.googleapis.com services/dataplex.googleapis.com
다음 단계
- 서비스를 사용 설정 및 중지하려면 서비스 사용 설정 관리를 참고하세요.
- 정책을 관리하려면 소비자 정책 관리를 참고하세요.