Cette page explique comment gérer les ressources créées à l'aide de Data Transfer Essentials.
Gérer les configurations
Vous pouvez lister les configurations Data Transfer Essentials dans votre projet, vérifier l'état d'une configuration, la mettre à jour ou la supprimer.
Lister les configurations d'un projet
Pour lister toutes les configurations d'un emplacement dans un projet, utilisez l'une des méthodes suivantes :
gcloud
Exécutez la commande gcloud network-connectivity multicloud-data-transfer-configs list.
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 projetLOCATION: région de la configuration
Vous pouvez également utiliser le paramètre de requête requestID pour identifier vos requêtes d'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 configurationLOCATION: région de la configuration
L'exemple de résultat suivant montre que le trafic provenant de compute-engine est prêt à être pris en compte pour la facturation Data Transfer Essentials. Pour cloud-sql et cloud-storage, la mise à jour est en attente.
La valeur effectiveTime indique l'heure à laquelle l'état devrait prendre effet. L'échantillon 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 projetLOCATION: région de la configurationCONFIGURATION_NAME: nom de la configuration
L'exemple de résultat suivant montre que le trafic provenant de compute-engine est prêt à être pris en compte pour la facturation Data Transfer Essentials.
Pour cloud-storage et cloud-sql, la mise à jour est en attente.
La valeur effectiveTime indique l'heure à laquelle l'état est censé prendre effet. L'échantillon 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 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 commande gcloud network-connectivity multicloud-data-transfer-configs update.
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 configurationremove-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 connaître les chaînes valides, consultez Services et régions compatibles. Utilisezclear-servicespour supprimer tous les services de la configuration.
API
Exécutez la méthode multicloudDataTransferConfigs.update.
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: par l'ID du 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 connaître les chaînes valides, consultez Services et régions compatibles.
De plus, pour empêcher l'écrasement d'un ensemble de champs spécifié lors d'une opération de mise à jour, vous pouvez utiliser l'option updateMask, qui suit le format fieldMask.
Les modifications apportées aux configurations Data Transfer Essentials prennent effet sous 24 heures environ.
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 méthode multicloudDataTransferConfigs.delete.
DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
Gérer les destinations
Vous pouvez lister les destinations Data Transfer Essentials dans votre projet, vérifier l'état d'une destination, la mettre à jour ou la supprimer.
Lister les destinations d'un projet
Pour lister 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 lister les destinationsLOCATION: 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 projetLOCATION: région de la configurationCONFIGURATION_NAME: nom de la configuration dont vous souhaitez lister 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 destinationCONFIGURATION_NAME: nom de la configuration dont vous souhaitez afficher la destinationLOCATION: 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 projetLOCATION: région de la configurationCONFIGURATION_NAME: nom de la configurationDESTINATION_NAME: nom de la destination
L'exemple de résultat 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 suspendue en raison d'un audit.ACTIVE: la destination est prise en compte pour la facturation de Transfert de données Essentials.SUSPENDED: la destination a été supprimée ou ne respecte pas les conditions d'utilisation. Elle 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'un seul point de terminaison est VALID, la destination est considérée comme éligible à la facturation 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 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 du trafic Internet normal.
Modifier 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 commande gcloud network-connectivity multicloud-data-transfer-configs destinations update.
Pour spécifier des points de terminaison, utilisez l'une des options suivantes. Vous pouvez spécifier les indicateurs add-endpoints ou remove-endpoints plusieurs fois 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: numéro 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.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"
}
]
}
Remplacez les éléments suivants :
PROJECT_ID: par l'ID du 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/24ou2001:db8::/32) ou de valeur (par exemple,203.0.113.6ou2001: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 numéro ASN.Spécifiez les 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: numéro 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 l'écrasement d'un ensemble de champs spécifié lors d'une opération de mise à jour, vous pouvez utiliser l'option updateMask, qui suit le format fieldMask.
Les modifications apportées aux destinations Data Transfer Essentials et aux configurations associées prennent effet sous 24 heures environ.
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 méthode multicloudDataTransferConfigs.destinations.delete.
DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME