透過端點存取區域性 Google API

主控台

1. 前往 Google Cloud 控制台的「Private Service Connect」頁面。

   前往 Private Service Connect

2. 按一下「連結端點」。

3. 在「目標」中，選取「Google API」。

4. 在「範圍」清單中選取「區域」。

5. 在「區域」清單中選取要使用的區域。

6. 在「Target service」清單中，選取要存取的服務。

7. 在「端點名稱」中輸入端點名稱。

8. 在「Network」(網路) 中選取網路。

9. 在「Subnetwork」(子網路) 中，選取子網路。

10. 在「IP 位址」中，執行下列任一操作來設定 IP 位址：

    • 選取「自動分配」，即可自動分配及保留新的 IP 位址。
    • 從清單中選取已保留的 IP 位址。
    • 按一下「Create IP address」(建立 IP 位址) 即可預留新的 IP 位址。

11. 選用：如要讓端點可在虛擬私有雲網路的所有區域中使用，請選取「啟用全域存取權」。

12. 按一下「新增端點」。

gcloud

使用 gcloud network-connectivity regional-endpoints create 指令。

gcloud network-connectivity regional-endpoints create ENDPOINT_NAME \
    --region=REGION \
    --address=ADDRESS \
    --network=projects/PROJECT_ID/global/networks/NETWORK_NAME \
    --subnetwork=projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME \
    --target-google-api=REP_DNS_NAME

如果您想讓其他區域的資源使用端點，請新增 --enable-global-access 標記。

更改下列內容：

• ENDPOINT_NAME：端點名稱。

• REGION：要建立端點的區域。

• ADDRESS：您要用於端點的 IPv4 或 IPv6 位址。如果省略此欄位，系統會分配子網路中的 IPv4 位址。請使用下列其中一種格式：

  • IPv4 位址，例如 10.0.0.2。
  • IPv4 或 IPv6 位址資源 URI，例如 projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME。

• PROJECT_ID：您要建立端點的專案。

• NETWORK_NAME：端點的 VPC 網路名稱。

• SUBNET_NAME：您要連結端點的子網路。

• REP_DNS_NAME：您要連線的區域服務端點主機名稱。例如：spanner.me-central2.rep.googleapis.com。

API

請使用 projects.locations.regionalEndpoints.create 方法。

HTTP 方法和網址：

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints?regionalEndpointId=ENDPOINT_NAME

{
  "accessType": "REGIONAL",
  "address": "ADDRESS",
  "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
  "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
  "targetGoogleApi": "REP_DNS_NAME"
}

更改下列內容：

• PROJECT_ID：端點的專案 ID。
• REGION：要建立端點的區域。
• ENDPOINT_NAME：端點名稱。
• ADDRESS：您要用於端點的 IPv4 或 IPv6 位址。如果省略此欄位，系統會分配子網路中的 IPv4 位址。請使用下列其中一種格式：
  • IPv4 位址，例如 10.0.0.2。
  • IPv4 或 IPv6 位址資源 URI，例如 projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME。
• NETWORK_NAME：端點的 VPC 網路名稱。
• SUBNET_NAME：您要連結端點的子網路名稱。
• REP_DNS_NAME：您要連線的區域服務端點主機名稱。例如：spanner.me-central2.rep.googleapis.com。

主控台

1. 前往 Google Cloud 控制台的「Private Service Connect」頁面。

   前往 Private Service Connect

2. 按一下「已連結的端點」分頁。

   系統會顯示所有端點，包括設有區域端點目標的端點。

gcloud

使用 gcloud network-connectivity regional-endpoints list 指令。

gcloud network-connectivity regional-endpoints list \
    --region=REGION

將 REGION 替換為您要列出的端點區域。

API

請使用 projects.locations.regionalEndpoints.list 方法。

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints

更改下列內容：

• PROJECT_ID：端點的專案 ID。
• REGION：您要列出的端點區域。

主控台

1. 前往 Google Cloud 控制台的「Create a DNS zone」頁面。

   前往「建立 DNS 區域」

2. 在「可用區類型」中，選取「Private」。

3. 在「Zone name」(可用區名稱) 輸入名稱。舉例來說，如果 Private Service Connect 端點指向 spanner.me-central2.rep.googleapis.com，請輸入 spanner-me-central2-rep-googleapis-com。

4. 針對「DNS name」(DNS 名稱)，請指定目標區域端點的主機名稱，後面加上半形句號。例如：spanner.me-central2.rep.googleapis.com.。

5. 選用步驟：新增說明。

6. 在「選項」下方，選取「預設 (私人)」。

7. 選取要顯示私人區域的 VPC 網路。只有您選取的 VPC 網路可查詢該區域中的記錄。

8. 按一下 [建立]。

gcloud

執行 dns managed-zones create 指令：

gcloud dns managed-zones create ZONE_NAME \
    --dns-name=REP_DNS_NAME. \
    --networks=VPC_NETWORK_LIST \
    --visibility=private \
    --description="Private zone for REP_DNS_NAME"

更改下列內容：

• ZONE_NAME：區域名稱，例如 spanner-me-central2-rep-googleapis.com。
• DESCRIPTION：區域說明
• REP_DNS_NAME：區域的 DNS 後置字串；請使用目標區域端點主機名稱，例如 spanner.me-central2.rep.googleapis.com
• VPC_NETWORK_LIST：以半形逗號分隔的清單，當中列有獲授權查詢區域的 VPC 網路

API

使用 managedZones.create 方法傳送 POST 要求：

HTTP 方法和網址：

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones

JSON 要求內文：

{
  "name": "ZONE_NAME",
  "dnsName": "REP_DNS_NAME.",
  "description": "DESCRIPTION",
  "visibility": "private",
  "privateVisibilityConfig": {
    "kind": "dns#managedZonePrivateVisibilityConfig",
    "networks": [
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "NETWORK_1_URL"
      },
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "NETWORK_2_URL"
      }
    ]
  }
}

更改下列內容：

• PROJECT_ID：DNS 區域的專案 ID。
• ZONE_NAME：您為這個區域端點建立的私人可用區名稱。
• REP_DNS_NAME：您要建立的記錄 FQDN；請使用目標區域端點主機名稱，例如 spanner.me-central2.rep.googleapis.com。
• DESCRIPTION：DNS 區域的說明。
• NETWORK_1_URL 和 NETWORK_2_URL：獲授權查詢該區的 VPC 網路的完整網址，例如 https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME。

主控台

1. 前往 Google Cloud 控制台的「Cloud DNS 區域」頁面。

   前往 Cloud DNS 區域

2. 按一下要新增記錄的代管區域名稱。

3. 在「Zone details」(可用區詳細資料) 頁面中，按一下「Add standard」(新增標準)。

4. 在「Create record set」頁面中，將「DNS name」欄位留空。將這個欄位留空，系統會在網域頂層建立資源記錄。

5. 在「Resource record type」(資源記錄類型) 中，選取 A。

6. 在「IPv4 位址」欄位中，輸入或選取 Private Service Connect 端點的 IP 位址。

7. 按一下 [建立]。

gcloud

如要新增資源記錄集，請使用 gcloud dns record-sets create 指令：

gcloud dns record-sets create REP_DNS_NAME \
    --rrdatas=ADDRESS \
    --type=RECORD_TYPE \
    --ttl=TTL \
    --zone=ZONE_NAME

更改下列內容：

• REP_DNS_NAME：您要建立的記錄 FQDN；請使用目標區域端點主機名稱，例如 spanner.me-central2.rep.googleapis.com。
• ADDRESS：Private Service Connect 端點的 IP 位址。
• RECORD_TYPE：DNS 記錄類型，例如 IPv4 記錄的 A，或 IPv6 記錄的 AAAA。
• TTL：解析器快取此資源記錄集合的 TTL，以秒為單位，例如 300。
• ZONE_NAME：您為這個區域端點建立的私人可用區名稱。

API

如要新增資源記錄集，請使用 resourceRecordSets.create 方法：

HTTP 方法和網址：

POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/ZONE_NAME/rrsets

JSON 要求內文：

{
  "name": "REP_DNS_NAME.",
  "type": "RECORD_TYPE",
  "ttl": TTL,
  "rrdatas": [ "ADDRESS" ]
}

更改下列內容：

• PROJECT_ID：DNS 區域的專案 ID。
• ZONE_NAME：您為這個區域端點建立的私人可用區名稱。
• REP_DNS_NAME：您要建立的記錄 FQDN；請使用目標區域端點主機名稱，例如 spanner.me-central2.rep.googleapis.com。
• RECORD_TYPE：DNS 記錄類型，例如 IPv4 記錄的 A，或 IPv6 記錄的 AAAA。
• TTL：解析器快取此資源記錄集合的 TTL，以秒為單位，例如 300。
• ADDRESS：Private Service Connect 端點的 IP 位址。

gcloud

使用 gcloud network-connectivity regional-endpoints describe 指令。

gcloud network-connectivity regional-endpoints describe \
    ENDPOINT_NAME --region=REGION

更改下列內容：

• ENDPOINT_NAME：端點名稱。
• REGION：端點的區域。

API

使用 projects.locations.regionalEndpoints.get 指令。

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints/ENDPOINT_NAME

更改下列內容：

• PROJECT_ID：端點的專案 ID。
• REGION：您要列出的端點區域。
• ENDPOINT_NAME：端點名稱。

gcloud

使用 gcloud network-connectivity regional-endpoints delete 指令。

gcloud network-connectivity regional-endpoints delete \
    ENDPOINT_NAME --region=REGION

更改下列內容：

• ENDPOINT_NAME：端點名稱。
• REGION：端點的區域。

API

使用 projects.location.regionalEndpoints.delete 指令。

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints/ENDPOINT_NAME

更改下列內容：

• PROJECT_ID：端點的專案 ID。
• REGION：端點的區域。
• ENDPOINT_NAME：端點名稱。