인스턴스 삭제

MySQL   |  PostgreSQL   |  SQL Server

이 페이지에서는 Cloud SQL 인스턴스를 삭제하는 방법을 설명합니다.

경고: 인스턴스를 삭제하면 백업을 포함한 인스턴스의 모든 데이터가 영구 삭제됩니다. 데이터를 보존하려면 Cloud Storage로 내보낸 후에 삭제하세요. Cloud SQL 관리자 역할은 인스턴스를 삭제할 수 있는 권한을 포함합니다. 실수로 삭제하지 않도록 방지하려면 필요한 경우에만 이 역할을 부여하세요. 또한 삭제 보호를 사용하는 것이 좋습니다.

인스턴스를 삭제할 계획이라면 다음 사항을 참고하세요.

• 복제본이 있는 인스턴스를 삭제할 수 없습니다. 인스턴스를 삭제하려면 먼저 모든 복제본을 삭제해야 합니다.
  복제본을 만들어 실수로 인스턴스를 삭제할 가능성을 줄일 수 있습니다. 복제본은 기본 인스턴스보다 먼저 삭제되어야 하기 때문입니다.
• 인스턴스를 삭제하면 해당 인스턴스가 프로젝트에서 '알 수 없는' 크기 및 '삭제 중'인 상태로 계속 표시될 수 있습니다. 이는 정상적인 현상이며 잠시 후 인스턴스가 완전히 사라집니다.
• 일반적으로 몇 분 내에 삭제되는 읽기 복제본을 제외하고 인스턴스와 관련된 기본 리소스가 완전히 삭제되는 데 최대 일주일이 걸릴 수 있습니다.
• 삭제된 인스턴스 이름을 즉시 재사용하여 새 인스턴스를 만들 수 있습니다.
• 인스턴스에 삭제 보호가 사용 설정된 경우 인스턴스를 삭제하기 전에 사용 중지해야 합니다.

필수 권한

기본적으로 Cloud SQL Admin(roles/cloudsql.admin) 또는 Owner(roles/owner) 역할이 있는 사용자 또는 서비스 계정만 Cloud SQL 인스턴스를 삭제할 수 있는 권한(cloudsql.instances.delete)이 있습니다.

사용자 또는 서비스 계정에 대해 cloudsql.instances.delete 권한을 포함하는 IAM 커스텀 역할을 정의할 수도 있습니다. 이 권한은 IAM 커스텀 역할에서 지원됩니다.

인스턴스 삭제

gcloud CLI 또는 API를 사용하여 Cloud SQL 인스턴스를 삭제할 수 있습니다.

참고: 인스턴스를 삭제하기 전에 안전한지 확인하세요. 그런 다음 인스턴스에 삭제 보호가 비활성화되었는지 확인합니다.

Private Service Connect가 사용 설정된 인스턴스를 삭제하면 다음 작업이 수행됩니다.

• 서비스 연결이 자동으로 삭제됩니다. 하지만 서비스 연결을 가리키는 Private Service Connect 엔드포인트는 자동으로 삭제되지 않습니다. 엔드포인트와 연결된 전달 규칙을 나열하면 규칙이 CLOSED 상태인 것을 확인할 수 있습니다. 이 상태를 수신한 후 엔드포인트를 삭제할 수 있습니다.
• 엔드포인트 연결 제한 시간이 표시됩니다.

추가 비용이 발생하지 않도록 해당 DNS 영역 및 DNS 레코드도 삭제하는 것이 좋습니다.

Console

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

   Cloud SQL 인스턴스로 이동

2. 인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
3. 삭제를 클릭합니다.
4. 데이터베이스 인스턴스 삭제 대화상자에서 확인을 클릭합니다.

gcloud

인스턴스를 삭제하려면 gcloud sql instances delete 명령어를 사용합니다.

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

다음을 바꿉니다.

• INSTANCE_NAME: 인스턴스 이름
• PROJECT_ID: 삭제할 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호

REST v1

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

• PROJECT_ID: 삭제할 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
• INSTANCE_NAME: 인스턴스 이름

HTTP 메서드 및 URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

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

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

이 태스크와 관련된 기본 REST API 요청이 생성되는 방식을 확인하려면 instances:delete 페이지의 API 탐색기를 참조하세요.

REST v1beta4

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

• PROJECT_ID: 삭제할 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
• INSTANCE_NAME: 인스턴스 이름

HTTP 메서드 및 URL:

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

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

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

이 태스크와 관련된 기본 REST API 요청이 생성되는 방식을 확인하려면 instances:delete 페이지의 API 탐색기를 참조하세요.