Administra los recursos de Transferencia de datos Essentials

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

Administración de configuraciones

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

Enumera las configuraciones de un proyecto

Para enumerar todas las configuraciones en una ubicación de un proyecto, usa una de las siguientes formas:

gcloud

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

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

Reemplaza 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

Reemplaza lo siguiente:

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

De manera opcional, usa el parámetro de consulta requestID para identificar tus solicitudes a la API. Si reintentas la solicitud, el servidor puede usar el identificador para ignorar una solicitud a la que ya se respondió.

Cómo ver los detalles de una configuración

Para ver los detalles de una configuración, usa una de las siguientes maneras:

gcloud

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

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

Reemplaza lo siguiente:

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

En el siguiente ejemplo de resultado, se muestra que el tráfico de compute-engine está listo para considerarse en la facturación de Data Transfer Essentials. En el caso de cloud-sql y cloud-storage, la actualización está pendiente. El valor effectiveTime indica la fecha y hora en que se espera que entre en vigencia el estado. La muestra también muestra la cantidad total de destinos en la configuración y la cantidad 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

Reemplaza lo siguiente:

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

En el siguiente ejemplo de resultado, se muestra que el tráfico de compute-engine está listo para considerarse en 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 fecha y hora en la que se espera que el estado entre en vigencia. En la muestra, también se indica la cantidad total de destinos en la configuración y la cantidad 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á agregando el servicio.
  • DELETING: Se está borrando el servicio.
  • ACTIVE: El servicio está configurado para la facturación de Data Transfer Essentials.

Actualiza una configuración

Para agregar o borrar servicios de una configuración, usa una de las siguientes opciones:

gcloud

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

Para especificar servicios, usa una de las siguientes opciones:

  • services: Reemplaza los servicios de la configuración por la lista especificada.
  • update-services: Agrega los servicios especificados a la configuración.
  • remove-services: Quita los servicios especificados de la configuración.
  • clear-services: Quita 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

Reemplaza lo siguiente:

  • CONFIGURATION_NAME: Es el nombre de la configuración que deseas actualizar.
  • LOCATION: Es la región de la configuración.
  • DESCRIPTION: Es una descripción de la configuración y su propósito.
  • SERVICE-A,...: Es una serie de cadenas que representan los servicios que deseas agregar o borrar de la configuración. Para obtener cadenas válidas, consulta Regiones y servicios compatibles. 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"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto.
  • LOCATION: Es la región de la configuración.
  • CONFIGURATION_NAME: Es el nombre de la configuración.
  • DESCRIPTION: Es una descripción de la configuración y su propósito.
  • SERVICE-A: Es una serie de cadenas que representan los servicios que deseas agregar o borrar de la configuración. Para obtener cadenas válidas, consulta Servicios y regiones compatibles.

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

Las actualizaciones de la configuración de Data Transfer Essentials tardan aproximadamente 24 horas en surtir efecto.

Borra una configuración

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

Para borrar una configuración, usa una de las siguientes opciones:

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

Administra destinos

Puedes enumerar los destinos de Data Transfer Essentials en tu proyecto, verificar el estado de un destino, actualizarlo o borrarlo.

Enumera los destinos de un proyecto

Para enumerar todos los destinos de un proyecto, usa 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

Reemplaza lo siguiente:

  • CONFIGURATION_NAME: Es el nombre de la configuración cuyas destinaciones deseas 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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto
  • LOCATION: la región de la configuración
  • CONFIGURATION_NAME: Es el nombre de la configuración cuyas destinaciones deseas enumerar.

Cómo ver los detalles de un destino

Para ver los detalles de un destino, usa una de las siguientes opciones:

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

Reemplaza lo siguiente:

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

En el siguiente ejemplo, se muestra que el extremo especificado para destination1 es válido y que el destino se agrega 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

Reemplaza lo siguiente:

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

El siguiente ejemplo de resultado muestra que el extremo especificado para destination1 es válido y que el destino se agrega 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á agregando el destino.
  • DELETING: Se está borrando el destino.
  • SUSPENDING: Se suspenderá el destino en función de la auditoría.
  • ACTIVE: El destino se considera para la facturación de Data Transfer Essentials.
  • SUSPENDED: El destino se borró o incumple las condiciones de uso, por lo que no se tendrá en cuenta para la facturación de Data Transfer Essentials.

En el caso de un extremo, 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 los valores de ASN y CSP no es válida.

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

Si el estado de todos los extremos es INVALID, se considera que el destino no cumple con los requisitos para la facturación de Data Transfer Essentials. En este caso, el estado del destino se establece en 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 normal de Internet.

Actualiza un destino

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

Para agregar o borrar extremos de un destino, usa una de las siguientes opciones:

gcloud

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

Para especificar extremos, usa una de las siguientes opciones. Puedes especificar las marcas add-endpoints o remove-endpoints varias veces en el mismo comando.

  • endpoints: Reemplaza los extremos del destino por la lista especificada.
  • add-endpoints: Agrega los extremos especificados al destino.
  • remove-endpoints: Quita los extremos 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

Reemplaza lo siguiente:

  • DESTINATION_NAME: Es el nombre del destino.
  • CONFIGURATION_NAME: Es el nombre de la configuración que deseas actualizar.
  • LOCATION: Es la región de la configuración.
  • DESCRIPTION: Es una descripción del destino y su propósito.
  • IP_PREFIX: Es el prefijo IP del destino especificado como un rango o un valor.

  • Para cada extremo, especifica lo siguiente:

    • ASN: Es el ASN que se espera que anuncie el prefijo. Consulta ASN reconocidos.
    • CSP: Es una cadena que representa la 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"
    }
  ]
}

Reemplaza lo siguiente:

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

  • IP_PREFIX: Es el prefijo IP del destino especificado como un rango (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 debe usar una vez en una configuración y para un solo ASN.

  • Especifica cadenas correspondientes a los extremos que deseas agregar al destino o quita los extremos que no deseas conservar en el destino:

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

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

Las actualizaciones de los destinos de Data Transfer Essentials y las configuraciones relacionadas tardan aproximadamente 24 horas en aplicarse.

Borra un destino

Para borrar un destino, usa una de las siguientes opciones:

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