비공개 서비스 액세스 구성

콘솔

1. Cloud de Confiance 콘솔에서 VPC 네트워크 페이지로 이동합니다.

   VPC 네트워크로 이동

2. 사용할 VPC 네트워크를 선택합니다.
3. 비공개 서비스 액세스 탭을 선택합니다.
4. 서비스에 할당된 IP 범위 탭을 선택합니다.
5. IP 범위 할당을 클릭합니다.
6. 할당된 범위의 이름에 google-managed-services-VPC_NETWORK_NAME을 지정합니다. 여기서 VPC_NETWORK_NAME은 연결할 VPC 네트워크의 이름입니다(예: google-managed-services-default). 설명은 선택사항입니다.
7. 커스텀 옵션을 선택한 다음 할당할 IP 주소 범위를 CIDR 표기법으로 입력합니다.
8. 할당을 클릭하여 할당된 범위를 만듭니다.

gcloud

다음 중 하나를 수행합니다.

• 주소 범위와 프리픽스 길이(서브넷 마스크)를 지정하려면 addresses 및 prefix-length 플래그를 사용합니다. 예를 들어 CIDR 블록 192.168.0.0/16을 할당하려면 주소에 192.168.0.0을 지정하고 프리픽스 길이에 16을 지정합니다.

    gcloud compute addresses create google-managed-services-VPC_NETWORK_NAME \
       --global \
       --purpose=VPC_PEERING \
       --addresses=192.168.0.0 \
       --prefix-length=16 \
       --network=projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME
    

• 프리픽스 길이 (서브넷 마스크)만 지정하려면 prefix-length 플래그를 사용합니다. IP 주소 범위를 생략하면 Cloud de Confiance가 VPC 네트워크에서 사용되지 않는 IP 주소 범위를 자동으로 선택합니다. 다음 예시에서는 프리픽스 길이가 16비트인 사용되지 않는 IP 주소 범위를 선택합니다.

  gcloud compute addresses create google-managed-services-VPC_NETWORK_NAME \
    --global \
    --purpose=VPC_PEERING \
    --prefix-length=16 \
    --network=projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME
  

VPC_NETWORK_NAME을 VPC 네트워크 이름으로 바꿉니다(예: my-vpc-network).

다음 예시에서는 VPC 네트워크 my-vpc-network의 리소스가 비공개 IP를 사용하여 Cloud SQL 인스턴스에 연결하도록 허용하는 IP 범위를 할당합니다.

  gcloud compute addresses create google-managed-services-my-vpc-network \
    --global \
    --purpose=VPC_PEERING \
    --prefix-length=16 \
    --network=projects/myprojectid/global/networks/myvpcnetwork \
    --project=my-project
    

Terraform

IP 주소 범위를 할당하려면 Terraform 리소스를 사용합니다.

resource "google_compute_global_address" "private_ip_address" {
  name          = "private-ip-address"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length = 16
  network       = google_compute_network.peering_network.id
}

변경사항 적용

Cloud de Confiance 프로젝트에 Terraform 구성을 적용하려면 다음 섹션의 단계를 완료하세요.

Cloud Shell 준비

1. Cloud Shell을 실행합니다.

2. Terraform 구성을 적용할 기본 Cloud de Confiance 프로젝트를 설정합니다.

   이 명령어는 프로젝트당 한 번만 실행하면 되며 어떤 디렉터리에서도 실행할 수 있습니다.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Terraform 구성 파일에서 명시적 값을 설정하면 환경 변수가 재정의됩니다.

디렉터리 준비

각 Terraform 구성 파일에는 자체 디렉터리(루트 모듈이라고도 함)가 있어야 합니다.

1. Cloud Shell에서 디렉터리를 만들고 해당 디렉터리 내에 새 파일을 만드세요. 파일 이름에는 .tf 확장자가 있어야 합니다(예: main.tf). 이 튜토리얼에서는 파일을 main.tf라고 합니다.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. 튜토리얼을 따라 하는 경우 각 섹션이나 단계에서 샘플 코드를 복사할 수 있습니다.

   샘플 코드를 새로 만든 main.tf에 복사합니다.

   필요한 경우 GitHub에서 코드를 복사합니다. 이는 Terraform 스니펫이 엔드 투 엔드 솔루션의 일부인 경우에 권장됩니다.

3. 환경에 적용할 샘플 파라미터를 검토하고 수정합니다.
4. 변경사항을 저장합니다.
5. Terraform을 초기화합니다. 이 작업은 디렉터리당 한 번만 수행하면 됩니다.

   terraform init

   원하는 경우 최신 Google 공급업체 버전을 사용하려면 -upgrade 옵션을 포함합니다.

   terraform init -upgrade

변경사항 적용

1. 구성을 검토하고 Terraform에서 만들거나 업데이트할 리소스가 예상과 일치하는지 확인합니다.

   terraform plan

   필요에 따라 구성을 수정합니다.

2. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 Terraform 구성을 적용합니다.

   terraform apply

   Terraform에 '적용 완료' 메시지가 표시될 때까지 기다립니다.

3. 결과를 보려면 Cloud de Confiance 프로젝트를 엽니다. Cloud de Confiance 콘솔에서 UI의 리소스로 이동하여 Terraform이 리소스를 만들었거나 업데이트했는지 확인합니다.

변경사항 삭제

다음 명령어를 실행하고 프롬프트에 yes를 입력하여 이전에 Terraform 구성에 적용된 리소스를 삭제합니다.

terraform destroy

Console

1. Cloud de Confiance 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

   Cloud SQL 인스턴스로 이동

2. 인스턴스 만들기를 클릭합니다.
3. 인스턴스 맞춤설정 섹션에서 구성 옵션 표시를 펼칩니다.
4. 연결을 펼칩니다.
5. 비공개 IP를 선택합니다.
6. 비공개 서비스 액세스 (PSA)를 선택합니다.

   드롭다운 목록에 프로젝트에서 사용할 수 있는 VPC 네트워크가 표시됩니다. 프로젝트가 공유 VPC의 서비스 프로젝트이면 호스트 프로젝트의 VPC 네트워크도 표시됩니다.

7. 사용할 VPC 네트워크를 선택합니다.

비공개 서비스 연결을 설정해야 한다는 메시지가 표시되면 다음 단계를 따르세요.

1. 연결 설정을 클릭합니다.
2. IP 범위 할당 섹션에서 다음 옵션 중 하나를 선택합니다.
   • 하나 이상의 기존 IP 범위를 선택하거나 드롭다운에서 새 범위를 만듭니다. 드롭다운에 이전에 할당된 범위(있는 경우)가 포함되거나 새 IP 범위 할당을 선택하고 새 범위와 이름을 입력할 수 있습니다.
   • 네트워크에 자동으로 할당된 IP 범위를 사용합니다.
3. 계속을 클릭합니다.
4. 연결 만들기를 클릭합니다.
5. Private service connection for network VPC_NETWORK_NAME has been successfully created 메시지가 표시되는지 확인합니다.
8. 원하는 경우 연결에 사용할 인스턴스에 할당된 IP 범위를 지정할 수 있습니다.
   1. 할당된 IP 범위 옵션 표시를 펼칩니다.
   2. 드롭다운 메뉴에서 IP 범위를 선택합니다.
9. (선택사항) BigQuery와 같은 다른 Cloud de Confiance by S3NS 서비스에서 Cloud SQL의 데이터에 액세스하고 비공개 IP 연결을 통해 이 데이터에 대해 쿼리를 수행하도록 허용하려면 비공개 경로 사용 설정을 선택합니다.
10. 인스턴스 구성을 완료합니다.
11. 인스턴스 만들기를 클릭합니다.

gcloud

비공개 IP 주소를 사용하여 인스턴스를 만들기 전에 프로젝트가 비공개 서비스 액세스를 위해 구성되었는지 확인합니다.

다음 gcloud CLI 명령어를 실행하여 Cloud SQL의 비공개 서비스 액세스 네트워킹을 설정합니다.

1. 필요한 API를 사용 설정합니다.

   gcloud services enable \
       sqladmin.googleapis.com \
       compute.googleapis.com \
       servicenetworking.googleapis.com \
       --project=PROJECT_ID
       

2. VPC 네트워크 피어링을 위한 IP 주소 범위 할당:

   gcloud compute addresses create google-managed-services-VPC_NETWORK_NAME \
       --global \
       --purpose=VPC_PEERING \
       --prefix-length=16 \
       --network=projects/NETWORK_PROJECT_ID/global/networks/VPC_NETWORK_NAME \
       --project=PROJECT_ID
       

3. VPC 네트워크 피어링 연결을 설정합니다.

   gcloud services vpc-peerings connect \
       --service=servicenetworking.googleapis.com \
       --ranges=google-managed-services-VPC_NETWORK_NAME \
       --network=VPC_NETWORK_NAME \
       --project=PROJECT_ID
       

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• INSTANCE_ID: 인스턴스 ID
• PROJECT_ID: 프로젝트 ID

• NETWORK_PROJECT_ID: VPC 네트워크의 프로젝트 ID

• VPC_NETWORK_NAME: VPC 네트워크의 이름입니다.
• RANGE_NAME: 선택사항. 지정하면 IP 범위가 할당되는 범위 이름이 설정됩니다. 범위 이름은 RFC-1035를 준수해야 하며 1~63자(영문 기준) 이내여야 합니다.
• REGION_NAME: 리전 이름입니다.

또한 원하는 경우 --enable-google-private-path 파라미터를 사용하여 BigQuery와 같은 다른 Cloud de Confiance 서비스에서 Cloud SQL의 데이터에 액세스하고 비공개 IP 연결을 통해 이 데이터에 대해 쿼리를 수행하도록 허용합니다. 이 파라미터는 다음 경우에만 유효합니다.

• --no-assign-ip 파라미터를 사용합니다.
• --network 파라미터를 사용하여 비공개 연결을 만드는 데 사용할 VPC 네트워크의 이름을 지정합니다.

gcloud beta sql instances create INSTANCE_ID \
  --project=PROJECT_ID \
  --network=projects/NETWORK_PROJECT_ID/global/networks/VPC_NETWORK_NAME \
  --no-assign-ip \
  --allocated-ip-range-name=RANGE_NAME \
  --enable-google-private-path \
  --enforce-new-sql-network-architecture

Terraform

새 인스턴스에 비공개 IP를 구성하려면 다음 Terraform 리소스를 사용합니다.

• google_compute_network
• google_compute_global_address
• google_service_networking_connection
• google_sql_database_instance

resource "google_compute_network" "peering_network" {
  name                    = "private-network"
  auto_create_subnetworks = "false"
}

resource "google_compute_global_address" "private_ip_address" {
  name          = "private-ip-address"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length = 16
  network       = google_compute_network.peering_network.id
}

resource "google_service_networking_connection" "default" {
  network                 = google_compute_network.peering_network.id
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.private_ip_address.name]
}

resource "google_sql_database_instance" "instance" {
  name             = "private-ip-sql-instance"
  region           = "us-central1"
  database_version = "MYSQL_8_0"

  depends_on = [google_service_networking_connection.default]

  settings {
    tier = "db-f1-micro"
    ip_configuration {
      ipv4_enabled    = "false"
      private_network = google_compute_network.peering_network.id
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

resource "google_compute_network_peering_routes_config" "peering_routes" {
  peering              = google_service_networking_connection.default.peering
  network              = google_compute_network.peering_network.name
  import_custom_routes = true
  export_custom_routes = true
}


## Uncomment this block after adding a valid DNS suffix

# resource "google_service_networking_peered_dns_domain" "default" {
#   name       = "example-com"
#   network    = google_compute_network.peering_network.name
#   dns_suffix = "example.com."
#   service    = "servicenetworking.googleapis.com"
# }

변경사항 적용

Cloud de Confiance 프로젝트에 Terraform 구성을 적용하려면 다음 섹션의 단계를 완료하세요.

Cloud Shell 준비

1. Cloud Shell을 실행합니다.

2. Terraform 구성을 적용할 기본 Cloud de Confiance 프로젝트를 설정합니다.

   이 명령어는 프로젝트당 한 번만 실행하면 되며 어떤 디렉터리에서도 실행할 수 있습니다.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Terraform 구성 파일에서 명시적 값을 설정하면 환경 변수가 재정의됩니다.

디렉터리 준비

각 Terraform 구성 파일에는 자체 디렉터리(루트 모듈이라고도 함)가 있어야 합니다.

1. Cloud Shell에서 디렉터리를 만들고 해당 디렉터리 내에 새 파일을 만드세요. 파일 이름에는 .tf 확장자가 있어야 합니다(예: main.tf). 이 튜토리얼에서는 파일을 main.tf라고 합니다.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. 튜토리얼을 따라 하는 경우 각 섹션이나 단계에서 샘플 코드를 복사할 수 있습니다.

   샘플 코드를 새로 만든 main.tf에 복사합니다.

   필요한 경우 GitHub에서 코드를 복사합니다. 이는 Terraform 스니펫이 엔드 투 엔드 솔루션의 일부인 경우에 권장됩니다.

3. 환경에 적용할 샘플 파라미터를 검토하고 수정합니다.
4. 변경사항을 저장합니다.
5. Terraform을 초기화합니다. 이 작업은 디렉터리당 한 번만 수행하면 됩니다.

   terraform init

   원하는 경우 최신 Google 공급업체 버전을 사용하려면 -upgrade 옵션을 포함합니다.

   terraform init -upgrade

변경사항 적용

1. 구성을 검토하고 Terraform에서 만들거나 업데이트할 리소스가 예상과 일치하는지 확인합니다.

   terraform plan

   필요에 따라 구성을 수정합니다.

2. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 Terraform 구성을 적용합니다.

   terraform apply

   Terraform에 '적용 완료' 메시지가 표시될 때까지 기다립니다.

3. 결과를 보려면 Cloud de Confiance 프로젝트를 엽니다. Cloud de Confiance 콘솔에서 UI의 리소스로 이동하여 Terraform이 리소스를 만들었거나 업데이트했는지 확인합니다.

변경사항 삭제

변경사항을 삭제하려면 다음 단계를 따르세요.

1. Terraform 구성 파일에서 삭제 방지를 사용 중지하려면 deletion_protection 인수를 false로 설정합니다.

   deletion_protection =  "false"

2. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 업데이트된 Terraform 구성을 적용합니다.

   terraform apply

3. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 이전에 Terraform 구성에 적용된 리소스를 삭제합니다.

   terraform destroy

REST v1

비공개 IP 주소로 새 인스턴스를 만듭니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID:: 프로젝트 ID
• INSTANCE_ID:: 인스턴스 ID
• VPC_NETWORK_NAME:: 이 인스턴스에 사용하려는 Virtual Private Cloud(VPC) 네트워크 이름을 지정합니다. 비공개 서비스 액세스가 이미 네트워크에 구성되어 있어야 합니다.
• RANGE_NAME:: 선택사항. 지정하면 IP 범위가 할당되는 범위 이름이 설정됩니다. 범위 이름은 RFC-1035를 준수해야 하며 1~63(영문 기준)자 이내여야 합니다.
• AUTHORIZED_NETWORKS:: 공개 IP 연결의 경우 인스턴스에 연결할 수 있는 승인된 네트워크의 연결을 지정합니다.

ipv4Enabled 파라미터의 경우 인스턴스에 공개 IP 주소를 사용하려면 값을 true로 설정하고, 인스턴스에 비공개 IP 주소가 포함되었으면 false로 설정합니다.

enablePrivatePathForGoogleCloudServices 파라미터를 true로 설정하면 BigQuery와 같은 다른 Cloud de Confiance by S3NS 서비스에서 Cloud SQL의 데이터에 액세스하고 비공개 IP 연결을 통해 이 데이터에 대해 쿼리를 수행할 수 있습니다. 이 파라미터를 false로 설정하면 다른 Cloud de Confiance by S3NS 서비스에서 비공개 IP 연결을 통해 Cloud SQL의 데이터에 액세스할 수 없습니다.

프로젝트가 완전히 업그레이드되지 않은 경우에도 sqlNetworkArchitecture 필드를 사용하여 인스턴스 생성 시 새 네트워크 아키텍처를 사용하도록 강제할 수 있습니다. 새 네트워크 아키텍처 및 그 영향에 관한 자세한 내용은 새 네트워크 아키텍처로 인스턴스 업그레이드 및 IP 주소 범위 할당을 참고하세요.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "name": "INSTANCE_ID",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

비공개 IP 주소로 새 인스턴스를 만듭니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID:: 프로젝트 ID
• INSTANCE_ID:: 인스턴스 ID
• VPC_NETWORK_NAME:: 이 인스턴스에 사용하려는 Virtual Private Cloud(VPC) 네트워크 이름을 지정합니다. 비공개 서비스 액세스가 이미 네트워크에 구성되어 있어야 합니다.
• RANGE_NAME:: 선택사항. 지정하면 IP 범위가 할당되는 범위 이름이 설정됩니다. 범위 이름은 RFC-1035를 준수해야 하며 1~63(영문 기준)자 이내여야 합니다.
• AUTHORIZED_NETWORKS:: 공개 IP 연결의 경우 인스턴스에 연결할 수 있는 승인된 네트워크의 연결을 지정합니다.

ipv4Enabled 파라미터의 경우 인스턴스에 공개 IP 주소를 사용하려면 값을 true로 설정하고, 인스턴스에 비공개 IP 주소가 포함되었으면 false로 설정합니다.

enablePrivatePathForGoogleCloudServices 파라미터를 true로 설정하면 BigQuery와 같은 다른 Cloud de Confiance by S3NS 서비스에서 Cloud SQL의 데이터에 액세스하고 비공개 IP 연결을 통해 이 데이터에 대해 쿼리를 수행할 수 있습니다. 이 파라미터를 false로 설정하면 다른 Cloud de Confiance by S3NS 서비스에서 비공개 IP 연결을 통해 Cloud SQL의 데이터에 액세스할 수 없습니다.

프로젝트가 완전히 업그레이드되지 않은 경우에도 sqlNetworkArchitecture 필드를 사용하여 인스턴스 생성 시 새 네트워크 아키텍처를 사용하도록 강제할 수 있습니다. 새 네트워크 아키텍처 및 그 영향에 관한 자세한 내용은 새 네트워크 아키텍처로 인스턴스 업그레이드 및 IP 주소 범위 할당을 참고하세요.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "name": "INSTANCE_ID",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Console

1. Cloud de Confiance 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

   Cloud SQL 인스턴스로 이동

2. 인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
3. Cloud SQL 탐색 메뉴에서 연결을 선택합니다.
4. 네트워킹 탭에서 비공개 IP 체크박스를 선택합니다.

   드롭다운 목록에 프로젝트에서 사용할 수 있는 네트워크가 표시됩니다.

5. 사용할 VPC 네트워크를 선택합니다.

비공개 서비스 연결 필요가 표시되는 경우:

1. 연결 설정을 클릭합니다.
2. IP 범위 할당 섹션에서 다음 옵션 중 하나를 선택합니다.
   • 하나 이상의 기존 IP 범위를 선택하거나 드롭다운에서 새 범위를 만듭니다. 드롭다운에 이전에 할당된 범위(있는 경우)가 포함되거나 새 IP 범위 할당을 선택하고 새 범위와 이름을 입력할 수 있습니다.
   • 네트워크에 자동으로 할당된 IP 범위를 사용합니다.
3. 계속을 클릭합니다.
4. 연결 만들기를 클릭합니다.
5. VPC_NETWORK_NAME 네트워크의 비공개 서비스 연결이 생성되었습니다. 상태가 표시되는지 확인합니다.
6. (선택사항) BigQuery와 같은 다른 Cloud de Confiance 서비스에서 Cloud SQL의 데이터에 액세스하고 비공개 IP 연결을 통해 이 데이터에 대해 쿼리를 수행하도록 허용하려면 비공개 경로 사용 설정 체크박스를 선택합니다.
7. 저장을 클릭합니다.

gcloud

프로젝트가 비공개 서비스 액세스를 위해 구성되었는지 확인합니다.

--network 파라미터를 사용하여 선택한 VPC 네트워크의 이름을 지정해 Cloud SQL 인스턴스를 업데이트합니다.

비공개 IP 네트워크 구성을 추가할 때 인스턴스에 새 네트워크 아키텍처를 사용하도록 강제하려면 --enforce-new-sql-network-architecture 플래그를 사용합니다. IP 범위에 충분한 IP 주소 공간이 할당되어 있는지 확인합니다. 프로젝트가 완전히 업그레이드되기 전에 새 네트워크 아키텍처 시행을 사용하는 경우 충분한 IP 주소 공간이 없으면 인스턴스 만들기가 실패할 수 있습니다.

자세한 내용은 새 네트워크 아키텍처로 인스턴스 업그레이드 및 IP 주소 범위 할당을 참조하세요.

gcloud beta sql instances patch INSTANCE_ID \
--project=PROJECT_ID \
--network=projects/NETWORK_PROJECT_ID/global/networks/VPC_NETWORK_NAME \
--no-assign-ip \
--enable-google-private-path \
--enforce-new-sql-network-architecture

REST v1

비공개 IP 주소로 새 인스턴스를 만듭니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID:: 프로젝트 ID
• INSTANCE_ID:: 인스턴스 ID
• VPC_NETWORK_NAME:: 이 인스턴스에 사용하려는 Virtual Private Cloud(VPC) 네트워크 이름을 지정합니다. 비공개 서비스 액세스가 이미 네트워크에 구성되어 있어야 합니다.
• RANGE_NAME:: 선택사항. 지정하면 IP 범위가 할당되는 범위 이름이 설정됩니다. 범위 이름은 RFC-1035를 준수해야 하며 1~63(영문 기준)자 이내여야 합니다.
• AUTHORIZED_NETWORKS:: 공개 IP 연결의 경우 인스턴스에 연결할 수 있는 승인된 네트워크의 연결을 지정합니다.

ipv4Enabled 파라미터의 경우 인스턴스에 공개 IP 주소를 사용하려면 값을 true로 설정하고, 인스턴스에 비공개 IP 주소가 포함되었으면 false로 설정합니다.

enablePrivatePathForGoogleCloudServices 파라미터를 true로 설정하면 BigQuery와 같은 다른 Cloud de Confiance by S3NS 서비스에서 Cloud SQL의 데이터에 액세스하고 비공개 IP 연결을 통해 이 데이터에 대해 쿼리를 수행할 수 있습니다. 이 파라미터를 false로 설정하면 다른 Cloud de Confiance by S3NS 서비스에서 비공개 IP 연결을 통해 Cloud SQL의 데이터에 액세스할 수 없습니다.

프로젝트가 완전히 업그레이드되지 않은 경우에도 sqlNetworkArchitecture 필드를 사용하여 인스턴스 생성 시 새 네트워크 아키텍처를 사용하도록 강제할 수 있습니다. 새 네트워크 아키텍처 및 그 영향에 관한 자세한 내용은 새 네트워크 아키텍처로 인스턴스 업그레이드 및 IP 주소 범위 할당을 참고하세요.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "settings":
  {
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

비공개 IP 주소로 새 인스턴스를 만듭니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID:: 프로젝트 ID
• INSTANCE_ID:: 인스턴스 ID
• VPC_NETWORK_NAME:: 이 인스턴스에 사용하려는 Virtual Private Cloud(VPC) 네트워크 이름을 지정합니다. 비공개 서비스 액세스가 이미 네트워크에 구성되어 있어야 합니다.
• RANGE_NAME:: 선택사항. 지정하면 IP 범위가 할당되는 범위 이름이 설정됩니다. 범위 이름은 RFC-1035를 준수해야 하며 1~63(영문 기준)자 이내여야 합니다.
• AUTHORIZED_NETWORKS: 공개 IP 연결의 경우 인스턴스에 연결할 수 있는 승인된 네트워크의 연결을 지정합니다.

ipv4Enabled 파라미터의 경우 인스턴스에 공개 IP 주소를 사용하려면 값을 true로 설정하고, 인스턴스에 비공개 IP 주소가 포함되었으면 false로 설정합니다.

enablePrivatePathForGoogleCloudServices 파라미터를 true로 설정하면 BigQuery와 같은 다른 Cloud de Confiance by S3NS 서비스에서 Cloud SQL의 데이터에 액세스하고 비공개 IP 연결을 통해 이 데이터에 대해 쿼리를 수행할 수 있습니다. 이 파라미터를 false로 설정하면 다른 Cloud de Confiance by S3NS 서비스에서 비공개 IP 연결을 통해 Cloud SQL의 데이터에 액세스할 수 없습니다.

프로젝트가 완전히 업그레이드되지 않은 경우에도 sqlNetworkArchitecture 필드를 사용하여 인스턴스 생성 시 새 네트워크 아키텍처를 사용하도록 강제할 수 있습니다. 새 네트워크 아키텍처 및 그 영향에 관한 자세한 내용은 새 네트워크 아키텍처로 인스턴스 업그레이드 및 IP 주소 범위 할당을 참고하세요.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 요청 본문:

{
  "settings":
  {
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}