管理数据传输基础版资源

本页面介绍了如何管理 使用 Data Transfer Essentials 创建的资源。

管理配置

您可以列出项目中的 Data Transfer Essentials 配置、检查配置的状态、更新配置或删除配置。

列出项目中的配置

如需列出项目中的某个位置的所有配置，请使用以下方法之一：

gcloud

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

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

将 LOCATION 替换为配置的区域。

API

使用 multicloudDataTransferConfigs.get 方法。

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

替换以下内容：

  • PROJECT_ID：您的项目的 ID
  • LOCATION：配置的区域

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

查看配置的详细信息

如需查看配置的详细信息，请使用以下方法之一：

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs describe CONFIGURATION_NAME \
    --location=LOCATION

替换以下内容：

  • CONFIGURATION_NAME：配置的名称
  • LOCATION：配置的区域

以下示例输出显示，来自 compute-engine 的流量已准备好纳入 Data Transfer Essentials 结算范围。对于 cloud-sql 和 cloud-storage，更新处于待处理状态。 effectiveTime 值表示状态预计生效的时间。该示例还显示了配置中的目标总数以及处于活跃状态的目标数。

description: 'sample config'
destinationsCount: 2
destinationsActiveCount: 0
name: config1
region: https://www.googleapis.com/network-connectivity/v1/projects/my-project/locations/europe-west3
services:
- cloud-sql:
  states:
  - effectiveTime: 2024-12-12T08:00:00Z
    state: DELETING
- cloud-storage:
  states:
  - effectiveTime: 2024-12-12T08:00:00Z
    state: ADDING
- compute-engine:
  states:
  - state: ACTIVE
…

API

使用 multicloudDataTransferConfigs.list 方法。

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

替换以下内容：

  • PROJECT_ID：您的项目的 ID
  • LOCATION：配置的区域
  • CONFIGURATION_NAME：配置的名称

以下示例输出显示，来自 compute-engine 的流量已准备好纳入 Data Transfer Essentials 结算范围。 对于 cloud-storage 和 cloud-sql，更新处于待处理状态。 effectiveTime 值表示状态预计生效的时间。该示例还显示了配置中的目标总数以及处于活跃状态的目标数。

{
  "multicloudDataTransferConfig": [
    {
      "name": "projects/test-project/locations/europe-west1/multicloudDataTransferConfigs/config1",
      "createTime": "2025-05-14T10:16:22.761275571Z",
      "updateTime": "2025-05-14T10:16:25.872465362Z",
      "etag": "l-WY4OT6hBsMT8sAwEbuSpviLsE9iC_UDJXDyfE265I",
      "description": "sample config",
      "destinationsCount": 1,
      "destinationsActiveCount": 1,
      "services": {
        "cloud-sql": {
          "states": [
            {
              "effectiveTime": "2025-05-29T07:00:00Z",
              "state": "DELETING"
            }
          ]
        },
        "cloud-storage": {
          "states": [
            {
              "effectiveTime": "2025-05-29T07:00:00Z",
              "state": "ADDING"
            }
          ]
        },
        "compute-engine": {
          "states": [
            {
              "state": "ACTIVE"
            }
          ]
        }
      }
    }
  ]
}

服务的状态可以是以下之一：

  • ADDING：正在添加服务。
  • DELETING：正在删除服务。
  • ACTIVE：服务已配置为纳入 Data Transfer Essentials 结算范围。

更新配置

如需在配置中添加或删除服务，请使用以下方法之一：

gcloud

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

如需指定服务，请使用以下选项之一：

  • services：将配置中的服务替换为指定的列表
  • update-services：将指定的服务添加到配置中
  • remove-services：从配置中移除指定的服务
  • clear-services：从配置中移除所有服务
gcloud network-connectivity multicloud-data-transfer-configs update CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --services=SERVICE-A,... |
        --update-services=SERVICE-A,... |
        --remove-services=SERVICE-A,... |
        --clear-services

替换以下内容：

  • CONFIGURATION_NAME：您要更新的配置的名称。
  • LOCATION：配置的区域。
  • DESCRIPTION：配置及其用途的说明。
  • SERVICE-A,...：一系列字符串，表示您要添加到配置中或从配置中删除的服务。如需了解有效字符串，请参阅支持的服务和区域。 使用 clear-services 从配置中移除所有服务。

API

使用 multicloudDataTransferConfigs.patch 方法。

PATCH 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：一系列字符串，表示您要添加到配置中或从配置中删除的服务。如需了解有效字符串，请参阅 支持的服务和区域。

此外，如需防止在更新操作期间覆盖一组指定的字段，您可以使用 updateMask 选项，该选项遵循 fieldMask 格式。

对 Data Transfer Essentials 配置的更新大约会在 24 小时内生效。

删除配置

只有在删除与配置关联的所有目标后，您才能删除该配置。

如需删除配置，请使用以下方法之一：

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs delete CONFIGURATION_NAME \
    --location=LOCATION

API

使用 multicloudDataTransferConfigs.delete 方法。

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME

管理目标

您可以列出项目中的 Data Transfer Essentials 目标、检查目标的状态、更新目标或删除目标。

列出项目中的目标

如需列出项目中的所有目标，请使用以下方法之一：

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations list \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

替换以下内容：

  • CONFIGURATION_NAME：您要列出其目标的配置的名称
  • LOCATION：配置的区域

API

使用 multicloudDataTransferConfigs.destinations.list 方法。

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

替换以下内容：

  • PROJECT_ID：您的项目的 ID
  • LOCATION：配置的区域
  • CONFIGURATION_NAME：您要列出其目标的配置的名称

查看目标的详细信息

如需查看目标的详细信息，请使用以下方法之一：

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations describe DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

替换以下内容：

  • DESTINATION_NAME：目标的名称
  • CONFIGURATION_NAME：您要查看其目标的配置的名称
  • LOCATION：配置的区域

以下示例显示，为 destination1 指定的端点有效，并且目标正在 effectiveTime 指示的时间之前添加。

createTime: '2025-05-28T13:08:00.171978514Z'
description: 'sample destination'
endpoints:
- asn: 16509
  csp: aws
  state: VALID
etag: tag1
ipPrefix: 203.0.113.0/24
name: projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1
stateTimeline:
  states:
  - effectiveTime: '2025-05-29T07:00:00Z'
    state: ADDING
updateTime: '2025-05-28T13:08:03.431862259Z'
…

API

使用 multicloudDataTransferConfigs.destinations.get 方法。

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME

替换以下内容：

  • PROJECT_ID：您的项目的 ID
  • LOCATION：配置的区域
  • CONFIGURATION_NAME：配置的名称
  • DESTINATION_NAME：目标的名称

以下示例输出显示，为 destination1 指定的端点有效，并且目标正在 effectiveTime 指示的时间之前添加。

{
  "destination": [
    {
      "name": "projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1",
      "createTime": "2025-05-14T10:18:16.941520739Z",
      "updateTime": "2025-05-14T10:18:20.028116272Z",
      "etag": "tag1",
      "description": "sample destination",
      "ipPrefix": "203.0.113.0/24",
      "endpoints": [
        {
          "asn": 16509,
          "csp": "aws",
          "state": "VALID"
        }
      ],
      "stateTimeline": {
        "states": [
          {
            "state": "ADDING",
            "effectiveTime": "2025-05-29T07:00:00Z"
          }
        ]
      }
    }
  ]
}

对于目标，状态可以是以下之一：

  • ADDING：正在添加目标。
  • DELETING：正在删除目标。
  • SUSPENDING：系统正在根据 审核结果暂停目标。
  • ACTIVE：目标已纳入 Data Transfer Essentials 结算范围。
  • SUSPENDED：目标已被删除或违反了使用条款，因此不会纳入 Data Transfer Essentials 结算范围。

对于端点，状态可以是以下之一：

  • VALID：ASN 和 CSP 值的组合有效。
  • INVALID：ASN 和 CSP 值的组合无效。

如果即使只有一个端点的状态为 VALID，则目标也会被视为符合 Data Transfer Essentials 结算条件。

如果所有端点的状态均为 INVALID，则目标会被视为不符合 Data Transfer Essentials 结算条件。 在这种情况下，目标的状态将设置为 SUSPENDING 或 SUSPENDED，具体取决于当前状态是 ADDING 还是 ACTIVE。前往此类目标的流量将被视为常规互联网流量。

更新目标

目标必须至少有一个端点，且不能超过五个端点。

如需在目标中添加或删除端点，请使用以下方法之一：

gcloud

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

如需指定端点，请使用以下选项之一。您可以在同一命令中多次指定 add-endpoints 或 remove-endpoints 标志。

  • endpoints：将目标中的端点替换为指定的列表
  • add-endpoints：将指定的端点添加到目标中
  • remove-endpoints：从目标中移除指定的端点
gcloud network-connectivity multicloud-data-transfer-configs destinations update DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --ip-prefix=IP_PREFIX \
    --endpoints=asn=ASN,csp=CSP |
        --add-endpoints=asn=ASN,csp=CSP |
        --remove-endpoints=asn=ASN,csp=CSP

替换以下内容：

  • DESTINATION_NAME：目标的名称。
  • CONFIGURATION_NAME：您要更新的配置的名称。
  • LOCATION：配置的区域。
  • DESCRIPTION：目标及其用途的说明。
  • IP_PREFIX：以范围或值形式指定的目标的 IP 前缀。

  • 对于每个端点，请指定以下内容：

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

API

使用 multicloudDataTransferConfigs.destinations.patch 方法。

PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
  "description": "DESCRIPTION",
  "ip_prefix": "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。

此外，如需防止在更新操作期间覆盖一组指定的字段，您可以使用 updateMask 选项，该选项遵循 fieldMask 格式。

对 Data Transfer Essentials 目标和相关配置的更新大约会在 24 小时内生效。

删除目标

如需删除目标，请使用以下方法之一：

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations delete DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

API

使用 multicloudDataTransferConfigs.destinations.delete 方法。

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME