Administrar las configuraciones de conectividad privada

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.

Los parámetros de configuración 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 realiza 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).

Para ver información de alto nivel sobre el uso de gcloud para administrar las configuraciones 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 un intercambio de tráfico de VPC con la VPC proporcionada, de modo que el rango no se superponga con las subredes dentro de esa VPC. Como resultado, Datastream puede comunicarse 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 el método de conectividad como si se usa el 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 deseas obtener más información para usar gcloud y 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 deseas obtener más información sobre el uso de gcloud para recuperar información sobre la configuración de tu conectividad privada, haz clic aquí.

Enumerar configuraciones 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 Cómo actualizar 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 para usar gcloud y borrar la configuración de conectividad privada, haz clic aquí.

¿Qué sigue?