Crear recursos de Data Transfer Essentials

Para que el tráfico se identifique como configurado para la facturación de Transferencia de Datos Esencial, debe seleccionar servicios y asociarlos a los endpoints seleccionados. En esta página se explica cómo crear los recursos de Data Transfer Essentials necesarios, que son configuraciones y destinos.

Antes de empezar

Antes de crear configuraciones o destinos de Data Transfer Essentials, haz lo siguiente:

  1. Si aún no lo has hecho, instala la CLI de Google Cloud.

  2. Autentica gcloud CLI con tu cuenta:

    gcloud auth login

  3. Configura tu proyecto:

    gcloud config set project PROJECT_ID

    Sustituye PROJECT_ID por el ID de tu proyecto.

  4. Habilita la API Network Connectivity en tu proyecto.

  5. Configura los permisos.

  6. Comprueba si los servicios que quieres seleccionar para Data Transfer Essentials son compatibles. Solo puede configurar Data Transfer Essentials para los servicios y las regiones admitidos.

    gcloud

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

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

    Sustituye LOCATION por un ID de región (por ejemplo, Google Cloud europe-west3).

    El siguiente ejemplo de salida muestra que los servicios se pueden configurar con Data Transfer Essentials porque usan niveles admitidos.

    NAME                   SERVICE_CONFIGS
cloud-sql              [{'eligibilityCriteria': 'NETWORK_SERVICE_TIER_PREMIUM_ONLY'}]
cloud-storage          [{'eligibilityCriteria': 'REQUEST_ENDPOINT_REGIONAL_ENDPOINT_ONLY'}]
compute-engine         [{'eligibilityCriteria': 'NETWORK_SERVICE_TIER_STANDARD_ONLY'}]

    Para comprobar si un servicio concreto cumple los requisitos, usa el comando gcloud network-connectivity multicloud-data-transfer-supported-services describe.

    gcloud network-connectivity multicloud-data-transfer-supported-services describe SERVICE1 \
    --location=LOCATION

    Sustituye SERVICE1 por una cadena válida que represente el servicio. Consulta los servicios y las regiones admitidos.

    API

    Usa el método multicloudDataTransferSupportedServices.get.

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

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto
    • LOCATION: un ID de región, por ejemplo, Google Cloud europe-west3

    En el siguiente ejemplo de salida se muestran los servicios que se pueden configurar con Transferencia de datos esencial porque usan niveles admitidos.

    {
  "multicloudDataTransferSupportedServices": [
    {
      "name": "cloud-sql",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "NETWORK_SERVICE_TIER_PREMIUM_ONLY"
        }
      ]
    },
    {
      "name": "cloud-storage",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "REQUEST_ENDPOINT_REGIONAL_ENDPOINT_ONLY"
        }
      ]
    },
    {
      "name": "compute-engine",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "NETWORK_SERVICE_TIER_STANDARD_ONLY"
        }
      ]
    }
  ]
}

    Para comprobar si un servicio concreto cumple los requisitos, utiliza el siguiente método:

    GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices
{
"service": "SERVICE1"
}

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto.
    • LOCATION: un ID de región, por ejemplo, Google Cloud .europe-west3
    • SERVICE1: una cadena válida que representa el servicio. Consulta los servicios y las regiones admitidos.

  7. Comprueba si se reconocen los números de sistemas autónomos (ASNs) que quieres especificar. Solo puedes configurar el tráfico a destinos que usen ASNs reconocidos.

Crear una configuración

Crea una configuración de Data Transfer Essentials que incluya los servicios especificados. Solo puedes crear una configuración por región y proyecto.

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs create CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --services=SERVICE-A,...

Haz los cambios siguientes:

  • CONFIGURATION_NAME: un nombre para la configuración.
  • 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 para los que quieres configurar Data Transfer Essentials. Para ver las cadenas válidas, consulta Servicios y regiones admitidos.

El siguiente comando de ejemplo crea una configuración llamada config1 en la región europe-west3 para los servicios compute-engine, cloud-storage y cloud-sql.

gcloud network-connectivity multicloud-data-transfer-configs create config1 \
    --location=europe-west3 \
    --description="configuration for europe-west3" \
    --services=compute-engine,cloud-storage,cloud-sql

API

Usa el método multicloudDataTransferConfigs.create.

POST 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: un nombre para la configuración.
  • DESCRIPTION: una descripción de la configuración y su finalidad.
  • SERVICE-A,...: una serie de cadenas que representan los servicios para los que quieres configurar Data Transfer Essentials. Para ver las cadenas válidas, consulta Servicios y regiones admitidos.

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.

El siguiente fragmento de JSON crea una configuración llamada config1 en la región europe-west3 para los servicios compute-engine, cloud-storage y cloud-sql.

POST https://networkconnectivity.googleapis.com/v1/projects/my-project/locations/europe-west3/multicloudDataTransferConfigs/config1
{
  "description": "configuration for europe-west3",
  "services": {
    "compute-engine": {},
    "cloud-storage": {},
    "cloud-sql": {}
}

Las configuraciones de Data Transfer Essentials tardan hasta 24 horas en crearse. Para comprobar el estado de la configuración, consulta los detalles de la configuración.

Para añadir o quitar servicios, actualiza una configuración.

Antes de intentar crear una configuración, elimine la configuración actual.

Crear un destino para la configuración

Crea un destino para la configuración de Data Transfer Essentials. Un recurso de destino crea una asociación entre una configuración y un prefijo de IP externa con un endpoint. Un endpoint contiene un identificador de proveedor de servicios en la nube (CSP) y su ASN.

Crea un destino cada vez.

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations create DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --ip-prefix=IP_PREFIX \
    --endpoints=asn=ASN,csp=CSP

Haz los cambios siguientes:

  • DESTINATION_NAME: el nombre del destino. El nombre debe ser único en una región.
  • CONFIGURATION_NAME: el nombre de la configuración.
  • 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 (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, debe asociarse a al menos un endpoint y puede asociarse a un máximo de cinco endpoints.

  • Especifica las cadenas correspondientes a los endpoints que quieras añadir al 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.

    Puedes especificar la marca endpoints varias veces en el mismo comando. Un destino debe tener al menos un endpoint y no puede tener más de cinco.

El siguiente comando de ejemplo crea un destino llamado destination1 para la configuración config1 en la región europe-west3 para el prefijo de IP y el endpoint especificados.

gcloud network-connectivity multicloud-data-transfer-configs destinations create destination1 \
    --multicloud-data-transfer-config=config1 \
    --location=europe-west3 \
    --description="destination1 for config1" \
    --ip-prefix=203.0.113.0/24 \
    --endpoints=asn=16509,csp="aws"

API

Usa el método multicloudDataTransferConfigs.destinations.create.

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
  "description": "DESCRIPTION",
  "ipPrefix": "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. El nombre debe ser único en una región.
  • 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:

    • 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.

    Puedes especificar varios endpoints en la misma llamada. Un destino debe tener al menos un endpoint y no puede tener más de cinco.

El siguiente comando de ejemplo crea un destino llamado destination1 para la configuración config1 en la región europe-west3 para el prefijo de IP y el endpoint especificados.

POST https://networkconnectivity.googleapis.com/v1/projects/my-project/locations/europe-west3/multicloudDataTransferConfigs/config1/destinations/destination1
{
  "description": "destination1 for config1",
  "ipPrefix": "203.0.113.0/24",
  "endpoints": [
    {
      "asn": "16509",
      "csp": "aws"
    }
  ]
}

Para comprobar el estado del destino, consulta los detalles del destino.

Para añadir o quitar endpoints, actualice el destino.

También puedes eliminar el destino.

Siguientes pasos