이 페이지는 Cloud Translation API를 통해 번역되었습니다.

최종 백업 관리

MySQL | PostgreSQL | SQL Server

이 페이지에서는 Cloud SQL 인스턴스의 최종 백업을 관리하는 방법을 설명합니다. 인스턴스를 삭제하기 전에 인스턴스의 최종 백업을 수행할 수 있습니다. 그런 다음 최종 백업을 새 인스턴스 또는 기존 인스턴스로 복원할 수 있습니다. 이렇게 하면 실수로 삭제한 인스턴스를 다시 만들거나 재난 복구 시나리오에 이러한 인스턴스를 사용할 수 있습니다.

인스턴스와 연결된 자동 백업 및 주문형 백업과 달리 인스턴스를 삭제하기 전에 최종 백업을 수행할 수 있습니다. Cloud SQL은 인스턴스의 전체 기간 동안 이 백업을 저장합니다.

기존 gcloud CLI 명령어를 사용하여 최종 백업을 나열, 설명, 업데이트, 삭제할 수 있습니다. 커스텀 역할을 사용하는 경우 역할에 다음 권한을 추가합니다.

cloudsql.backupRuns.list
cloudsql.backupRuns.get
cloudsql.backupRuns.update
cloudsql.backupRuns.delete

이러한 권한에 대한 자세한 내용은 필수 권한을 참고하세요. 또한 백업 작동 방식에 대한 자세한 내용은 Cloud SQL 백업 정보를 참고하세요.

필수 권한

Google Cloud 콘솔

Google Cloud 프로젝트에서 최종 백업을 관리하려면 다음 권한이 필요합니다.

작업	필수 권한
최종 백업 나열	`cloudsql.backupRuns.list`
최종 백업 설명	`cloudsql.backupRuns.get`
최종 백업 업데이트	`cloudsql.backupRuns.update`
최종 백업 삭제	`cloudsql.backupRuns.delete`

gcloud CLI

Google Cloud 프로젝트에서 최종 백업을 관리하려면 다음 권한이 필요합니다.

작업	명령어	필수 권한
최종 백업 나열	`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

Google Cloud 프로젝트에서 최종 백업을 관리하려면 다음 권한이 필요합니다.

작업	메서드	필수 권한
최종 백업 나열	`backups.list`	`cloudsql.backupRuns.list`
최종 백업 설명	`backups.describe`	`cloudsql.backupRuns.get`
최종 백업 업데이트	`backups.patch`	`cloudsql.backupRuns.update`
최종 백업 삭제	`backups.delete`	`cloudsql.backupRuns.delete`

최종 백업 목록 보기

Google Cloud 콘솔, gcloud CLI 또는 Cloud SQL API를 사용하여 최종 백업 목록과 백업 세부정보를 볼 수 있습니다.

Google Cloud 콘솔은 건너뛰거나 실패한 백업을 백업 기록에 표시하지 않습니다. 이러한 유형의 백업을 보려면 gcloud 또는 Cloud SQL API를 사용하세요.

콘솔

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

Cloud SQL 백업으로 이동

이 페이지에는 Google Cloud 프로젝트와 연결된 최종 백업을 비롯한 모든 백업이 나열됩니다.
최종 백업에 대한 세부정보를 보려면 백업을 클릭합니다. 최종 백업 대화상자가 표시됩니다. 이 대화상자에는 다음 정보가 표시됩니다.
- 최종 백업을 만드는 데 사용된 인스턴스가 삭제된 날짜 및 시간입니다.
- 삭제된 인스턴스의 이름 및 버전
- Cloud SQL에서 최종 백업을 보관하는 기간의 날짜 및 시간 스탬프
- 최종 백업의 설명

gcloud

Google Cloud 프로젝트와 연결된 모든 최종 백업의 목록을 가져오려면 gcloud sql backups list 명령어를 사용합니다.
```
gcloud sql backups list \
--filter="type=FINAL"
```
참고: 이 명령어를 사용하면 ID를 비롯한 백업에 관한 정보를 검색할 수 있습니다. 최종 백업에 대한 세부정보를 보려면 백업 ID가 필요합니다.

또한 표준 목록 매개변수를 사용하여 이 명령어 실행 결과를 필터링하고 제어할 수 있습니다. 전체 목록은 gcloud sql backups list 명령어 참조 페이지를 확인하세요.
최종 백업에 대한 세부정보를 보려면 gcloud sql backups describe 명령어를 사용합니다.
```
gcloud sql backups describe \
BACKUP_NAME
```
gcloud sql backups list 명령어 실행의 출력에서 BACKUP_NAME를 가져옵니다. BACKUP_NAME의 형식은 projects/PROJECT_ID/backups/BACKUP_ID입니다.

REST v1

최종 백업 목록 가져오기

이 예시를 사용하여 Google Cloud 프로젝트와 연결된 모든 최종 백업의 목록을 가져옵니다. 이 호출의 전체 매개변수 목록은 backupRuns.list 페이지를 참고하세요.

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

PROJECT_ID: 프로젝트 ID
INSTANCE_ID: 인스턴스 ID입니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

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

cURL(Linux, macOS, Cloud Shell)

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

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

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 GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

응답

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

최종 백업에 대한 세부정보 보기

이 예시를 사용하여 최종 백업에 대한 세부정보를 확인하세요. 이 호출의 전체 매개변수 목록은 backupRuns.get 페이지를 참고하세요.

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

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

HTTP 메서드 및 URL:

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

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

cURL(Linux, macOS, Cloud Shell)

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

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

PowerShell(Windows)

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

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

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

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

응답

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
    }

REST v1beta4

최종 백업 목록 가져오기

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

PROJECT_ID: 프로젝트 ID
INSTANCE_ID: 인스턴스 ID입니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

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

cURL(Linux, macOS, Cloud Shell)

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell(Windows)

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

응답

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

최종 백업에 대한 세부정보 보기

이 예시를 사용하여 최종 백업에 대한 세부정보를 확인하세요. 이 호출의 전체 매개변수 목록은 backupRuns.get 페이지를 참고하세요.

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

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

HTTP 메서드 및 URL:

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

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

cURL(Linux, macOS, Cloud Shell)

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

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

PowerShell(Windows)

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

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

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

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

응답

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
    }

최종 백업 업데이트

Google Cloud 콘솔, gcloud CLI 또는 Cloud SQL API를 사용하여 인스턴스의 Cloud SQL에서 최종 백업을 보관하는 기간과 백업의 설명을 업데이트할 수 있습니다.

콘솔

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

Cloud SQL 백업으로 이동

이 페이지에는 Google Cloud 프로젝트와 연결된 최종 백업을 비롯한 모든 백업이 나열됩니다.
최종 백업을 업데이트하려면 백업을 클릭합니다. 최종 백업 대화상자가 표시됩니다.
Cloud SQL에서 최종 백업을 보관하는 기간을 업데이트하려면 다음 작업을 완료합니다.
1. 백업 보관 기간 필드 옆에 있는 보관 기간 수정 아이콘을 클릭합니다.
2. 백업 보관 기간 입력란 옆에 있는 날짜 선택 아이콘을 클릭합니다.
3. 캘린더에서 Cloud SQL이 최종 백업을 보관하는 기간을 나타내는 새 날짜를 선택합니다.
4. 업데이트를 클릭합니다. Cloud SQL 백업 페이지로 돌아갑니다.
최종 백업의 설명을 업데이트하려면 다음 작업을 완료합니다.
1. 최종 백업을 클릭합니다.
2. 설명 필드 옆에 있는 설명 수정 아이콘을 클릭합니다.
3. 이 백업 설명 필드에 최종 백업의 업데이트된 설명을 입력합니다.
4. 업데이트를 클릭합니다. Cloud SQL 백업 페이지로 돌아갑니다.

gcloud

Google Cloud 프로젝트와 연결된 모든 최종 백업의 목록을 가져오려면 gcloud sql backups list 명령어를 사용합니다.
```
gcloud sql backups list \
--filter="type=FINAL"
```
참고: 이 명령어를 사용하면 ID를 비롯한 최종 백업에 관한 정보를 검색할 수 있습니다. 최종 백업을 업데이트하려면 백업 ID가 필요합니다.

또한 표준 목록 매개변수를 사용하여 이 명령어 실행 결과를 필터링하고 제어할 수 있습니다. 전체 목록은 gcloud sql backups list 명령어 참조 페이지를 확인하세요.
최종 백업의 설명과 보관 기간을 업데이트하려면 gcloud sql backups patch 명령어를 사용합니다.
```
gcloud sql backups patch \
BACKUP_NAME  \
--description=DESCRIPTION /
--expiry-time=DATE-AND-TIME-STAMP | --ttl-days=NUMBER-OF-DAYS
```
gcloud sql backups list 명령어 실행의 출력에서 BACKUP_NAME를 가져옵니다. BACKUP_NAME의 형식은 projects/PROJECT_ID/backups/BACKUP_ID입니다.

--expiry-time 및 --ttl-days 플래그의 경우 다음 가이드라인을 따르세요.
- --expiry-time 플래그의 경우 Cloud SQL에서 최종 백업을 자동으로 삭제하는 날짜 및 시간 스탬프를 지정합니다.
- --ttl-days 플래그에는 최종 백업의 보관 기간 (1~365일)을 지정합니다. 이를 TTL (수명)이라고 합니다. 보관 기간은 현재 날짜 및 시간부터 시작되며 Cloud SQL에서 허용하는 최대 보관 기간은 1년 (365일)입니다.
--expiry-time 또는 --ttl-days 플래그 중 하나만 사용합니다. 두 플래그를 모두 사용하면 안 됩니다.

REST v1

최종 백업 목록 가져오기

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

PROJECT_ID: 프로젝트 ID
INSTANCE_ID: 인스턴스 ID입니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

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

cURL(Linux, macOS, Cloud Shell)

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell(Windows)

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

응답

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

보관 기간 업데이트

최종 백업의 보관 기간은 다음 방법 중 하나로 업데이트할 수 있습니다.

보관 기간: Cloud SQL이 백업을 보관하는 일수를 수정합니다.
만료 시간: Cloud SQL에서 백업을 자동으로 삭제할 때의 업데이트된 날짜 및 시간 스탬프를 입력합니다.

보관 기간 업데이트

이 예를 사용하여 Cloud SQL이 최종 백업을 보관하는 일수를 업데이트합니다. 이 호출의 전체 매개변수 목록은 backupRuns.update 페이지를 참고하세요.

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

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

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

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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/backups/BACKUP_ID?update_mask=ttl_days"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$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/backups/BACKUP_ID?update_mask=ttl_days" | Select-Object -Expand Content

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

응답

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

만료 시간 업데이트

이 예시를 사용하여 Cloud SQL에서 백업을 삭제할 때 업데이트된 날짜 및 시간 스탬프를 제공합니다. 이 호출의 전체 매개변수 목록은 backupRuns.update 페이지를 참고하세요.

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

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

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

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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/backups/BACKUP_ID?update_mask=expiry_time"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$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/backups/BACKUP_ID?update_mask=expiry_time" | Select-Object -Expand Content

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

응답

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

설명 업데이트

이 예시를 사용하여 최종 백업의 설명을 업데이트합니다. 이 호출의 전체 매개변수 목록은 backupRuns.update 페이지를 참고하세요.

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

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

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

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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/backups/BACKUP_ID?update_mask=description"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$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/backups/BACKUP_ID?update_mask=description" | Select-Object -Expand Content

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

응답

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

REST v1beta4

최종 백업 목록 가져오기

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

PROJECT_ID: 프로젝트 ID
INSTANCE_ID: 인스턴스 ID입니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

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

cURL(Linux, macOS, Cloud Shell)

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell(Windows)

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

응답

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

보관 기간 업데이트

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

보관 기간: Cloud SQL이 백업을 보관하는 일수를 수정합니다.
만료 시간: Cloud SQL에서 백업을 자동으로 삭제할 때의 업데이트된 날짜 및 시간 스탬프를 입력합니다.

보관 기간 업데이트

이 예를 사용하여 Cloud SQL이 최종 백업을 보관하는 일수를 업데이트합니다. 이 호출의 전체 매개변수 목록은 backupRuns.update 페이지를 참고하세요.

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

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

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

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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/backups/BACKUP_ID?update_mask=ttl_days"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$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/backups/BACKUP_ID?update_mask=ttl_days" | Select-Object -Expand Content

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

응답

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

만료 시간 업데이트

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

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

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

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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/backups/BACKUP_ID?update_mask=expiry_time"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$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/backups/BACKUP_ID?update_mask=expiry_time" | Select-Object -Expand Content

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

응답

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

설명 업데이트

이 예시를 사용하여 최종 백업의 설명을 업데이트합니다. 이 호출의 전체 매개변수 목록은 backupRuns.update 페이지를 참고하세요.

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

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

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

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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/backups/BACKUP_ID?update_mask=description"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$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/backups/BACKUP_ID?update_mask=description" | Select-Object -Expand Content

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

응답

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

최종 백업 삭제

Google Cloud 콘솔, gcloud CLI 또는 Cloud SQL API를 사용하여 최종 백업을 삭제할 수 있습니다.

백업을 삭제해도 백업 크기만큼의 공간이 확보되지 않을 수 있습니다. 이는 백업이 증분 방식이라 이전 백업을 삭제하면 최신 백업의 무결성을 유지하기 위해 일부 내용이 최신 백업으로 전송될 수 있기 때문입니다.

콘솔

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

Cloud SQL 백업으로 이동

이 페이지에는 Google Cloud 프로젝트와 연결된 최종 백업을 비롯한 모든 백업이 나열됩니다.
삭제하려는 최종 백업의 추가 작업 을 클릭한 다음 삭제를 선택합니다.
최종 백업 삭제? 창에서 최종 백업을 만드는 데 사용한 인스턴스의 이름을 입력한 후 삭제를 클릭합니다.

gcloud

Google Cloud 프로젝트와 연결된 모든 최종 백업의 목록을 가져오려면 gcloud sql backups list 명령어를 사용합니다.
```
gcloud sql backups list \
--filter="type=FINAL"
```
참고: 이 명령어를 사용하면 ID를 비롯한 백업에 대한 정보를 검색할 수 있습니다. 최종 백업을 삭제하려면 백업 ID가 필요합니다.

또한 표준 목록 매개변수를 사용하여 이 명령어 실행 결과를 필터링하고 제어할 수 있습니다. 전체 목록은 gcloud sql backups list 명령어 참조 페이지를 확인하세요.
최종 백업을 삭제하려면 gcloud sql backups delete 명령어를 사용합니다.
```
gcloud sql backups delete \
BACKUP_NAME
```
gcloud sql backups list 명령어 실행의 출력에서 BACKUP_NAME를 가져옵니다. BACKUP_NAME의 형식은 projects/PROJECT_ID/backups/BACKUP_ID입니다.

REST v1

최종 백업 목록 가져오기

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

PROJECT_ID: 프로젝트 ID
INSTANCE_ID: 인스턴스 ID입니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

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

cURL(Linux, macOS, Cloud Shell)

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell(Windows)

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

응답

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

최종 백업 삭제

이 예시를 사용하여 최종 백업을 삭제합니다. 이 호출의 전체 매개변수 목록은 backupRuns.delete 페이지를 참고하세요.

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

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

HTTP 메서드 및 URL:

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

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

cURL(Linux, macOS, Cloud Shell)

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

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

PowerShell(Windows)

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

$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/backups/BACKUP_ID" | Select-Object -Expand Content

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

응답

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

REST v1beta4

최종 백업 목록 가져오기

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

PROJECT_ID: 프로젝트 ID
INSTANCE_ID: 인스턴스 ID입니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

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

cURL(Linux, macOS, Cloud Shell)

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

PowerShell(Windows)

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL" | Select-Object -Expand Content

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

응답

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
         }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "final backup",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

최종 백업 삭제

이 예시를 사용하여 최종 백업을 삭제합니다. 이 호출의 전체 매개변수 목록은 backupRuns.delete 페이지를 참고하세요.

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

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

HTTP 메서드 및 URL:

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

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

cURL(Linux, macOS, Cloud Shell)

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

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

PowerShell(Windows)

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

$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/backups/BACKUP_ID" | Select-Object -Expand Content

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

응답

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