通过端点访问区域性 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 或 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 控制台中，前往创建 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：端点的名称。