エンドポイントを介して公開サービスにアクセスする

このドキュメントでは、Private Service Connect エンドポイントを使用して、別の VPC ネットワーク内のサービスにアクセスする方法について説明します。自社のサービスに接続することも、他のサービス提供者（Google を含む）が提供するサービスに接続することもできます。

サービスの詳細については、マネージドサービスを公開するをご覧ください。

ロール

次の IAM ロールは、このガイドのタスクを行うために必要な権限を備えています。

タスク	ロール
エンドポイントを作成する	次の両方のロール: Compute ネットワーク管理者（`roles/compute.networkAdmin`） Service Directory 編集者（`roles/servicedirectory.editor`）
エンドポイントの DNS エントリを自動または手動で構成する	DNS 管理者（`roles/dns.admin`）

始める前に

制限事項など、エンドポイントを使用したサービスへの接続についてを確認する。
プロジェクトで Compute Engine API を有効にする必要があります。
プロジェクトで Service Directory API を有効にする必要があります。
プロジェクトで Cloud DNS API を有効にする必要があります。
エンドポイントの IP アドレスの割り当てに使用する通常のサブネットを特定するか、作成します。
- サブネットは、接続するサービスと同じリージョンに存在する必要があります。
- IPv4 のみのサブネットまたはデュアルスタックサブネットの IPv4 アドレスを使用できます。
- サブネットに内部 IPv6 アドレス範囲がある場合は、デュアルスタックサブネットの IPv6 アドレスを使用できます。
- IP アドレスの IP バージョンは、エンドポイントがどの公開サービスに接続できるかに影響します。詳細については、IP バージョンの変換をご覧ください。
下り（外向き）ファイアウォールルールで、エンドポイントの内部 IP アドレスへのトラフィックを許可する必要があります。暗黙の下り（外向き）許可ファイアウォールルールでは、任意の宛先 IP アドレスへの下り（外向き）が許可されます。VPC ネットワークで下り（外向き）拒否ファイアウォールルールを作成した場合、または暗黙の下り（外向き）許可動作を変更する階層型ファイアウォールポリシーを作成した場合、エンドポイントへのアクセスに影響する可能性があります。サービスエンドポイントの内部 IP アドレスの宛先へのトラフィックを許可する、特定の下り（外向き）許可ファイアウォールルールまたはポリシーを作成します。
サービスのサービスアタッチメントの URI が必要です。例: projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME。

エンドポイントを作成する

エンドポイントは、Private Service Connect 転送ルールを使用して、別の VPC ネットワーク内のサービスに接続します。各転送ルールでは、Private Service Connect の転送ルールが別の VPC ネットワーク内のサービスにアクセスするためのプロジェクトごとの割り当てに対してカウントされます。

エンドポイントを作成すると、選択した名前空間またはデフォルトの名前空間 goog-psc-default を使用して、Service Directory に自動的に登録されます。

エンドポイントを複数のリージョンで利用可能にする場合は、グローバルアクセスを有効にします。

エンドポイントのグローバルアクセスフィールドを更新できるのは、公開サービスのみです。他のフィールドを更新する場合は、エンドポイントを削除してから新しいエンドポイントを作成します。

このタスクに必要な権限

このタスクを実行するには、次の権限または次の IAM ロールのいずれかが付与されている必要があります。

gcloud CLI と API の権限

compute.networks.use
compute.addresses.create
compute.addresses.use
compute.forwardingRules.create
compute.forwardingRules.pscCreate
servicedirectory.namespaces.create
servicedirectory.namespaces.associatePrivateZone
servicedirectory.services.create
dns.managedZones.create
dns.networks.bindPrivateDNSZone

Google Cloud コンソールの権限

compute.forwardingRules.list
compute.globalForwardingRules.list
compute.networks.list
compute.backendBuckets.list
compute.backendServices.list
compute.instanceGroupManagers.list
compute.targetPools.list
compute.targetSslProxies.list
compute.targetTcpProxies.list
compute.urlMaps.list

ロール

詳しくは、ロールをご覧ください。

コンソール

Google Cloud コンソールで [Private Service Connect] ページに移動します。

[Private Service Connect] に移動
[接続エンドポイント] タブをクリックします。
[エンドポイントを接続] をクリックします。
[ターゲット] で [公開済みのサービス] を選択します。
[ターゲットサービス] に、接続するサービスアタッチメント URI を入力します。

サービスアタッチメント URI の形式は projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME です。
[エンドポイント名] に、エンドポイントに使用する名前を入力します。
エンドポイントのネットワークを選択します。
エンドポイントのサブネットワークを選択します。
エンドポイントの IP アドレスを選択します。新しい IP アドレスが必要な場合は、次のように作成します。
1. [IP アドレス] プルダウンメニューをクリックし、[IP アドレスを作成] を選択します。
2. IP アドレスの名前と説明（省略可）を入力します。
3. IP バージョンを選択します。
4. IPv4 アドレスを作成する場合は、[自動的に割り当てる] または [自分で選択] を選択します。 [ユーザー指定] を選択した場合、使用するカスタム IP アドレスを入力します。
5. [予約] をクリックします。
任意のリージョンからエンドポイントを利用できるようにするには、[グローバルアクセスを有効にする] を選択します。
プルダウンリストから名前空間を選択するか、新しい名前空間を作成します。

リージョンは、選択したサブネットワークに基づいて入力されます。
[エンドポイントを追加] をクリックします。

gcloud

エンドポイントに割り当てる内部 IP アドレスを予約します。
```
gcloud compute addresses create ADDRESS_NAME \
    --region=REGION \
    --subnet=SUBNET \
    --ip-version=IP_VERSION
```
以下を置き換えます。
- ADDRESS_NAME: 予約済みの IP アドレスに割り当てる名前。
- REGION: エンドポイントの IP アドレスのリージョン。これは、サービスプロデューサーのサービスアタッチメントが含まれているのと同じリージョンに存在している必要があります。
- SUBNET: エンドポイント IP アドレスのサブネットの名前。
- IP_VERSION: IP アドレスの IP バージョン。IPV4 または IPV6 のいずれかです。デフォルトは IPV4 です。IPV6 を指定するには、IP アドレスが内部 IPv6 アドレス範囲を持つデュアルスタックサブネットに接続されている必要があります。

予約済みの IP アドレスを探します。

gcloud compute addresses list --filter="name=ADDRESS_NAME"

エンドポイントをサービスプロデューサーのサービスアタッチメントに接続する転送ルールを作成します。デフォルトでは、エンドポイントは独自のリージョンからのみ使用できます。任意のリージョンからエンドポイントを利用できるようにするには、--allow-psc-global-access フラグを使用します。
- 独自のリージョンからのみアクセスできるエンドポイントを作成します。
```
gcloud compute forwarding-rules create ENDPOINT_NAME \
  --region=REGION \
  --network=NETWORK_NAME \
  --address=ADDRESS_NAME \
  --target-service-attachment=SERVICE_ATTACHMENT \
  [ --service-directory-registration=projects/PROJECT_ID/locations/REGION/namespaces/NAMESPACE ]
```
- 任意のリージョンからアクセスできるエンドポイントを作成します。
```
gcloud compute forwarding-rules create ENDPOINT_NAME \
  --region=REGION \
  --network=NETWORK_NAME \
  --address=ADDRESS_NAME \
  --target-service-attachment=SERVICE_ATTACHMENT \
  --allow-psc-global-access \
  [ --service-directory-registration=projects/PROJECT_ID/locations/REGION/namespaces/NAMESPACE ]
```
次のように置き換えます。
- ENDPOINT_NAME: エンドポイントに割り当てる名前。
- REGION: エンドポイントのリージョン。これは、サービスプロデューサーのサービスアタッチメントが含まれているのと同じリージョンに存在している必要があります。
- NETWORK_NAME: エンドポイントの VPC ネットワークの名前。
- ADDRESS_NAME: 予約済みのアドレスの名前。
- SERVICE_ATTACHMENT: サービスプロデューサーのサービスアタッチメントの URI。例: projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME
- PROJECT_ID: プロジェクト ID。
- NAMESPACE: 使用する Service Directory の名前空間。存在しない名前空間を指定すると、その名前空間が作成されます。
  
  --service-directory-registration フラグを省略した場合、goog-psc-default のデフォルトの名前空間が使用されます。

API

エンドポイントに割り当てる内部 IP アドレスを予約します。
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

{
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "subnetwork": "SUBNET_URI",
  "ipVersion": "IP_VERSION"
}
```
以下を置き換えます。
- PROJECT_ID: プロジェクト ID。
- ADDRESS_NAME: 予約済みの IP アドレスに割り当てる名前。
- SUBNET_URI: IP アドレスのサブネット。subnetworks.list メソッドまたは gcloud compute networks subnets list --uri を使用して、ネットワークの URL を検索します。
- IP_VERSION: IP アドレスの IP バージョン。IPV4 または IPV6 のいずれかです。デフォルトは IPV4 です。IPV6 を指定するには、IP アドレスが内部 IPv6 アドレス範囲を持つデュアルスタックサブネットに接続されている必要があります。
エンドポイントをサービスプロデューサーのサービスアタッチメントに接続する転送ルールを作成します。デフォルトでは、エンドポイントは独自のリージョンからのみ使用できます。任意のリージョンからエンドポイントを利用できるようにするには、allowPscGlobalAccess を true に設定します。
- 独自のリージョンからのみアクセスできるエンドポイントを作成します。
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules
{
  "name": "ENDPOINT_NAME",
  "IPAddress": "ADDRESS_URI",
  "target": "SERVICE_ATTACHMENT",
  "network": "NETWORK_URI",
  "serviceDirectoryRegistrations": [
      {
          "namespace": "NAMESPACE"
      }
  ]
}
```
- 任意のリージョンからアクセスできるエンドポイントを作成します。
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules
{
  "name": "ENDPOINT_NAME",
  "IPAddress": "ADDRESS_URI",
  "target": "SERVICE_ATTACHMENT",
  "network": "NETWORK_URI",
  "allowPscGlobalAccess": true,
  "serviceDirectoryRegistrations": [
      {
          "namespace": "NAMESPACE"
      }
  ]
}
```
次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- REGION: エンドポイントのリージョン。
- ENDPOINT_NAME: エンドポイントに割り当てる名前。
- ADDRESS_URI: 関連付けられたネットワークに予約されたアドレスの URI。addresses.list メソッドまたは gcloud compute addresses list --uri を使用して、予約されたアドレスの URL を検索します。
- SERVICE_ATTACHMENT: サービスプロデューサーのサービスアタッチメントの URI。例: projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME
- NETWORK_URI: エンドポイントの VPC ネットワーク。network.list メソッドまたは gcloud compute networks list --uri を使用して、ネットワークの URI を検索します。
- NAMESPACE: エンドポイントの名前空間。存在しない名前空間を指定すると、その名前空間が作成されます。namespace フィールドを省略すると、goog-psc-default のデフォルトの名前空間が割り当てられます。

このタスクに必要な権限

このタスクを実行するには、次の権限または次の IAM ロールのいずれかが付与されている必要があります。

gcloud CLI と API の権限

compute.networks.use
compute.addresses.create
compute.addresses.use
compute.forwardingRules.create
compute.forwardingRules.pscCreate
servicedirectory.namespaces.create
servicedirectory.namespaces.associatePrivateZone
servicedirectory.services.create
dns.managedZones.create
dns.networks.bindPrivateDNSZone

ロール

詳しくは、ロールをご覧ください。

共有 VPC ネットワークの IP アドレスを使用してエンドポイントを作成する

サービスプロジェクト管理者は、接続された共有 VPC ネットワークの IP アドレスを使用して共有 VPC サービスプロジェクトにエンドポイントを作成できます。このタイプのエンドポイントは、Google Cloud コンソールで作成できません。Google Cloud CLI を使用するか、API リクエストを送信する必要があります。詳しくは、共有 VPC をご覧ください。

この例では、単一のリージョンからアクセスできる共有 VPC ネットワークの IP アドレスを持つエンドポイントを作成する方法を示します。グローバルアクセスを有効にする、または Service Directory の名前空間を選択するには、エンドポイントを作成するをご覧ください。

gcloud

エンドポイントに割り振る内部 IP アドレスを予約するには、次のいずれかを行います。
- サービスプロジェクトで、共有 VPC ネットワークの共有サブネットから内部 IPv4 アドレスまたは IPv6 アドレスを予約します。
- ホストプロジェクトで、共有 VPC ネットワークの共有サブネットから内部 IPv4 アドレスまたは IPv6 アドレスを予約するようホストプロジェクト管理者に依頼します。
サービスプロジェクトでエンドポイントを作成します。
```
gcloud compute forwarding-rules create ENDPOINT_NAME \
    --region=REGION \
    --network=projects/HOST_PROJECT/global/networks/HOST_NETWORK \
    --address=projects/ADDRESS_PROJECT/regions/REGION/addresses/ADDRESS_NAME \
    --target-service-attachment=SERVICE_ATTACHMENT
```
次のように置き換えます。
- ENDPOINT_NAME: エンドポイントに割り当てる名前。
- REGION: エンドポイントのリージョン。これは、サービスプロデューサーのサービスアタッチメントが含まれているのと同じリージョンに存在している必要があります。
- HOST_PROJECT: 共有 VPC ネットワークのプロジェクトのプロジェクト ID。
- HOST_NETWORK: エンドポイントの IP アドレスを含む共有 VPC ネットワークの名前。
- ADDRESS_PROJECT: IP アドレスを予約したプロジェクトの ID。これは、サービスプロジェクトまたはホストプロジェクトのいずれかです。
- ADDRESS_NAME: 予約済み IP アドレスの名前。
- SERVICE_ATTACHMENT: サービスプロデューサーのサービスアタッチメントの URI。例: projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME

API

エンドポイントに割り振る内部 IP アドレスを予約するには、次のいずれかを行います。
- サービスプロジェクトで、共有 VPC ネットワークの共有サブネットから内部 IPv4 アドレスまたは IPv6 アドレスを予約します。
- ホストプロジェクトで、共有 VPC ネットワークの共有サブネットから内部 IPv4 アドレスまたは IPv6 アドレスを予約するようホストプロジェクト管理者に依頼します。
サービスプロジェクトでエンドポイントを作成します。
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/forwardingRules
{
   "name": "ENDPOINT_NAME",
   "IPAddress": "projects/ADDRESS_PROJECT/regions/REGION/addresses/ADDRESS_NAME",
   "target": "SERVICE_ATTACHMENT",
   "network": "projects/HOST_PROJECT/global/networks/HOST_NETWORK"
}
```
次のように置き換えます。
- PROJECT: サービスプロジェクト ID。
- REGION: エンドポイントのリージョン。これは、サービスプロデューサーのサービスアタッチメントが含まれているのと同じリージョンに存在している必要があります。
- ENDPOINT_NAME: エンドポイントに割り当てる名前。
- ADDRESS_PROJECT: IP アドレスを予約したプロジェクトの ID。これは、サービスプロジェクトまたはホストプロジェクトのいずれかです。
- ADDRESS_NAME: 予約済み IP アドレスの名前。
- SERVICE_ATTACHMENT: サービスプロデューサーのサービスアタッチメントの URI。例: projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME
- HOST_PROJECT: 共有 VPC ネットワークのプロジェクトのプロジェクト ID。
- HOST_NETWORK: エンドポイントの IP アドレスを含む共有 VPC ネットワークの名前。

エンドポイントを一覧表示する

構成したエンドポイントの一覧を取得できます。

このタスクに必要な権限

このタスクを実行するには、次の権限または次の IAM ロールのいずれかが付与されている必要があります。

gcloud CLI と API の権限

compute.forwardingRules.list

Google Cloud コンソールの権限

compute.forwardingRules.list
compute.globalForwardingRules.list
compute.networks.list
compute.backendBuckets.list
compute.backendServices.list
compute.instanceGroupManagers.list
compute.targetPools.list
compute.targetSslProxies.list
compute.targetTcpProxies.list
compute.urlMaps.list

ロール

詳しくは、ロールをご覧ください。

コンソール

Google Cloud コンソールで [Private Service Connect] ページに移動します。

[Private Service Connect] に移動
[接続エンドポイント] タブをクリックします。

エンドポイントが表示されます。

gcloud

gcloud compute forwarding-rules list \
    --filter 'target~serviceAttachments'

出力は次のようになります。

NAME  REGION  IP_ADDRESS  IP_PROTOCOL  TARGET
RULE          IP          TCP          REGION/serviceAttachments/SERVICE_NAME

API

この API 呼び出しでは、サービスへのアクセスに使用されるエンドポイントだけでなく、すべての転送ルールが返されます。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules

次のように置き換えます。

PROJECT_ID: エンドポイントが含まれるプロジェクト。
REGION: エンドポイントのリージョン。

エンドポイントの詳細を表示する

エンドポイントの接続ステータスなど、エンドポイント構成の詳細をすべて表示できます。

このタスクに必要な権限

このタスクを実行するには、次の権限または次の IAM ロールのいずれかが付与されている必要があります。

gcloud CLI と API の権限

compute.forwardingRules.get

Google Cloud コンソールの権限

compute.forwardingRules.list
compute.globalForwardingRules.list
compute.networks.list
compute.backendBuckets.list
compute.backendServices.list
compute.instanceGroupManagers.list
compute.targetPools.list
compute.targetSslProxies.list
compute.targetTcpProxies.list
compute.urlMaps.list

ロール

詳しくは、ロールをご覧ください。

コンソール

Google Cloud コンソールで [Private Service Connect] ページに移動します。

[Private Service Connect] に移動
[接続エンドポイント] タブをクリックします。
表示するエンドポイントをクリックします。

gcloud

gcloud compute forwarding-rules describe \
    ENDPOINT_NAME --region=REGION

以下を置き換えます。

ENDPOINT_NAME: エンドポイントの名前。
REGION: エンドポイントのリージョン。

API

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules/ENDPOINT_NAME

以下を置き換えます。

PROJECT_ID: エンドポイントが含まれるプロジェクト。
REGION: エンドポイントのリージョン。
ENDPOINT_NAME: エンドポイントの名前。

エンドポイントにラベルを付ける

エンドポイントのラベルを管理できます。詳しい手順については、リソースのラベル付けをご覧ください。

このタスクに必要な権限

このタスクを実行するには、次の権限または次の IAM ロールのいずれかが付与されている必要があります。

gcloud CLI と API の権限

compute.forwardingRules.pscSetLabels
compute.forwardingRules.setLabels

Google Cloud コンソールの権限

compute.forwardingRules.list
compute.globalForwardingRules.list
compute.networks.list
compute.backendBuckets.list
compute.backendServices.list
compute.instanceGroupManagers.list
compute.targetPools.list
compute.targetSslProxies.list
compute.targetTcpProxies.list
compute.urlMaps.list

ロール

詳しくは、ロールをご覧ください。

エンドポイントを削除する

エンドポイントを削除できます。

ただし、次の Service Directory 構成は、エンドポイントを削除しても削除されません。

Service Directory の名前空間
Service Directory の DNS ゾーン

Service Directory の名前空間と Service Directory の DNS ゾーンは他のサービスで使用できます。Service Directory 名前空間を削除するか、Service Directory DNS ゾーンを削除する前に、名前空間が空であることを確認します。

このタスクに必要な権限

このタスクを実行するには、次の権限または次の IAM ロールのいずれかが付与されている必要があります。

gcloud CLI と API の権限

compute.forwardingRules.pscDelete
compute.forwardingRules.delete
servicedirectory.namespaces.delete
servicedirectory.services.delete

Google Cloud コンソールの権限

compute.forwardingRules.list
compute.globalForwardingRules.list
compute.networks.list
compute.backendBuckets.list
compute.backendServices.list
compute.instanceGroupManagers.list
compute.targetPools.list
compute.targetSslProxies.list
compute.targetTcpProxies.list
compute.urlMaps.list

ロール

詳しくは、ロールをご覧ください。

コンソール

Google Cloud コンソールで [Private Service Connect] ページに移動します。

[Private Service Connect] に移動
[接続エンドポイント] タブをクリックします。
削除するエンドポイントを選択し、[削除] をクリックします。

gcloud

    gcloud compute forwarding-rules delete \
        ENDPOINT_NAME --region=REGION

以下を置き換えます。

ENDPOINT_NAME: エンドポイントの名前。
REGION: エンドポイントのリージョン。

API

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules/ENDPOINT_NAME

以下を置き換えます。

PROJECT_ID: エンドポイントが含まれるプロジェクト。
REGION: エンドポイントのリージョン。
ENDPOINT_NAME: エンドポイントの名前。

ハイブリッドネットワークからエンドポイントにアクセスする

Cloud Interconnect または Cloud VPN トンネル用の VLAN アタッチメントを使用して Google Cloud に接続しているネットワーク上のクライアントは、Private Service Connect エンドポイントにアクセスできます。

VLAN アタッチメントまたは Cloud VPN トンネルは、エンドポイントと同じ VPC ネットワーク（または共有 VPC ネットワーク）で終端する必要があります。ピアリングされた VPC ネットワーク内のクライアントはエンドポイントに到達できません。
グローバルアクセスが構成されている場合、VLAN アタッチメントまたは Cloud VPN トンネルからのクライアントトラフィックは、別のリージョンのエンドポイントに到達できます。
VLAN アタッチメントでは、Dataplane v1 と Dataplane v2 の両方がサポートされています。Dataplane のバージョンの詳細については、Dataplane v2 をご覧ください。

DNS 名を使用してエンドポイントにアクセスする場合は、限定公開 DNS ゾーンにクエリを実行できるように、他のネットワークのシステムを構成する必要があります。

Cloud DNS を使用して限定公開 DNS ゾーンを実装した場合は、次の手順を完了します。

他のネットワークが接続する VPC ネットワークにインバウンドサーバーポリシーを作成します。
他のネットワークが接続する VPC ネットワークで、VLAN アタッチメントまたは Cloud VPN トンネルが配置されているリージョンのインバウンドフォワーダーエントリポイントを特定します。
VPC ネットワークに接続する VLAN アタッチメントまたは Cloud VPN トンネルと同じリージョン内のインバウンドフォワーダーのエントリポイントにエンドポイントの DNS 名を転送するように、他のネットワークのシステムと DNS ネームサーバーを構成します。

Service Directory の DNS ゾーンを表示する

DNS の自動構成の前提条件を満たしている場合、NAMESPACE--REGION という形式の名前で DNS ゾーンが作成されます。

コンソール

Google Cloud コンソールで、Cloud DNS の [ゾーン] ページに移動します。

Cloud DNS の [ゾーン] に移動
NAMESPACE--REGION という名前の限定公開ゾーンを探します。

gcloud

次のコマンドを実行して、すべての限定公開 DNS ゾーンを一覧表示します。
```
gcloud dns managed-zones list \
    --filter="visibility=private"
```
次のコマンドを実行して、NAMESPACE--REGION という名前のゾーンの詳細を取得します。
```
gcloud dns managed-zones describe NAMESPACE--REGION
```

ゾーンが存在しない場合は、エンドポイントの詳細を表示し、エンドポイント構成に名前空間の値が含まれているかどうかを確認します。

エンドポイントに名前空間構成がある場合は、Service Directory の DNS ゾーンの構成をご覧ください。
エンドポイントに名前空間構成がない場合は、エンドポイントを Service Directory に登録するをご覧ください。

DNS を構成するその他の方法

自動 DNS 構成の前提条件が満たされていない場合は、他の方法で DNS エントリを作成できます。

エンドポイントに名前空間が構成されている場合は、Service Directory の DNS ゾーンの構成をご覧ください。
エンドポイントに名前空間が構成されていない場合は、エンドポイントを Service Directory に登録するをご覧ください。
DNS を手動で構成する場合は、DNS を手動で構成するをご覧ください。

Service Directory の DNS ゾーンを構成する

エンドポイントが Service Directory に登録されていても、接続先の公開サービスがドメイン名を構成していない場合、DNS の変更は行われません。

DNS の自動構成をレプリケートする場合は、Service Directory の名前空間を基盤とする Service Directory の DNS ゾーンを手動で構成します。ゾーンが作成されると、エンドポイントの DNS エントリが自動的に作成されます。

次の構成で Service Directory の DNS ゾーンを作成します。

ゾーン名: NAMESPACE--REGION を指定します。ここで、NAMESPACE はエンドポイントが登録されている名前空間、REGION はエンドポイントが作成されるリージョンです。
DNS 名: サービスプロデューサーが公開サービスに使用している DNS ドメイン。詳細については、サービスプロデューサーに確認してください。

DNS 名の形式は REGION.p.DOMAIN です。たとえば、サービスプロデューサーのパブリックドメインが example.com で、公開サービスが us-west1 にある場合は、us-west1.p.example.com ドメインを使用してサービスを利用できるようにすることをおすすめします。末尾のドットを含めます（例: us-west1.p.example.com.）。
Service Directory の名前空間: このエンドポイントに構成した名前空間。

エンドポイントの詳細を表示して、Service Directory の名前空間とリージョンを確認します。

この構成では、DNS 名 us-west1.p.example.com を使用して Service Directory の DNS ゾーンを構成し、analytics という名前のエンドポイントを作成した場合、analytics.us-west1.p.example.com の DNS レコードが自動的に作成されます。

Service Directory でエンドポイントを登録する

新しいエンドポイントは Service Directory に自動的に登録されます。ただし、Service Directory の自動登録が有効になる前にエンドポイントが作成された場合は、この構成が見つからない可能性があります。

エンドポイントを削除して、Service Directory に自動的に登録される新しいエンドポイントを作成できます。

または、次の手順で既存のエンドポイントを Service Directory の名前空間に登録できます。

エンドポイントに Service Directory 名前空間 NAMESPACE を作成します。
エンドポイント SERVICE_NAME に Service Directory サービスを作成します。

このサービスには、エンドポイント（ENDPOINT_NAME）の転送ルールの同じ名前を使用します。
default という名前の Service Directory エンドポイントを作成し、エンドポイントの IP アドレスとポート（443）を使用します。

エンドポイントを Service Directory に登録したら、Service Directory の DNS ゾーンを構成します。

DNS を手動で構成する

DNS の自動構成ができない場合や、構成で有効になっていない場合は、Cloud DNS を使用して手動で DNS レコードを作成できます。

詳しくは次のページをご覧ください。

アクセス制御: DNS 管理者ロール（roles/dns.admin）は、DNS ゾーンとレコードの作成に必要な権限を提供します。
限定公開ゾーンを作成する
- 限定公開ゾーンを構成する場合は、DNS 名を指定します。サービスプロデューサーが公開サービスに使用している DNS ドメインを使用します。詳細については、サービスプロデューサーに確認してください。
  
  形式は REGION.p.DOMAIN となります。たとえば、サービスプロデューサーのパブリックドメインが example.com で、公開サービスが us-west1 にある場合は、us-west1.p.example.com ドメインを使用してサービスを利用できるようにすることをおすすめします。
レコードを追加する

トラブルシューティング

限定公開 DNS ゾーンを作成できない

エンドポイントを作成すると、Service Directory DNS ゾーンが作成されます。ゾーンの作成が失敗する理由には、次のようなものがあります。

プロジェクトで Cloud DNS API が有効になっていない。
Service Directory DNS ゾーンを作成するために必要な権限がない。
この VPC ネットワークに同じゾーン名を持つ DNS ゾーンが存在する。
この VPC ネットワークに同じドメイン名の DNS ゾーンがすでに存在する。

Service Directory の DNS ゾーンを手動で作成するには、次の手順を行います。

プロジェクトで Cloud DNS API が有効になっていることを確認します。
Service Directory DNS ゾーンの作成に必要な権限があることを確認します。
- dns.managedZones.create
- dns.networks.bindPrivateDNSZone
- servicedirectory.namespaces.associatePrivateZone
不要な競合ゾーンがある場合は、DNS ゾーンを削除します。
エンドポイントに関連付けられている Service Directory 名前空間に基づいて Service Directory の DNS ゾーンを作成します。

グローバルアクセスが構成されていると、エンドポイントの作成に失敗する

すべての Private Service Connect 公開サービスが、グローバルアクセスが有効になっているエンドポイントをサポートしているわけではありません。グローバルアクセスを構成したエンドポイントが公開サービスでサポートされていない場合は、次のエラーメッセージが表示されます。

Private Service Connect global access is not supported for the given forwarding rule, since its producer service does not support consumer global access.

グローバルアクセスオプションなしでエンドポイントを作成します。

エンドポイントの作成は成功するが、接続が確立されない

公開サービスのエンドポイントが正常に作成されても接続が確立されていない場合は、エンドポイントの接続ステータスを確認します。接続ステータスが問題の解決手順を示している場合があります。

エンドポイントを介して公開サービスにアクセスする

ロール

始める前に

エンドポイントを作成する

このタスクに必要な権限

コンソール

gcloud

API

このタスクに必要な権限

共有 VPC ネットワークの IP アドレスを使用してエンドポイントを作成する

gcloud

API

エンドポイントを一覧表示する

このタスクに必要な権限

コンソール

gcloud

API

エンドポイントの詳細を表示する

このタスクに必要な権限

コンソール

gcloud

API

エンドポイントにラベルを付ける

このタスクに必要な権限

エンドポイントを削除する

このタスクに必要な権限

コンソール

gcloud

API

ハイブリッド ネットワークからエンドポイントにアクセスする

Service Directory の DNS ゾーンを表示する

コンソール

gcloud

DNS を構成するその他の方法

Service Directory の DNS ゾーンを構成する

Service Directory でエンドポイントを登録する

DNS を手動で構成する

トラブルシューティング

限定公開 DNS ゾーンを作成できない

グローバル アクセスが構成されていると、エンドポイントの作成に失敗する

エンドポイントの作成は成功するが、接続が確立されない

ハイブリッドネットワークからエンドポイントにアクセスする

グローバルアクセスが構成されていると、エンドポイントの作成に失敗する