데이터 도메인 관리

미리보기

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

이 문서에서는 Google Cloud 콘솔과 REST API를 사용하여 데이터 도메인과 하위 도메인을 보고, 업데이트하고, 삭제하는 방법을 설명합니다.

시작하기 전에

데이터 도메인을 관리하기 전에 필요한 역할이 있고 API가 사용 설정되어 있는지 확인합니다.

API 사용 설정

Dataplex API를 사용 설정합니다.

API 사용 설정에 필요한 역할

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

API 사용 설정하기

필요한 역할

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

• 데이터 도메인 및 리소스 바인딩 업데이트: Dataplex 데이터 도메인 구성 편집자 (roles/dataplex.dataDomainEditor)
• 데이터 도메인 및 바인딩 구성 보기: Dataplex 데이터 도메인 구성 뷰어 (roles/dataplex.dataDomainViewer)

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

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

데이터 도메인 및 하위 도메인 보기

특정 프로젝트의 데이터 도메인 및 하위 도메인을 확인합니다.

콘솔

모든 데이터 도메인 보기

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

   데이터 도메인으로 이동

2. 표에 생성된 도메인이 나열됩니다. 데이터 도메인 이름 옆에 있는 펼치기 화살표를 클릭하여 중첩된 하위 도메인을 확인합니다.

데이터 도메인 및 하위 도메인 세부정보 보기

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

   데이터 도메인으로 이동

2. 보려는 도메인 또는 하위 도메인의 이름을 클릭합니다.

3. 도메인 세부정보 페이지에는 다음 탭이 표시됩니다.

   • 개요: 도메인 개요와 필수 및 선택적 측면 목록을 제공합니다.
   • 리소스: 이 도메인에 포함된 리소스를 나열합니다. 목록에는 도메인에 직접 포함된 폴더, 프로젝트, 리소스만 표시됩니다.

REST

데이터 도메인 및 하위 도메인 보기

데이터 도메인을 보려면 projects.locations.dataDomains.list 메서드를 사용합니다.

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

• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• LOCATION_ID: 프로젝트의 리전입니다. 예를 들면 us-central1입니다.

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 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"

PowerShell(Windows)

참고: 다음 명령어는 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" | Select-Object -Expand Content

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

데이터 하위 도메인 보기

데이터 하위 도메인을 보려면 projects.locations.dataDomains.listSubdomains 메서드를 사용하세요.

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

• 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/subdomains

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 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/subdomains"

PowerShell(Windows)

참고: 다음 명령어는 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/subdomains" | Select-Object -Expand Content

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

filter 매개변수를 사용하여 특정 상위 도메인에 속한 하위 도메인을 나열합니다.

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

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

HTTP 메서드 및 URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID"

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 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?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID""

PowerShell(Windows)

참고: 다음 명령어는 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?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID"" | Select-Object -Expand Content

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

데이터 도메인 세부정보 보기

도메인 또는 하위 도메인 세부정보를 가져오려면 projects.locations.dataDomains.get 메서드를 사용합니다.

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

• 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(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 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(Windows)

참고: 다음 명령어는 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)와 빈 응답을 받게 됩니다.

데이터 도메인 또는 하위 도메인 업데이트

도메인의 표시 이름, 설명, 라벨을 업데이트할 수 있습니다. 도메인을 만든 후에는 도메인 ID나 위치를 변경할 수 없습니다.

콘솔

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

   데이터 도메인으로 이동

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

3. 상단 표시줄에서 수정을 클릭합니다.

4. 표시 이름 또는 설명을 업데이트합니다.

5. 저장을 클릭합니다.

REST

데이터 도메인을 업데이트하려면 projects.locations.dataDomains.patch 메서드를 사용합니다.

참고: 다른 속성을 덮어쓰지 않으려면 updateMask 쿼리 매개변수를 사용하여 업데이트할 필드를 지정해야 합니다.

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

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

HTTP 메서드 및 URL:

PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID?updateMask=description,labels

JSON 요청 본문:

{
  "description": "Updated description for the domain",
  "labels": {
    "status": "active"
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

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

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

curl -X PATCH \
     -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?updateMask=description,labels"

PowerShell(Windows)

참고: 다음 명령어는 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 PATCH `
    -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?updateMask=description,labels" | Select-Object -Expand Content

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

데이터 도메인 또는 하위 도메인 삭제

비어 있는 데이터 도메인만 삭제할 수 있습니다. 도메인 자체를 삭제하려면 먼저 모든 하위 도메인을 삭제하고 도메인과 연결된 모든 리소스 바인딩을 삭제해야 합니다. 도메인이 비어 있지 않으면 삭제 요청이 오류와 함께 실패합니다.

콘솔

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

   데이터 도메인으로 이동

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

3. 상단 표시줄에서 삭제를 클릭합니다.

4. 데이터 도메인 또는 하위 도메인 이름을 입력하여 삭제를 확인합니다.

5. 삭제를 클릭합니다.

REST

데이터 도메인을 삭제하려면 projects.locations.dataDomains.delete 메서드를 사용합니다.

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

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

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 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"

PowerShell(Windows)

참고: 다음 명령어는 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" | Select-Object -Expand Content

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

다음 단계

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