삭제된 인스턴스의 백업 관리

인스턴스 삭제 후 백업 보관을 선택했거나 인스턴스를 삭제하기 전에 최종 백업을 수행한 경우 인스턴스가 삭제된 후 백업을 관리할 수 있습니다. 보관된 백업에는 인스턴스가 사용 중일 때 생성된 자동 백업 및 주문형 백업이 포함됩니다. 인스턴스를 삭제하면 이러한 백업은 인스턴스와 독립적으로 프로젝트 수준에 저장됩니다. 백업 작동 방식과 보관되는 백업에 대한 자세한 내용은 Cloud SQL 백업 개요를 참고하세요.

인스턴스가 삭제된 후 이러한 백업을 사용하여 인스턴스를 복원할 수 있습니다.

시작하기 전에

Cloud de Confiance 프로젝트에서 보관된 백업을 관리하려면 다음 권한이 필요합니다.

콘솔

작업 필수 권한
백업 표시 cloudsql.backupRuns.list
백업 설명 cloudsql.backupRuns.get
백업 업데이트 cloudsql.backupRuns.update
백업 삭제 cloudsql.backupRuns.delete

gcloud

작업 명령어 필수 권한
백업 표시 gcloud sql backups list cloudsql.backupRuns.list
백업 설명 gcloud sql backups describe cloudsql.backupRuns.get
백업 업데이트 gcloud sql backups patch cloudsql.backupRuns.update
백업 삭제 gcloud sql backups delete cloudsql.backupRuns.delete

REST

작업 메서드 필수 권한
백업 표시 backups.listBackup cloudsql.backupRuns.list
백업 설명 backups.getBackup cloudsql.backupRuns.get
백업 업데이트 backups.updateBackup cloudsql.backupRuns.update
백업 삭제 backups.deleteBackup cloudsql.backupRuns.delete

삭제된 인스턴스의 모든 백업 나열

Cloud de Confiance 콘솔 프로젝트의 삭제된 인스턴스에 대해 보관된 모든 백업과 최종 백업의 목록을 볼 수 있습니다. 백업에는 백업 이름, 백업에 속한 인스턴스, 백업 유형, 인스턴스 삭제 시간과 같은 세부정보가 포함됩니다. 삭제된 인스턴스의 이름은 삭제 후 재사용될 수 있으므로 instance deletion time 필드를 사용하여 특정 백업이 속한 인스턴스를 구분하는 것이 좋습니다. 실시간 인스턴스의 경우 이 필드는 비어 있습니다.

콘솔

  1. Cloud de Confiance 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.

    Cloud SQL 백업으로 이동

  2. 인스턴스의 백업 옵션(표준 등급 또는 고급 등급)을 선택합니다.

  3. 필터, 인스턴스 상태를 차례로 클릭하고 삭제된 인스턴스를 선택합니다.

    이 페이지에는Cloud de Confiance 콘솔 프로젝트에서 삭제된 모든 인스턴스가 나열됩니다.

  4. 백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.

    이 페이지에는 삭제된 인스턴스의 모든 보관된 자동 및 주문형 백업과 최종 백업(있는 경우)이 나열됩니다.

gcloud

  1. Cloud de Confiance 프로젝트와 연결된 모든 백업 목록을 가져오려면 gcloud sql backups list 명령어를 사용합니다.

    gcloud sql backups list
    --project=PROJECT_ID
    

    다음을 바꿉니다.

    • PROJECT_ID: Cloud de Confiance 프로젝트의 ID입니다.
  2. 특정 보관된 백업에 대한 세부정보를 보려면 gcloud sql backups describe 명령어를 사용합니다.

    gcloud sql backups describe BACKUP_NAME
    --project=PROJECT_ID
    

    다음을 바꿉니다.

    • BACKUP_NAME: 보관된 백업 이름입니다.
    • PROJECT_ID: Cloud de Confiance 프로젝트의 ID입니다.

REST v1

모든 백업 목록 가져오기

이 예시를 사용하여 Cloud de Confiance 프로젝트와 연결된 모든 보관된 백업과 최종 백업의 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

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

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

백업 세부정보 보기

이 예시를 사용하여 보관된 백업 또는 최종 백업의 세부정보를 봅니다. 이 호출의 전체 파라미터 목록은 backup.getBackup 페이지를 참고하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

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

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

REST v1beta4

모든 보관된 백업 목록 가져오기

이 예시를 사용하여Cloud de Confiance 프로젝트와 연결된 모든 보관된 백업과 최종 백업의 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

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

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

보관된 백업 세부정보 보기

이 예시를 사용하여 보관된 백업 또는 최종 백업의 세부정보를 봅니다. 이 호출의 전체 파라미터 목록은 backups.getBackup 페이지를 참고하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

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

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

인스턴스 삭제 후 보관된 백업 또는 최종 백업 업데이트

인스턴스를 삭제한 후에는 프로젝트 수준에 저장된 해당 인스턴스와 연결된 보관된 백업 또는 최종 백업의 설정을 업데이트할 수 있습니다. 백업 유형에 따라 업데이트할 수 있는 세부정보가 다를 수 있습니다.

인스턴스를 삭제하기 전에 수행한 최종 백업의 설명과 보관 설정을 업데이트할 수 있습니다. 하지만 인스턴스 삭제 후 보관되는 주문형 또는 자동 백업의 경우 이러한 백업의 설명만 업데이트할 수 있습니다. 보관된 백업의 경우 인스턴스가 사용 중일 때 백업의 보관 설정에 따라 보관 설정이 지정됩니다. 자세한 내용은 인스턴스 삭제 후 백업 보관을 참조하세요.

최종 백업 업데이트

인스턴스를 삭제하기 전에 생성된 최종 백업의 보관 설정과 설명을 업데이트할 수 있습니다. 백업을 업데이트하려면 다음을 수행하세요.

콘솔

  1. Cloud de Confiance 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.

    Cloud SQL 백업으로 이동

  2. 백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.

    모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.

  3. 업데이트하려는 최종 백업의 경우 추가 작업 추가 작업 아이콘을 클릭한 후 다음 단계를 따르세요.

    • 최종 백업의 설명을 수정하려면 설명 수정을 클릭합니다.

      이 백업 설명 필드에 설명을 입력한 다음 업데이트를 클릭합니다.

    • 최종 백업의 보관 기간을 수정하려면 보관 기간 수정을 클릭합니다.

      백업 보관 기한 필드에서 날짜를 선택합니다. 보관 기간은 인스턴스 삭제 후 1~365일입니다. 백업 보관 기한을 선택한 후 업데이트를 클릭합니다.

gcloud

업데이트할 최종 백업의 backup-name이 필요합니다. backup-name를 가져오려면 삭제된 인스턴스의 백업 나열을 참고하세요.

최종 백업의 보관 기간 또는 설명을 업데이트하려면 gcloud sql backups patch 명령어를 사용하고 백업에 대해 expiry-time 또는 ttl-days를 지정합니다.

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
--expiry-time=EXPIRY_TIME | --ttl-days=TTL_DAYS

다음을 바꿉니다.

  • BACKUP_NAME: 최종 백업의 이름입니다.
  • BACKUP_DESCRIPTION: 최종 백업에 추가할 새 설명
  • 다음 중 하나입니다.

    • EXPIRY_TIME: 최종 백업을 삭제할 새 날짜와 시간입니다. 최대 시간은 인스턴스 삭제 후 365일입니다.
    • TTL_DAYS: 최종 백업을 보관할 일수입니다. 이 값은 1~365일 범위에서 설정할 수 있으며 기본값은 30일입니다.

REST v1

업데이트할 최종 백업의 backup-name이 필요합니다. backup-name를 가져오려면 삭제된 인스턴스의 백업 나열을 참고하세요.

최종 백업의 설명과 보관 설정을 업데이트할 수 있습니다. 보관 설정은 다음 방법 중 하나를 사용하여 업데이트할 수 있습니다.

  • 최종 백업의 보관 일수 업데이트
  • 최종 백업의 만료 시간 업데이트

보관 일수를 사용하여 보관 기간 업데이트

이 예시를 사용하여 보관 기간(일) 매개변수를 사용하여 최종 백업의 보관 설정을 업데이트합니다.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
  • TTL_DAYS: 최종 백업의 보관 기간입니다(1~365일). 이를 TTL(수명)이라고 합니다. 보관 기간은 현재 날짜 및 시간부터 시작되며 Cloud SQL에서 허용하는 최대 보관 기간은 1년(365일)입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

JSON 요청 본문:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

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

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

만료 시간을 사용하여 보관 기간 업데이트

만료 시간 매개변수를 사용하여 최종 백업의 보관 설정을 업데이트하려면 다음 예시를 사용하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
  • DATE_AND_TIME_STAMP: Cloud SQL에서 최종 백업을 자동으로 삭제한 날짜 및 시간 스탬프입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

JSON 요청 본문:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

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

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

설명 업데이트

최종 백업의 설명을 업데이트하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 backups.updateBackup 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
  • DESCRIPTION: 최종 백업에 대한 업데이트된 설명입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

JSON 요청 본문:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

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

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

REST v1beta4

업데이트할 최종 백업의 backup-name이 필요합니다. backup-name를 가져오려면 삭제된 인스턴스의 백업 나열을 참고하세요.

최종 백업의 설명과 보관 설정을 업데이트할 수 있습니다. 보관 설정은 다음 방법 중 하나를 사용하여 업데이트할 수 있습니다.

  • 최종 백업의 보관 일수 업데이트
  • 최종 백업의 만료 시간 업데이트

보관 일수를 사용하여 보관 기간 업데이트

이 예시를 사용하여 보관 기간(일) 매개변수를 사용하여 최종 백업의 보관 설정을 업데이트합니다.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
  • TTL_DAYS: 최종 백업의 보관 기간입니다(1~365일). 이를 TTL(수명)이라고 합니다. 보관 기간은 현재 날짜 및 시간부터 시작되며 Cloud SQL에서 허용하는 최대 보관 기간은 1년(365일)입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

JSON 요청 본문:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

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

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

만료 시간을 사용하여 보관 기간 업데이트

만료 시간 매개변수를 사용하여 최종 백업의 보관 설정을 업데이트하려면 다음 예시를 사용하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
  • DATE_AND_TIME_STAMP: Cloud SQL에서 최종 백업을 자동으로 삭제한 날짜 및 시간 스탬프입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

JSON 요청 본문:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

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

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

설명 업데이트

최종 백업의 설명을 업데이트하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 backups.updateBackup 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
  • DESCRIPTION: 최종 백업에 대한 업데이트된 설명입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

JSON 요청 본문:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

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

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

보관된 백업 업데이트

보관된 주문형 및 자동 백업의 설명을 업데이트할 수 있습니다. 백업을 업데이트하려면 다음을 수행하세요.

콘솔

  1. Cloud de Confiance 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.

    Cloud SQL 백업으로 이동

  2. 백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.

    모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.

  3. 업데이트하려는 보관된 백업의 경우 작업 더보기 추가 작업 아이콘를 클릭한 후 설명 수정을 선택합니다.

  4. 백업 설명 수정 창에서 백업 설명을 업데이트합니다.

  5. 업데이트를 클릭합니다.

gcloud

보관된 백업 설명을 업데이트하려면 gcloud sql backups patch 명령어를 사용합니다.

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION

다음을 바꿉니다.

  • BACKUP_NAME: 보관된 백업 이름
  • BACKUP_DESCRIPTION: 보관된 백업에 추가할 새 설명

REST v1

모든 보관된 백업 목록 가져오기

이 예시를 사용하여Cloud de Confiance 프로젝트와 연결된 모든 보관된 백업 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

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

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

설명 업데이트

이 예시를 사용하여 보관된 백업 설명을 업데이트합니다. 이 호출의 전체 파라미터 목록은 backups.updateBackup 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
  • DESCRIPTION: 최종 백업에 대한 업데이트된 설명입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

JSON 요청 본문:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

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

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

REST v1beta4

모든 보관된 백업 목록 가져오기

이 예시를 사용하여Cloud de Confiance 프로젝트와 연결된 모든 보관된 백업 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

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

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

설명 업데이트

이 예시를 사용하여 보관된 백업 설명을 업데이트합니다. 이 호출의 전체 파라미터 목록은 backups.updateBackup 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
  • DESCRIPTION: 최종 백업에 대한 업데이트된 설명입니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

JSON 요청 본문:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

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

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

삭제된 인스턴스와 연결된 백업 삭제

삭제된 인스턴스의 최종 또는 보관된 주문형 및 자동 백업은 언제든지 삭제할 수 있습니다.

콘솔

  1. Cloud de Confiance 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.

    Cloud SQL 백업으로 이동

  2. 백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.

    모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.

  3. 삭제하려는 백업의 경우 추가 작업 추가 작업 아이콘을 클릭한 후 삭제를 선택합니다.

  4. 백업 삭제 창에 삭제된 인스턴스의 이름을 입력한 후 삭제를 클릭합니다.

gcloud

보관된 백업을 삭제하려면 gcloud sql backups delete 명령어를 사용합니다.

gcloud sql backups delete BACKUP_NAME

다음을 바꿉니다.

  • BACKUP_NAME: 보관된 백업 이름

REST v1

최종 또는 보관된 백업을 삭제하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 backups.deleteBackup 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.

HTTP 메서드 및 URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

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

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

REST v1beta4

최종 또는 보관된 백업을 삭제하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 backups.deleteBackup 페이지를 참조하세요.

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

  • PROJECT_ID: 프로젝트 ID
  • BACKUP_ID: 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.

HTTP 메서드 및 URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

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

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

다음 단계