データ ドメインを管理する

プレビュー

このプロダクトまたは機能は サービス固有規約の「一般サービス規約」セクションの「一般提供前のサービス規約」の対象となります 。 pre-GA のプロダクトと機能は「現状のまま」利用できますが、サポートが制限されることがあります。 詳細については、 リリースステージの説明をご覧ください。

このドキュメントでは、 Google Cloud コンソールと REST API を使用してデータ ドメインとサブドメインを表示、更新、削除する方法について説明します。

始める前に

データ ドメインを管理する前に、必要なロールと API が有効になっていることを確認してください。

API を有効にする

Dataplex API を有効にする

API を有効にするために必要なロール

API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限が付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法をご覧ください。

API の有効化

必要なロール

データ ドメインの管理に必要な権 101} 限を取得するため、101} 101} プロジェクトの次の IAM ロールを付与するように管理者に依頼してください。101} 101}

• データ ドメインとリソース バインディングを更新する: 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）と空のレスポンスが返されます。

次のステップ

• データ ドメインの詳細を確認する。
• リソース バインディングと包含の詳細を確認する。
• データ ドメインを作成する方法を学習する。
• データ ドメインを使用する方法を学習する。