비공개 연결 구성 관리

개요

이 섹션에서는 Datastream API를 사용하여 비공개 연결 구성을 만들고, 관련 정보를 검색하고, 삭제하는 방법을 알아봅니다.

비공개 연결 구성에는 Datastream이 Google Cloud 내에서 내부적으로 또는 VPN 또는 Interconnect를 통해 연결된 외부 소스를 사용하여 비공개 네트워크를 통해 데이터 소스와 통신하기 위해 사용되는 정보가 포함되어 있습니다. 이 통신은 Virtual Private Cloud(VPC) 피어링 연결을 통해 이루어집니다.

Datastream API는 두 가지 방법으로 사용될 수 있습니다. REST API 호출을 수행하거나 Google Cloud CLI(CLI)를 사용할 수 있습니다.

gcloud를 사용한 Datastream 비공개 연결 구성 관리에 대한 개요 정보를 보려면 여기를 클릭합니다.

비공개 연결 구성 만들기

비공개 연결 구성을 만들려면 먼저 다음을 확인해야 합니다.

VPC 네트워크를 Datastream의 비공개 네트워크와 피어링합니다. VPC 네트워크 만들기에 대한 자세한 내용은 VPC 네트워크 피어링 사용을 참조하세요.
VPC 네트워크에서 사용 가능한 IP 범위를 설정합니다. Datastream은 이 IP 범위를 사용해서 제공된 VPC와 VPC 피어링을 만듭니다. 따라서 범위가 해당 VPC 내의 서브넷과 겹칠 수 없습니다. 그 결과 Datastream이 소스와 통신할 수 있습니다.

비공개 연결 구성을 만들 때는 연관된 매개변수가 2개 있습니다.

vpcName: VPC 네트워크의 이름 및 경로를 지정합니다.
subnet: VPC 네트워크에서 사용 가능한 IP 범위를 제공합니다.

다음 코드는 비공개 연결 구성을 만들기 위한 요청을 보여주고 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]"
  }
}

예를 들면 다음과 같습니다.

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

비공개 연결 구성이 생성되었으면 privateConnections/get 메서드를 호출하여 구성 정보를 확인할 수 있습니다. 다음과 비슷한 출력이 표시됩니다.

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

gcloud를 사용하여 비공개 연결 구성을 만드는 방법에 대한 자세한 내용은 여기를 클릭하세요.

비공개 연결 구성 정보 가져오기

다음 코드는 생성된 비공개 연결 구성에 대한 정보 검색 요청을 보여줍니다.

REST

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

예를 들면 다음과 같습니다.

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

gcloud

gcloud를 사용하여 비공개 연결 구성에 대해 정보를 검색하는 방법을 보려면 여기를 클릭하세요.

비공개 연결 구성 나열

다음 코드는 모든 비공개 연결 구성에 대한 정보 검색 요청을 보여줍니다.

REST

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

gcloud

gcloud를 사용하여 모든 비공개 연결 구성에 대해 정보를 검색하는 방법을 보려면 여기를 클릭하세요.

비공개 연결 구성 삭제

다음 코드는 비공개 연결 구성을 삭제하는 요청을 보여줍니다. 구성을 삭제하면 해당 구성을 사용하는 모든 연결 프로필이 작동하지 않습니다. 또한 이러한 연결 프로필을 사용하는 모든 스트림이 작동하지 않습니다.

이 문제를 해결하려면 각 연결 프로필에 다른 비공개 연결 구성을 할당합니다. 자세한 내용은 연결 프로필 업데이트를 참조하세요.

REST

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

예를 들면 다음과 같습니다.

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

비공개 연결 구성이 올바르게 삭제되도록 하려면 {"force": true} 코드 부분을 추가해야 합니다.

gcloud

gcloud를 사용하여 비공개 연결 구성을 삭제하는 방법을 보려면 여기를 클릭하세요.

API를 사용하여 태그 관리

API를 사용하여 연결 프로필 관리