Gestire le risorse di Data Transfer Essentials

Questa pagina descrive come gestire le risorse create utilizzando Data Transfer Essentials.

Gestire le configurazioni

Puoi elencare le configurazioni di Data Transfer Essentials nel tuo progetto, controllare lo stato di una configurazione, aggiornarla o eliminarla.

Elenca le configurazioni in un progetto

Per elencare tutte le configurazioni in una posizione di un progetto, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud network-connectivity multicloud-data-transfer-configs list.

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

Sostituisci LOCATION con la regione della configurazione.

API

Utilizza il metodo multicloudDataTransferConfigs.get.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • LOCATION: la regione della configurazione

Se vuoi, utilizza il parametro di query requestID per identificare le tue richieste API. Se riprovi a inviare la richiesta, il server può utilizzare l'identificatore per ignorare una richiesta a cui è già stata data una risposta.

Visualizzare i dettagli di una configurazione

Per visualizzare i dettagli di una configurazione, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud network-connectivity multicloud-data-transfer-configs describe.

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

Sostituisci quanto segue:

  • CONFIGURATION_NAME: il nome della configurazione
  • LOCATION: la regione della configurazione

L'output di esempio seguente mostra che il traffico da compute-engine è pronto per essere preso in considerazione per la fatturazione di Data Transfer Essentials. Per cloud-sql e cloud-storage, l'aggiornamento è in attesa. Il valore effectiveTime indica l'ora in cui lo stato dovrebbe entrare in vigore. Il campione mostra anche il numero totale di destinazioni nella configurazione e il numero di destinazioni attive.

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

Utilizza il metodo multicloudDataTransferConfigs.list.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • LOCATION: la regione della configurazione
  • CONFIGURATION_NAME: il nome della configurazione

Il seguente output di esempio mostra che il traffico proveniente da compute-engine è pronto per essere preso in considerazione per la fatturazione di Data Transfer Essentials. Per cloud-storage e cloud-sql, l'aggiornamento è in attesa. Il valore effectiveTime indica l'ora in cui lo stato dovrebbe entrare in vigore. Il campione mostra anche il numero totale di destinazioni nella configurazione e il numero di destinazioni attive.

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

Lo stato di un servizio può essere uno dei seguenti:

  • ADDING: il servizio è in fase di aggiunta.
  • DELETING: il servizio è in fase di eliminazione.
  • ACTIVE: il servizio è configurato per la fatturazione di Data Transfer Essentials.

Aggiornare una configurazione

Per aggiungere o eliminare servizi da una configurazione, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud network-connectivity multicloud-data-transfer-configs update.

Per specificare i servizi, utilizza una delle seguenti opzioni:

  • services: sostituisce i servizi nella configurazione con l'elenco specificato
  • update-services: aggiunge i servizi specificati alla configurazione
  • remove-services: rimuove i servizi specificati dalla configurazione
  • clear-services: rimuove tutti i servizi dalla configurazione
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

Sostituisci quanto segue:

  • CONFIGURATION_NAME: il nome della configurazione che vuoi aggiornare.
  • LOCATION: la regione della configurazione.
  • DESCRIPTION: una descrizione della configurazione e del suo scopo.
  • SERVICE-A,...: una serie di stringhe che rappresentano i servizi che vuoi aggiungere o eliminare dalla configurazione. Per le stringhe valide, vedi Servizi e regioni supportati. Utilizza clear-services per rimuovere tutti i servizi dalla configurazione.

API

Utilizza il metodo multicloudDataTransferConfigs.update.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • LOCATION: la regione della configurazione.
  • CONFIGURATION_NAME: il nome della configurazione.
  • DESCRIPTION: una descrizione della configurazione e del suo scopo.
  • SERVICE-A: una serie di stringhe che rappresentano i servizi che vuoi aggiungere o eliminare dalla configurazione. Per le stringhe valide, vedi Servizi e regioni supportati.

Inoltre, per impedire la sovrascrittura di un insieme specificato di campi durante un'operazione di aggiornamento, puoi utilizzare l'opzione updateMask, che segue il formato fieldMask.

Gli aggiornamenti alle configurazioni di Data Transfer Essentials vengono applicati in circa 24 ore.

Eliminare una configurazione

Puoi eliminare una configurazione solo dopo aver eliminato tutte le destinazioni associate.

Per eliminare una configurazione, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud network-connectivity multicloud-data-transfer-configs delete.

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

API

Utilizza il metodo multicloudDataTransferConfigs.delete.

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

Gestisci destinazioni

Puoi elencare le destinazioni di Data Transfer Essentials nel tuo progetto, controllare lo stato di una destinazione, aggiornarla o eliminarla.

Elenca le destinazioni in un progetto

Per elencare tutte le destinazioni in un progetto, utilizza uno dei seguenti metodi:

gcloud

Utilizza il 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

Sostituisci quanto segue:

  • CONFIGURATION_NAME: il nome della configurazione di cui vuoi elencare le destinazioni
  • LOCATION: la regione della configurazione

API

Utilizza il metodo multicloudDataTransferConfigs.destinations.list.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • LOCATION: la regione della configurazione
  • CONFIGURATION_NAME: il nome della configurazione di cui vuoi elencare le destinazioni

Visualizzare i dettagli di una destinazione

Per visualizzare i dettagli di una destinazione, utilizza uno dei seguenti metodi:

gcloud

Utilizza il 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

Sostituisci quanto segue:

  • DESTINATION_NAME: il nome della destinazione
  • CONFIGURATION_NAME: il nome della configurazione di cui vuoi visualizzare la destinazione
  • LOCATION: la regione della configurazione

Il seguente esempio mostra che l'endpoint specificato per destination1 è valido e la destinazione viene aggiunta entro l'ora indicata da 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

Utilizza il metodo multicloudDataTransferConfigs.destinations.get.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • LOCATION: la regione della configurazione
  • CONFIGURATION_NAME: il nome della configurazione
  • DESTINATION_NAME: il nome della destinazione

Il seguente output di esempio mostra che l'endpoint specificato per destination1 è valido e la destinazione viene aggiunta entro l'ora indicata da 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"
          }
        ]
      }
    }
  ]
}

Per una destinazione, lo stato può essere uno dei seguenti:

  • ADDING: la destinazione è in fase di aggiunta.
  • DELETING: la destinazione è in fase di eliminazione.
  • SUSPENDING: la destinazione è in fase di sospensione in base all'audit.
  • ACTIVE: la destinazione viene presa in considerazione per la fatturazione di Data Transfer Essentials.
  • SUSPENDED: la destinazione è stata eliminata o viola i termini di utilizzo e non verrà presa in considerazione per la fatturazione di Data Transfer Essentials.

Per un endpoint, lo stato può essere uno dei seguenti:

  • VALID: la combinazione di valori ASN e CSP è valida.
  • INVALID: la combinazione di valori ASN e CSP non è valida.

Se lo stato di anche un solo endpoint è VALID, la destinazione viene considerata idonea per la fatturazione di Data Transfer Essentials.

Se lo stato di tutti gli endpoint è INVALID, la destinazione è considerata non idonea per la fatturazione di Data Transfer Essentials. In questo caso, lo stato della destinazione è impostato su SUSPENDING o SUSPENDED, a seconda che lo stato attuale sia ADDING o ACTIVE, rispettivamente. Il traffico verso una destinazione di questo tipo viene trattato come normale traffico internet.

Aggiornare una destinazione

Una destinazione deve avere almeno un endpoint e non può averne più di cinque.

Per aggiungere o eliminare endpoint da una destinazione, utilizza uno dei seguenti metodi:

gcloud

Utilizza il comando gcloud network-connectivity multicloud-data-transfer-configs destinations update.

Per specificare gli endpoint, utilizza una delle seguenti opzioni. Puoi specificare i flag add-endpoints o remove-endpoints più volte nello stesso comando.

  • endpoints: sostituisce gli endpoint nella destinazione con l'elenco specificato
  • add-endpoints: aggiunge gli endpoint specificati alla destinazione
  • remove-endpoints: rimuove gli endpoint specificati dalla destinazione
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

Sostituisci quanto segue:

  • DESTINATION_NAME: il nome della destinazione.
  • CONFIGURATION_NAME: il nome della configurazione che vuoi aggiornare.
  • LOCATION: la regione della configurazione.
  • DESCRIPTION: una descrizione della destinazione e del suo scopo.
  • IP_PREFIX: il prefisso IP della destinazione specificato come intervallo o valore.

  • Per ogni endpoint, specifica quanto segue:

    • ASN: l'ASN che dovrebbe annunciare il prefisso. Consulta la sezione ASN riconosciuti.
    • CSP: una stringa che rappresenta il CSP dell'ASN che annuncia il prefisso.

API

Utilizza il metodo 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"
    }
  ]
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • LOCATION: la regione della configurazione.
  • CONFIGURATION_NAME: il nome della configurazione.
  • DESTINATION_NAME: il nome della destinazione.
  • DESCRIPTION: una descrizione della destinazione e del suo scopo.

  • IP_PREFIX: il prefisso IP della destinazione specificato come intervallo (ad esempio 203.0.113.0/24 o 2001:db8::/32) o come valore (ad esempio 203.0.113.6 o 2001:db8:2:2:2:2:2:2). Un prefisso IP deve essere utilizzato una sola volta in una configurazione e per un solo ASN.

  • Specifica le stringhe corrispondenti agli endpoint che vuoi aggiungere alla destinazione o rimuovi gli endpoint che non vuoi conservare nella destinazione:

    • ASN: l'ASN che dovrebbe annunciare il prefisso. Consulta la sezione ASN riconosciuti.
    • CSP: una stringa che rappresenta il CSP dell'ASN che annuncia il prefisso.

Inoltre, per impedire la sovrascrittura di un insieme specificato di campi durante un'operazione di aggiornamento, puoi utilizzare l'opzione updateMask, che segue il formato fieldMask.

Gli aggiornamenti alle destinazioni di Data Transfer Essentials e alle configurazioni correlate diventano effettivi in circa 24 ore.

Eliminare una destinazione

Per eliminare una destinazione, utilizza uno dei seguenti metodi:

gcloud

Utilizza il 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

Utilizza il metodo multicloudDataTransferConfigs.destinations.delete.

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