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

Si quieres ver información general sobre el uso de gcloud para administrar la 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:

  • Ten una red de VPC para intercambiar tráfico con la red privada de Datastream. Si quieres obtener más información para 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 entre VPC con la VPC proporcionada, por lo que el rango no puede superponerse 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 que usa el intercambio de tráfico de 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 obtener más información sobre el uso de gcloud para recuperar información sobre la configuración de conectividad privada, haz clic aquí.

Enumerar parámetros de configuración de conectividad privada

En el siguiente código, se muestra una solicitud para recuperar información sobre todas tus opciones de configuración de conectividad privada.

REST

GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections

gcloud

Si quieres obtener más información sobre el uso de gcloud para recuperar información 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. Una vez que se borre la configuración, los perfiles de conexión que la usen dejarán de funcionar. Además, las transmisiones que usen estos perfiles de conexión no podrán operar.

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 quieres obtener más información sobre el uso de gcloud para borrar la configuración de conectividad privada, haz clic aquí.