Gérer les ressources Data Transfer Essentials

Cette page explique comment gérer les ressources créées à l'aide de Data Transfer Essentials.

Gérer les configurations

Vous pouvez répertorier les configurations Data Transfer Essentials dans votre projet, vérifier l'état d'une configuration, la mettre à jour ou la supprimer.

Répertorier les configurations d'un projet

Pour répertorier toutes les configurations d'un emplacement dans un projet, utilisez l'une des méthodes suivantes :

gcloud

Exécutez la gcloud network-connectivity multicloud-data-transfer-configs list commande.

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

Remplacez LOCATION par la région de la configuration.

API

Exécutez la méthode multicloudDataTransferConfigs.get.

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

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• LOCATION : région de la configuration

Vous pouvez également utiliser le paramètre de requête requestID pour identifier vos requêtes API. Si vous relancez votre requête, le serveur peut utiliser l'identifiant pour ignorer une requête à laquelle il a déjà répondu.

Afficher les détails d'une configuration

Pour afficher les détails d'une configuration, utilisez l'une des méthodes suivantes :

gcloud

Exécutez la commande gcloud network-connectivity multicloud-data-transfer-configs describe.

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

Remplacez les éléments suivants :

• CONFIGURATION_NAME: nom de la configuration
• LOCATION : région de la configuration

L'exemple de sortie suivant montre que le trafic provenant de compute-engine peut être pris en compte pour la facturation de Data Transfer Essentials. Pour cloud-sql et cloud-storage, la mise à jour est en attente. La valeur effectiveTime indique l'heure à laquelle l'état doit prendre effet. L'exemple indique également le nombre total de destinations dans la configuration et le nombre de destinations actives.

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

Exécutez la méthode multicloudDataTransferConfigs.list.

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

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• LOCATION : région de la configuration
• CONFIGURATION_NAME: nom de la configuration

L'exemple de sortie suivant montre que le trafic provenant de compute-engine peut être pris en compte pour la facturation de Data Transfer Essentials. Pour cloud-storage et cloud-sql, la mise à jour est en attente. La valeur effectiveTime indique l'heure à laquelle l'état doit prendre effet. L'exemple indique également le nombre total de destinations dans la configuration et le nombre de destinations actives.

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

L'état d'un service peut être l'un des suivants :

• ADDING : le service est en cours d'ajout.
• DELETING : le service est en cours de suppression.
• ACTIVE: le service est configuré pour la facturation de Data Transfer Essentials.

Mettre à jour une configuration

Pour ajouter ou supprimer des services d'une configuration, utilisez l'une des méthodes suivantes :

gcloud

Exécutez la gcloud network-connectivity multicloud-data-transfer-configs update commande.

Pour spécifier des services, utilisez l'une des options suivantes :

• services: remplace les services de la configuration par la liste spécifiée
• update-services : ajoute les services spécifiés à la configuration
• remove-services: supprime les services spécifiés de la configuration
• clear-services : supprime tous les services de la configuration

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

Remplacez les éléments suivants :

• CONFIGURATION_NAME: nom de la configuration que vous souhaitez mettre à jour.
• LOCATION : région de la configuration.
• DESCRIPTION: description de la configuration et de son objectif.
• SERVICE-A,...: série de chaînes représentant les services que vous souhaitez ajouter ou supprimer de la configuration. Pour obtenir la liste des chaînes valides, consultez la section Services et régions compatibles. Utilisez clear-services pour supprimer tous les services de la configuration.

API

Exécutez la méthode multicloudDataTransferConfigs.patch.

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

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet.
• LOCATION : région de la configuration.
• CONFIGURATION_NAME: nom de la configuration.
• DESCRIPTION: description de la configuration et de son objectif.
• SERVICE-A: série de chaînes représentant les services que vous souhaitez ajouter ou supprimer de la configuration. Pour obtenir la liste des chaînes valides, consultez la section Services et régions compatibles.

De plus, pour empêcher qu'un ensemble de champs spécifié ne soit écrasé lors d'une opération de mise à jour, vous pouvez utiliser l'option updateMask, qui suit le format fieldMask.

Les mises à jour des configurations Data Transfer Essentials prennent effet dans environ 24 heures.

Supprimer une configuration

Vous ne pouvez supprimer une configuration qu'après avoir supprimé toutes les destinations qui y sont associées.

Pour supprimer une configuration, utilisez l'une des méthodes suivantes :

gcloud

Exécutez la commande gcloud network-connectivity multicloud-data-transfer-configs delete.

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

API

Exécutez la multicloudDataTransferConfigs.delete méthode.

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

Gérer les destinations

Vous pouvez répertorier les destinations Data Transfer Essentials dans votre projet, vérifier l'état d'une destination, la mettre à jour ou la supprimer.

Répertorier les destinations d'un projet

Pour répertorier toutes les destinations d'un projet, utilisez l'une des méthodes suivantes :

gcloud

Exécutez la commande 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

Remplacez les éléments suivants :

• CONFIGURATION_NAME: nom de la configuration dont vous souhaitez répertorier les destinations
• LOCATION : région de la configuration

API

Exécutez la méthode multicloudDataTransferConfigs.destinations.list.

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

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• LOCATION : région de la configuration
• CONFIGURATION_NAME: nom de la configuration dont vous souhaitez répertorier les destinations

Afficher les détails d'une destination

Pour afficher les détails d'une destination, utilisez l'une des méthodes suivantes :

gcloud

Exécutez la commande 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

Remplacez les éléments suivants :

• DESTINATION_NAME : nom de la destination
• CONFIGURATION_NAME: nom de la configuration dont vous souhaitez afficher la destination
• LOCATION : région de la configuration

L'exemple suivant montre que le point de terminaison spécifié pour destination1 est valide et que la destination est ajoutée à l'heure indiquée par 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

Exécutez la méthode multicloudDataTransferConfigs.destinations.get.

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

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• LOCATION : région de la configuration
• CONFIGURATION_NAME: nom de la configuration
• DESTINATION_NAME : nom de la destination

L'exemple de sortie suivant montre que le point de terminaison spécifié pour destination1 est valide et que la destination est ajoutée à l'heure indiquée par 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"
          }
        ]
      }
    }
  ]
}

Pour une destination, l'état peut être l'un des suivants :

• ADDING : la destination est en cours d'ajout.
• DELETING : la destination est en cours de suppression.
• SUSPENDING : la destination est en cours de suspension en fonction de l'audit.
• ACTIVE: la destination est prise en compte pour la facturation de Data Transfer Essentials.
• SUSPENDED: la destination a été supprimée ou ne respecte pas les conditions d'utilisation et ne sera pas prise en compte pour la facturation de Data Transfer Essentials.

Pour un point de terminaison, l'état peut être l'un des suivants :

• VALID : la combinaison des valeurs ASN et CSP est valide.
• INVALID : la combinaison des valeurs ASN et CSP n'est pas valide.

Si l'état d'au moins un point de terminaison est VALID, la destination est considérée comme éligible à la facturation de Data Transfer Essentials.

Si l'état de tous les points de terminaison est INVALID, la destination est considérée comme non éligible à la facturation de Data Transfer Essentials. Dans ce cas, l'état de la destination est défini sur SUSPENDING ou SUSPENDED, selon que l'état actuel est ADDING ou ACTIVE, respectivement. Le trafic vers une telle destination est traité comme un trafic Internet normal.

Mettre à jour une destination

Une destination doit comporter au moins un point de terminaison et ne peut pas en comporter plus de cinq.

Pour ajouter ou supprimer des points de terminaison d'une destination, utilisez l'une des méthodes suivantes :

gcloud

Exécutez la gcloud network-connectivity multicloud-data-transfer-configs destinations update commande.

Pour spécifier des points de terminaison, utilisez l'une des options suivantes. Vous pouvez spécifier plusieurs fois les indicateurs add-endpoints ou remove-endpoints dans la même commande.

• endpoints: remplace les points de terminaison de la destination par la liste spécifiée
• add-endpoints : ajoute les points de terminaison spécifiés à la destination
• remove-endpoints: supprime les points de terminaison spécifiés de la destination

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

Remplacez les éléments suivants :

• DESTINATION_NAME : nom de la destination.
• CONFIGURATION_NAME: nom de la configuration que vous souhaitez mettre à jour.
• LOCATION : région de la configuration.
• DESCRIPTION: description de la destination et de son objectif.
• IP_PREFIX: préfixe IP de la destination spécifié sous forme de plage ou de valeur.

• Pour chaque point de terminaison, spécifiez les éléments suivants :

  • ASN: ASN qui doit annoncer le préfixe. Consultez la section ASN reconnus.
  • CSP: chaîne représentant le CSP de l'ASN qui annonce le préfixe.

API

Exécutez la méthode 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"
    }
  ]
}

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet.
• LOCATION : région de la configuration.
• CONFIGURATION_NAME: nom de la configuration.
• DESTINATION_NAME : nom de la destination.
• DESCRIPTION: description de la destination et de son objectif.

• IP_PREFIX: préfixe IP de la destination spécifié sous forme de plage (par exemple, 203.0.113.0/24 ou 2001:db8::/32) ou de valeur (par exemple, 203.0.113.6 ou 2001:db8:2:2:2:2:2:2). Un préfixe IP ne doit être utilisé qu'une seule fois dans une configuration et pour un seul ASN.

• Spécifiez des chaînes correspondant aux points de terminaison que vous souhaitez ajouter à la destination ou supprimez les points de terminaison que vous ne souhaitez pas conserver dans la destination :

  • ASN: ASN qui doit annoncer le préfixe. Consultez la section ASN reconnus.
  • CSP: chaîne représentant le CSP de l'ASN qui annonce le préfixe.

De plus, pour empêcher qu'un ensemble de champs spécifié ne soit écrasé lors d'une opération de mise à jour, vous pouvez utiliser l'option updateMask, qui suit le format fieldMask.

Les mises à jour des destinations Data Transfer Essentials et des configurations associées prennent effet dans environ 24 heures.

Supprimer une destination

Pour supprimer une destination, utilisez l'une des méthodes suivantes :

gcloud

Exécutez la commande 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

Exécutez la multicloudDataTransferConfigs.destinations.delete méthode.

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