Gestionar los recursos de Data Transfer Essentials

En esta página se describe cómo gestionar los recursos creados con Data Transfer Essentials.

Gestionar configuraciones

Puedes enumerar las configuraciones de Data Transfer Essentials de tu proyecto, comprobar el estado de una configuración, actualizarla o eliminarla.

Mostrar las configuraciones de un proyecto

Para obtener una lista de todas las configuraciones de una ubicación de un proyecto, utiliza uno de los siguientes métodos:

gcloud

Usa el comando gcloud network-connectivity multicloud-data-transfer-configs list.

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

Sustituye LOCATION por la región de la configuración.

API

Usa el método multicloudDataTransferConfigs.get.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID de tu proyecto
  • LOCATION: la región de la configuración

También puedes usar el parámetro de consulta requestID para identificar tus solicitudes de API. Si vuelves a enviar la solicitud, el servidor puede usar el identificador para ignorar una solicitud a la que ya se ha respondido.

Ver los detalles de una configuración

Para ver los detalles de una configuración, utiliza uno de los siguientes métodos:

gcloud

Usa el comando gcloud network-connectivity multicloud-data-transfer-configs describe.

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

Haz los cambios siguientes:

  • CONFIGURATION_NAME: el nombre de la configuración
  • LOCATION: la región de la configuración

El siguiente ejemplo de salida muestra que el tráfico de compute-engine se puede tener en cuenta para la facturación de Transferencia de Datos Esenciales. En el caso de cloud-sql y cloud-storage, la actualización está pendiente. El valor de effectiveTime indica la hora a la que se espera que entre en vigor el estado. La muestra también muestra el número total de destinos de la configuración y el número de destinos activos.

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

Usa el método multicloudDataTransferConfigs.list.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID de tu proyecto
  • LOCATION: la región de la configuración
  • CONFIGURATION_NAME: el nombre de la configuración

El siguiente ejemplo de resultado muestra que el tráfico de compute-engine se puede tener en cuenta para la facturación de Data Transfer Essentials. En el caso de cloud-storage y cloud-sql, la actualización está pendiente. El valor de effectiveTime indica la hora a la que se espera que entre en vigor el estado. La muestra también muestra el número total de destinos de la configuración y el número de destinos activos.

{
  "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"
            }
          ]
        }
      }
    }
  ]
}

El estado de un servicio puede ser uno de los siguientes:

  • ADDING: se está añadiendo el servicio.
  • DELETING: el servicio se está eliminando.
  • ACTIVE: el servicio está configurado para la facturación de Data Transfer Essentials.

Actualizar una configuración

Para añadir o eliminar servicios de una configuración, siga uno de estos pasos:

gcloud

Usa el comando gcloud network-connectivity multicloud-data-transfer-configs update.

Para especificar los servicios, use una de las siguientes opciones:

  • services: sustituye los servicios de la configuración por la lista especificada.
  • update-services: añade los servicios especificados a la configuración.
  • remove-services: elimina los servicios especificados de la configuración.
  • clear-services: elimina todos los servicios de la configuración
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

Haz los cambios siguientes:

  • CONFIGURATION_NAME: el nombre de la configuración que quieras actualizar.
  • LOCATION: la región de la configuración.
  • DESCRIPTION: una descripción de la configuración y su finalidad.
  • SERVICE-A,...: una serie de cadenas que representan los servicios que quieres añadir o eliminar de la configuración. Para ver las cadenas válidas, consulta Servicios y regiones admitidos. Usa clear-services para quitar todos los servicios de la configuración.

API

Usa el método multicloudDataTransferConfigs.update.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID de tu proyecto.
  • LOCATION: la región de la configuración.
  • CONFIGURATION_NAME: el nombre de la configuración.
  • DESCRIPTION: una descripción de la configuración y su finalidad.
  • SERVICE-A: una serie de cadenas que representan los servicios que quieres añadir o eliminar de la configuración. Para ver las cadenas válidas, consulta Servicios y regiones admitidos.

Además, para evitar que se sobrescriba un conjunto de campos especificado durante una operación de actualización, puedes usar la opción updateMask, que sigue el formato fieldMask.

Los cambios en las configuraciones de Data Transfer Essentials tardan aproximadamente 24 horas en aplicarse.

Eliminar una configuración

Solo puedes eliminar una configuración después de eliminar todos los destinos asociados a ella.

Para eliminar una configuración, puede hacerlo de una de las siguientes formas:

gcloud

Usa el comando gcloud network-connectivity multicloud-data-transfer-configs delete.

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

API

Usa el método multicloudDataTransferConfigs.delete.

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

Gestionar destinos

Puede enumerar los destinos de Data Transfer Essentials de su proyecto, comprobar el estado de un destino, actualizarlo o eliminarlo.

Mostrar los destinos de un proyecto

Para enumerar todos los destinos de un proyecto, utiliza una de las siguientes opciones:

gcloud

Usa el comando 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

Haz los cambios siguientes:

  • CONFIGURATION_NAME: el nombre de la configuración cuyos destinos quieres enumerar
  • LOCATION: la región de la configuración

API

Usa el método multicloudDataTransferConfigs.destinations.list.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID de tu proyecto
  • LOCATION: la región de la configuración
  • CONFIGURATION_NAME: el nombre de la configuración cuyos destinos quieres enumerar

Ver los detalles de un destino

Para ver los detalles de un destino, utiliza uno de los siguientes métodos:

gcloud

Usa el comando 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

Haz los cambios siguientes:

  • DESTINATION_NAME: el nombre del destino
  • CONFIGURATION_NAME: el nombre de la configuración cuyo destino quieres ver
  • LOCATION: la región de la configuración

En el siguiente ejemplo se muestra que el endpoint especificado para destination1 es válido y que el destino se añade en el momento indicado por 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

Usa el método multicloudDataTransferConfigs.destinations.get.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID de tu proyecto
  • LOCATION: la región de la configuración
  • CONFIGURATION_NAME: el nombre de la configuración
  • DESTINATION_NAME: el nombre del destino

El siguiente ejemplo de salida muestra que el endpoint especificado para destination1 es válido y que el destino se añade en el momento indicado por 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"
          }
        ]
      }
    }
  ]
}

En el caso de un destino, el estado puede ser uno de los siguientes:

  • ADDING: se está añadiendo el destino.
  • DELETING: el destino se está eliminando.
  • SUSPENDING: el destino se suspende en función de la auditoría.
  • ACTIVE: el destino se tiene en cuenta para la facturación de Data Transfer Essentials.
  • SUSPENDED: el destino se ha eliminado o infringe los términos de uso y no se tendrá en cuenta para la facturación de Data Transfer Essentials.

En el caso de un endpoint, el estado puede ser uno de los siguientes:

  • VALID: la combinación de los valores de ASN y CSP es válida.
  • INVALID: la combinación de valores de ASN y CSP no es válida.

Si el estado de al menos un endpoint es VALID, se considera que el destino cumple los requisitos para la facturación de Data Transfer Essentials.

Si el estado de todos los endpoints es INVALID, se considera que el destino no cumple los requisitos para la facturación de Transferencia de Datos Esenciales. En este caso, el estado del destino se define como SUSPENDING o SUSPENDED, según si el estado actual es ADDING o ACTIVE, respectivamente. El tráfico a ese destino se trata como tráfico de Internet normal.

Actualizar un destino

Un destino debe tener al menos un endpoint y no puede tener más de cinco.

Para añadir o eliminar endpoints de un destino, utiliza una de las siguientes opciones:

gcloud

Usa el comando gcloud network-connectivity multicloud-data-transfer-configs destinations update.

Para especificar los endpoints, use una de las siguientes opciones. Puede especificar las marcas add-endpoints o remove-endpoints varias veces en el mismo comando.

  • endpoints: sustituye los endpoints del destino por la lista especificada.
  • add-endpoints: añade los endpoints especificados al destino
  • remove-endpoints: elimina los endpoints especificados del destino.
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

Haz los cambios siguientes:

  • DESTINATION_NAME: el nombre del destino.
  • CONFIGURATION_NAME: el nombre de la configuración que quieras actualizar.
  • LOCATION: la región de la configuración.
  • DESCRIPTION: una descripción del destino y su finalidad.
  • IP_PREFIX: el prefijo IP del destino, especificado como un intervalo o un valor.

  • Para cada endpoint, especifica lo siguiente:

    • ASN: el ASN que se espera que anuncie el prefijo. Consulta ASNs reconocidos.
    • CSP: cadena que representa el CSP del ASN que anuncia el prefijo.

API

Usa el método multicloudDataTransferConfigs.destinations.update.

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"
    }
  ]
}

Haz los cambios siguientes:

  • PROJECT_ID: el ID de tu proyecto.
  • LOCATION: la región de la configuración.
  • CONFIGURATION_NAME: el nombre de la configuración.
  • DESTINATION_NAME: el nombre del destino.
  • DESCRIPTION: una descripción del destino y su finalidad.

  • IP_PREFIX: el prefijo IP del destino especificado como un intervalo (por ejemplo, 203.0.113.0/24 o 2001:db8::/32) o un valor (por ejemplo, 203.0.113.6 o 2001:db8:2:2:2:2:2:2). Un prefijo IP solo se puede usar una vez en una configuración y para un solo ASN.

  • Especifica las cadenas correspondientes a los endpoints que quieras añadir al destino o elimina los endpoints que no quieras conservar en el destino:

    • ASN: el ASN que se espera que anuncie el prefijo. Consulta ASNs reconocidos.
    • CSP: cadena que representa el CSP del ASN que anuncia el prefijo.

Además, para evitar que se sobrescriba un conjunto de campos especificado durante una operación de actualización, puedes usar la opción updateMask, que sigue el formato fieldMask.

Los cambios en los destinos de Data Transfer Essentials y en las configuraciones relacionadas se aplican en un plazo de 24 horas aproximadamente.

Eliminar un destino

Para eliminar un destino, puedes hacerlo de una de las siguientes formas:

gcloud

Usa el comando 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

Usa el método multicloudDataTransferConfigs.destinations.delete.

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