Gerenciar configurações de conectividade privada

Visão geral

Nesta seção, você aprenderá a usar a API Datastream para criar, recuperar informações e excluir configurações de conectividade particular.

As configurações de conectividade privada contêm informações que o Datastream usa para se comunicar com uma fonte de dados em uma rede privada (internamente no Google Cloud ou com fontes externas conectadas por VPN ou Interconnect). Essa comunicação acontece por meio de uma conexão de peering de nuvem privada virtual (VPC).

Há duas maneiras de usar a API Datastream. É possível fazer chamadas da API REST ou usar a ferramenta de linha de comando (CLI) gcloud.

Para ver informações de alto nível sobre como usar o gcloud para gerenciar as configurações de conectividade particular do Datastream, clique aqui.

Criar uma configuração de conectividade privada

Antes de criar uma configuração de conectividade privada, verifique se você:

  • Ter uma rede VPC para fazer peering na rede privada do Datastream. Para mais informações sobre como criar uma rede VPC, consulte Como usar o Peering de redes VPC.
  • Aloque um intervalo de IP disponível na rede VPC. O Datastream usa esse intervalo de IP para criar o peering de VPC com a VPC fornecida. Assim, o intervalo não pode se sobrepor às sub-redes nessa VPC. Como resultado, o Datastream pode se comunicar com a origem.

Há dois parâmetros associados à criação de uma configuração de conectividade privada:

  • vpcName: Especifique o nome e o caminho da rede VPC.
  • subnet: Aloque um intervalo de IP disponível na rede VPC.

O código a seguir mostra uma solicitação para criar uma configuração de conectividade privada e especifica o método de conectividade como usando o peering 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]"
  }
}

Exemplo:

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"
  }
}

Após a criação da configuração de conectividade particular, é possível ver informações sobre ela chamando o método privateConnections/get. A saída será assim:

{
  "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"
  }
}

Receber informações sobre uma configuração de conectividade privada

O código a seguir mostra uma solicitação para recuperar informações sobre uma configuração de conectividade particular que foi criada.

REST

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

Exemplo:

GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection
     

gcloud

Para mais informações sobre como usar o gcloud para recuperar informações sobre a configuração de conectividade particular, clique aqui.

Listar configurações de conectividade particulares

O código a seguir mostra uma solicitação para recuperar informações sobre todas as configurações de conectividade particulares.

REST

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

gcloud

Para ver mais informações sobre como usar o gcloud para recuperar informações sobre todas as suas configurações de conectividade particular, clique aqui.

Excluir uma configuração de conectividade privada

O código a seguir mostra uma solicitação para excluir uma configuração de conectividade particular. Depois que a configuração for excluída, todos os perfis de conexão que usam a configuração não funcionarão. Além disso, os streams que usam esses perfis de conexão não poderão ser operados.

Para resolver esse problema, atribua uma configuração de conectividade privada diferente a cada perfil de conexão. Veja mais informações em Atualizar um perfil de conexão.

REST

DELETE https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id] {"force": true}

Exemplo:

DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}

gcloud

Para mais informações sobre como usar o gcloud para excluir sua configuração de conectividade particular, clique aqui.