Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 de una ubicación en un proyecto, usa una de las siguientes maneras:

gcloud

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

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: Es el ID de tu proyecto.
LOCATION: Es 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 que ya se respondió.

Visualiza 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: Es el nombre de la configuración.
LOCATION: Es la región de la configuración.

En los siguientes datos de resultado de muestra, se muestra que el tráfico de compute-engine está listo para considerarse para la facturación de Data Transfer Essentials. Para cloud-sql y cloud-storage, la actualización está pendiente. El valor effectiveTime indica la hora en la que se espera que el estado entre en vigencia. En el ejemplo, también se muestra la cantidad total de destinos en la configuración y la cantidad de destinos que están 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: Es el ID de tu proyecto.
LOCATION: Es la región de la configuración.
CONFIGURATION_NAME: Es el nombre de la configuración.

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

gcloud

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

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 Servicios y regiones compatibles. Usa clear-services para quitar todos los servicios de la configuración.

API

Usa el método multicloudDataTransferConfigs.patch.

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: Es 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 de campos especificado durante una operación de actualización, puedes usar la opción updateMask, que sigue el formato fieldMask.

Las actualizaciones de las configuraciones de Data Transfer Essentials entran en vigencia en aproximadamente 24 horas.

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 maneras:

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 multicloudDataTransferConfigs.delete método.

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 maneras:

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 cuyos destinos deseas enumerar.
LOCATION: Es 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: Es el ID de tu proyecto.
LOCATION: Es la región de la configuración.
CONFIGURATION_NAME: Es el nombre de la configuración cuyos destinos deseas enumerar.

Visualiza los detalles de un destino

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

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: Es 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: Es 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.

En los siguientes datos de resultado de muestra, se 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"
          }
        ]
      }
    }
  ]
}

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

ADDING: Se está agregando el destino.
DELETING: Se está borrando el destino.
SUSPENDING: El destino se suspende 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 y no se considerará para la facturación de Data Transfer Essentials.

Para un extremo, el estado puede ser uno de los siguientes:

VALID: La combinación de 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 incluso un extremo es VALID, el destino se considera apto para la facturación de Data Transfer Essentials.

Si el estado de todos los extremos es INVALID, el destino se considera no apto 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 de Internet normal.

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 maneras:

gcloud

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

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 ASNs reconocidos.
- CSP: Es una cadena que representa el CSP del ASN que anuncia el prefijo.

API

Usa el método 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"
    }
  ]
}

Reemplaza lo siguiente:

PROJECT_ID: Es 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 debe usarse solo 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 ASNs reconocidos.
- CSP: Es una 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.

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

Borra un destino

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

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 multicloudDataTransferConfigs.destinations.delete método.

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

Administra los recursos de Transferencia de datos Essentials Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Administración de configuraciones

Enumera las configuraciones de un proyecto

gcloud

API

Visualiza los detalles de una configuración

gcloud

API

Actualiza una configuración

gcloud

API

Borra una configuración

gcloud

API

Administra destinos

Enumera los destinos de un proyecto

gcloud

API

Visualiza los detalles de un destino

gcloud

API

Actualiza un destino

gcloud

API

Borra un destino

gcloud

API

Administra los recursos de Transferencia de datos Essentials