Descripción general
En esta sección, aprenderás a usar la API de Datastream para crear, recuperar información y borrar configuraciones de conectividad privada.
Las configuraciones de conectividad privada contienen información que Datastream usa para comunicarse con una fuente de datos a través de una red privada (de forma interna en Google Cloud o con fuentes externas conectadas a través de VPN o Interconnect). Esta comunicación se produce a través de una conexión de intercambio de tráfico de nube privada virtual (VPC).
Existen dos formas de usar la API de Datastream. Puedes realizar llamadas a la API de REST o usar Google Cloud CLI (CLI).
Si quieres ver información de alto nivel sobre el uso de gcloud para administrar los parámetros de configuración de conectividad privada de Datastream, haz clic aquí.
Crear una configuración de conectividad privada
Antes de crear una configuración de conectividad privada, asegúrate de hacer lo siguiente:
- Tener una red de VPC para intercambiar tráfico con la red privada de Datastream Para obtener más información sobre cómo crear una red de VPC, consulta Usa el intercambio de tráfico entre redes de VPC.
- Tener un rango de IP disponible en la red de VPC Datastream usa este rango de IP para crear intercambio de tráfico entre VPC con la VPC proporcionada, por lo que el rango no puede superponerse con las subredes dentro de esa VPC. Como resultado, Datastream se puede comunicar con la fuente.
Hay dos parámetros asociados con la creación de una configuración de conectividad privada:
vpcName:Especifica el nombre y la ruta de acceso de la red de VPC.subnet:Asigna un rango de IP disponible en la red de VPC.
En el siguiente código, se muestra una solicitud para crear una configuración de conectividad privada y se especifica que el método de conectividad es el uso del intercambio de tráfico entre VPC (vpcPeeringConfig).
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]"
}
}
Por ejemplo:
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"
}
}
Después de crear la configuración de conectividad privada, puedes ver información sobre ella llamando al método privateConnections/get. Aparecerá un resultado similar al siguiente:
{
"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
Si quieres obtener más información sobre el uso de gcloud para crear una configuración de conectividad privada, haz clic aquí.
Obtén información sobre una configuración de conectividad privada
En el siguiente código, se muestra una solicitud para recuperar información sobre una configuración de conectividad privada que se creó.
REST
GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/ [location]/privateConnections/[private-connectivity-configuration-id]
Por ejemplo:
GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection
gcloud
Si quieres saber más sobre el uso de gcloud para recuperar datos sobre tu configuración de conectividad privada, haz clic aquí.
Mostrar lista de opciones de configuración de conectividad privada
El siguiente código muestra una solicitud para recuperar información sobre todas tus configuraciones de conectividad privada.
REST
GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/ [location]/privateConnections
gcloud
Si quieres saber más sobre el uso de gcloud para recuperar datos sobre todas tus configuraciones de conectividad privada, haz clic aquí.
Borrar una configuración de conectividad privada
En el siguiente código, se muestra una solicitud para borrar una configuración de conectividad privada. Después de borrar la configuración, no funcionarán los perfiles de conexión que la usen. Tampoco se podrán operar las transmisiones que usen estos perfiles de conexión.
Para resolver este problema, asigna una configuración de conectividad privada diferente a cada perfil de conexión. Para obtener más información, consulta Actualiza un perfil de conexión.
REST
DELETE https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id] {"force": true}
Por ejemplo:
DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}
gcloud
Si deseas obtener más información sobre el uso de gcloud para borrar la configuración de conectividad privada, haz clic aquí.
¿Qué sigue?
- Obtén más información sobre la conectividad privada.
- Obtén más información sobre otras opciones de conectividad de red. que puedes usar con Datastream.
- Obtén más información para usar la API de Datastream para administrar perfiles de conexión.
- Aprende a usar la API de Datastream para administrar transmisiones.
- Para obtener más información sobre el uso de la API de Datastream, consulta la documentación de referencia.