通过专用端点访问区域级和多区域级 Google API

控制台

1. 在 Google Cloud 控制台中，前往 Private Service Connect 页面。

   转到 Private Service Connect

2. 点击连接端点。

3. 在目标中，选择 Google API。

4. 在范围列表中，选择区域级。

5. 在区域列表中，选择您要使用的区域。

6. 在目标服务列表中，选择您要访问的服务。

7. 在端点名称中，输入端点的名称。

8. 在网络中，选择一个网络。

9. 在子网中，选择一个子网。

10. 在 IP 地址中，执行以下操作之一以配置 IP 地址：

    • 选择自动分配以自动分配和预留新的静态 IP 地址。
    • 从列表中选择一个静态 IP 地址。
    • 点击创建 IP 地址以预留新的静态 IP 地址。

11. 可选：如需使端点可从 VPC 网络中的所有区域进行访问，请选择启用全球访问权限。

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 或 /96 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（区域级）或 storage.us.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 或 /96 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（区域级）或 storage.us.rep.googleapis.com（多区域级）。

gcloud

1. 使用 gcloud compute addresses create 命令预留一个静态 IP 地址，以用于区域级端点。对于 IPv4，使用静态 IP 地址是可选的；对于 IPv6，则必须使用静态 IP 地址。

   在服务项目中创建地址资源，并指定宿主项目中的子网。

   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 或 /96 IPv6 地址。如果省略，系统会分配子网中的 IPv4 地址。请采用以下某种格式：

     • IPv4 地址，例如 10.0.0.2。
     • IPv4 或 IPv6 地址资源 URI。地址资源必须在服务项目中创建，而不是在宿主项目中创建。例如 projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME。
     • HOST_PROJECT：宿主项目的 ID。

   • HOST_NETWORK：宿主项目中的 VPC 网络的名称。

   • HOST_SUBNET：您要将端点连接到的宿主项目中的子网。

   • REP_DNS_NAME：您要连接到的区域级服务端点或多区域级端点的主机名。 例如，spanner.me-central2.rep.googleapis.com（区域级）或 storage.us.rep.googleapis.com（多区域级）。

   • SERVICE_PROJECT：服务项目的项目 ID

API

1. 预留一个静态 IP 地址，以用于区域端点。对于 IPv4，使用静态 IP 地址是可选的；对于 IPv6，则必须使用静态 IP 地址。

   在服务项目中创建地址资源，并指定宿主项目中的子网。

   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：共享 VPC 网络中要从中预留 IP 地址的子网。

   • 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 或 /96 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（单区域）或 storage.us.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 控制台中，前往创建 DNS 区域页面。

   前往“创建 DNS 区域”

2. 对于可用区类型，请选择专用。

3. 对于区域名称，请输入一个名称。例如，如果您的 Private Service Connect 端点指向 spanner.me-central2.rep.googleapis.com，请输入 spanner-me-central2-rep-googleapis-com。

4. 对于 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. 在区域详情页面上，点击添加标准。

4. 在创建记录集页面上，将 DNS 名称字段留空。如果将该字段留空，系统会在网域顶层创建资源记录。

5. 对于资源记录类型，请选择 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 记录的类型，例如 A（用于 IPv4 记录）或 AAAA（用于 IPv6 记录）。
• 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 记录的类型，例如 A（用于 IPv4 记录）或 AAAA（用于 IPv6 记录）。
• 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：端点的名称。