管理数据传输基础版资源

本页面介绍了如何管理 使用 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 方法。