Présentation
Dans cette section, vous allez apprendre à utiliser l'API Datastream pour obtenir des informations sur, créer et supprimer des configurations de connectivité privée.
Les configurations de connectivité privée contiennent des informations que Datastream utilise pour communiquer avec une source de données via un réseau privé (en interne dans Google Cloud ou avec des sources externes connectées via VPN ou interconnexion). Cette communication se fait via une connexion d'appairage de cloud privé virtuel (VPC).
Vous pouvez utiliser l'API Datastream de deux manières. Vous pouvez effectuer des appels d'API REST ou utiliser la Google Cloud CLI (CLI).
Pour obtenir des informations générales sur l'utilisation de gcloud afin de gérer les configurations de connectivité privée Datastream, cliquez ici.
Créer une configuration de connectivité privée
Avant de créer une configuration de connectivité privée, assurez-vous que les conditions suivantes sont satisfaites :
- Vous disposez d'un réseau VPC à appairer avec le réseau privé de Datastream. Pour plus d'informations sur la création d'un réseau VPC, consultez la section Utiliser l'appairage de réseaux VPC.
- Vous disposez d'une plage d'adresses IP disponible sur le réseau VPC. Datastream utilise cette plage d'adresses IP pour créer un appairage VPC avec le VPC fourni. La plage ne peut donc pas chevaucher les sous-réseaux de ce VPC. Ainsi, Datastream peut communiquer avec la source.
Deux paramètres sont associés à la création d'une configuration de connectivité privée :
vpcName:, qui indique le nom et le chemin d'accès du réseau VPC.subnet:qui fournit une plage d'adresses IP disponibles sur le réseau VPC.
Le code suivant montre une demande de création de configuration de connectivité privée et spécifie l'utilisation de l'appairage de VPC (vpcPeeringConfig) comme méthode de connectivité.
REST
POST https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections?privateConnectionId=[private-connectivity configuration-id]
{
"displayName": "[private-connectivity-configuration-display-name]",
"vpcPeeringConfig": {
"vpcName": "[name-and-path-of-VPC-network]",
"subnet": "[subnet]"
}
}
Exemple :
POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
"displayName": "my private connectivity configuration",
"vpcPeeringConfig": {
"vpcName": "projects/my-project/global/networks/my-vpc",
"subnet": "10.11.12.13/29"
}
}
Une fois la configuration de connectivité privée créée, vous pouvez afficher des informations la concernant en appelant la méthode privateConnections/get. Un résultat semblable aux lignes suivantes s'affiche :
{
"name": "projects/projectId/location/us-central1/privateConnections/myPrivateConnection",
"createTime": "2019-12-22T16:17:37.159786963Z",
"updateTime": "2019-12-22T16:17:37.159786963Z",
"displayName": "my private connectivity configuration",
"state": "CREATED",
"vpcPeeringConfig": {
"vpcName": "projects/my-project/global/networks/my-vpc",
"subnet": "10.11.12.13/29"
}
}
gcloud
Pour plus d'informations sur l'utilisation de gcloud pour créer une configuration de connectivité privée, cliquez ici.
Obtenir des informations sur une configuration de connectivité privée
Le code suivant montre une requête de récupération d'informations pour une configuration de connectivité privée préalablement créée.
REST
GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/ [location]/privateConnections/[private-connectivity-configuration-id]
Exemple :
GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection
gcloud
Pour en savoir plus sur l'utilisation de gcloud afin de récupérer des informations sur votre configuration de connectivité privée, cliquez ici.
Répertorier les configurations de connectivité privée
Le code suivant montre une requête de récupération d'informations sur toutes vos configurations de connectivité privée.
REST
GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/ [location]/privateConnections
gcloud
Pour en savoir plus sur l'utilisation de gcloud afin de récupérer des informations sur toutes vos configurations de connectivité privée, cliquez ici.
Supprimer une configuration de connectivité privée
Le code suivant montre une requête de suppression d'une configuration de connectivité privée. Une fois la configuration supprimée, les profils de connexion utilisant cette configuration ne fonctionneront plus. En outre, les flux utilisant ces profils de connexion ne seront pas exploitables.
Pour résoudre ce problème, attribuez une configuration de connectivité privée différente à chaque profil de connexion. Pour en savoir plus, consultez la page Mettre à jour un profil de connexion.
REST
DELETE https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id] {"force": true}
Exemple :
DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}
gcloud
Pour en savoir plus sur la suppression de votre configuration de connectivité privée à l'aide de gcloud, cliquez ici.