엔드포인트를 통해 리전 Google API에 액세스

콘솔

1. Google Cloud 콘솔에서 Private Service Connect 페이지로 이동합니다.

   Private Service Connect로 이동

2. 엔드포인트 연결을 클릭합니다.

3. 대상에서 Google API를 선택합니다.

4. 범위 목록에서 리전을 선택합니다.

5. 리전 목록에서 사용하려는 리전을 선택합니다.

6. 대상 서비스 목록에서 액세스하려는 서비스를 선택합니다.

7. 엔드포인트 이름에 엔드포인트 이름을 입력합니다.

8. 네트워크에서 네트워크를 선택합니다.

9. 서브네트워크에서 서브네트워크를 선택합니다.

10. IP 주소에서 다음 중 하나를 수행하여 IP 주소를 구성합니다.

    • 자동 할당을 선택하여 새 IP 주소를 자동으로 할당하고 예약합니다.
    • 목록에서 예약된 IP 주소를 선택합니다.
    • IP 주소 만들기를 클릭하여 새 IP 주소를 예약합니다.

11. (선택사항) VPC 네트워크의 모든 리전에서 엔드포인트를 사용할 수 있게 하려면 전역 액세스 사용 설정을 선택합니다.

12. 엔드포인트 추가를 클릭합니다.

gcloud

gcloud network-connectivity regional-endpoints create 명령어를 사용합니다.

gcloud network-connectivity regional-endpoints create ENDPOINT_NAME \
    --region=REGION \
    --address=ADDRESS \
    --network=projects/PROJECT_ID/global/networks/NETWORK_NAME \
    --subnetwork=projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME \
    --target-google-api=REP_DNS_NAME

다른 리전의 리소스에서 엔드포인트를 사용할 수 있게 하려면 --enable-global-access 플래그를 추가합니다.

다음을 바꿉니다.

• ENDPOINT_NAME: 엔드포인트의 이름

• REGION: 엔드포인트를 만들려는 리전

• ADDRESS: 엔드포인트에 사용할 IPv4 또는 IPv6 주소. 생략하면 서브네트워크의 IPv4 주소가 할당됩니다. 다음 형식 중 하나를 사용하세요.

  • IPv4 주소(예: 10.0.0.2)
  • IPv4 또는 IPv6 주소 리소스 URI(예: projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME)

• PROJECT_ID: 엔드포인트를 만들려는 프로젝트

• NETWORK_NAME: 엔드포인트의 VPC 네트워크 이름

• SUBNET_NAME: 엔드포인트를 연결할 서브넷

• REP_DNS_NAME: 연결하려는 리전 서비스 엔드포인트의 호스트 이름. 예를 들면 spanner.me-central2.rep.googleapis.com입니다.

API

projects.locations.regionalEndpoints.create 메서드를 사용합니다.

HTTP 메서드 및 URL:

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints?regionalEndpointId=ENDPOINT_NAME

{
  "accessType": "REGIONAL",
  "address": "ADDRESS",
  "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
  "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
  "targetGoogleApi": "REP_DNS_NAME"
}

다음을 바꿉니다.

• PROJECT_ID: 엔드포인트의 프로젝트 ID
• REGION: 엔드포인트를 만들려는 리전
• ENDPOINT_NAME: 엔드포인트의 이름
• ADDRESS: 엔드포인트에 사용할 IPv4 또는 IPv6 주소. 생략하면 서브네트워크의 IPv4 주소가 할당됩니다. 다음 형식 중 하나를 사용하세요.
  • IPv4 주소(예: 10.0.0.2)
  • IPv4 또는 IPv6 주소 리소스 URI(예: projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME)
• NETWORK_NAME: 엔드포인트의 VPC 네트워크 이름
• SUBNET_NAME: 엔드포인트를 연결할 서브넷의 이름
• REP_DNS_NAME: 연결할 리전 서비스 엔드포인트의 호스트 이름. 예를 들면 spanner.me-central2.rep.googleapis.com입니다.

콘솔

1. Google Cloud 콘솔에서 Private Service Connect 페이지로 이동합니다.

   Private Service Connect로 이동

2. 연결된 엔드포인트 탭을 클릭합니다.

   리전 엔드포인트 타겟이 있는 엔드포인트를 포함한 모든 엔드포인트가 표시됩니다.

gcloud

gcloud network-connectivity regional-endpoints list 명령어를 사용합니다.

gcloud network-connectivity regional-endpoints list \
    --region=REGION

REGION을 나열하려는 엔드포인트의 리전으로 바꿉니다.

API

projects.locations.regionalEndpoints.list 메서드를 사용합니다.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints

다음을 바꿉니다.

• PROJECT_ID: 엔드포인트의 프로젝트 ID
• REGION: 나열할 엔드포인트의 리전

콘솔

1. Google Cloud 콘솔에서 DNS 영역 만들기 페이지로 이동합니다.

   DNS 영역 만들기로 이동

2. 영역 유형으로 비공개를 선택합니다.

3. 영역 이름에 이름을 입력합니다. 예를 들어 Private Service Connect 엔드포인트가 spanner.me-central2.rep.googleapis.com를 가리키는 경우 spanner-me-central2-rep-googleapis-com을 입력합니다.

4. DNS 이름에는 대상 지역 엔드포인트의 호스트 이름을 지정하고 그 뒤에 후행 점을 붙입니다. 예를 들면 spanner.me-central2.rep.googleapis.com.입니다.

5. (선택사항) 설명을 추가합니다.

6. 옵션에서 기본값(비공개)을 선택합니다.

7. 비공개 영역이 표시될 VPC 네트워크를 선택합니다. 선택한 VPC 네트워크만 영역의 레코드를 쿼리할 수 있습니다.

8. 만들기를 클릭합니다.

gcloud

dns managed-zones create 명령어를 실행합니다.

gcloud dns managed-zones create ZONE_NAME \
    --dns-name=REP_DNS_NAME. \
    --networks=VPC_NETWORK_LIST \
    --visibility=private \
    --description="Private zone for REP_DNS_NAME"

다음을 바꿉니다.

• ZONE_NAME: 영역의 이름(예: spanner-me-central2-rep-googleapis.com)
• DESCRIPTION: 영역에 대한 설명
• REP_DNS_NAME: 영역의 DNS 서픽스. 대상 지역 엔드포인트 호스트 이름을 사용합니다(예: spanner.me-central2.rep.googleapis.com).
• VPC_NETWORK_LIST: 영역을 쿼리할 수 있는 VPC 네트워크의 쉼표로 구분된 목록.

API

managedZones.create 메서드를 사용하여 POST 요청을 전송합니다.

HTTP 메서드 및 URL:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones

JSON 요청 본문:

{
  "name": "ZONE_NAME",
  "dnsName": "REP_DNS_NAME.",
  "description": "DESCRIPTION",
  "visibility": "private",
  "privateVisibilityConfig": {
    "kind": "dns#managedZonePrivateVisibilityConfig",
    "networks": [
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "NETWORK_1_URL"
      },
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "NETWORK_2_URL"
      }
    ]
  }
}

다음을 바꿉니다.

• PROJECT_ID: DNS 영역의 프로젝트 ID.
• ZONE_NAME: 이 지역 엔드포인트용으로 만든 비공개 영역의 이름
• REP_DNS_NAME: 만들려는 레코드의 FQDN. 대상 지역 엔드포인트 호스트 이름을 사용합니다(예: spanner.me-central2.rep.googleapis.com).
• DESCRIPTION: DNS 영역에 대한 설명
• NETWORK_1_URL 및 NETWORK_2_URL: 영역을 쿼리할 권한이 있는 VPC 네트워크의 전체 URL(예: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME)

콘솔

1. Google Cloud 콘솔에서 Cloud DNS 영역 페이지로 이동합니다.

   Cloud DNS 영역으로 이동

2. 레코드를 추가할 관리형 영역의 이름을 클릭합니다.

3. 영역 세부정보 페이지에서 표준 추가를 클릭합니다.

4. 레코드 모음 만들기 페이지에서 DNS 이름 입력란은 비워 둡니다. 이 필드를 비워 두면 도메인 맨 위에 리소스 레코드가 생성됩니다.

5. 리소스 레코드 유형에서 A를 선택합니다.

6. IPv4 주소 필드에 Private Service Connect 엔드포인트의 IP 주소를 입력하거나 선택합니다.

7. 만들기를 클릭합니다.

gcloud

리소스 레코드 세트를 만들려면 gcloud dns record-sets create 명령어를 사용합니다.

gcloud dns record-sets create REP_DNS_NAME \
    --rrdatas=ADDRESS \
    --type=RECORD_TYPE \
    --ttl=TTL \
    --zone=ZONE_NAME

다음을 바꿉니다.

• REP_DNS_NAME: 만들려는 레코드의 FQDN. 대상 지역 엔드포인트 호스트 이름을 사용합니다(예: spanner.me-central2.rep.googleapis.com).
• ADDRESS: Private Service Connect 엔드포인트의 IP 주소
• RECORD_TYPE: DNS 레코드 유형(예: IPv4 레코드의 경우 A, IPv6 레코드의 경우 AAAA)
• TTL: 리졸버가 이 리소스 레코드 세트를 캐시하는 TTL(초)(예: 300)
• ZONE_NAME: 이 지역 엔드포인트용으로 만든 비공개 영역의 이름

API

리소스 레코드 세트를 추가하려면 resourceRecordSets.create 메서드를 사용합니다.

HTTP 메서드 및 URL:

POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/ZONE_NAME/rrsets

JSON 요청 본문:

{
  "name": "REP_DNS_NAME.",
  "type": "RECORD_TYPE",
  "ttl": TTL,
  "rrdatas": [ "ADDRESS" ]
}

다음을 바꿉니다.

• PROJECT_ID: DNS 영역의 프로젝트 ID.
• ZONE_NAME: 이 지역 엔드포인트용으로 만든 비공개 영역의 이름
• REP_DNS_NAME: 만들려는 레코드의 FQDN. 대상 지역 엔드포인트 호스트 이름을 사용합니다(예: spanner.me-central2.rep.googleapis.com).
• RECORD_TYPE: DNS 레코드 유형(예: IPv4 레코드의 경우 A, IPv6 레코드의 경우 AAAA)
• TTL: 리졸버가 이 리소스 레코드 세트를 캐시하는 TTL(초)(예: 300)
• ADDRESS: Private Service Connect 엔드포인트의 IP 주소

gcloud

gcloud network-connectivity regional-endpoints describe 명령어를 사용합니다.

gcloud network-connectivity regional-endpoints describe \
    ENDPOINT_NAME --region=REGION

다음을 바꿉니다.

• ENDPOINT_NAME: 엔드포인트의 이름
• REGION: 엔드포인트의 리전

API

projects.locations.regionalEndpoints.get 명령어를 사용합니다.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints/ENDPOINT_NAME

다음을 바꿉니다.

• PROJECT_ID: 엔드포인트의 프로젝트 ID
• REGION: 나열할 엔드포인트의 리전
• ENDPOINT_NAME: 엔드포인트의 이름

gcloud

gcloud network-connectivity regional-endpoints delete 명령어를 사용합니다.

gcloud network-connectivity regional-endpoints delete \
    ENDPOINT_NAME --region=REGION

다음을 바꿉니다.

• ENDPOINT_NAME: 엔드포인트의 이름
• REGION: 엔드포인트의 리전

API

projects.location.regionalEndpoints.delete 명령어를 사용합니다.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints/ENDPOINT_NAME

다음을 바꿉니다.

• PROJECT_ID: 엔드포인트의 프로젝트 ID
• REGION: 엔드포인트의 리전
• ENDPOINT_NAME: 엔드포인트의 이름