透過端點存取區域性 Google API

控制台

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

   前往 Private Service Connect

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

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

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

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

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

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

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

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

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

    • 選取「自動分配」，自動分配並預留新的靜態 IP 位址。
    • 從清單中選取靜態 IP 位址。
    • 按一下「建立 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：端點的虛擬私有雲網路名稱。

• 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：端點的虛擬私有雲網路名稱。
• SUBNET_NAME：要將端點連線至的子網路名稱。
• REP_DNS_NAME：要連線的區域服務端點主機名稱，例如 spanner.me-central2.rep.googleapis.com。

gcloud

1. 使用 gcloud compute addresses create 指令，保留靜態 IP 位址供區域端點使用。 使用靜態 IP 位址是 IPv4 的選用功能，但 IPv6 必須使用。

   在服務專案中建立位址資源，並指定主專案中的子網路。

   gcloud compute addresses create ADDRESS_NAME \
       --region=REGION \
       --subnet=projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET \
       --ip-version=IP_VERSION \
       --project=SERVICE_PROJECT
   

   更改下列內容：

   • ADDRESS_NAME：要指派給保留 IP 位址的名稱。
   • REGION：端點 IP 位址的區域。這個區域必須與服務生產者的服務連結所在的區域相同。
   • HOST_PROJECT：主機專案的專案 ID。
   • HOST_SUBNET：端點 IP 位址的子網路名稱。
   • IP_VERSION：IP 位址的 IP 版本，可以是 IPV4 或 IPV6。預設為 IPV4。如要指定 IPV6，IP 位址必須連線至具有內部 IPv6 位址範圍的子網路。
   • SERVICE_PROJECT：服務專案的專案 ID

2. 使用 gcloud network-connectivity regional-endpoints create 指令在服務專案中建立區域端點。

   gcloud network-connectivity regional-endpoints create ENDPOINT_NAME \
       --region=REGION \
       --address=ADDRESS \
       --network=projects/HOST_PROJECT/global/networks/HOST_NETWORK \
       --subnetwork=projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET \
       --target-google-api=REP_DNS_NAME \
       --project=SERVICE_PROJECT
       

   如要讓其他區域的資源存取端點，請新增 --enable-global-access 旗標。

   更改下列內容：

   • ENDPOINT_NAME：端點名稱。

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

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

     • IPv4 位址，例如 10.0.0.2。
     • IPv4 或 IPv6 位址資源 URI。位址資源必須在服務專案中建立，而非主專案。例如：projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME。
     • HOST_PROJECT：主機專案的 ID。

   • HOST_NETWORK：主機專案中的虛擬私有雲網路名稱。

   • HOST_SUBNET：要將端點連線至主專案的子網路。

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

   • SERVICE_PROJECT：服務專案的專案 ID

API

1. 預留靜態 IP 位址，用於區域端點。使用靜態 IP 位址是 IPv4 的選用設定，但 IPv6 必須使用。

   在服務專案中建立位址資源，並指定主專案中的子網路。

   POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT/regions/REGION/addresses
   

   
   {
       "name": "ADDRESS_NAME",
       "addressType": "INTERNAL",
       "subnetwork": "projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET",
       "ipVersion": "IP_VERSION"
   }
   

   更改下列內容：

   • SERVICE_PROJECT：服務專案的 ID。

   • REGION：端點的區域。這必須與您要連線的區域端點位於相同區域。

   • ADDRESS_NAME：要指派給靜態 IP 位址的名稱。

   • HOST_PROJECT：主機專案的 ID。

   • HOST_SUBNET：要保留 IP 位址的 Shared VPC 網路子網路。

   • IP_VERSION：IP 位址的 IP 版本，可以是 IPV4 或 IPV6。預設為 IPV4。如要指定 IPV6，IP 位址必須連線至具有內部 IPv6 位址範圍的子網路。

2. 使用 projects.locations.regionalEndpoints.create 方法建立 Private Service Connect 端點。

   HTTP 方法和網址：

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

   {
     "accessType": "REGIONAL",
     "address": "ADDRESS",
     "network": "projects/HOST_PROJECT/global/networks/HOST_NETWORK",
     "subnetwork": "projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET",
     "targetGoogleApi": "REP_DNS_NAME"
   }
   

   更改下列內容：

   • SERVICE_PROJECT：服務專案的 ID。
   • REGION：要在其中建立端點的區域。
   • ENDPOINT_NAME：端點名稱。
   • ADDRESS：要用於端點的 IPv4 或 IPv6 位址。如省略此欄位，系統會從子網路分配 IPv4 位址。請使用下列其中一種格式：
     • IPv4 位址，例如 10.0.0.2。
     • IPv4 或 IPv6 位址資源 URI，例如 projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME。
   • HOST_PROJECT：主機專案的 ID。
   • HOST_NETWORK：主機專案中的網路名稱。
   • HOST_SUBNET：要將端點連線至主機專案中的子網路名稱。
   • 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 區域) 頁面。

   前往建立 DNS 區域

2. 在「Zone type」(區域類型) 中，選取「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. 在「Options」(選項) 下方選取「Default (private)」(預設 (私人))。

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

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：以半形逗號分隔的虛擬私有雲網路清單，這些網路有權查詢該區域

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：經授權可查詢區域的虛擬私有雲網路完整網址，例如 https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME。

控制台

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

   前往 Cloud DNS 區域

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

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

4. 在「Create record set」(建立記錄集) 頁面，將「DNS name」(DNS 名稱) 欄位留空。將這個欄位留空，即可在網域頂層建立資源記錄。

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

6. 在「IPv4 address」(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：解析器快取這個資源記錄集的存留時間 (以秒為單位)，例如 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：解析器快取這個資源記錄集的存留時間 (以秒為單位)，例如 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：端點名稱。