创建 Data Transfer Essentials 资源

如需将流量标识为已配置为采用数据转移基础版结算，您需要选择服务并将其与所选端点相关联。本页面介绍了如何创建所需的数据转移必备资源，即配置和目标平台。

准备工作

在创建“数据转移基础知识”配置或目标之前，请执行以下操作：

  1. 如果您尚未安装 Google Cloud CLI，请进行安装。

  2. 使用您的账号对 gcloud CLI 进行身份验证：

    gcloud auth login

  3. 设置项目：

    gcloud config set project PROJECT_ID

    请将 PROJECT_ID 替换为您的项目 ID。

  4. 在项目中启用 Network Connectivity API。

  5. 配置权限。

  6. 检查您要为 Data Transfer Essentials 选择的服务是否受支持。您只能为受支持的服务和地区配置数据传输基本功能。

    gcloud

    使用 gcloud network-connectivity multicloud-data-transfer-supported-services list 命令。

    gcloud network-connectivity multicloud-data-transfer-supported-services list \
    --location=LOCATION

    将 LOCATION 替换为 Google Cloud地区 ID，例如 europe-west3。

    以下示例输出显示，这些服务符合使用 Data Transfer Essentials 进行配置的条件，因为它们使用的是受支持的层级。

    NAME                   SERVICE_CONFIGS
cloud-sql              [{'eligibilityCriteria': 'NETWORK_SERVICE_TIER_PREMIUM_ONLY'}]
cloud-storage          [{'eligibilityCriteria': 'REQUEST_ENDPOINT_REGIONAL_ENDPOINT_ONLY'}]
compute-engine         [{'eligibilityCriteria': 'NETWORK_SERVICE_TIER_STANDARD_ONLY'}]

    如需检查特定服务是否符合条件，请使用 gcloud network-connectivity multicloud-data-transfer-supported-services describe 命令。

    gcloud network-connectivity multicloud-data-transfer-supported-services describe SERVICE1 \
    --location=LOCATION

    将 SERVICE1 替换为表示相应服务的有效字符串。请参阅支持的服务和地区。

    API

    使用 multicloudDataTransferSupportedServices.get 方法。

    GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices

    替换以下内容：

    • PROJECT_ID：您的项目的 ID
    • LOCATION： Google Cloud 区域 ID，例如 europe-west3

    以下示例输出列出了符合使用 Data Transfer Essentials 配置条件的 Google 服务，因为它们使用的是受支持的层级。

    {
  "multicloudDataTransferSupportedServices": [
    {
      "name": "cloud-sql",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "NETWORK_SERVICE_TIER_PREMIUM_ONLY"
        }
      ]
    },
    {
      "name": "cloud-storage",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "REQUEST_ENDPOINT_REGIONAL_ENDPOINT_ONLY"
        }
      ]
    },
    {
      "name": "compute-engine",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "NETWORK_SERVICE_TIER_STANDARD_ONLY"
        }
      ]
    }
  ]
}

    如需检查特定服务是否符合条件，请使用以下方法：

    GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices
{
"service": "SERVICE1"
}

    替换以下内容：

    • PROJECT_ID：您的项目的 ID。
    • LOCATION： Google Cloud 区域 ID，例如 europe-west3。
    • SERVICE1：表示服务的有效字符串。请参阅支持的服务和地区。

  7. 检查您要指定的自治系统编号 (ASN) 是否已被识别。您只能将流量配置到使用已识别 ASN 的目的地。

创建配置

创建包含指定服务的 Data Transfer Essentials 配置。您只能为每个项目的每个区域创建一项配置。

gcloud

使用 gcloud network-connectivity multicloud-data-transfer-configs create 命令。

gcloud network-connectivity multicloud-data-transfer-configs create CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --services=SERVICE-A,...

替换以下内容：

  • CONFIGURATION_NAME：配置的名称。
  • LOCATION：配置的区域。
  • DESCRIPTION：配置及其用途的说明。
  • SERVICE-A,...：一系列字符串，表示您要为哪些服务配置数据传输基础版。如需查看有效字符串，请参阅支持的服务和区域。

以下示例命令会在 europe-west3 区域中为 compute-engine、cloud-storage 和 cloud-sql 服务创建一个名为 config1 的配置。

gcloud network-connectivity multicloud-data-transfer-configs create config1 \
    --location=europe-west3 \
    --description="configuration for europe-west3" \
    --services=compute-engine,cloud-storage,cloud-sql

API

使用 multicloudDataTransferConfigs.create 方法。

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
{
  "description": "DESCRIPTION",
  "services": {
    "SERVICE-A",
    "SERVICE-B"
  }
}

替换以下内容：

  • PROJECT_ID：您的项目的 ID。
  • LOCATION：配置的区域。
  • CONFIGURATION_NAME：配置的名称。
  • DESCRIPTION：配置及其用途的说明。
  • SERVICE-A,...：一系列字符串，表示您要为哪些服务配置数据传输基础版。如需查看有效字符串，请参阅支持的服务和区域。

您可以选择使用 requestID 查询参数来标识您的 API 请求。如果您重试请求，服务器可以使用该标识符来忽略已响应的请求。

以下 JSON 代码段会在 europe-west3 区域中为 compute-engine、cloud-storage 和 cloud-sql 服务创建一个名为 config1 的配置。

POST https://networkconnectivity.googleapis.com/v1/projects/my-project/locations/europe-west3/multicloudDataTransferConfigs/config1
{
  "description": "configuration for europe-west3",
  "services": {
    "compute-engine": {},
    "cloud-storage": {},
    "cloud-sql": {}
}

创建“数据转移基础知识”配置最多需要 24 小时。如需查看配置的状态，请查看配置的详细信息。

如需添加或移除服务，请更新配置。

在尝试创建新配置之前，请删除现有配置。

为配置创建目的地

为“数据转移基础知识”配置创建目标。目标资源用于在现有配置与具有端点的外部 IP 前缀之间创建关联。端点包含云服务提供商 (CSP) 标识符及其 ASN。

一次创建一个目的地。

gcloud

使用 gcloud network-connectivity multicloud-data-transfer-configs destinations create 命令。

gcloud network-connectivity multicloud-data-transfer-configs destinations create DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --ip-prefix=IP_PREFIX \
    --endpoints=asn=ASN,csp=CSP

替换以下内容：

  • DESTINATION_NAME：目的地的名称。 该名称在区域内必须是唯一的。
  • CONFIGURATION_NAME：配置的名称。
  • LOCATION：配置的区域。
  • DESCRIPTION：目标及其用途的说明。

  • IP_PREFIX：指定为范围（例如 203.0.113.0/24 或 2001:db8::/32）或值（例如 203.0.113.6 或 2001:db8:2:2:2:2:2:2）的目标 IP 前缀。一个 IP 前缀只能在配置中使用一次，必须与至少一个端点相关联，并且最多可以与 5 个端点相关联。

  • 指定与要添加到目标位置的端点对应的字符串：

    • ASN：预期会公布前缀的 ASN。请参阅已识别的 ASN。
    • CSP：一个字符串，表示公布前缀的 ASN 的 CSP。

    您可以在同一命令中多次指定 endpoints 标志。目的地必须至少有一个端点，且端点数量不得超过 5 个。

以下示例命令会在 europe-west3 区域中为配置 config1 创建一个名为 destination1 的目标，其中包含指定的 IP 前缀和端点。

gcloud network-connectivity multicloud-data-transfer-configs destinations create destination1 \
    --multicloud-data-transfer-config=config1 \
    --location=europe-west3 \
    --description="destination1 for config1" \
    --ip-prefix=203.0.113.0/24 \
    --endpoints=asn=16509,csp="aws"

API

使用 multicloudDataTransferConfigs.destinations.create 方法。

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
  "description": "DESCRIPTION",
  "ipPrefix": "IP_PREFIX",
  "endpoints": [
    {
      "asn": "ASN",
      "csp": "CSP"
    }
  ]
}

替换以下内容：

  • PROJECT_ID：您的项目的 ID。
  • LOCATION：配置的区域。
  • CONFIGURATION_NAME：配置的名称。
  • DESTINATION_NAME：目的地的名称。 该名称在区域内必须是唯一的。
  • DESCRIPTION：目标及其用途的说明。

  • IP_PREFIX：指定为范围（例如 203.0.113.0/24 或 2001:db8::/32）或值（例如 203.0.113.6 或 2001:db8:2:2:2:2:2:2）的目标 IP 前缀。一个 IP 前缀只能在配置中使用一次，并且只能用于一个 ASN。

  • 指定与要添加到目标位置的端点对应的字符串：

    • ASN：预期会公布前缀的 ASN。请参阅已识别的 ASN。
    • CSP：一个字符串，表示公布前缀的 ASN 的 CSP。

    您可以在同一调用中指定多个端点。目的地必须至少有一个端点，且端点数不能超过 5 个。

以下示例命令会在 europe-west3 区域中为配置 config1 创建一个名为 destination1 的目标，其中包含指定的 IP 前缀和端点。

POST https://networkconnectivity.googleapis.com/v1/projects/my-project/locations/europe-west3/multicloudDataTransferConfigs/config1/destinations/destination1
{
  "description": "destination1 for config1",
  "ipPrefix": "203.0.113.0/24",
  "endpoints": [
    {
      "asn": "16509",
      "csp": "aws"
    }
  ]
}

如需查看目的地的状态，请查看目的地的详细信息。

如需添加或移除端点，请更新目标。

或者，删除目的地。

后续步骤