이 페이지에서는 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
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)
다음 명령어를 실행합니다.
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.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
최종 백업 목록 가져오기
이 예시를 사용하여 Google Cloud 프로젝트와 연결된 모든 최종 백업의 목록을 가져옵니다. 이 호출의 전체 매개변수 목록은 backupRuns.list 페이지를 참고하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
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에서 최종 백업을 보관하는 기간을 업데이트하려면 다음 작업을 완료합니다.
백업 보관 기간 필드 옆에 있는 보관 기간 수정 아이콘을 클릭합니다.
백업 보관 기간 입력란 옆에 있는 날짜 선택 아이콘을 클릭합니다.
캘린더에서 Cloud SQL이 최종 백업을 보관하는 기간을 나타내는 새 날짜를 선택합니다.
업데이트 를 클릭합니다. Cloud SQL 백업 페이지로 돌아갑니다.
최종 백업의 설명을 업데이트하려면 다음 작업을 완료합니다.
최종 백업을 클릭합니다.
설명 필드 옆에 있는 설명 수정 아이콘을 클릭합니다.
이 백업 설명 필드에 최종 백업의 업데이트된 설명을 입력합니다.
업데이트 를 클릭합니다. 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
최종 백업 목록 가져오기
이 예시를 사용하여 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)
다음 명령어를 실행합니다.
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
최종 백업 목록 가져오기
이 예시를 사용하여 Google Cloud 프로젝트와 연결된 모든 최종 백업의 목록을 가져옵니다. 이 호출의 전체 매개변수 목록은 backupRuns.list 페이지를 참고하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
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 "
}
만료 시간 업데이트
이 예시를 사용하여 Cloud SQL에서 백업을 삭제할 때 업데이트된 날짜 및 타임스탬프를 제공합니다. 이 호출의 전체 매개변수 목록은 backupRuns.update 페이지를 참고하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
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를 사용하여 최종 백업을 삭제할 수 있습니다.
MySQL 인스턴스의 경우 백업을 삭제해도 공간이 백업 크기만큼 확보되지 않을 수 있습니다. 백업이 증분 방식이므로 이전 백업을 삭제하면 최신 백업 무결성이 유지되도록 일부 콘텐츠가 최신 백업으로 전송될 수 있습니다.
콘솔
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
최종 백업 목록 가져오기
이 예시를 사용하여 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)
다음 명령어를 실행합니다.
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
최종 백업 목록 가져오기
이 예시를 사용하여 Google Cloud 프로젝트와 연결된 모든 최종 백업의 목록을 가져옵니다. 이 호출의 전체 매개변수 목록은 backupRuns.list 페이지를 참고하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
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 "
}
다음 단계