데이터 도메인에 리소스 포함

미리보기

이 제품 또는 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 '현재 상태 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

Knowledge Catalog(이전 명칭: Dataplex Universal Catalog)의 데이터 도메인을 사용하면 프로젝트, 데이터 제품, 개별 애셋(예: BigQuery 데이터 세트 및 테이블)을 논리적 계층 구조로 구성할 수 있습니다. 도메인을 승인하고 리소스 바인딩을 만든 후 사용자는 해당 비즈니스 컨텍스트 내에서 검색하여 포함된 리소스를 검색하고 메타데이터를 볼 수 있습니다.

작동 방식

도메인에 리소스를 포함하려면 다음 단계를 수행해야 합니다.

1. 승인하려는 도메인의 도메인 주 구성원 ID를 가져옵니다. 자세한 내용은 도메인 주 구성원 가져오기를 참조하세요.
2. 도메인에 특정 리소스 또는 프로젝트에 대한 액세스 권한을 부여합니다.
3. 리소스와 도메인 간에 바인딩을 만듭니다. 자세한 내용은 도메인에 리소스 바인딩을 참조하세요.

데이터 도메인 승인 정보

도메인 승인은 리소스와 도메인 간의 신뢰를 설정합니다. 리소스 소유자가 대상 리소스 또는 프로젝트의 데이터 도메인 IAM 주 구성원에게 IAM 권한을 부여합니다. 이 작업을 통해 Knowledge Catalog는 리소스를 도메인에 연결하는 바인딩 생성을 승인하고 실행할 수 있습니다.

도메인 승인은 바인딩이 생성될 때만 확인됩니다. 즉, 리소스에서 도메인 주 구성원의 IAM 역할을 취소해도 해당 리소스가 도메인에서 자동으로 바인딩 해제되거나 삭제되지 않습니다. roles/dataplex.dataDomainEntryReader 역할이 있는 도메인 사용자는 리소스-도메인 바인딩이 명시적으로 삭제될 때까지 리소스를 계속 검색하고 메타데이터를 볼 수 있습니다.

도메인 승인 및 도메인 사용자 권한

데이터 도메인을 사용할 때는 데이터 도메인 승인과 사용자에게 데이터 도메인 권한을 부여하는 것을 구분하는 것이 중요합니다.

• 데이터 도메인 승인: 대상 리소스에서 데이터 도메인을 승인하는 것을 의미합니다. 프로젝트 또는 BigQuery 데이터 세트와 같은 기본 리소스에 대한 데이터 도메인 IAM 주 구성원 권한을 부여하여 리소스와 도메인 간의 바인딩을 만듭니다.
• 사용자에게 데이터 도메인 권한 부여: 사용자 또는 서비스 계정에 데이터 도메인 자체와 상호작용할 수 있는 권한을 부여하는 것을 의미합니다. 데이터 도메인에서 사용자에게 직접 IAM 역할을 부여하여 Knowledge Catalog 내에서 도메인을 보거나 수정하거나 관리할 수 있도록 합니다. 자세한 내용은 데이터 도메인 역할 및 권한을 참조하세요.

역할 유형

대상 리소스에서 데이터 도메인을 승인할 때 리더, 작성자, 관리자 역할 유형 중 하나에 해당하는 IAM 역할을 선택할 수 있습니다.

일반적으로 작성자 및 관리자 역할 유형은 도메인이 다음과 같이 승인된 리소스에 대해 확장된 범위의 작업을 수행할 수 있도록 예약되어 있습니다.

• 작성자 역할 유형을 사용하면 도메인에서 리소스에 대한 메타데이터 수정 권한을 관리할 수 있습니다.
• 관리자 역할 유형을 사용하면 도메인에서 리소스에 대한 모든 권한을 관리할 수 있습니다.

데이터 도메인 범위 내에서 세 가지 역할 유형 모두 데이터 도메인이 대상 리소스에 대한 바인딩을 만들 수 있도록 허용합니다. 바인딩이 생성되면 사용자는 도메인 내에서 리소스를 검색하고 메타데이터를 볼 수 있습니다. 자세한 내용은 데이터 리소스 검색을 참조하세요.

역할 유형을 선택할 때는 리소스에 대해 도메인에 부여할 장기적인 액세스 수준을 고려하세요.

도메인 승인에 권장되는 역할

다음 표에는 도메인에서 리소스를 검사하도록 승인하는 데 사용할 수 있는 권장 역할이 나와 있습니다. 각 리소스에 대해 권장되는 역할과 다른 역할을 선택할 수 있지만, 이러한 역할에는 리소스 바인딩을 수행하는 데 필요한 권한이 포함되어야 합니다.

목록에서 역할을 보려는 리소스 유형을 선택합니다.

모든 리소스 프로젝트 BigQuery 데이터 세트 BigQuery 테이블 데이터 제품 Dataform 저장소 Dataproc Metastore 데이터베이스 Dataproc Metastore 테이블 Cloud Spanner 데이터베이스 BigLake 테이블 PostgreSQL용 AlloyDB 인스턴스 Gemini Enterprise Agent Platform 데이터 세트

리소스 유형	역할 유형	권장 역할	설명	필수 권한
프로젝트	리더	roles/browser	프로젝트에 대한 정보를 가져올 수 있는 도메인 권한을 부여합니다.	resourcemanager.projects.get
	작성자	roles/editor	프로젝트에 대한 정보를 가져오고 메타데이터를 관리할 수 있는 도메인 권한을 부여합니다.	resourcemanager.projects.get resourcemanager.projects.update
	관리자	roles/owner	검색, 메타데이터 거버넌스, 액세스 정책 관리를 포함하여 프로젝트에 대한 도메인 관리 권한을 부여합니다.	resourcemanager.projects.get resourcemanager.projects.update resourcemanager.projects.setIamPolicy
BigQuery 데이터 세트	리더	roles/bigquery.metadataViewer	BigQuery 데이터 세트에 대한 정보를 가져올 수 있는 도메인 권한을 부여합니다.	bigquery.datasets.get
	작성자	roles/bigquery.dataEditor	BigQuery 데이터 세트에 대한 정보를 가져오고 메타데이터를 관리할 수 있는 도메인 권한을 부여합니다.	bigquery.datasets.get bigquery.datasets.updateTag
	관리자	roles/bigquery.dataOwner	도메인에 탐색, 메타데이터 거버넌스, 액세스 정책 관리를 포함한 BigQuery 데이터 세트에 대한 관리 권한을 부여합니다.	bigquery.datasets.get bigquery.datasets.updateTag bigquery.datasets.setIamPolicy
BigQuery 테이블	리더	roles/bigquery.metadataViewer	BigQuery 테이블에 관한 정보를 가져올 수 있는 도메인 권한을 부여합니다.	bigquery.tables.get
	작성자	roles/bigquery.dataEditor	BigQuery 테이블에 대한 정보를 가져오고 메타데이터를 관리할 수 있는 도메인 권한을 부여합니다.	bigquery.tables.get bigquery.tables.update
	관리자	roles/bigquery.dataOwner	도메인에 탐색, 메타데이터 거버넌스, 액세스 정책 관리를 포함한 BigQuery 테이블에 대한 관리 권한을 부여합니다.	bigquery.tables.get bigquery.tables.update bigquery.tables.setIamPolicy
데이터 제품	리더	roles/dataplex.dataProductsViewer	데이터 제품에 대한 정보를 가져올 수 있는 도메인 권한을 부여합니다.	dataplex.dataProducts.get
	작성자	roles/dataplex.dataProductsEditor	도메인에 데이터 제품에 대한 정보를 가져오고 메타데이터를 관리할 수 있는 권한을 부여합니다.	dataplex.dataProducts.get dataplex.dataProducts.update
	관리자	roles/dataplex.dataProductsAdmin	데이터 제품 검색, 메타데이터 거버넌스, 액세스 정책 관리를 포함하여 데이터 제품에 대한 도메인 관리 권한을 부여합니다.	dataplex.dataProducts.get dataplex.dataProducts.update dataplex.dataProducts.setIamPolicy
Dataform 저장소	리더	roles/dataform.codeViewer	도메인에 Dataform 코드 리소스에 대한 읽기 전용 액세스 권한을 부여합니다.	dataform.repositories.get
	작성자	roles/dataform.codeOwner	도메인에 Dataform 저장소 및 코드 리소스에 대한 전체 액세스 권한을 부여합니다.	dataform.repositories.get dataform.repositories.update
	관리자	roles/dataform.codeOwner	도메인에 Dataform 저장소 및 코드 리소스에 대한 전체 액세스 권한을 부여합니다.	dataform.repositories.get dataform.repositories.setIamPolicy
Dataproc Metastore 데이터베이스	리더	roles/metastore.metadataUser	도메인에 Dataproc Metastore 데이터베이스 목록을 가져올 수 있는 권한을 부여합니다.	metastore.databases.get
	작성자	roles/metastore.metadataEditor	도메인에 Dataproc Metastore 데이터베이스 및 해당 데이터베이스에 속한 테이블의 메타데이터를 읽고 수정할 수 있는 액세스 권한을 부여합니다.	metastore.databases.get metastore.databases.update
	관리자	roles/metastore.metadataOwner	도메인에 Dataproc Metastore 데이터베이스 및 해당 데이터베이스에 속한 테이블의 메타데이터에 대한 전체 액세스 권한을 부여합니다.	metastore.databases.get metastore.databases.setIamPolicy
Dataproc Metastore 테이블	리더	roles/metastore.metadataViewer	도메인에 Dataproc Metastore 데이터베이스 및 해당 데이터베이스 아래의 테이블의 메타데이터를 읽을 수 있는 액세스 권한을 부여합니다.	metastore.tables.get
	작성자	roles/metastore.metadataEditor	도메인에 Dataproc Metastore 데이터베이스 및 해당 데이터베이스에 속한 테이블의 메타데이터를 읽고 수정할 수 있는 액세스 권한을 부여합니다.	metastore.tables.get
	관리자	roles/metastore.metadataOwner	도메인에 Dataproc Metastore 데이터베이스 및 해당 데이터베이스에 속한 테이블의 메타데이터에 대한 전체 액세스 권한을 부여합니다.	metastore.tables.get metastore.tables.setIamPolicy
Cloud Spanner 데이터베이스	리더	roles/spanner.databaseReader	도메인에 Spanner 데이터베이스에서 읽고, SQL 쿼리를 실행하고, 데이터베이스의 스키마를 볼 수 있는 권한을 부여합니다.	spanner.databases.get
	작성자	roles/spanner.editor	인스턴스 및 데이터베이스 관리, 쿼리 실행, 백업 및 복원 관리, 리소스 관리를 포함한 Spanner 리소스 전반에 대한 도메인 관리 및 운영 권한을 부여합니다.	spanner.databases.get spanner.databases.update
	관리자	roles/spanner.databaseAdmin	도메인에 프로젝트의 Spanner 인스턴스와 이러한 인스턴스의 데이터베이스를 관리할 수 있는 전체 액세스 권한을 부여합니다.	spanner.databases.get spanner.databases.setIamPolicy
BigLake 테이블	리더	roles/biglake.metadataViewer	도메인에 모든 BigLake 리소스에 대한 읽기 전용 메타데이터 액세스 권한을 부여합니다.	biglake.tables.get
	작성자	roles/biglake.editor	도메인에 모든 BigLake 리소스에 대한 읽기 및 쓰기 액세스 권한을 부여합니다.	biglake.tables.get biglake.tables.update
	관리자	roles/biglake.admin	도메인에 모든 BigLake 리소스에 대한 전체 액세스 권한을 부여합니다.	biglake.tables.get biglake.tables.setIamPolicy
PostgreSQL용 AlloyDB 인스턴스	리더	roles/alloydb.viewer	도메인에 PostgreSQL용 AlloyDB 리소스에 대한 읽기 전용 액세스 권한을 부여합니다.	alloydb.instances.get
	작성자	roles/alloydb.editor	도메인에 PostgreSQL용 AlloyDB 리소스에 대한 읽기 및 쓰기 액세스 권한을 부여합니다.	alloydb.instances.get alloydb.instances.update
Gemini Enterprise Agent Platform 데이터 세트	리더	roles/aiplatform.viewer	Gemini Enterprise Agent Platform의 모든 리소스를 볼 수 있는 도메인 권한을 부여합니다.	aiplatform.datasets.get
	작성자	roles/aiplatform.user	Gemini Enterprise Agent Platform의 모든 리소스를 사용할 수 있는 도메인 권한을 부여합니다.	aiplatform.datasets.get aiplatform.datasets.update

시작하기 전에

데이터 도메인에 리소스를 포함하기 전에 필요한 역할과 API가 사용 설정되어 있는지 확인합니다. 또한 다음 한도를 고려하세요.

• 리소스는 하나의 도메인에만 속할 수 있습니다.
• 도메인에는 최대 500개의 리소스가 포함될 수 있습니다.

API 사용 설정

Dataplex API가 아직 사용 설정되지 않았으면 사용 설정합니다.

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기

API 사용 설정하기

참고: 리소스를 승인하고 데이터 도메인에 바인딩하려면 리소스를 호스팅하는 프로젝트에서 대상 리소스의 서비스에 해당하는 API를 사용 설정해야 합니다. 예를 들어 Spanner 데이터베이스 또는 Vertex AI 데이터 세트를 승인하고 바인딩하려면 spanner.googleapis.com 및 aiplatform.googleapis.com API를 사용 설정해야 합니다.

필요한 역할

리소스를 데이터 도메인에 바인딩하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• 도메인 및 리소스 바인딩 관리: Dataplex 데이터 도메인 편집자 (roles/dataplex.dataDomainEditor)

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

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

도메인 IAM 주 구성원 가져오기

도움말: Google Cloud 콘솔의 리소스 바인딩 추가 페이지에 있는 도움말에서 도메인 IAM 주 구성원 ID를 직접 복사할 수 있습니다.

데이터 도메인이 리소스에 대한 작업을 수행하도록 승인하려면 도메인 IAM 주 구성원 ID가 필요합니다. 리소스에서 도메인을 승인할 때 도메인 주 구성원 ID를 제공해야 하므로 이 ID를 보관해 두세요.

콘솔

1. Google Cloud 콘솔에서 데이터 도메인 페이지로 이동합니다.

   데이터 도메인으로 이동

2. 도메인 이름을 클릭하여 도메인 세부정보 페이지로 이동합니다.

3. 개요 탭에서 정보로 이동한 다음 식별자로 이동합니다.

4. IAM 주 구성원 값을 복사합니다. 형식은 다음과 비슷합니다.

principal://dataplex.googleapis.com/projects/DOMAIN_PROJECT_NUMBER/name/locations/LOCATION_ID/dataDomains/DOMAIN_ID

REST

REST API를 사용하여 도메인 주 구성원을 가져오려면 projects.locations.dataDomains.get 메서드를 사용하여 데이터 도메인을 가져옵니다. 응답에는 도메인의 IAM 주 구성원 (iamPolicyNamePrincipal 또는 iamPolicyUidPrincipal)이 포함된 policyMember 필드가 포함됩니다.

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

• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• LOCATION_ID: 데이터 도메인이 있는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인 또는 하위 도메인의 고유 식별자입니다.

HTTP 메서드 및 URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

참고: 다음 명령어는 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)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

리소스에서 도메인 승인

리소스를 바인딩하려면 먼저 도메인의 주 구성원에게 대상 리소스에 대한 필수 IAM 역할을 부여해야 합니다.

참고: Google Cloud 콘솔을 사용하여 Gemini Enterprise Agent Platform 데이터 세트, Dataproc Metastore 데이터베이스 및 테이블, Dataform 저장소, PostgreSQL용 AlloyDB 인스턴스, BigLake 테이블을 직접 승인할 수 없습니다. 대신 프로젝트 수준에서 리소스를 승인하여 리소스가 권한을 상속하도록 허용합니다.

콘솔

1. Google Cloud 콘솔에서 대상 리소스로 이동하고 해당 리소스의 권한 패널을 엽니다.

   • 프로젝트, Gemini Enterprise Agent Platform 데이터 세트, Dataproc Metastore 데이터베이스 및 테이블, Dataform 저장소, PostgreSQL용 AlloyDB 인스턴스, BigLake 테이블의 경우 IAM 페이지로 이동하여 액세스 권한 부여를 클릭합니다.
   • 데이터 제품의 경우 데이터 제품 페이지로 이동하여 데이터 제품을 선택하고 공유 > 권한 설정을 클릭합니다.
   • BigQuery 데이터 세트 및 테이블의 경우 BigQuery 페이지로 이동하여 데이터 세트 또는 테이블을 선택하고 공유 > 권한 관리를 클릭합니다.
   • Spanner 데이터베이스의 경우 Spanner 페이지로 이동하여 데이터베이스를 선택하고 권한 탭을 클릭합니다.

2. 주 구성원 추가 또는 이에 상응하는 항목을 클릭합니다.

3. 새 주 구성원 필드에 도메인의 IAM 주 구성원을 붙여넣습니다. 도메인 주 구성원을 가져오는 방법은 도메인 IAM 주 구성원 가져오기 섹션을 참조하세요.

4. 역할 선택 메뉴에서 목적에 맞는 역할을 선택합니다. 전체 역할 목록은 도메인 승인에 권장되는 역할 섹션을 참조하세요. 변경사항이 전파될 때까지 2~3분 정도 기다립니다.

5. 저장을 클릭합니다.

gcloud

제품의 Google Cloud CLI 명령어를 사용하여 도메인 주 구성원에 필요한 역할을 부여합니다.

principal://dataplex.googleapis.com/projects/DOMAIN_PROJECT_NUMBER/name/locations/LOCATION_ID/dataDomains/DOMAIN_ID

예를 들어 gcloud을 사용하여 프로젝트를 바인딩합니다.

gcloud projects add-iam-policy-binding RESOURCE_PROJECT_ID \
--member "principal://dataplex.googleapis.com/projects/DOMAIN_PROJECT_NUMBER/name/locations/LOCATION_ID/dataDomains/DOMAIN_ID" \
--role ROLE

다음을 바꿉니다.

• RESOURCE_PROJECT_ID: 승인할 대상 프로젝트의 ID입니다.
• DOMAIN_PROJECT_NUMBER: 데이터 도메인을 호스팅하는 프로젝트의 프로젝트 번호입니다.
• LOCATION_ID: 데이터 도메인이 있는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• ROLE: 필요한 바인딩 목적에 맞는 IAM 역할입니다.

BigQuery의 bq add-iam-policy-binding와 같은 특정 제품 명령어는 제품의 API 참고 리소스를 참조하세요.

REST

도메인 주 구성원에게 리소스에 대한 권한을 부여하려면 일반적으로 getIamPolicy를 사용하여 기존 IAM 정책을 가져오고, 선택한 역할과 함께 도메인 주 구성원 바인딩을 추가하고, setIamPolicy를 사용하여 업데이트된 정책을 설정합니다.

다음 예시에서는 프로젝트에 대한 IAM 정책을 설정하는 방법을 보여줍니다.

현재 IAM 정책 가져오기

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

• RESOURCE_PROJECT_ID: 승인할 대상 프로젝트의 ID입니다.

HTTP 메서드 및 URL:

POST https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:getIamPolicy

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:getIamPolicy"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:getIamPolicy" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

도메인 주 구성원을 포함하는 업데이트된 정책 설정

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

• RESOURCE_PROJECT_ID: 승인할 대상 프로젝트의 ID입니다.
• DOMAIN_PROJECT_NUMBER: 데이터 도메인을 호스팅하는 프로젝트의 프로젝트 번호입니다.
• LOCATION_ID: 데이터 도메인이 있는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• ROLE: 필요한 바인딩 목적에 맞는 IAM 역할입니다.

HTTP 메서드 및 URL:

POST https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:setIamPolicy

JSON 요청 본문:

{
  "policy": {
    "bindings": [
      {
        "role": "ROLE",
        "members": [
          "principal://dataplex.googleapis.com/projects/DOMAIN_PROJECT_NUMBER/name/locations/LOCATION_ID/dataDomains/DOMAIN_ID"
        ]
      }
    ]
  }
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:setIamPolicy"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v1/projects/RESOURCE_PROJECT_ID:setIamPolicy" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

다른 리소스의 정책 설정에 대한 안내는 다음 API 참고 리소스를 참조하세요.

• 데이터 제품
• BigQuery 데이터 세트
• BigQuery 테이블
• Dataform 저장소
• Dataproc Metastore 데이터베이스
• Dataproc Metastore 테이블
• Cloud Spanner 데이터베이스
• BigLake 테이블
• PostgreSQL용 AlloyDB 인스턴스
• Gemini Enterprise Agent Platform 데이터 세트

도메인에 리소스 바인딩

대상 리소스에서 도메인을 승인한 후 리소스를 도메인에 바인딩할 수 있습니다. 프로젝트를 포함하면 프로젝트 내의 모든 리소스가 도메인에 자동으로 추가됩니다. 단, 포함을 명시적으로 재정의하는 경우는 예외입니다.

콘솔

1. Google Cloud 콘솔에서 데이터 도메인 페이지로 이동합니다.

   데이터 도메인으로 이동

2. 리소스를 추가할 도메인을 선택합니다.

3. 리소스 탭을 클릭합니다.

4. 포함할 항목에 따라 리소스 추가 또는 프로젝트 추가를 클릭합니다.

5. 도메인에 포함할 리소스를 검색하고 선택합니다.

6. 선택을 클릭합니다.

REST

도메인에 리소스를 포함하려면 projects.locations.dataDomains.bindings.create 메서드를 사용합니다.

도메인에 포함할 리소스의 페이로드를 보려면 다음 섹션 중 하나를 펼치세요.

프로젝트

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

• PROJECT_ID: 데이터 도메인을 호스팅하는 Google Cloud 프로젝트의 ID입니다.
• LOCATION_ID: 데이터 도메인이 있는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 고유 식별자입니다.
• RESOURCE_PROJECT_ID: 도메인에 포함할 대상 프로젝트의 ID입니다.
• BINDING_ID: 이 리소스 바인딩의 고유 식별자입니다(선택사항).

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//cloudresourcemanager.googleapis.com/projects/RESOURCE_PROJECT_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

BigQuery 데이터 세트 및 테이블

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

• PROJECT_ID: 데이터 도메인을 호스팅하는 Google Cloud 프로젝트의 ID입니다.
• LOCATION_ID: 데이터 도메인이 있는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 고유 식별자입니다.
• RESOURCE_PROJECT_ID: 리소스를 호스팅하는 Google Cloud 프로젝트의 ID입니다.
• DATASET_ID: 대상 리소스의 ID입니다 (예: BigQuery 데이터 세트).
• BINDING_ID: 이 리소스 바인딩의 고유 식별자입니다(선택사항).

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//bigquery.googleapis.com/projects/RESOURCE_PROJECT_ID/datasets/DATASET_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

데이터 제품

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

• PROJECT_ID: 데이터 도메인을 호스팅하는 Google Cloud 프로젝트의 ID입니다.
• LOCATION_ID: 데이터 도메인과 리소스가 있는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 고유 식별자입니다.
• RESOURCE_PROJECT_ID: 데이터 제품을 호스팅하는 Google Cloud 프로젝트의 ID입니다.
• DATA_PRODUCT_ID: 대상 데이터 제품의 고유 ID입니다.
• BINDING_ID: 이 리소스 바인딩의 고유 식별자입니다(선택사항).

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//dataplex.googleapis.com/projects/RESOURCE_PROJECT_ID/locations/LOCATION_ID/dataProducts/DATA_PRODUCT_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

Dataform 저장소

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

• DOMAIN_PROJECT_ID: 데이터 도메인을 호스팅하는 프로젝트의 ID입니다.
• DOMAIN_LOCATION_ID: 데이터 도메인이 호스팅되는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• BINDING_ID: 새 데이터 도메인 바인딩에 할당할 ID입니다.
• PROJECT_ID: 저장소를 호스팅하는 프로젝트의 ID입니다.
• LOCATION_ID: 저장소를 호스팅하는 리전입니다.
• REPOSITORY_ID: Dataform 저장소 ID입니다.

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

Dataproc Metastore 데이터베이스

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

• DOMAIN_PROJECT_ID: 데이터 도메인을 호스팅하는 프로젝트의 ID입니다.
• DOMAIN_LOCATION_ID: 데이터 도메인이 호스팅되는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• BINDING_ID: 새 데이터 도메인 바인딩에 할당할 ID입니다.
• PROJECT_ID: 데이터베이스를 호스팅하는 프로젝트의 ID입니다.
• LOCATION_ID: 서비스를 호스팅하는 리전입니다.
• SERVICE_ID: Dataproc Metastore 서비스의 ID입니다.
• DATABASE_ID: 데이터베이스 ID입니다.

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID/databases/DATABASE_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

Dataproc Metastore 테이블

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

• DOMAIN_PROJECT_ID: 데이터 도메인을 호스팅하는 프로젝트의 ID입니다.
• DOMAIN_LOCATION_ID: 데이터 도메인이 호스팅되는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• BINDING_ID: 새 데이터 도메인 바인딩에 할당할 ID입니다.
• PROJECT_ID: 테이블을 호스팅하는 프로젝트의 ID입니다.
• LOCATION_ID: 서비스를 호스팅하는 리전입니다.
• SERVICE_ID: Dataproc Metastore 서비스의 ID입니다.
• DATABASE_ID: 데이터베이스 ID입니다.
• TABLE_ID: 테이블의 ID입니다.

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID/databases/DATABASE_ID/tables/TABLE_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

Spanner 데이터베이스

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

• DOMAIN_PROJECT_ID: 데이터 도메인을 호스팅하는 프로젝트의 ID입니다.
• DOMAIN_LOCATION_ID: 데이터 도메인이 호스팅되는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• BINDING_ID: 새 데이터 도메인 바인딩에 할당할 ID입니다.
• PROJECT_ID: 데이터베이스를 호스팅하는 프로젝트의 ID입니다.
• INSTANCE_ID: Spanner 인스턴스의 ID입니다.
• DATABASE_ID: 데이터베이스 ID입니다.

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

BigLake

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

• DOMAIN_PROJECT_ID: 데이터 도메인을 호스팅하는 프로젝트의 ID입니다.
• DOMAIN_LOCATION_ID: 데이터 도메인이 호스팅되는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• BINDING_ID: 새 데이터 도메인 바인딩에 할당할 ID입니다.
• PROJECT_ID: 카탈로그를 호스팅하는 프로젝트의 ID입니다.
• LOCATION_ID: 카탈로그를 호스팅하는 리전입니다.
• CATALOG_ID: 카탈로그 ID입니다.
• DATABASE_ID: 데이터베이스 ID입니다.
• TABLE_ID: 테이블의 ID입니다.

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//biglake.googleapis.com/projects/PROJECT_ID/catalogs/CATALOG_ID/databases/DATABASE_ID/tables/TABLE_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

PostgreSQL용 AlloyDB

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

• DOMAIN_PROJECT_ID: 데이터 도메인을 호스팅하는 프로젝트의 ID입니다.
• DOMAIN_LOCATION_ID: 데이터 도메인이 호스팅되는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• BINDING_ID: 새 데이터 도메인 바인딩에 할당할 ID입니다.
• PROJECT_ID: 클러스터를 호스팅하는 프로젝트의 ID입니다.
• LOCATION_ID: 클러스터를 호스팅하는 리전입니다.
• CLUSTER_ID: 클러스터의 ID입니다.
• INSTANCE_ID: 인스턴스의 ID입니다.

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//alloydb.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

Gemini Enterprise 에이전트 플랫폼

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

• DOMAIN_PROJECT_ID: 데이터 도메인을 호스팅하는 프로젝트의 ID입니다.
• DOMAIN_LOCATION_ID: 데이터 도메인이 호스팅되는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 ID입니다.
• BINDING_ID: 새 데이터 도메인 바인딩에 할당할 ID입니다.
• PROJECT_ID: 데이터 세트를 호스팅하는 프로젝트의 ID입니다.
• LOCATION_ID: 데이터 세트를 호스팅하는 리전입니다.
• DATASET_ID: 데이터 세트 ID

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID

JSON 요청 본문:

{
  "resource": "//aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/datasets/DATASET_ID"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/DOMAIN_PROJECT_ID/locations/DOMAIN_LOCATION_ID/dataDomains/DOMAIN_ID/bindings?data_domain_binding_id=BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

포함된 리소스 보기

데이터 도메인에 직접 바인딩된 폴더, 프로젝트, 리소스를 확인합니다.

콘솔

1. Google Cloud 콘솔에서 데이터 도메인 페이지로 이동합니다.

   데이터 도메인으로 이동

2. 도메인 이름을 클릭합니다.

3. 리소스 탭을 클릭합니다. 목록에는 도메인에 직접 포함된 리소스가 표시됩니다.

REST

포함된 리소스 바인딩을 나열하려면 projects.locations.dataDomains.bindings.list 메서드를 사용합니다.

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

• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• LOCATION_ID: 데이터 도메인이 있는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 고유 식별자입니다.

HTTP 메서드 및 URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

참고: 다음 명령어는 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)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

도메인에서 리소스 삭제

리소스를 삭제하면 데이터 도메인 계층 구조에서 바인딩이 해제됩니다.

콘솔

1. Google Cloud 콘솔에서 데이터 도메인 페이지로 이동합니다.

   데이터 도메인으로 이동

2. 도메인 이름을 클릭합니다.

3. 리소스 탭을 클릭합니다.

4. 삭제할 리소스를 선택합니다.

5. 삭제를 클릭하고 삭제를 확인합니다.

REST

리소스 바인딩을 삭제하려면 projects.locations.dataDomains.bindings.delete 메서드를 사용합니다.

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

• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• LOCATION_ID: 데이터 도메인이 있는 리전입니다. 예를 들면 us-central1입니다.
• DOMAIN_ID: 데이터 도메인의 고유 식별자입니다.
• BINDING_ID: 리소스 바인딩의 고유 식별자입니다.

HTTP 메서드 및 URL:

DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings/BINDING_ID

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

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

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

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings/BINDING_ID"

PowerShell

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/bindings/BINDING_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

다음 단계

• 데이터 도메인에 대해 자세히 알아보세요.
• 리소스 결합 및 포함에 대해 자세히 알아보세요.
• 데이터 도메인을 만드는 방법 알아보기
• 데이터 도메인을 사용하는 방법을 알아보세요.