Informações gerais
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 de API REST ou usar a Google Cloud CLI (CLI).
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"
}
}
gcloud
Para mais informações sobre como usar gcloud para criar uma configuração de conectividade particular, clique aqui.
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.